Cluster mit Assisted Installer installieren

Installieren Sie mit dem unterstützten Installationsprogramm von Red Hat ein OpenShift Container Platform-Cluster auf OCI.

Bevor Sie beginnen, sollten Sie den Abschnitt Voraussetzungen dieser Dokumentation lesen. Der Workflow für Assisted Installer umfasst drei Hauptschritte:
  1. Das Discovery-ISO-Image (Red Hat Console) wird generiert.
  2. Provisioning der Clusterinfrastruktur (OCI-Konsole).
  3. Installation abschließen (Red Hat Console).

Teil 1: Discovery-ISO-Datei generieren (Red Hat-Konsole)

Die Compute Nodes für das Cluster erfordern ein vorkonfiguriertes Discovery-ISO-Image, um Hardware- und Netzwerkkonfigurationen während der Clusterbereitstellung zu validieren. Befolgen Sie die Schritte unter Mit dem unterstützten Installationsprogramm ein OCI-kompatibles Discovery-ISO-Image generieren (Red Hat-Dokumentation), um das Discovery-ISO mit der Red Hat Hybrid Cloud-Konsole zu generieren und herunterzuladen. Kehren Sie dann zu dieser Anleitung für Teil 2: Provisioning-Infrastruktur (OCI-Konsole) zurück.

Teil 2: Provisioning-Infrastruktur (OCI-Konsole)

Laden Sie das Discovery-ISO hoch, und richten Sie die Infrastruktur mit dem Red Hat-Plug-in OpenShift und Resource Manager in der OCI-Konsole ein.

In den Aufgaben in diesem Abschnitt laden Sie in der OCI-Konsole das Discovery-ISO-Image hoch und stellen die Clusterinfrastrukturressourcen bereit, wie unter Konfigurationsdateien beschrieben. Eine Liste der Ressourcen, die vom Terraform-Skript für diese Installationsmethode erstellt wurden, finden Sie unter Definierte Terraform-Ressourcen für OpenShift. Beachten Sie, dass Sie ein vorhandenes Compartment und einen Objektspeicher-Bucket für das Cluster angeben. Informationen zum Erstellen dieser Ressourcen finden Sie unter Compartment erstellen und Object Storage-Bucket erstellen.

Red Hat-ISO-Image in Object Storage hochladen

  1. Erstellen Sie in der OCI-Konsole einen Object Storage-Bucket, und laden Sie das Discovery-ISO in den Bucket hoch.
  2. Suchen Sie das hochgeladene Discovery-ISO, und führen Sie die folgenden Schritte aus:
    1. Erstellen Sie eine vorab authentifizierte Anforderung für das ISO in Object Storage.
    2. Kopieren Sie die generierte URL, die im nächsten Schritt als OpenShift-Bildquellen-URI verwendet werden soll. Weitere Informationen finden Sie unter Im Voraus authentifizierte Anforderungen für Object Storage.

OpenShift Container Platform Infrastructure erstellen

Führen Sie die Schritte aus, um die erforderliche Infrastruktur für das Cluster OpenShift einzurichten.
Hinweis

  • Führen Sie den create-resource-attribution-tags-Stack aus, bevor Sie den create-cluster-Stack ausführen, um Installationsfehler zu vermeiden.
  • Der Stack create-resource-attribution-tags muss nur einmal ausgeführt werden. Wenn der Tag-Namespace und die definierten Tags bereits vorhanden sind, können Sie diesen Schritt für zukünftige Installationen überspringen.
  1. Öffnen Sie das Navigationsmenü , und wählen Sie Entwicklerservices aus. Wählen Sie dann Red Hat OpenShift aus.
  2. Geben Sie auf der Seite Stackinformationen einen optionalen Namen und eine optionale Beschreibung ein.
    • Die neueste Version des Terraform-Stacks wird automatisch für Sie hochgeladen.
    • Die Felder Erstellen in Compartment und Terraform-Version werden vorab aufgefüllt.
  3. (Optional) Fügen Sie im Abschnitt Tags Tags hinzu, um die Ressourcen zu organisieren.
    1. Wählen Sie in der Dropdown-Liste Tag-Namespace einen relevanten Tag-Namespace aus.
    2. Geben Sie im Feld Tagschlüssel einen Tagschlüssel an.
    3. Geben Sie im Feld Tagwert einen Wert für das Tag ein.
    4. Wählen Sie Tag hinzufügen aus.
  4. Wählen Sie Weiter.
  5. Prüfen und konfigurieren Sie auf der Seite Variablen konfigurieren die erforderlichen Variablen für die Infrastrukturressourcen, die der Stack erstellt, wenn Sie den Job Anwenden für diesen Ausführungsplan ausführen.
  6. Prüfen und konfigurieren Sie im Abschnitt OpenShift Clusterkonfiguration die folgenden Felder:

    OpenShift-Clusterkonfiguration

    Feld Beschreibung
    Mandanten-OCID

    Die OCID des aktuellen Mandanten.

    Standardwert: Aktueller Mandant

    Compartment

    Die OCID des Compartments, in dem Sie das OpenShift-Cluster erstellen möchten.

    Standardwert: Aktuelles Compartment

    Clustername

    Der Clustername OpenShift.

    Hinweis: Verwenden Sie denselben Wert für den Clusternamen, den Sie in der Red Hat Hybrid Cloud-Konsole angegeben haben, und stellen Sie sicher, dass er DNS-kompatibel ist.

    Installationsart

    Die Installationsmethode, die Sie für die Installation des Clusters verwenden möchten.

    Standardwert: Assisted Installer

    Image OpenShift und Instanzen erstellen

    Aktiviert die Erstellung von OpenShift-Image und -Instanzen.

    Standardwert: True

    OpenShift Bildquellen-URI

    Die im Voraus authentifizierte Anforderungs-URL, die in der vorherigen Aufgabe Red Hat ISO-Image in Object Storage hochladen erstellt wurde.

    Hinweis: Dieses Feld wird nur angezeigt, wenn das Kontrollkästchen OpenShift-Image und -Instanzen erstellen aktiviert ist.

  7. Prüfen und konfigurieren Sie im Abschnitt OpenShift Resource Attribution Tags das folgende Feld:

    OpenShift Ressourcenattribut-Tags
    Feld Beschreibung
    Tag-Namespace-Compartment für OpenShift-Ressourcenattribut-Tags

    Das Tag-Namespace-Compartment für Attributionstags der Ressource OpenShift.

    Hinweis: Stellen Sie sicher, dass das angegebene Tag vorhanden ist, bevor Sie den Terraform-Stack anwenden. Das Compartment, in dem der Tag-Namespace für das Ressourcentagging erstellt wird, ist standardmäßig das aktuelle Compartment. Bei der OpenShift-Attribution für OCI-Ressourcen werden der Tag-Namespace und die definierten Tags auf openshift-tags und openshift-resource gesetzt. Wenn der Namespace "openhift-tags" bereits vorhanden ist, stellen Sie sicher, dass er korrekt definiert und angewendet ist. Beispiel: defined-tags" - {"openshift-tags"- {"openshift-resource" - "openshift-resource-infra"} }

  8. Prüfen und konfigurieren Sie im Abschnitt Konfiguration der Control-Plane-Knoten die folgenden Felder:

    Konfiguration von Control-Plane-Knoten

    Hinweis: Dieser Abschnitt ist nur sichtbar, wenn das Kontrollkästchen OpenShift Bildquellen-URI aktiviert ist.

    Feld Beschreibung
    Control-Plane-Ausprägung

    Die Compute-Instanzausprägung der Control-Plane-Knoten. Weitere Informationen finden Sie unter Compute-Ausprägungen.

    Standardwert: VM.Standard.E5. FlexFeld

    Anzahl Control-Plane-Knoten

    Die Anzahl der Control-Plane-Knoten im Cluster.

    Standardwert: 3

    Control-Plane-Knoten-OCPU

    Die Anzahl der verfügbaren OCPUs für jede Control-Plane-Knotenausprägung.

    Standardwert: 4

    Control-Plane-Knotenspeicher

    Der verfügbare Arbeitsspeicher in Gigabyte (GB) für jede Control-Plane-Knotenausprägung.

    Standardwert: 24

    Boot-Volume für Control-Plane-Knoten

    Die Boot-Volume-Größe (GB) der einzelnen Control-Plane-Knoten.

    Standardwert: 1024

    Control-Plane-Knoten VPU

    Die Anzahl der auf das Volume angewendeten Volume Performance Units (VPUs) pro 1 GB für jeden Control-Plane-Knoten.

    Standardwert: 100

    Control-Plane-Instanzen über ADs verteilen

    Ermöglicht die automatische Verteilung von Control-Plane-Instanzen über Availability-Domains (ADs) in einer Round-Robin-Sequenz, beginnend mit der ausgewählten AD. Wenn diese Option deaktiviert ist, werden alle Knoten in der ausgewählten Start-AD erstellt.

    Standardwert: True

    (Optional) AD starten

    Availability-Domain (AD) für die anfängliche Knotenplatzierung. Zusätzliche Knoten werden automatisch in einer Round-Robin-Sequenz über ADs verteilt, beginnend mit der gewählten AD.

    Control-Plane-Instanzen über Geschäftsbereiche verteilen

    Verteilt Control-Plane-Instanzen über Faultdomains in einer Round-Robin-Sequenz. Wenn diese Option nicht ausgewählt ist, verteilt der OCI Compute-Service sie basierend auf der Ausprägungsverfügbarkeit und anderen Kriterien.

    Standardwert: True

  9. Prüfen und konfigurieren Sie im Abschnitt Compute-Knotenkonfiguration die folgenden Felder:

    Compute Node-Konfiguration

    Hinweis: Dieser Abschnitt ist nur sichtbar, wenn das Kontrollkästchen OpenShift Bildquellen-URI aktiviert ist.

    Feld Beschreibung
    Compute-Ausprägung

    Die Instanzausprägung der Compute Nodes. Weitere Informationen finden Sie unter Compute-Ausprägungen.

    Standardwert: VM.Standard.E5. FlexFeld

    Anzahl Computing-Knoten

    Die Anzahl der Compute Nodes im Cluster.

    Standardwert: 3

    Compute Node-OCPU

    Die Anzahl der für jede Compute Node-Ausprägung verfügbaren OCPUs.

    Standardwert: 6

    Compute Node-Speicher

    Der verfügbare Arbeitsspeicher in Gigabyte (GB) für jede Control-Plane-Knotenausprägung.

    Standardwert: 16

    Boot-Volume von Compute Node

    Die Boot-Volume-Größe (GB) jedes Control Plane-Knotens.

    Standardwert: 100

    Compute Node-VPU

    Die Anzahl der Volume Performance Units (VPUs), die auf das Volume pro 1 GB pro Compute Node angewendet werden.

    Standardwert: 30

    Compute-Instanzen über ADs verteilen

    Ermöglicht die automatische Verteilung von Compute-Instanzen über Availability-Domains (ADs) in einer Round-Robin-Sequenz, beginnend mit der ausgewählten AD. Wenn diese Option deaktiviert ist, werden alle Knoten in der ausgewählten Start-AD erstellt.

    Standardwert: True

    (Optional) AD starten

    Availability-Domain (AD) für die anfängliche Knotenplatzierung. Zusätzliche Knoten werden automatisch in einer Round-Robin-Sequenz über ADs verteilt, beginnend mit der gewählten AD.

    Compute-Instanzen über Geschäftsbereiche verteilen

    Verteilt Compute-Instanzen über Faultdomains in einer Round-Robin-Sequenz. Wenn diese Option nicht ausgewählt ist, verteilt der OCI Compute-Service sie basierend auf der Ausprägungsverfügbarkeit und anderen Kriterien.

    Standardwert: True

  10. Prüfen und konfigurieren Sie im Abschnitt Netzwerkkonfiguration die folgenden Felder:

    Netzwerkkonfiguration
    Feld Beschreibung
    Öffentliches DNS erstellen

    Erstellen Sie eine öffentliche DNS-Zone basierend auf der Basisdomain, die im Feld "Zonen-DNS" angegeben ist.

    Hinweis: Wenn Sie kein öffentliches DNS erstellen möchten, erstellen Sie eine private DNS-Zone, es sei denn, Sie verwenden Ihre eigene DNS-Lösung. Um Clusterhostnamen ohne DNS aufzulösen, fügen Sie Einträge zu /etc/hosts hinzu, die Clusterhostnamen mit der etc_hosts_entry -Ausgabe der IP-Adresse des api_apps Load Balancers zuordnen.

    Standardwert: True

    Privates DNS erstellen

    Erstellt eine private DNS-Zone basierend auf der Basisdomain, die im Feld "Zonen-DNS" angegeben ist, um die Auflösung von Hostnamen innerhalb des VCN zu unterstützen.

    Hinweis: Die private DNS-Zone enthält dieselben Datensätze wie die öffentliche DNS-Zone. Wenn Sie eine nicht registrierte Basisdomain verwenden, wird empfohlen, eine private DNS-Zone zu erstellen. Andernfalls benötigen Sie möglicherweise alternative Methoden zum Auflösen von Clusterhostnamen. Weitere Informationen finden Sie unter Private DNS.

    Öffentlichen API-Load Balancer aktivieren

    Erstellt einen Load Balancer für den API-Endpunkt OpenShift im öffentlichen Subnetz mit einer öffentlichen IP-Adresse für den externen Zugriff.

    Hinweis: Wenn diese Option deaktiviert ist, wird der Load Balancer in einem privaten Subnetz mit eingeschränktem Zugriff innerhalb des VCN oder verbundener privater Netzwerke erstellt. In On-Premise-Umgebungen (z.B. C3/PCA) können öffentliche IPs intern sein (RFC 1918). Der öffentliche Zugriff ist für Remoteverwaltung, Automatisierung und CI/CD hilfreich. Wenden Sie sich bei Bedarf an Ihren Netzwerkadministrator.

    Load Balancer für öffentliche Apps aktivieren

    Erstellt einen Load Balancer für OpenShift-Anwendungen im öffentlichen Subnetz mit einer öffentlichen IP-Adresse für den externen Zugriff auf Workloads.

    Hinweis: Wenn diese Option nicht ausgewählt ist, wird der Load Balancer in einem privaten Subnetz erstellt. Dadurch wird der Zugriff auf das VCN oder über ein VPN/privates Netzwerk eingeschränkt. Der öffentliche Zugriff ist nützlich für internetbasierte Apps, Kundenservices oder mehrmandantenfähige Workloads. Bei On-Premise-Setups (z.B. C3/PCA) können öffentliche IPs intern sein (RFC 1918). Wenden Sie sich an Ihr Netzwerkteam, um eine angemessene Belichtung sicherzustellen.

    Standardwert: True

    Zonen-DNS

    Die Basisdomain für die DNS-Datensätze Ihres Clusters (z.B. devcluster.openshift.com), mit der öffentliche oder private (oder beide) DNS-Zonen erstellt werden. Dieser Wert muss mit dem Wert der Basisdomain übereinstimmen, der bei der Erstellung des ISO-Abbilds in der Red Hat Hybrid Cloud-Konsole eingegeben wurde.

    VCN-DNS-Label

    Ein DNS-Label für das VCN, das mithilfe des Hostnamens der VNIC und des DNS-Labels des Subnetzes zur Bildung eines vollqualifizierten Domainnamens (FQDN) für jede VNIC in diesem Subnetz verwendet wird. (Beispiel: bminstance1.subnet123.vcn1.oraclevcn.com).

    Standardwert: openshiftvcn

    VCN-CIDR

    Die IPv4 CIDR-Blöcke für das VCN des OpenShift-Clusters.

    Standardwert: 10.0.0.0/16

    Öffentliches Subnetz-CIDR

    Die IPv4 CIDR-Blöcke für das öffentliche Subnetz des OpenShift-Clusters.

    Standardwert: 10.0.0.0/20

    Privates Subnetz-CIDR für OCP

    Die IPv4 CIDR-Blöcke für das private Subnetz des OpenShift-Clusters.

    Standardwert: 10.0.16.0/20

    Reserviertes privates Subnetz-CIDR für Bare Metal

    Die IPv4 CIDR-Blöcke für das private Subnetz von OpenShift-Bare-Metal-Clustern.

    Standardwert: 10.0.32.0/20

    Maximale Bandbreite für Load Balancer

    Bandbreite (Mbps), die über die maximale Bandbreite (Ingress plus Egress) entscheidet, die der Load Balancer erreichen kann. Die Werte müssen zwischen minimumBandwidthInMbps und 8000 liegen.

    Standardwert: 500

    Mindestbandbreite für Load Balancer

    Bandbreite (Mbps), welche die gesamte vorab bereitgestellte Bandbreite (Ingress plus Egress) bestimmt. Die Werte müssen zwischen 10 und maximumBandwidthInMbps liegen

    Standardwert: 10

  11. (Optional) Prüfen und konfigurieren Sie im Abschnitt Erweiterte Konfigurationen die folgenden Felder:

    Erweiterte Konfigurationen
    Feld Beschreibung
    OCI CCM- und CSI-Treiberversion

    Die bereitzustellende OCI-CCM- und CSI-Treiberversion. Weitere Informationen finden Sie in der Liste der Treiberversionen und in der Datei STORAGE.MD auf GitHub.

    Standardwert: v1.32.0

    Vorhandene Instanzrollentags verwenden

    Gibt an, ob der vorhandene Instanzrollen-Tag-Namespace und definierte Tags beim Tagging von OCI-Ressourcen wiederverwendet werden sollen. Standardmäßig wird eine neue Gruppe von Instanzrollen-Tagging-Ressourcen mit den restlichen Clusterressourcen erstellt und gelöscht.

    Erstellen Sie bei Bedarf Instanzrollen-Tagressourcen separat, die mit dem Terraform-Stack auf der Seite create-instance-role-tags im Repository oci-openshift GitHub wiederverwendet werden können. Die vorhandenen Taggingressourcen für Instanzrollen werden nicht gelöscht, wenn das Cluster gelöscht wird.

    (Optional) Namespace-Name für Instanzrollentag

    Der Name des Tag-Namespace der Instanzrolle, der wieder verwendet werden soll.

    Hinweis: Dieses Feld wird nur angezeigt, wenn das Kontrollkästchen Vorhandene Instanzrollentags verwenden aktiviert ist.

    Standardwert: openshift-{cluster_name}

    Instanzrollen-Tag-Namespace-Compartment-OCID

    Das Compartment mit dem vorhandenen Tag-Namespace der Instanzrolle.

    Hinweis: Dieses Feld wird nur angezeigt, wenn das Kontrollkästchen Vorhandene Instanzrollentags verwenden aktiviert ist.

    Standardwert: Aktuelles Compartment

  12. Wählen Sie Weiter.
  13. Prüfen Sie auf der Seite Prüfen die Stackinformationen und Variablen.
  14. Wählen Sie Erstellen aus, um den Stack zu erstellen. Die Konsole leitet zur Detailseite des Resource Manager-Stacks für den neuen Stack um.
  15. Wählen Sie auf der Seite mit den Stackdetails die Option Anwenden aus, um einen Apply-Job zu erstellen und die Infrastruktur für das Cluster bereitzustellen. Nachdem Sie einen Apply-Job ausgeführt haben, rufen Sie die Jobdetails ab, um den Status zu prüfen. Erfolgreich (SUCCEEDED) gibt an, dass der Job abgeschlossen wurde.
    Weitere Schritte Nachdem Sie den Apply-Job für den Stack ausgeführt haben, bleiben Sie im Abschnitt "Resource Manager" der OCI-Konsole, und führen Sie die Schritte unter Benutzerdefinierte Manifeste für die Installation abrufen aus.

Benutzerdefinierte Manifeste für die Installation abrufen

Rufen Sie nach dem Provisioning der Infrastruktur im Resource Manager aus den "Ausgaben" des Stackjobs die Datei dynamic_custom_manifest ab. Diese Ausgabe enthält alle erforderlichen Manifeste, verkettet und vorformatiert mit den Konfigurationswerten für CCM und CSI.

  1. Wählen Sie auf der Seite Stacks in Resource Manager den Namen des Stacks aus, um die zugehörigen Details anzuzeigen. Wenn die Listenansicht der Jobs nicht angezeigt wird, wählen Sie im Abschnitt Ressourcen die Option Jobs aus, um die Jobliste anzuzeigen.
  2. Wählen Sie den Job für die Stackerstellung aus. Die Seite Jobdetails wird in der Konsole angezeigt.
  3. Wählen Sie im Abschnitt Ressourcen die Option Ausgaben, um die Liste der Ausgaben für den Job anzuzeigen.
  4. Wählen Sie für die Ausgabe dynamic_custom_manifest die Option show aus, um die Inhalte der Ausgabe anzuzeigen.
  5. Wählen Sie Kopieren aus, um den Inhalt der Ausgabe zu kopieren. Hinweis: Es wird empfohlen, den Text nicht manuell auszuwählen und zu kopieren, da dies zu Einrückungsproblemen führen kann, wenn Sie diese Ausgabe im folgenden Schritt einfügen.
  6. Speichern Sie die kopierte Ausgabe mit einem Text- oder Codeeditor in einer neuen manifest.yaml-Datei. Laden Sie diese Datei im Schritt Benutzerdefiniertes Manifest des Installationsprozesses hoch, der unter Teil 3: Cluster installieren (Red Hat-Konsole) beschrieben wird.

Teil 3: Cluster installieren (Red Hat Console)

Kehren Sie zur Red Hat Hybrid Cloud-Konsole zurück, um die Clustererstellung mit dem Assisted Installer abzuschließen. Befolgen Sie die Schritte unter Verbleibende Schritte für das unterstützte Installationsprogramm abschließen (Red Hat-Dokumentation). Dazu gehören:

  • Rollen der Control Plane und den Compute-Instanzen zuweisen, die in OCI ausgeführt werden.
  • Prüfen der Einstellungen für Clusterspeicher und Networking.
  • Die Datei manifest.yaml, die Sie in Teil 2: Provisioning-Infrastruktur (OCI-Konsole) im Abschnitt Benutzerdefiniertes Manifest erstellt haben, wird hochgeladen.
  • Clusterinstallation wird gestartet.

Auf Clusterkonsole zugreifen

Nachdem die Installation abgeschlossen ist, wählen Sie OpenShift-Konsole starten in der Red Hat Hybrid Cloud-Konsole aus. Dadurch wird die Managementkonsole für das neue Cluster geöffnet. Die Webkonsolen-URL für die Clusterkonsole wird auf der Seite Installationsfortschritt angezeigt und kann in einem Browser als Lesezeichen gesetzt werden. Laden Sie in der Clustermanagementkonsole die Datei kubeconfig herunter, mit der Sie mit der CLI (oc) OpenShift oder der Kubernetes-CLI (kubectl) auf das Cluster zugreifen.