Erste Schritte mit dem Akzelerator OpenShift Container Platform V4.3.1

Voraussetzungen und Schritte zur Bereitstellung von OpenShift Container Platform V4.3.1 auf IBM Cloud Pak® System.

Vorgehensweise

  1. Stellen Sie sicher, dass eine gemeinsam genutzte Red Hat Satellite Six-Serviceinstanz mit den folgenden Paketen verfügbar ist:

    • rhel-7-server-rpms
    • rhel-7-server-extras-rpms

    Hinweis:

  2. Stellen Sie einen gemeinsam genutzten Cloud Pak® Docker Private Registry Service bereit, in dem OpenShift Container Platform V4.3.1 -Images gehostet werden.

  3. Implementieren Sie einen Cloud Pak Docker Private Registry Virtual System Accelerator, der automatisch die Images für OpenShift Container Platform V4.3.1 und V4.3.18 lädt. Notieren Sie sich den vollständig qualifizierten Domänennamen dieser Implementierung für den nächsten Schritt.

  4. Stellen Sie den gemeinsamen Dienst IBM Cloud Pak® System Registry Service in der Cloud-Gruppe bereit, in der Sie OpenShift Container Platform -Cluster bereitstellen möchten. Wenn Sie den gemeinsamen Dienst IBM Cloud Pak System Registry Service bereitstellen, geben Sie den FQDN des Cloud Pak Docker Private Registry Accelerators ein, der im vorherigen Schritt bereitgestellt wurde.

  5. Optional: Konfigurieren Sie DNS-Platzhalteradressen für alle IPs in der IP-Gruppe, die für die Bereitstellung von OpenShift Container Platform -Clustern verwendet werden. Dadurch kann die Konsole sofort über die Konsolenlinks auf der Benutzeroberfläche IBM Cloud Pak System aufgerufen werden. Wenn DNS nicht vorab konfiguriert wurde, können Sie die folgenden Schritte ausführen:

    • Fügen Sie zu Testzwecken /etc/hosts Einträge aus dem System hinzu, das den Web-Browser ausführt.

    • Fügen Sie nach Abschluss der Installation von OpenShift Container Platform jederzeit einzelne DNS-Einträge hinzu. Fügen Sie für jede IP-Adresse in der IP-Gruppe, die für OpenShift Container Platform -Bereitstellungen verwendet wird, die folgenden zwei Platzhaltereinträge hinzu:

      *.<fqdn> IN A <ip>
*.apps.<fqdn> IN A <ip>

      Hinweis: Nach Abschluss der Bereitstellung sind Anweisungen im Abschnitt 'Verlauf' der OpenShift Container Platform Accelerator-Bereitstellung verfügbar. Der folgende FQDN-Eintrag (vollständig qualifizierter Domänenname) ist beispielsweise in Ihrem DNS vorhanden.

      9.9.9.9 cps-rack-79-vm-83.rtp.raleigh.ibm.com

      Fügen Sie in dem Fall anschließend diese zwei Platzhaltereinträge hinzu:

      *.cps-rack-79-vm-83.rtp.raleigh.ibm.com IN A 9.9.9.9 
*.apps.cps-rack-79-vm-83.rtp.raleigh.ibm.com IN A 9.9.9.9

    Anmerkung: Es gibt eine OpenShift-Einschränkung bzgl. der maximal zulässigen Anzahl für CoreOS-Hostnamen. Die maximal zulässige Anzahl von Zeichen für den Hostnamen ist 63 Zeichen. Berücksichtigen Sie diese Einschränkung, wenn Sie Ihren FQDN (Clustername und Domänenname) definieren. Ein Hostname für einen CoreOS-Workerknoten ist beispielsweise "worker-xxxx.clustername.domain".

    Weitere Informationen zu den OpenShift -Anforderungen für externe DNS finden Sie unter Vom Benutzer bereitgestellte DNS-Anforderungen Symbol für externen Link. Die DNS-Datensätze, die als "Dieser Datensatz muss von beiden Clients außerhalb des Clusters auflösbar sein ..." aufgelistet sind. sind erforderlich. DNS wird auf den Helperknoten bereitgestellt, um die Auflösung innerhalb des Clusters zu verarbeiten.

  6. Stellen Sie den Akzelerator OpenShift Container Platform bereit. Es sind nur die mit * gekennzeichneten Implementierungsfelder erforderlich. Geben Sie die "OpenShift-Version" an, die Sie implementieren möchten. Standardmäßig ist dies V4.3.1 und entspricht den Images, die in die Cloud Pak Docker Private Registry geladen werden. Wenn der OpenShift-Clustername und die OpenShift-Basisdomäne nicht angegeben sind, benennt die Implementierung den Cluster automatisch nach der fließenden IP-Adresse, die vor den beiden Helperknoten verwendet wird. Dies funktioniert gut mit bereits vorinstallierten DNS-Platzhaltereinträgen. Der Cluster ist über den Konsolenlink auf der Benutzeroberfläche IBM Cloud Pak System sofort zugänglich.

    Hinweis: DNS-Namen dürfen nur alphabetische Zeichen (a-z), numerische Zeichen (0-9), Minuszeichen (-) und Punkte (.) enthalten. Punkt ist nur zulässig, um die Komponenten von Domänendarstellungsnamen zu begrenzen.

  7. Greifen Sie auf die OpenShift Container Platform -Konsole zu:

    1. Rufen Sie das kubeadmin-Kennwort über die Befehlszeile ab, indem Sie den im Implementierungsverlauf generierten Befehl verwenden. Setzen Sie beispielsweise den folgenden Befehl ab, um das kubeadmin-Kennwort für den OpenShift-Cluster abzurufen:

      ssh virtuser@9.9.9.9 echo "kubeadmin password is: \$(cat /kubeadmin-password)"

    2. Blenden Sie die PrimaryHelper-VM ein und klicken Sie auf den OpenShift-Konsolenlink im unteren Bereich des Abschnitts.

      username: kubeadmin
password: <password retrieved from command above>

      Anmerkung: Wenn sich die OpenShift-Konsole trotz erfolgreicher Implementierung nicht im Browser öffnet, stellen Sie sicher, dass eine der folgenden Aktivitäten abgeschlossen ist.

      • Die DNS-Platzhaltereinträge wurden entweder vor oder nach der Implementierung hinzugefügt.
      • Die /etc/hosts-Einträge sind auf dem System mit dem Web-Browser vorhanden.

      Die Beispielausgabe im Implementierungsverlauf enthält weitere Anweisungen für die exakten Zeilen, die im DNS oder /etc/hosts hinzugefügt werden sollen. Beispiel:

      OpenShift-Webkonsole:

      https://console-openshift-console.apps.cps-rack-79-vm-83.rtp.raleigh.ibm.com

      Setzen Sie den folgenden Befehl ab, um das kubeadmin-Kennwort für den OpenShift-Cluster abzurufen:

      ssh virtuser@9.9.9.9 echo "kubeadmin password is: \$(cat /kubeadmin-password)"

      Fügen Sie dem DNS-Server die folgenden Platzhaltereinträge hinzu, um auf die OpenShift-Webkonsole, -Apps und -APIs zuzugreifen:

      *.cps-rack-79-vm-83.rtp.raleigh.ibm.com IN A 9.9.9.9 
*.apps.cps-rack-79-vm-83.rtp.raleigh.ibm.com IN A 9.9.9.9

      Fügen Sie zu Testzwecken den folgenden Eintrag /etc/hosts hinzu, um auf die OpenShift-Webkonsole zuzugreifen:

      9.9.9.9 console-openshift-console.apps.cps-rack-79-vm-83.rtp.raleigh.ibm.com oauth-openshift.apps.cps-rack-79-vm-83.rtp.raleigh.ibm.com

  8. Wenn Sie keine Verbindung zum OpenShift-Cluster haben, denken Sie daran, Ihren OpenShift-Cluster mit Red Hat zu registrieren. Dieser manuelle Schritt ist erforderlich, wenn Ihr OpenShift-Cluster keine Internetverbindung hat, um Red Hat zu erreichen. Informationen zur Registrierung Ihres Clusters auf der Seite "Clusterregistrierung" finden Sie unter Installation in einer vom Benutzer bereitgestellten Infrastruktur abschließen Symbol für externen Link.

  9. Um ein Upgrade für einen OpenShift Container Platform -Cluster durchzuführen, müssen Sie sicherstellen, dass die Images der neuen Version in Ihrer Docker Private Registry gespiegelt werden. Der Einsatz eines OpenShift Container Platform Clusters auf IBM Cloud Pak System ist ein disconnected cluster. Weitere Informationen zum Upgrade finden Sie unter Cluster innerhalb einer Nebenversion über die Befehlszeilenschnittstelle aktualisieren Symbol für externen Link.

    Die folgende Nachricht enthält die Schritte aus dem genannten Link.

    "Disconnected clusters 
Customers which have chosen to not be connected to Red Hat and are curating their own OpenShift Container Platform container 
image content manually should consult the Red Hat errata associated with product releases and note any comments impacting upgrades. 
During upgrade the user interface may caution about switching between these versions and it is up to the customer to ensure they 
have correctly selected the appropriate version before bypassing those cautions."

    Verwenden Sie bei einem Upgrade eines Clusters von Version 4.2.18 auf Version 4.3.1 die Datei release.txt aus Red Hat unter 4.3.1.

    https://mirror.openshift.com/pub/openshift-v4/clients/ocp/4.2.19/release.txt

    Suchen Sie den mit "Digest" gekennzeichneten Wert:

    Digest:

    sha256:b51a0c316bb0c11686e6b038ec7c9f7ff96763f47a53c3443ac82e8c054bc035

    Stellen Sie sicher, dass die Images in Ihre private Docker-Registry gespiegelt werden, die von IBM Cloud Pak System und OpenShift Container Platform cluster verwendet wird. Weitere Informationen oder Hilfe finden Sie unter Spiegelregistry für die Installation in einem eingeschränkten Netz erstellen Symbol für externen Link.

    Melden Sie sich am primären Helperknoten an und führen Sie den Upgradebefehl über die Befehlszeile aus, der auf Ihre private Docker-Registry und das Image aus dem neuen OpenShift Container Platform -Release verweist.

    -bash-4.2# oc adm upgrade --to-image=ipas-pvm-144-004.cps.raleigh.ibm.com:443/ocp4/
openshift4@sha256:b51a0c316bb0c11686e6b038ec7c9f7ff96763f47a53c3443ac82e8c054bc035 
--allow-explicit-upgrade --force=true
Updating to release image ipas-pvm-144-004.cps.raleigh.ibm.com:443/ocp4/
openshift4@sha256:b51a0c316bb0c11686e6b038ec7c9f7ff96763f47a53c3443ac82e8c054bc035

    Wenn Sie den Fortschritt des Upgrades anzeigen möchten, rufen Sie die Seite Verwaltung > Clustereinstellungen > Clusteroperatoren auf.

    Hinweis: Wenn der Clusteroperator "openshift-samples" aufgrund einer Unterbrechung der Internetkonnektivität während des Installationsvorgangs eingeschränkt wird, führen Sie die folgenden Schritte aus:

    1. Wechseln Sie zu Home > Suchen > "config" > samples.operator.openshift.io.
    2. Bearbeiten Sie die YAML-Datei und wechseln Sie zu managementState: Removed.
    3. Speichern Sie die Datei.

    Weitere Informationen zu den Schritten finden Sie in Schritt 5 des Abschnitts Beispieloperatorimagestreams mit alternativen oder gespiegelten Registrys verwenden Symbol für externen Link.

    Ein Upgrade für OpenShift Container Platform kann ungefähr eine Stunde dauern.