Satellite-Konfigurationen über die Konsole erstellen

Informationen zum Bereitstellen einer Beispiel-App finden Sie unter Kubernetes-Ressourcen in Clustern mit Satellite Config bereitstellen.

Verwenden Sie zum Erstellen Ihrer angepassten Konfiguration die Benutzerschnittstelle von Satellite und führen Sie die folgenden Schritte aus.

1. Melden Sie sich bei der Satellite Config UI mit Ihren IBM Cloud-Berechtigungsnachweisen an.

2. Klicken Sie auf Konfiguration erstellen.

3. Wählen Sie auf der Seite Vorlagen durchsuchen die Vorlage Direct Upload aus.

4. Geben Sie auf der Seite Konfiguration Ihren Konfigurationsnamen und die Datenposition an.

5. Geben Sie auf der Seite Version Ihren Versionsnamen und Ihre Beschreibung an. Laden Sie anschließend eine vorhandene Datei hoch oder verwenden Sie den YAML-Editor, um den Dateiinhalt einzufügen.

6. Geben Sie auf der Seite Subskription Ihren Subskriptionsnamen, die Subskriptionsversion und die Clustergruppe für die Bereitstellung an.

7. Vergewissern Sie sich auf der Seite Zusammenfassung, dass die angezeigten Informationen korrekt sind, und klicken Sie anschließend auf Abschließen.

Satellite-Konfigurationen über die CLI erstellen

Verwenden Sie das CLI-Plug-in für Satellite-Befehle, um eine Konfiguration zu erstellen und die Kubernetes-Ressourcendefinition hochzuladen, die Sie in Ihren Clustern bereitstellen möchten.

Gehen Sie wie folgt vor, um die Konfiguration zu erstellen:

1. Richten Sie Ihre Cluster für die Verwendung mit Satellite Config ein. Diese Einrichtung umfasst die Erstellung einer Clustergruppe und die Erteilung des Zugriffs auf „ Satellite-Konfiguration“ für Ihre Cluster.

2. Fügen Sie Cluster zu Ihrer Clustergruppe hinzu. Die Cluster können an Ihrem Standort oder in IBM Cloud ausgeführt werden.

   1. Listen Sie die Cluster auf, die bei der Satellite Config-Komponente registriert sind, und notieren Sie die zugehörige ID.

       ibmcloud sat cluster ls
       ```
   2. Fügen Sie den Cluster zu Ihrer Clustergruppe hinzu,
   ```sh {: pre}
       ibmcloud sat group attach --cluster CLUSTER_ID --group CLUSTER_GROUP_NAME
       ```
   3. Überprüfen Sie, dass Ihr Cluster erfolgreich zu Ihrer Clustergruppe hinzugefügt wurde.
   ```sh {: pre}
       ibmcloud sat group get --group CLUSTER_GROUP_NAME
       ```
   

3. Erstellen Sie eine „ Satellite “-Konfiguration.

   ibmcloud sat config create --name CONFIG_NAME [--data-location <location>] [-q]
   

   Erläuterungen zu den Komponenten dieses Befehls

   Komponente	Beschreibung
   --name <config_name>	Geben Sie den Namen der Satellite-Konfiguration ein.
   --data-location <location>	Geben Sie den Speicherort für Ihre „ Satellite “-Konfigurationen ein, zum Beispiel us-east. „ Satellite “-Konfigurationen sind „ Kubernetes “-Ressourcendefinitionen, wie beispielsweise „ ConfigMaps, “-Speicherklassen oder Secrets, die über Abonnements in den Clustern an Ihrem Speicherort bereitgestellt werden. Wenn --data-location nicht angegeben ist, werden Ihre Konfigurationen standardmäßig in us-east gespeichert. Bei diesen Standorten handelt es sich um IBM Cloud Object Storage-Buckets, deren Eigner IBM ist und die für jede Region vorab bereitgestellt werden. Weitere Informationen zur Speicherung Ihrer Daten finden Sie unter Wie werden meine Informationen gespeichert, gesichert und verschlüsselt?. Eine Liste der Standorte finden Sie unter Unterstützte Standorte.
   -q	Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

   Beispielausgabe

   Creating configuration...
   OK
   Configuration <config_name> was successfully created with ID 116fffde-0835-467c-8987-67dd42e4e393.
   

4. Erstellen Sie eine Subskription für Ihre Clustergruppe für die Konfiguration Satellite. Nachdem das Abonnement erstellt wurde, lädt Satellite Config automatisch die Kubernetes-Ressourcendatei für die von Ihnen angegebene Version herunter und wendet diese Datei auf alle Cluster an, die zu der Clustergruppe gehören. Es kann mehrere Minuten dauern, bis dieser Vorgang abgeschlossen ist. Darüber hinaus werden Informationen zu allen von Ihnen erstellten „ Kubernetes “-Ressourcen von Ihren Clustern an „ Satellite Config“ zurückgesendet und können im Dashboard „ Satellite -Cluster-Ressourcen“ eingesehen werden. Überprüfen Sie die Befehlsoptionen, indem Sie ibmcloud sat subscription create ausführen.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Erläuterungen zu den Komponenten dieses Befehls

   Komponente	Beschreibung
   --group <cluster_group_name>	Geben Sie den Namen der Clustergruppe ein, in der Ihre Kubernetes-Ressourcen bereitgestellt werden sollen.
   --config <config_name_or_ID>	Geben Sie den Namen oder die ID der Satellite-Konfiguration ein, die Sie zuvor erstellt haben.
   --name <subscription_name>	Geben Sie einen Namen für Ihr Satellite-Abonnement ein.
   --version <version_name_or_ID>	Geben Sie den Namen oder die ID der Kubernetes-Ressourcendefinition ein, die Sie als Version zu Ihrer Konfiguration hinzugefügt haben. Führen Sie ibmcloud sat config get --config <config_name_or_ID> aus, um die verfügbaren Versionen aufzulisten.

   Beispielausgabe

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

5. Führen Sie Schritt 5 aus dem Abschnitt Satellite-Konfigurationen über die Konsole erstellen aus, um den Rollout-Status Ihrer Kubernetes-Ressourcen zu überprüfen.

Satellite-Konfiguration über die Konsole aktualisieren

Verwenden Sie die „ Satellite “-Konsole, um eine neue Versionsdatei hochzuladen und Ihr Abonnement entsprechend anzupassen.

1. Klicken Sie im Aktionsmenü einer Konfiguration auf Version hinzufügen.
   1. Geben Sie einen Namen und optional eine Beschreibung für Ihre Version ein.
   2. Laden Sie eine YAML-Datei für Kubernetes-Ressourcen hoch oder geben Sie die gewünschte Ressourcendefinition im Editor manuell ein. Stellen Sie sicher, dass der Kubernetes-Namensbereich angegeben wird, in dem Ihre Ressource bereitgestellt werden soll. Wenn Sie keinen Namensbereich angeben, wird die Ressource standardmäßig im Namensbereich razeedeploy bereitgestellt.
   3. Optional: Zum Anzeigen der Ressourcen, nachdem sie im Cluster über das Satellite Config-Dashboard erstellt wurden, fügen Sie die Bezeichnung razee/watch-resource=lite zum Abschnitt metadata.labels Ihrer YAML-Datei hinzu oder wählen Sie eine andere Option aus, um Ihre implementierten Ressourcen anzuzeigen, wie z. B. das Hinzufügen einer configmap zu Ihrem Cluster.
   4. Klicken Sie auf Hinzufügen, um die Kubernetes-Ressourcendefinition als Version zu Ihrer Konfiguration hinzuzufügen.
2. Erstellen Sie ein Abonnement für Ihre Clustergruppe. Die Subskription definiert, welche Satellite-Konfiguration zum Bereitstellen der Kubernetes-Ressourcen in Ihren Clustern verwendet wird.
   1. Wählen Sie die von Ihnen erstellte Konfiguration aus, um die Konfigurationsdetails anzuzeigen.
   2. Klicken Sie auf Abonnement erstellen.
   3. Geben Sie einen Namen für Ihr Abonnement ein und wählen Sie den Versionsnamen und die Clustergruppe aus, die Sie zuvor erstellt haben.
   4. Klicken Sie auf Erstellen, um das Abonnement zu erstellen.
3. Wählen Sie Ihr Abonnement aus, um die zugehörigen Details und den Rollout-Status Ihrer Kubernetes-Ressourcenbereitstellung anzuzeigen. Falls während der Bereitstellung Fehler auftreten (z. B. Formatfehler in YAML-Dateien oder nicht unterstützte Werte für die API-Version) werden die Fehlernachrichten in der Spalte Nachricht der Abonnementdetails angezeigt.

(AKTUALISIERUNG MIT NEUEN BEFEHLEN:) Satellite-Konfiguration mit der Befehlszeilenschnittstelle aktualisieren

Verwenden Sie das CLI-Plugin für die Befehle „ Satellite “, um eine neue Versionsdatei hochzuladen und Ihr Abonnement entsprechend anzupassen.

1. Erstellen Sie eine Version, indem Sie eine Kubernetes in Ihre Konfiguration hochladen. Stellen Sie sicher, dass der Kubernetes-Namensbereich angegeben wird, in dem Ihre Ressource bereitgestellt werden soll. Wenn Sie keinen Namensbereich angeben, wird die Ressource standardmäßig im Namensbereich razeedeploy bereitgestellt. Überprüfen Sie die Befehlsoptionen, indem Sie den Befehl ibmcloud sat config version create ausführen.

   Wenn Sie die Ressourcen nach der Erstellung im Cluster über das Satellite Config-Dashboard anzeigen möchten, fügen Sie die Bezeichnung razee/watch-resource=lite zum Abschnitt metadata.labels Ihrer YAML-Datei hinzu oder wählen Sie eine andere Option aus, um Ihre implementierten Ressourcen anzuzeigen, wie z. B. das Hinzufügen einer configmap zu Ihrem Cluster.

   ibmcloud sat config version create --name <version_name> --config <config_name_or_ID> --file-format yaml --read-config <file_path>
   

   Erläuterungen zu den Komponenten dieses Befehls

   Komponente	Beschreibung
   --name <version_name>	Geben Sie einen Namen für Ihre Konfigurationsversion ein.
   --config <config_name_or_ID>	Geben Sie den Namen oder die ID der Satellite-Konfiguration ein, die Sie zuvor erstellt haben.
   --read-config <file_path>	Geben Sie den relativen Dateipfad zu der Kubernetes-Ressourcendatei auf Ihrer lokalen Maschine ein.

   Beispielausgabe

   Creating configuration version...
   OK
   Configuration Version <version_name> was successfully created with ID ad5ae7a9-4f74-486c-816a-32de98de00df.
   

2. Erstellen Sie eine Subskription für Ihre Clustergruppe für die Konfiguration Satellite. Nachdem das Abonnement erstellt wurde, lädt Satellite Config automatisch die Kubernetes-Ressourcendatei für die von Ihnen angegebene Version herunter und wendet diese Datei auf alle Cluster an, die zu der Clustergruppe gehören. Es kann mehrere Minuten dauern, bis dieser Vorgang abgeschlossen ist. Darüber hinaus werden Informationen zu allen von Ihnen erstellten „ Kubernetes “-Ressourcen von Ihren Clustern an „ Satellite Config“ zurückgesendet und können im Dashboard „ Satellite -Cluster-Ressourcen“ eingesehen werden. Überprüfen Sie die Befehlsoptionen, indem Sie ibmcloud sat subscription create ausführen.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Erläuterungen zu den Komponenten dieses Befehls

   Komponente	Beschreibung
   --group <cluster_group_name>	Geben Sie den Namen der Clustergruppe ein, in der Ihre Kubernetes-Ressourcen bereitgestellt werden sollen.
   --config <config_name_or_ID>	Geben Sie den Namen oder die ID der Satellite-Konfiguration ein, die Sie zuvor erstellt haben.
   --name <subscription_name>	Geben Sie einen Namen für Ihr Satellite-Abonnement ein.
   --version <version_name_or_ID>	Geben Sie den Namen oder die ID der Kubernetes-Ressourcendefinition ein, die Sie als Version zu Ihrer Konfiguration hinzugefügt haben. Führen Sie ibmcloud sat config get --config <config_name_or_ID> aus, um die verfügbaren Versionen aufzulisten.

   Beispielausgabe

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

3. Führen Sie Schritt 5 aus dem Abschnitt Satellite-Konfigurationen über die Konsole erstellen aus, um den Rollout-Status Ihrer Kubernetes-Ressourcen zu überprüfen.