Satellite-Cluster über die Konsole erstellen

Verwenden Sie die IBM Cloud-Konsole, um Ihre Red Hat OpenShift-Cluster auf Ihrer Satellite-Infrastruktur zu erstellen.

Klicken Sie in der Konsole auf "Erstellen ". Sehen Sie sich anschließend die folgenden Abschnitte an, um Ihren Cluster einzurichten.

Infrastruktur

Wählen Sie Satellite aus.

Standort

Wählen Sie die Ressourcengruppe und die Position vonSatellite aus, an der Sie den Cluster erstellen wollen.

Wenn Sie an RHCOS-fähigen Standorten Worker-Pools zu Ihrem Cluster hinzufügen wollen, können Sie RHCOS oder RHEL-Hosts verwenden. Stellen Sie sicher, dass Sie Hosts mit dem Betriebssystem verbinden, das Sie Ihrem Standort zuordnen möchten, bevor Sie sie einem Worker-Pool zuordnen.

Infrastrukturtopologie

• Hoch verfügbar: Wählen Sie diese Option für die meisten Anwendungsfälle aus. Erstellen Sie mindestens 3 Workerknoten für Hochverfügbarkeit.

• Einzelreplikat: Einzelknotencluster werden nur unter bestimmten Umständen empfohlen und dürfen nur an Edge-Positionen mit Ressourcenengpass verwendet werden, an denen mehrere redundante Standorte dieselbe Workload ausführen. Wenn Sie Ihren Red Hat OpenShift on IBM Cloud-Cluster in der Infrastruktur von Satellite an einem fernen, ressourcenbeschränkten Edge-Standort mit begrenzten Ressourcen (z. B. ein kleines Rechenzentrum in einem mobilen Tower) ausführen, kann die Ausführung einer Datenebene mit einem kleineren Fußdruck für Ihre Konfiguration von Vorteil sein. Während für typische Red Hat OpenShift on IBM Cloud-Cluster mindestens drei Workerknoten für Hochverfügbarkeit erforderlich sind, können Sie einen Cluster erstellen, der einen einzelnen Workerknoten ausführt. Einzelknotencluster haben mehrere Einschränkungen und sollten nur unter bestimmten Umständen verwendet werden. Einzelknotencluster verfügen nicht über hohe Verfügbarkeit. Durch die Bereitstellung eines Einzelknotenclusters akzeptieren Sie, dass es wahrscheinlicher ist, dass Ausfallzeiten und Unterbrechungen in Ihrer Workload auftreten. Einzelknotencluster müssen an einer Satellite-Position mit aktiviertem CoreOS ausgeführt werden. Die Steuerebenenhosts an Ihrem Standort und der Host, den Sie Ihrem Einzelknotencluster zuordnen, müssen entweder das Betriebssystem RHEL 8 oder RHCOS ausführen. Wird nur für Satellite-Cluster unterstützt, auf denen Version 4.11 oder höher ausgeführt wird. Weitere Informationen finden Sie im Abschnitt Einschränkungen.

Standard-Worker-Pool

Konfigurieren Sie die Details für Ihren Standardworker-Pool.

• Host-Betriebssystem: Wählen Sie das Betriebssystem der Hosts aus, die Sie im Standard-Worker-Pool Ihres Clusters verwenden möchten. An Red Hat CoreOS-aktivierten Positionen können Sie entweder Ihre RHCOS- oder RHEL-Hosts verwenden.

• Worker-Pool-Zonen, die von Satellite verwendet werden, um Hosts gleichmäßig auf Zonen zu verteilen, die den Zonen Ihres zugrunde liegenden Infrastrukturanbieters entsprechen. Im Allgemeinen erstellen Sie Ihren Worker-Pool über 3 Zonen für hohe Verfügbarkeit.

• vCPU, Arbeitsspeicher (GB) und Anzahl der Worker-Knoten pro Zone: Geben Sie die Ressourcen an, mit denen Sie den Worker-Pool erstellen möchten. Satellite kann dem Worker-Pool automatisch verfügbare Hosts zuweisen, um Ihre Anfrage zu erfüllen. Wählen Sie in der Regel mindestens einen Worker-Knoten pro Zone für insgesamt 3 Workerknoten in Ihrem Cluster aus.

OpenShift-Version

Wählen Sie Ihre Clusterversion aus. Wählen Sie die Standardversion aus oder geben Sie eine andere unterstützte Version an.

Lizenz für OpenShift Container Platform (OCP)

Auf allen Benutzerclustern an Ihrem Satellite-Standort ist OpenShift Container Platform installiert, wofür eine Lizenzgebühr von Red Hat anfällt. Sie können jedoch Ihre eigene OpenShift Container Platform-Lizenz für Cluster mitbringen, die mit Ihrer lokalen Infrastruktur erstellt wurden, oder für Cluster, die lokal mithilfe von IBM Cloud Paks erstellt wurden. Service-Cluster, die die zugrunde liegende Plattform für alle IBM Cloud-Services sind, werden von Services wie Key Protect oder IBM Cloud Object Storage erstellt und benötigen keine Lizenz.

• Berechtigung für Cloud Pak anwenden: Aktivieren Sie diese Option, um Ihre Cloud Pak-Berechtigung auf den Standard-Worker-Pool anzuwenden. Cloud Pak-Berechtigungen werden auf Worker-Pool-Ebene angewendet. Überschreiten Sie Ihre Berechtigung nicht. Beachten Sie, dass Ihre OpenShift Container Platform-Berechtigungen zusammen mit anderen Cloud-Providern oder in anderen Umgebungen verwendet werden können. Um spätere Abrechnungsprobleme zu vermeiden, achten Sie darauf, nur das zu verwenden, wofür Sie berechtigt sind. Beispiel: Sie haben eine Berechtigung für die OCP-Lizenzen für zwei Workerknoten von 4 CPU und 16 GB Speicher und Sie erstellen diesen Worker-Pool mit zwei Workerknoten von 4 CPU und 16 GB Speicher. Sie haben Ihre gesamte Berechtigung verwendet und Sie können nicht dieselbe Berechtigung für andere Workerpools, Cloud-Provider oder Umgebungen verwenden.

• Lizenz erwerben: Kaufen Sie eine neue Lizenz für OpenShift Container Platform für den Standardworker-Pool. Diese Option wird auf Worker-Pool-Ebene angewendet. Wenn Sie zusätzliche Worker-Pools erstellen, müssen Sie zusätzliche Lizenzen erwerben.

• Mit Red Hat OpenShift Cluster Manager verwalten: Geben Sie eine vorhandene OCP-Berechtigung für die Workerknoten in diesem Cluster an, indem Sie Ihren Red Hat®-Account-Pull-Secret als Datei oder im unformatierten JSON-Format angeben. Der Cluster verwendet diesen geheimen Pull-Schlüssel auch, um Red Hat OpenShift-Images von Ihrem eigenen Red Hat-Konto herunterzuladen. Diese Option wird auf Clusterebene angewendet.

Satellite-Konfiguration

Entscheiden Sie, ob der Clusteradministratorzugriff für die Konfiguration Satellite aktiviert werden soll. Wenn Sie keinen Satellite Config-Zugriff erteilen, können Sie die Satellite Config-Funktion später nicht verwenden, um Kubernetes-Ressourcen für Ihre Cluster anzuzeigen oder bereitzustellen. Wenn Sie den Zugriff zu einem späteren Zeitpunkt aktivieren möchten, können Sie angepasste RBAC-Rollen für Satellite Config erstellen.

Verschlüsselung

Aktivieren Sie die Datenverschlüsselung mit einem Key Management Service (KMS), um geheime Schlüssel und andere sensible Informationen in Ihrem Cluster zu verschlüsseln. Sie können KMS auch später aktivieren.

Verwaltung geheimer Ingress-Schlüssel

IBM Cloud Secrets Manager verwaltet Ingress-Unterdomänenzertifikate und andere geheime Schlüssel in Ihrem Cluster zentral. Während des Clustererstellungsprozesses können Sie eine Secrets Manager-Instanz in Ihrem Cluster registrieren. Sie können auch eine Gruppe geheimer Schlüssel angeben, mit deren Hilfe Sie den Zugriff auf die geheimen Schlüssel in Ihrem Cluster steuern können. Beide Optionen können nach der Erstellung des Clusters konfiguriert oder geändert werden.

Clusterdetails

Benennen Sie Ihren Cluster und geben Sie alle IBM Cloud-Tags ein, die Sie Ihrer Cloudressource zuordnen möchten. Der Clustername muss mit einem Buchstaben beginnen, darf Buchstaben, Ziffern und den Bindestrich (-) enthalten und darf maximal 35 Zeichen lang sein.

Wenn an Ihrem Satellite-Standort keine verfügbaren und übereinstimmenden Hosts vorhanden sind, wird der Cluster trotzdem erstellt, wechselt aber in den Status Warnung. Ordnen Sie Hosts Ihrem Satellite-Standort zu, damit Hosts als Workerknoten dem Worker-Pool zugewiesen werden können. Wenn die Hosts nicht automatisch zugewiesen werden, können Sie Satellite-Hosts auch manuell zu Ihrem Cluster zuweisen. Stellen Sie sicher, dass Hosts als Workerknoten in jeder Zone Ihres Standard-Worker-Pools zugewiesen sind.

Wenn Ihre Standorthosts nur über private Netzkonnektivität verfügen oder wenn Sie Amazon Web Services-, Google Cloud Platform- oder Microsoft Azure-Hosts verwenden, müssen Sie mit dem privaten Netz Ihres Hosts verbunden sein (z. B. über den VPN-Zugriff), um eine Verbindung zu Ihrem Cluster herzustellen und auf die Red Hat OpenShift-Webkonsole zuzugreifen. Wenn Ihre Hosts über öffentliche Netzkonnektivität verfügen, können Sie alternativ den Zugriff auf Ihren Cluster testen, indem Sie die DNS-Datensätze Ihres Clusters und des Standorts ändern, um öffentliche IP-Adressen der Hosts zu verwenden.

Warten Sie, bis Ihr Cluster den Status Normal erreicht, greifen Sie auf Ihren Cluster zu, um auf die Webkonsole von Red Hat OpenShift zuzugreifen oder um oc-und kubectl-Befehle über die Befehlszeilenschnittstelle auszuführen. Wenn Sie den Satellite Config-Zugriff aktiviert haben, müssen Sie diesen Schritt ausführen, um die Berechtigungen zu synchronisieren.

Satellite-Cluster über die Befehlszeilenschnittstelle erstellen

Verwenden Sie die Satellite-Befehlszeilenschnittstelle, um Ihre Red Hat OpenShift-Cluster auf Ihrer Satellite-Infrastruktur zu erstellen.

Bevor Sie beginnen, müssen Sie zunächst das Plug-in für die Satellite-CLI installieren.

1. Führen Sie die vorausgesetzten Schritte aus.

2. Stellen Sie sicher, dass Ihr Standort den Status Normal aufweist. Der Standort hat den Status Normal, wenn Sie die Satellite-Steuerebene erfolgreich erstellt haben und alle für die Steuerebene verwendeten Hosts einen einwandfreien Zustand aufweisen.

   ibmcloud sat location ls
   

   Beispielausgabe

   Retrieving locations...
   OK
   Name         ID                     Status            Ready   Created      Hosts (used/total)   Managed From   
   mylocation   brhtfum2015a6mgqj16g   normal            yes     4 days ago   3 / 6                Dallas   
   

3. Erstellen Sie einen Red Hat OpenShift-Cluster an Ihrem Satellite-Standort. Wenn Sie den Cluster erstellen, wird der Cluster-Master automatisch in Ihrer Satellite-Steuerebene erstellt.

   • Um sicherzustellen, dass Hosts automatisch als Worker-Knoten im Standard-Worker-Pool Ihres Clusters zugewiesen werden, geben Sie die Labels dieser Hosts in der Option --host-label an und legen Sie die Anzahl der Worker-Knoten pro Zone in der Option --workers fest.
   • Um den Cluster-Administratorzugriff für Satellite-Konfiguration zu aktivieren, fügen Sie die Option --enable-admin-agent ein. Wenn Sie keinen Satellite Config-Zugriff erteilen, können Sie die Satellite Config-Funktion später nicht verwenden, um Kubernetes-Ressourcen für Ihre Cluster anzuzeigen oder bereitzustellen. Wenn Sie den Zugriff zu einem späteren Zeitpunkt aktivieren möchten, können Sie angepasste RBAC-Rollen für Satellite Config erstellen.
   • Weitere Informationen zu den Optionen in diesem Befehl finden Sie in der CLI-Referenzliteratur.
   • Sie können einen Einzelknotencluster erstellen, indem Sie die Option --infrastructure-topology einschließen und den Wert single-replica angeben, wenn Sie einen Satellite-Cluster in der Befehlszeilenschnittstelle erstellen. Wenn diese Option nicht enthalten ist, wird der Cluster standardmäßig mit der Hochverfügbarkeitskonfiguration von drei Workerknoten bereitgestellt.
   • Wenn Sie Ihre eigene OCP-Lizenz verwenden möchten, stellen Sie sicher, dass Sie Ihr Red Hat-Pull-Secret angeben, um den Cluster zur Ausführung von OCP zu berechtigen. Laden Sie das Pull-Secret entweder in der Konsole hoch oder fügen Sie die Option --pull-secret in den Befehlibmcloud oc cluster create satellite ein.
   • Um Ihre Cloud Pak-Berechtigung anzuwenden, stellen Sie sicher, dass Sie die Option --entitlement ocp_entitled einschließen.

--operating-system RHEL_9_64|REDHAT_8_64|RHCOS: Optional. Das Betriebssystem der Workerknoten in Ihrem Cluster. Eine Liste der verfügbaren Betriebssysteme nach Cluster-Version finden Sie in den Versionsinformationen unter Red Hat OpenShift on IBM Cloud. Wenn keine Option angegeben ist, wird das Standardbetriebssystem verwendet, das der Clusterversion entspricht.

Beispiel für einen `cluster create`-Befehl

```sh {: pre}
ibmcloud oc cluster create satellite --location LOCATION --name NAME --pull-secret SECRET --version 4.21_openshift [--enable-admin-agent] [--host-label LABEL ...] [--operating-system SYSTEM] [--pod-subnet SUBNET] [-q] [--service-subnet SUBNET] [--workers WORKERS-PER-ZONE] [--zone ZONE] [--entitlement ENTITLEMENT]
```
Beispiel für einen `cluster create`-Befehl unter Verwendung von `RHCOS`-Hosts und Anwendung einer `--pull-secret`-Lizenz
```sh {: pre}
ibmcloud oc cluster create satellite --location LOCATION --name CLUSTER_NAME --pull-secret SECRET --version VERSION --enable-admin-agent --operating-system RHCOS
```
Beispielausgabe

```sh {: screen}
Creating cluster...
OK
Cluster created with ID brkhsd220b6ktv7sjl50
```

4. Warten Sie, bis der Cluster den Zustand Warnung aufweist. Der Zustand Warnung weist darauf hin, dass der Cluster-Master vollständig bereitgestellt wurde, aber keine Workerknoten im Cluster erkannt wurden.

   ibmcloud oc cluster ls
   

   Beispielausgabe

   OK
   Name                ID                     State     Created          Workers   Location           Version                 Resource Group Name   Provider   
   satcluster          brkhsd220b6ktv7sjl50   warning   12 minutes ago   0         mylocation         4.5.23_1525_openshift   Default               satellite  
   

5. Stellen Sie sicher, dass Hosts als Workerknoten für den Cluster zugewiesen sind.

   • Automatische Zuweisung: Wenn Sie --host-labels eingefügt haben, als Sie den Cluster erstellten, und wenn Hosts mit übereinstimmenden Bezeichnungen an Ihrem Satellite-Standort verfügbar sind, werden die Workerknoten automatisch dem Cluster zugewiesen. Wenn Sie keine verfügbaren und übereinstimmenden Hosts haben, wird der Cluster trotzdem erstellt, aber in den Status Warnung versetzt. Ordnen Sie Hosts Ihrem Satellite-Standort zu, damit Hosts als Workerknoten dem Worker-Pool zugewiesen werden können. Wenn die Hosts nicht automatisch zugewiesen werden, können Sie Satellite-Hosts auch manuell zu Ihrem Cluster zuweisen.
   • Manuelle Zuweisung: Weisen Sie Ihrem Cluster Satellite-Hosts zu. Nachdem das Bootstrapping der Hosts erfolgreich durchgeführt wurde, dienen die Hosts als Workerknoten für Ihren Cluster und werden für die Ausführung von Red Hat OpenShift-Workloads eingesetzt. Weisen Sie in Ihrem Cluster mindestens 3 Hosts als Workerknoten zu.

6. Stellen Sie sicher, dass Ihr Cluster den Status Normal erreicht.

   ibmcloud oc cluster ls
   

   Beispielausgabe

   OK
   Name         ID                     State    Created        Workers   Location     Version                 Resource Group Name   Provider   
   satcluster   brkhsd220b6ktv7sjl50   normal   2 hours ago    3         mylocation   4.3.23_1525_openshift   Default               satellite   
   

7. Greifen Sie auf Ihren Cluster zu, um die Befehle oc und kubectl auszuführen, oder greifen Sie auf die Red Hat OpenShift-Webkonsole zu. Wenn Sie den Satellite Config-Zugriff aktiviert haben, müssen Sie diesen Schritt ausführen, um die Berechtigungen zu synchronisieren.

Wenn Ihre Standorthosts nur über private Netzkonnektivität verfügen oder wenn Sie Amazon Web Services-, Google Cloud Platform- oder Microsoft Azure-Hosts verwenden, müssen Sie mit dem privaten Netz Ihres Hosts verbunden sein (z. B. über den VPN-Zugriff), um eine Verbindung zu Ihrem Cluster herzustellen und auf die Red Hat OpenShift-Webkonsole zuzugreifen. Wenn Ihre Hosts über öffentliche Netzkonnektivität verfügen, können Sie alternativ den Zugriff auf Ihren Cluster testen, indem Sie die DNS-Datensätze Ihres Clusters und des Standorts ändern, um öffentliche IP-Adressen der Hosts zu verwenden.