CLI-Referenz für Satellite Befehle

Nutzen Sie diese CLI-Befehle für Satellite, wenn Sie die Erstellung und Verwaltung Ihres Satellite-Standorts automatisieren möchten, einschließlich Vorgängen in Bezug auf Standort, Host, Cluster und Endpunkte.

Informationen zur Installation der Befehlszeilenschnittstelle finden Sie unter Befehlszeilenschnittstelle installieren. Eine Übersicht über alle Befehle auf IBM Cloud Satellite finden Sie in der CLI-Map.

  1. Installieren Sie die IBM Cloud-Befehlszeilenschnittstelle. Informationen hierzu finden Sie unter Erste Schritte mit der IBM Cloud-Befehlszeilenschnittstelle (CLI, Command Line Interface).

  2. Installieren Sie das Plug-in ks.

    ibmcloud plugin install ks
    

ACL-Befehle

Satellite-Zugriffskontrolllisten (ACLs) anzeigen und verwalten.

ibmcloud sat acl create

Satellite

Erstellen Sie eine ACL.

ibmcloud sat acl create --name NAME --subnet SUBNET [--subnet SUBNET ...] [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Der Name der ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subnet
Ein IP- oder CIDR-Block, der von dieser ACL zugelassen wird. Der Wert muss vollständig in den folgenden CIDRs enthalten sein: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Beispiele

ACL erstellen

ibmcloud sat acl create --name NAME --subnet SUBNET --connector-id ID

ibmcloud sat acl endpoint add

Satellite

Fügen Sie einen oder mehrere aktivierte Endpunkte zu einer ACL hinzu.

ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Fügen Sie einer ACL einen oder mehrere aktivierte Endpunkte hinzu

ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT --connector-id ID

ibmcloud sat acl endpoint help

Hilfe anzeigen

ibmcloud sat acl endpoint help

Beispiele

Hilfe anzeigen

ibmcloud sat acl endpoint help

ibmcloud sat acl endpoint ls

Satellite

Alle aktivierten Endpunkte für eine ACL auflisten.

ibmcloud sat acl endpoint ls --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Alle aktivierten Endpunkte für eine ACL auflisten

ibmcloud sat acl endpoint ls --acl-id ID --connector-id ID

ibmcloud sat acl endpoint rm

Satellite

Entfernen Sie einen oder mehrere aktivierte Endpunkte aus einer ACL.

ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Ein Name oder eine ID eines Endpunkts, der für diese ACL deaktiviert werden soll.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Einen oder mehrere aktivierte Endpunkte aus einer ACL entfernen

ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT --connector-id ID

ibmcloud sat acl get

Satellite

Details einer ACL anzeigen.

ibmcloud sat acl get --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details einer ACL anzeigen

ibmcloud sat acl get --acl-id ID --connector-id ID

ibmcloud sat acl help

Hilfe anzeigen

ibmcloud sat acl help

Beispiele

Hilfe anzeigen

ibmcloud sat acl help

ibmcloud sat acl ls

Satellite

Alle ACLs für einen Satellite-Konnektor oder -Standort auflisten.

ibmcloud sat acl ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Alle ACLs für einen Satellite-Konnektor oder -Standort auflisten

ibmcloud sat acl ls --connector-id ID

ibmcloud sat acl rm

Satellite

Eine ACL löschen.

ibmcloud sat acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Eine ACL löschen

ibmcloud sat acl rm --acl-id ID --connector-id ID

ibmcloud sat acl subnet add

Satellite

Fügen Sie ein oder mehrere Subnetze zu einer ACL hinzu.

ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subnet
Ein IP- oder CIDR-Block, der von dieser ACL zugelassen wird. Der Wert muss vollständig in den folgenden CIDRs enthalten sein: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Beispiele

Ein oder mehrere Subnetze zu einer ACL hinzufügen

ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET --connector-id ID

ibmcloud sat acl subnet help

Hilfe anzeigen

ibmcloud sat acl subnet help

Beispiele

Hilfe anzeigen

ibmcloud sat acl subnet help

ibmcloud sat acl subnet rm

Satellite

Entfernen Sie ein oder mehrere Subnetze aus einer ACL.

ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subnet
Ein IP- oder CIDR-Block, der von dieser ACL zugelassen wird. Der Wert muss vollständig in den folgenden CIDRs enthalten sein: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Beispiele

Ein oder mehrere Subnetze aus einer ACL entfernen

ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET --connector-id ID

ibmcloud sat acl update

Satellite

Aktualisieren Sie den Namen einer ACL.

ibmcloud sat acl update --acl-id ID --name NAME [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--acl-id
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Der neue Name für die ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Den Namen einer ACL aktualisieren

ibmcloud sat acl update --acl-id ID --name NAME --connector-id ID

Agentenbefehle

Satellite-Connector-Agenten anhängen oder anzeigen.

ibmcloud sat agent attach

Satellite

Laden Sie einen Satellite Connector-Agenten für eine bestimmte Plattform herunter. Laden Sie den Agent für .zip Windows herunter oder rufen Sie einen Link zur Dokumentation für Docker-Umgebungen auf.

ibmcloud sat agent attach --platform PLATFORM [-q]

Befehlsoptionen

--platform
Die Plattform für den Satellite Connector Agent. Weitere Informationen über Docker finden Sie in der Dokumentation unter https://ibm.biz/satconagent Verfügbare Optionen: Windows, Docker
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Holen Sie sich einen Satellite-Connector-Agenten für eine bestimmte Plattform

ibmcloud sat agent attach --platform PLATFORM

ibmcloud sat agent help

Hilfe anzeigen

ibmcloud sat agent help

Beispiele

Hilfe anzeigen

ibmcloud sat agent help

ibmcloud sat agent ls

Satellite

Alle Agenten für einen Satellite-Konnektor auflisten.

ibmcloud sat agent ls --connector-id ID [--output OUTPUT] [-q]

Befehlsoptionen

--connector-id
Die ID eines Satellite-Connectors.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Alle Agenten für einen Satellite-Konnektor auflisten

ibmcloud sat agent ls --connector-id ID

Clusterbefehle

Registrieren und verwalten Sie Cluster für die Verwendung mit Satellite-Konfigurationen.

ibmcloud sat cluster get

Virtual Private Cloud Classic infrastructure Satellite

Rufen Sie die Details eines registrierten Clusters ab.

ibmcloud sat cluster get --cluster CLUSTER [--output OUTPUT] [-q]

Befehlsoptionen

-c, --cluster
Geben Sie den Clusternamen oder die ID an. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details zu einem registrierten Cluster abrufen

ibmcloud sat cluster get --cluster CLUSTER

ibmcloud sat cluster help

Hilfe anzeigen

ibmcloud sat cluster help

Beispiele

Hilfe anzeigen

ibmcloud sat cluster help

ibmcloud sat cluster ls

Virtual Private Cloud Classic infrastructure Satellite

Listen Sie alle registrierten Cluster in Ihrem IBM Cloud-Konto auf.

ibmcloud sat cluster ls [--filter FILTER] [--limit LIMIT] [--output OUTPUT] [-q]

Befehlsoptionen

--filter
Filtern Sie registrierte Cluster nach Cluster-ID.
--limit
Begrenzt die Anzahl der zurückgegebenen Cluster.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle registrierten Cluster in Ihrem IBM Cloud-Konto auf

ibmcloud sat cluster ls

ibmcloud sat cluster register

Satellite

Rufen Sie einen Befehl kubectl auf, um Ihren Cluster in einer Satellite-Konfiguration zu registrieren. Melden Sie sich bei Ihrem Cluster an und führen Sie diesen Befehl aus, um einen Satellite-Konfigurationsagenten zu installieren. Cluster, die Sie an Ihrem Satellite-Standort ausführen, installieren diesen Agenten automatisch.

ibmcloud sat cluster register --name NAME [-q] [--silent]

Befehlsoptionen

--name
Geben Sie den Namen des Clusters an, den Sie registrieren wollen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--silent
Im Hintergrund. In der Ausgabe wird nur der Registrierungsbefehl zurückgeben.

Beispiele

Hier finden Sie einen Befehl kubectl zum Registrieren Ihres Clusters in einer Satellite-Konfiguration

ibmcloud sat cluster register --name NAME

ibmcloud sat cluster unregister

Satellite

Entfernen Si eine Clusterregistrierung. Der Cluster abonniert keine Satellite-Konfiguration mehr, aber der Cluster und seine vorhandenen Ressourcen werden weiterhin ausgeführt.

ibmcloud sat cluster unregister --cluster CLUSTER [-f] [-q]

Befehlsoptionen

-c, --cluster
Geben Sie den Clusternamen oder die ID an. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Cluster-Registrierung entfernen

ibmcloud sat cluster unregister --cluster CLUSTER

Konfigurationsbefehle

Satellite-Konfiguration anzeigen und verwalten.

ibmcloud sat config create

Satellite

Erstellen Sie eine Konfiguration, um anzugeben, welche Kubernetes-Ressourcen Sie in Ihren Clustern in Ihren Satellite-Workloads bereitstellen wollen.

ibmcloud sat config create --name NAME [-q] (--data-location LOCATION | --provider PROVIDER)

Befehlsoptionen

--data-location
Geben Sie die IBM-Region an, in der die Daten der Satellite-Konfiguration gespeichert werden sollen. Strategie: Direkter Upload.
--name
Geben Sie einen Namen für die Satellite-Konfiguration an.
--provider
Geben Sie den fernen GitOps-Provider für die Satellite-Konfiguration an. Dieser Provider speichert die Kubernetes-Ressourcendefinitionen. Strategie: GitOps. Zulässige Werte: github, gitlab
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erstellen Sie eine Konfiguration, um festzulegen, welche Kubernetes-Ressourcen Sie in Ihren Clustern für Ihre Satellite-Workloads bereitstellen möchten

ibmcloud sat config create --name NAME --data-location LOCATION

ibmcloud sat config get

Satellite

Rufen Sie Details zu einer Satellite-Konfiguration ab, z. B. die Versionen oder die Abonnements, die der Konfiguration zugeordnet sind.

ibmcloud sat config get --config CONFIG [--output OUTPUT] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erhalten Sie Details zu einer Satellite-Konfiguration, wie z. B. die mit der Konfiguration verknüpften Versionen oder Abonnements

ibmcloud sat config get --config CONFIG

ibmcloud sat config help

Hilfe anzeigen

ibmcloud sat config help

Beispiele

Hilfe anzeigen

ibmcloud sat config help

ibmcloud sat config ls

Satellite

Alle Satellite-Konfigurationen in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat config ls [--output OUTPUT] [-q]

Befehlsoptionen

--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Satellite-Konfigurationen in Ihrem IBM Cloud-Konto auf

ibmcloud sat config ls

ibmcloud sat config rename

Satellite

Satellite-Konfiguration umbenennen.

ibmcloud sat config rename --config CONFIG --name NAME [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
--name
Geben Sie einen neuen Namen für die Satellite-Konfiguration an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Satellite-Konfiguration umbenennen

ibmcloud sat config rename --config CONFIG --name NAME

ibmcloud sat config rm

Satellite

Satellite-Konfiguration entfernen. Zunächst müssen alle zugeordneten Subskriptionen entfernt werden. Es werden alle Versionen gelöscht. Erstellen Sie von allen Ressourcendefinitionen, die Sie beibehalten möchten, eine Sicherungskopie.

ibmcloud sat config rm --config CONFIG [-f] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Satellite-Konfiguration entfernen

ibmcloud sat config rm --config CONFIG

ibmcloud sat config version create

Satellite

Konfigurationsversion erstellen, um vorhandene Kubernetes-Ressourcen für Ihre Satellite-Workloads zu aktualisieren.

ibmcloud sat config version create --config CONFIG --file-format FORMAT --name NAME --read-config CONFIG [--description DESCRIPTION] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID der Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
--description
Fügen Sie eine Beschreibung für die Version der Satellite-Konfiguration hinzu.
--file-format
Geben Sie das Dateiformat der Konfigurationsversion an. Verfügbare Optionen: yaml
--name
Geben Sie einen Namen für die Version der Satellite-Konfiguration an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--read-config
Geben Sie den Dateipfad für die Datei mit der Konfigurationsversion an.

Beispiele

Erstellen Sie eine Konfigurationsversion, um vorhandene Ressourcen von Kubernetes für Ihre Satellite-Workloads zu aktualisieren

ibmcloud sat config version create \
  --config CONFIG \
  --file-format FORMAT \
  --name NAME \
  --read-config CONFIG

ibmcloud sat config version get

Satellite

Detaillierte Informationen zu einer Satellite-Konfigurationsversion abrufen.

ibmcloud sat config version get --config CONFIG --version VERSION [--output OUTPUT] [-q] [--save-config]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID der Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--save-config
Konfigurationsversion herunterladen und in einer temporären Datei speichern.
--version
Geben Sie den Namen oder die ID der Version einer Satellite-Konfiguration an. Führen Sie ibmcloud sat config get --config <configuration_name_or_ID> aus, um Versionen in Ihrer Konfiguration aufzulisten.

Beispiele

Details zu einer Konfigurationsversion von Satellite abrufen

ibmcloud sat config version get --config CONFIG --version VERSION

ibmcloud sat config version help

Hilfe anzeigen

ibmcloud sat config version help

Beispiele

Hilfe anzeigen

ibmcloud sat config version help

ibmcloud sat config version rm

Satellite

Satellite-Konfigurationsversion entfernen.

ibmcloud sat config version rm --config CONFIG --version VERSION [-f] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID der Satellite-Konfiguration an. Führen Sie den Befehl ibmcloud sat config ls aus, um die verfügbaren Konfigurationen aufzulisten.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--version
Geben Sie den Namen oder die ID der Version einer Satellite-Konfiguration an. Um die Versionen aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat config get --config <configuration_name_or_ID>.

Beispiele

Eine Konfigurationsversion von Satellite entfernen

ibmcloud sat config version rm --config CONFIG --version VERSION

Befehle für den Connector

Satellite-Connectors erstellen, anzeigen und ändern.

ibmcloud sat connector create

Satellite

Erstellen Sie einen Satellite-Connector.

ibmcloud sat connector create --name NAME --region REGION [-q]

Befehlsoptionen

--name
Der Name des Satellite-Connectors.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--region
Die IBM Cloud-Region für die Verwaltung Ihres Satellite-Connectors

Beispiele

Erstellen Sie einen Satellite-Konnektor

ibmcloud sat connector create --name NAME --region REGION

ibmcloud sat connector get

Satellite

Details eines Satellite-Connectors anzeigen.

ibmcloud sat connector get --connector-id ID [--output OUTPUT] [-q]

Befehlsoptionen

--connector-id
Die ID eines Satellite-Connectors.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details zum Satellite-Konnektor anzeigen

ibmcloud sat connector get --connector-id ID

ibmcloud sat connector help

Hilfe anzeigen

ibmcloud sat connector help

Beispiele

Hilfe anzeigen

ibmcloud sat connector help

ibmcloud sat connector ls

Satellite

Rufen Sie die Satellite-Konnektoren in Ihrem IBM Cloud-Konto auf.

ibmcloud sat connector ls [--after AFTER] [--first FIRST] [--output OUTPUT] [-q]

Befehlsoptionen

--after
Zeigt Satellite-Verbindungen nach dem angegebenen Cursor.
--first
Zeigt die nächsten Satellite-Verbindungen an, bis zur ersten Anzahl von Verbindern.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Sehen Sie sich die Satellite-Konnektoren in Ihrem IBM Cloud-Konto an

ibmcloud sat connector ls

ibmcloud sat connector rm

Satellite

Löschen Sie einen Satellite-Connector.

ibmcloud sat connector rm --connector-id ID [-f] [-q]

Befehlsoptionen

--connector-id
Die ID eines Satellite-Connectors.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Einen Satellite-Konnektor löschen

ibmcloud sat connector rm --connector-id ID

Endpunktbefehle

Satellite-Endpunkte anzeigen und verwalten.

ibmcloud sat endpoint authn get

Satellite

Abrufen der Authentifizierungseinstellungen für einen Endpunkt.

ibmcloud sat endpoint authn get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Abrufen der Authentifizierungseinstellungen für einen Endpunkt

ibmcloud sat endpoint authn get --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint authn help

Hilfe anzeigen

ibmcloud sat endpoint authn help

Beispiele

Hilfe anzeigen

ibmcloud sat endpoint authn help

ibmcloud sat endpoint authn rotate

Satellite

Ersetzen Sie vorhandene Authentifizierungszertifikate durch neue. Im Anforderungsablauf gibt es zwei TLS-Verbindungen. Die Optionen source beziehen sich auf den TLS-Handshake zwischen der Quelle und dem Connector-Dienst. Die Optionen destination beziehen sich auf den Handshake gemäß dem TLS zwischen dem Connector-Dienst und Ihrem Zielserver. Sie können Zertifikate für eine oder beide Verbindungen bereitstellen. Es werden nur die von Ihnen angegebenen Zertifikate ersetzt.

ibmcloud sat endpoint authn rotate --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--source-ca-cert-file
Zertifikat einer anerkannten Zertifizierungsstelle oder Kette, die verwendet wird, um das Zertifikat des Quellenclients zu validieren, wenn source-tls-mode auf "mutual" gesetzt ist. Beispiel: myCA.pem.
--source-cert-file
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file
Der private Serverschlüssel, der zum Verschlüsseln des Serverzertifikats verwendet wird Beispiel: myKey.pem.

Beispiele

Ersetzen Sie vorhandene Authentifizierungszertifikate durch neue

ibmcloud sat endpoint authn rotate --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint authn set

Satellite

Legen Sie die Authentifizierungseinstellungen für einen Endpunkt fest. Im Anforderungsablauf gibt es zwei TLS-Verbindungen. Die Optionen source beziehen sich auf den TLS-Handshake zwischen der Quelle und dem Connector-Dienst. Die Optionen destination beziehen sich auf den Handshake gemäß dem TLS zwischen dem Connector-Dienst und Ihrem Zielserver. Sie können Zertifikate für eine oder beide Verbindungen bereitstellen. Nicht angegebene Einstellungen werden auf ihre Standardwerte gesetzt.

ibmcloud sat endpoint authn set --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [--dest-tls-mode MODE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] [--source-tls-mode MODE] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--dest-tls-mode
Das Ziel TLS Modus. Akzeptierte Werte:simple,mutual,none
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--source-ca-cert-file
Zertifikat einer anerkannten Zertifizierungsstelle oder Kette, die verwendet wird, um das Zertifikat des Quellenclients zu validieren, wenn source-tls-mode auf "mutual" gesetzt ist. Beispiel: myCA.pem.
--source-cert-file
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file
Der private Serverschlüssel, der zum Verschlüsseln des Serverzertifikats verwendet wird Beispiel: myKey.pem.
--source-tls-mode
Die Quelle: TLS-Modus. Akzeptierte Werte: simple, mutual

Beispiele

Authentifizierungseinstellungen für einen Endpunkt festlegen

ibmcloud sat endpoint authn set --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint create

Satellite

Endpunkt erstellen.

ibmcloud sat endpoint create --dest-hostname HOSTNAME --dest-port PORT --dest-type TYPE --name NAME --source-protocol PROTOCOL [--dest-protocol PROTOCOL] [--idle-timeout-seconds SECONDS] [--output OUTPUT] [-q] [--sni SNI] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-hostname
Geben Sie den vollständig qualifizierten Domänennamen (FQDN) oder die extern zugängliche IP-Adresse des Ziels an, zu dem Sie eine Verbindung herstellen möchten. Bei cloud Endpunkten muss dieser Wert auf eine öffentliche IP-Adresse oder auf eine private IP-Adresse aufgelöst werden, auf die innerhalb von IBM Cloud zugegriffen werden kann, wie beispielsweise ein Endpunkt eines privaten Cloud-Dienstes. Bei location Endpunkten muss dieser Wert von den Hosts der Steuerungsebene für Satellite-Standorte aufgelöst werden und von dort aus erreichbar sein oder dort, wo der Agent für den Satellite Connector ausgeführt wird.
--dest-port
Geben Sie den Port an, an dem die Zielressource für eingehende Anforderungen empfangsbereit ist. Stellen Sie sicher, dass der Port dem Zielprotokoll entspricht.
--dest-protocol
Geben Sie das Protokoll des Ziels an. Wenn Sie diese Option nicht angeben, wird das Zielprotokoll aus dem Quellenprotokoll übernommen. Akzeptierte Werte: TCP, TLS
--dest-type
Geben Sie an, wo die Zielressource ausgeführt wird: entweder in IBM Cloud (cloud) oder an Ihrem Satellite-Standort (location). Verfügbare Optionen: location, cloud
--idle-timeout-seconds
Geben Sie das Zeitlimitintervall für aktive Verbindungen zum Ziel in Sekunden an. Stellen Sie sicher, dass Ihr Zeitlimit mit den Einstellungen für den Zielservice und das Zielprotokoll keep-alive kompatibel ist.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Geben Sie einen Namen für den Endpunkt an.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--sni
Geben Sie den Servernamen-Indikator an, wenn Sie ein oder tls https Quellprotokoll festlegen und möchten, dass dem Handshake von TLS ein separater Hostname hinzugefügt wird.
--source-protocol
Geben Sie das Protokoll an, das die Quelle verwendet, um eine Verbindung zur Zielressource herzustelen. Siehe http://ibm.biz/endpoint-protocols. Verfügbare Optionen: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Beispiele

Endpunkt erstellen

ibmcloud sat endpoint create \
  --dest-hostname HOSTNAME \
  --dest-port PORT \
  --dest-type TYPE \
  --name NAME \
  --source-protocol PROTOCOL \
  --connector-id ID

ibmcloud sat endpoint disable

Satellite

Deaktivieren eines Endpunkts.

ibmcloud sat endpoint disable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Endpunkt deaktivieren

ibmcloud sat endpoint disable --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint enable

Satellite

Aktivieren Sie einen Endpunkt.

ibmcloud sat endpoint enable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Endpunkt aktivieren

ibmcloud sat endpoint enable --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint get

Satellite

Zeigen Sie die Details zu einem Endpunkt an.

ibmcloud sat endpoint get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details zu einem Endpunkt anzeigen

ibmcloud sat endpoint get --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint help

Hilfe anzeigen

ibmcloud sat endpoint help

Beispiele

Hilfe anzeigen

ibmcloud sat endpoint help

ibmcloud sat endpoint ls

Satellite

Listen Sie alle Endpunkte an einem Satellite-Standort auf.

ibmcloud sat endpoint ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Alle Endpunkte in einem Satellite-Speicherort auflisten

ibmcloud sat endpoint ls --connector-id ID

ibmcloud sat endpoint rm

Satellite

Endpunkt löschen.

ibmcloud sat endpoint rm --endpoint ENDPOINT [-q] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Endpunkt löschen

ibmcloud sat endpoint rm --endpoint ENDPOINT --connector-id ID

ibmcloud sat endpoint update

Satellite

Einen Endpunkt aktualisieren. Nur die von Ihnen angegebenen Optionen werden aktualisiert.

ibmcloud sat endpoint update --endpoint ENDPOINT [--dest-hostname HOSTNAME] [--dest-port PORT] [--dest-protocol PROTOCOL] [--idle-timeout-seconds SECONDS] [--name NAME] [-q] [--sni SNI] [--source-protocol PROTOCOL] (--connector-id ID | --location LOCATION)

Befehlsoptionen

--connector-id
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-hostname
Geben Sie den vollständig qualifizierten Domänennamen (FQDN) oder die extern zugängliche IP-Adresse des Ziels an, zu dem Sie eine Verbindung herstellen möchten. Bei cloud Endpunkten muss dieser Wert auf eine öffentliche IP-Adresse oder auf eine private IP-Adresse aufgelöst werden, auf die innerhalb von IBM Cloud zugegriffen werden kann, wie beispielsweise ein Endpunkt eines privaten Cloud-Dienstes. Bei location Endpunkten muss dieser Wert von den Hosts der Steuerungsebene für Satellite-Standorte aufgelöst werden und von dort aus erreichbar sein oder dort, wo der Agent für den Satellite Connector ausgeführt wird.
--dest-port
Geben Sie den Port an, an dem die Zielressource für eingehende Anforderungen empfangsbereit ist. Stellen Sie sicher, dass der Port dem Zielprotokoll entspricht.
--dest-protocol
Geben Sie das Protokoll des Ziels an. Wenn Sie diese Option nicht angeben, wird das Zielprotokoll aus dem Quellenprotokoll übernommen. Akzeptierte Werte: TCP, TLS
--endpoint
Geben Sie den Namen oder die ID des Endpunkts an. Um alle Endpunkte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--idle-timeout-seconds
Geben Sie das Zeitlimitintervall für aktive Verbindungen zum Ziel in Sekunden an. Stellen Sie sicher, dass Ihr Zeitlimit mit den Einstellungen für den Zielservice und das Zielprotokoll keep-alive kompatibel ist.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Geben Sie einen neuen Namen für den Endpunkt an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--sni
Geben Sie den Servernamen-Indikator an, wenn Sie ein oder tls https Quellprotokoll festlegen und möchten, dass dem Handshake von TLS ein separater Hostname hinzugefügt wird.
--source-protocol
Geben Sie das Protokoll an, das die Quelle verwendet, um eine Verbindung zur Zielressource herzustelen. Siehe http://ibm.biz/endpoint-protocols. Zulässige Werte: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Beispiele

Endpunkt aktualisieren

ibmcloud sat endpoint update --endpoint ENDPOINT --connector-id ID

Experimentelle Befehle

[Expires on 2024-11-25] Experimentieren Sie mit neuen Befehlen. WICHTIG: Die hier aufgeführten Befehle werden nach dem in [date] ihrer Beschreibung angegebenen Zeitpunkt nicht mehr unterstützt.

ibmcloud sat experimental endpoint help

Hilfe anzeigen

ibmcloud sat experimental endpoint help

Beispiele

Hilfe anzeigen

ibmcloud sat experimental endpoint help

ibmcloud sat experimental help

Hilfe anzeigen

ibmcloud sat experimental help

Beispiele

Hilfe anzeigen

ibmcloud sat experimental help

GROUP-Befehle

Satellite-Clustergruppen anzeigen und verwalten. Clustergruppen werden verwendet, um Cluster für Satellite-Konfigurationen von Kubernetes-Ressourcen zu abonnieren.

ibmcloud sat group attach

Satellite

Fügen Sie einen Cluster zu Ihrer Clustergruppe hinzu. Der Cluster kann an Ihrem Satellite-Standort oder in IBM Cloud ausgeführt werden. Wenn Sie einen Cluster hinzufügen wollen, der in IBM Cloud ausgeführt wird, müssen Sie zunächst den Cluster bei Satellite Config registrieren.

ibmcloud sat group attach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-q]

Befehlsoptionen

-c, --cluster
Gibt den Clusternamen oder die Cluster-ID an. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
-g, --group
Geben Sie den Namen oder die ID einer Satellite-Clustergruppe an. Führen Sie den Befehl ibmcloud sat group ls aus, um die verfügbaren Clustergruppen aufzulisten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Fügen Sie Ihrer Clustergruppe einen Cluster hinzu

ibmcloud sat group attach --cluster CLUSTER --group GROUP

ibmcloud sat group create

Satellite

Erstellen Sie eine Clustergruppe. Anschließend können Sie ein Abonnement der Clustergruppe bei einer Satellite-Konfiguration einrichten.

ibmcloud sat group create --name NAME [--cluster CLUSTER ...] [-q]

Befehlsoptionen

-c, --cluster
Geben Sie den Namen oder die ID des Clusters an, der zu der Clustergruppe hinzugefügt werden soll. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
--name
Geben Sie einen Namen für die Satellite-Clustergruppe an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Clustergruppe erstellen

ibmcloud sat group create --name NAME

ibmcloud sat group detach

Satellite

Mindestens ein Cluster aus Ihrer Satellite-Clustergruppe wird entfernt und es werden die Kubernetes-Ressourcen entfernt, die von den Abonnements der Gruppe verwaltet wurden.

ibmcloud sat group detach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-f] [-q]

Befehlsoptionen

-c, --cluster
Gibt den Clusternamen oder die Cluster-ID an. Um die Cluster in Ihrer Clustergruppe aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat group get --group <cluster_group_name_or_ID>.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-g, --group
Geben Sie den Namen oder die ID einer Satellite-Clustergruppe an. Führen Sie den Befehl ibmcloud sat group ls aus, um die verfügbaren Clustergruppen aufzulisten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Entfernt einen oder mehrere Cluster aus Ihrer Satellite-Clustergruppe und löscht die Ressourcen unter Kubernetes, die von den Abonnements der Gruppe verwaltet wurden

ibmcloud sat group detach --cluster CLUSTER --group GROUP

ibmcloud sat group get

Satellite

Detaillierte Informationen zu einer Satellite-Clustergruppe abrufen.

ibmcloud sat group get --group GROUP [--output OUTPUT] [-q]

Befehlsoptionen

-g, --group
Geben Sie den Namen oder die ID einer Satellite-Clustergruppe an. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erhalten Sie detaillierte Informationen zu einer Satellite-Clustergruppe

ibmcloud sat group get --group GROUP

ibmcloud sat group help

Hilfe anzeigen

ibmcloud sat group help

Beispiele

Hilfe anzeigen

ibmcloud sat group help

ibmcloud sat group ls

Satellite

Alle Satellite-Clustergruppen in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat group ls [--output OUTPUT] [-q]

Befehlsoptionen

--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Satellite-Clustergruppen in Ihrem IBM Cloud-Konto auf

ibmcloud sat group ls

ibmcloud sat group rm

Satellite

Satellite-Clustergruppe entfernen; dadurch wird das Abonnement für Cluster aufgehoben und es werden die Kubernetes-Ressourcen gelöscht, die von den Abonnements der Gruppe verwaltet wurden.

ibmcloud sat group rm --group GROUP [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-g, --group
Geben Sie den Namen oder die ID einer Satellite-Clustergruppe an. Führen Sie den Befehl ibmcloud sat group ls aus, um die verfügbaren Clustergruppen aufzulisten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Entfernen Sie eine Satellite-Clustergruppe. Dadurch werden die Cluster abgemeldet und die Ressourcen Kubernetes, die von den Abonnements der Gruppe verwaltet wurden, gelöscht

ibmcloud sat group rm --group GROUP

Hostbefehle

Zeigen Sie Satellite-Hosts an und nehmen Sie Änderungen an ihnen vor.

ibmcloud sat host assign

Satellite

Weisen Sie einer Steuerebene oder einem Cluster eines Satellite-Standorts einen Host zu.

ibmcloud sat host assign --location LOCATION [--cluster CLUSTER] [--host HOST] [--host-label LABEL ...] [-q] [--worker-pool POOL] [--zone ZONE]

Befehlsoptionen

--cluster
Der Name oder die ID des Clusters, dem der Host zugewiesen werden soll. Um die verfügbaren Cluster aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat cluster ls. Falls kein Cluster angegeben ist, wird der Host automatisch der Satellite-Steuerebene zugeordnet.
--host
Der Name oder die ID des Hosts, der zugewiesen werden soll. Geben Sie diese Option nicht an, wenn Hosts auf der Basis von Bezeichnungen automatisch zugewiesen werden sollen. Führen Sie ibmcloud sat host ls --location <location_ID_or_name> aus, um die Host-ID abzurufen.
--host-label, --hl
Geben Sie beliebige Bezeichnungen als Schlüssel-Wert-Paare ein, um den Host zu identifizieren, der Ihrer Satellite-Steuerungsebene oder Ihrem Red Hat OpenShift-Cluster zugewiesen werden soll. Der erste Host, der diese Bezeichnung aufweist und nicht zugeordnet ist, wird automatisch der Steuerebene oder dem Cluster zugewiesen. Führen Sie ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID> aus, um verfügbare Hostbezeichnungen zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-p, --worker-pool
Der Name oder die ID des Worker-Pools im Cluster, dem der Host zugewiesen werden soll. Wenn kein Worker-Pool angegeben ist, wird der Host dem Standard-Worker-Pool zugeordnet.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--zone
Der Name oder die ID der Zone, der der Host zugewiesen werden soll. Um verfügbare Zonen zu finden, führen Sie aus und ibmcloud sat location get --location <location_name_or_ID> suchen Sie nach dem Feld Host Zones.

Beispiele

Weisen Sie einen Host einer Steuerungsebene oder einem Cluster des Satellite-Standorts zu

ibmcloud sat host assign --location LOCATION

ibmcloud sat host attach

Satellite

Erstellen und laden Sie ein Script herunter, das Sie auf Ihren Hosts ausführen können, um diese an Ihren Standort anzuhängen. Bei RHCOS-fähigen Standorten handelt es sich bei dem Script um eine Ignition-Datei.

ibmcloud sat host attach --location LOCATION [--host-label LABEL ...] [--host-link-agent-endpoint ENDPOINT] [--operating-system SYSTEM] [-q] [--reset-key]

Befehlsoptionen

--host-label, --hl
Geben Sie beliebige Bezeichnungen als Schlüssel-Wert-Paare ein, um den Host zu identifizieren, der Ihrer Satellite-Steuerungsebene oder Ihrem Red Hat OpenShift-Cluster zugewiesen werden soll. Der erste Host, der diese Bezeichnung aufweist und nicht zugeordnet ist, wird automatisch der Steuerebene oder dem Cluster zugewiesen. Führen Sie ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID> aus, um verfügbare Hostbezeichnungen zu suchen.
--host-link-agent-endpoint
Der Endpunkt, über den der Linkagent eine Verbindung zum Link-Tunnel-Server herstellt.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--operating-system
Das Betriebssystem der Hosts, die Sie an Ihren Standort anhängen wollen Zum Anhängen von RHCOS-Hosts muss Ihr Standort RHCOS-fähig sein. Akzeptierte Werte: RHEL, RHCOS
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--reset-key
Setzen Sie den Schlüssel zurück, den die Steuerungsebene zum Anbinden und Zuweisen von Hosts am Standort verwendet. Siehe https://ibm.biz/reset-key.

Beispiele

Erstellen und laden Sie ein Skript herunter, das Sie auf Ihren Hosts ausführen können, um diese Ihrem Standort zuzuordnen

ibmcloud sat host attach --location LOCATION

ibmcloud sat host get

Satellite

Details zu einem Satellite-Host anzeigen.

ibmcloud sat host get --host HOST --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--host
Die ID des Satellite-Hosts. Um die Host-ID zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat host ls <location_ID_or_name>.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details zu einem Satellite-Host anzeigen

ibmcloud sat host get --host HOST --location LOCATION

ibmcloud sat host help

Hilfe anzeigen

ibmcloud sat host help

Beispiele

Hilfe anzeigen

ibmcloud sat host help

ibmcloud sat host ls

Satellite

Alle Hosts auflisten, die einem Satellite-Standort zugeordnet sind, einschließlich Hosts, die Clustern oder der Steuerebene zugewiesen sind.

ibmcloud sat host ls --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Hosts auf, die einem Satellite-Standort zugeordnet sind, einschließlich der Hosts, die Clustern oder der Control Plane zugewiesen sind

ibmcloud sat host ls --location LOCATION

ibmcloud sat host rm

Satellite

Host aus einem Satellite-Standort entfernen.

ibmcloud sat host rm --host HOST --location LOCATION [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--host
Der Name oder die ID des Hosts, der entfernt werden soll.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Einen Host aus einem Satellite-Standort entfernen

ibmcloud sat host rm --host HOST --location LOCATION

ibmcloud sat host update

Satellite

Hostinformationen, wie z. B. Zonen oder Bezeichnungen aktualisieren.

ibmcloud sat host update --host HOST --location LOCATION [--host-label LABEL ...] [-q] [--zone ZONE]

Befehlsoptionen

--host
Der Name oder die ID des Hosts, der zugewiesen werden soll. Geben Sie diese Option nicht an, wenn Hosts auf der Basis von Bezeichnungen automatisch zugewiesen werden sollen.
--host-label, --hl
Geben Sie beliebige Bezeichnungen als Schlüssel-Wert-Paare ein, um den Host zu identifizieren, der Ihrer Satellite-Steuerungsebene oder Ihrem Red Hat OpenShift-Cluster zugewiesen werden soll. Der erste Host, der diese Bezeichnung aufweist und nicht zugeordnet ist, wird automatisch der Steuerebene oder dem Cluster zugewiesen. Führen Sie ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID> aus, um verfügbare Hostbezeichnungen zu suchen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--zone
Der Name oder die ID der Zone, der der Host zugeordnet werden soll. Die Zone der Hosts, die einer Ressource (z. B. einem Cluster) zugewiesen sind, kann nicht geändert werden. Dazu müssten Sie zunächst die Zuweisung aufheben. Um die verfügbaren Zonen aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat location get --location <ID>.

Beispiele

Host-Informationen wie Zonen und Bezeichnungen aktualisieren

ibmcloud sat host update --host HOST --location LOCATION

Wichtige Befehle

Zeigen Sie Satellite Config-Schlüssel an und verwalten Sie sie.

ibmcloud sat key help

Hilfe anzeigen

ibmcloud sat key help

Beispiele

Hilfe anzeigen

ibmcloud sat key help

ibmcloud sat key ls

Satellite

Listen Sie alle Satellite Config-Schlüssel in Ihrem IBM Cloud-Konto auf.

ibmcloud sat key ls [--output OUTPUT] [-q]

Befehlsoptionen

--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Satellite-Konfigurationsschlüssel in Ihrem IBM Cloud-Konto auf

ibmcloud sat key ls

ibmcloud sat key rm

Satellite

Entfernen Sie einen Satellite Config-Schlüssel. Alle Cluster, der diesen Schlüssel noch verwenden, sind nicht in der Lage, eine Verbindung zu Satellite Config herzustellen.

ibmcloud sat key rm --key KEY [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--key
Der Name oder die ID eines Satellite Config-Schlüssels.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Einen Konfigurationsschlüssel für Satellite entfernen

ibmcloud sat key rm --key KEY

ibmcloud sat key rotate

Satellite

Generieren Sie einen neuen Schlüssel zur Verwendung durch verwaltete Cluster, um eine Verbindung zu Satellite Config herzustellen.

ibmcloud sat key rotate --name NAME [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--name
Der Name des neuen Satellite Config-Schlüssels.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Generieren Sie einen neuen Schlüssel, den verwaltete Cluster für die Verbindung mit Satellite-Konfiguration verwenden können

ibmcloud sat key rotate --name NAME

Standortbefehle

Satellite-Standorte erstellen, anzeigen und ändern.

ibmcloud sat location create

Satellite

Erstellen Sie einen Satellite-Standort. Ein Satellite-Standort ist eine Darstellung einer Umgebung in Ihrem Infrastrukturprovider. Nachdem Sie einen Standort erstellt haben, fügen Sie Hosts aus verschiedenen Zonen Ihrer zugrunde liegenden Infrastrukturumgebung mit dem Befehl ibmcloud sat host attach hinzu.

ibmcloud sat location create --managed-from REGION --name NAME [--capability CAPABILITY ...] [--coreos-enabled] [--cos-bucket BUCKET] [--description DESCRIPTION] [--ha-zone ZONE ...] [--physical-address ADDRESS] [--pod-network-interface-selection SELECTION] [--pod-subnet SUBNET] [--provider PROVIDER] [--provider-credential CREDENTIAL] [--provider-region REGION] [-q] [--service-subnet SUBNET]

Befehlsoptionen

--capability
Eine Funktion der Satellite-Website.
--coreos-enabled
Aktivieren Sie die CoreOS-Funktionen von Red Hat für den Satellite-Standort. Diese Aktion kann nicht rückgängig gemacht werden. Siehe https://ibm.biz/infra-os.
--cos-bucket
Geben Sie den Namen des IBM Cloud Object Storage-Buckets an, in dem die Steuerebenendaten Ihres Satellite-Standorts gespeichert werden sollen. Andernfalls wird ein neuer Bucket für Sie erstellt.
--description
Geben Sie eine Beschreibung für den Satellite-Standort ein.
--ha-zone
Geben Sie die Zone für Ihren Standort an. Um eine hohe Verfügbarkeit zu gewährleisten, geben Sie für Ihren Standort 3 Zonen an, und zwar als --ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. Die Namen der Zonen müssen genau mit den Namen der entsprechenden Zonen in Ihrem Infrastrukturprovider übereinstimmen, in dem Sie beabsichtigen, Hosts zu erstellen.
--managed-from
Wählen Sie die IBM Cloud-Region aus, von der aus Sie Ihren Satellite-Standort verwalten wollen. Wählen Sie eine Region in der Nähe Ihres lokalen Rechenzentrums aus, um eine bessere Leistung zu erhalten. Siehe https://ibm.biz/sat-region.
--name
Geben Sie einen Namen für den Satellite-Standort an. Ortsnamen müssen mit einem Buchstaben beginnen, dürfen Buchstaben, Ziffern, Punkte (.) und Bindestriche (-) enthalten und müssen kürzer als 36 Zeichen sein. Vermeiden Sie die Wiederverwendung von Namen, selbst wenn der andere Standort gelöscht wird.
--physical-address
Die physische Adresse des Satellite-Standorts.
--pod-network-interface-selection
Die Methode der Auswahl der Knotennetzschnittstelle für das interne Pod-Netz. Diese Option kann nur verwendet werden, wenn Sie zusätzlich Red Hat ( CoreOS ) mit der Option --coreos-enabled aktivieren. Um eine direkte URL oder IP-Adresse anzugeben, geben Sie can-reach=<url> oder can-reach=<ip_address> an. Geben Sie interface=<network_interface> an, um eine Netzschnittstelle auszuwählen.
--pod-subnet
Gibt ein angepasstes Teilnetz-CIDR an, um private IP-Adressen für Pods bereitzustellen. Diese Option wird nur verwendet, wenn Sie Red Hat ( CoreOS ) mit der Option --coreos-enabled aktivieren. Das Subnetz muss /23 oder größer sein. Siehe https://ibm.biz/sat-location-create. Standardwert: '172.16.0.0/16'
--provider
Geben Sie den Infrastrukturprovider an, der für den Satellite-Standort verwendet werden soll. Wenn Sie diese Option angeben, muss auch die Option --provider-credential angegeben werden. Akzeptierte Werte: aws, azure, gcp, vmware
--provider-credential
Geben Sie den Pfad zu einer JSON-Datei auf Ihrer lokalen Maschine an, in der die Berechtigungsnachweise des Infrastrukturproviders für den Satellite-Standort enthalten sind. Das Format des Berechtigungsnachweises ist vom jeweiligen Provider abhängig. Siehe http://ibm.biz/sat-infra-creds.
--provider-region
Geben Sie die Region in dem Infrastrukturprovider an, in der Sie beabsichtigen, die Hosts für den Satellite-Standort zu erstellen. Wenn Sie diese Option angeben, muss auch die Option --provider angegeben werden.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--service-subnet
Gibt ein angepasstes Teilnetz-CIDR an, um private IP-Adressen für Services bereitzustellen. Diese Option wird nur verwendet, wenn Sie Red Hat ( CoreOS ) mit der Option --coreos-enabled aktivieren. Das Subnetz muss /24 oder größer sein. Siehe https://ibm.biz/sat-location-create. Standardwert: 172.20.0.0/16

Beispiele

Satellite-Standort erstellen

ibmcloud sat location create --managed-from REGION --name NAME

ibmcloud sat location dns get

Satellite

Zeigen Sie die Details einer registrierten Unterdomäne an einer Satellite -Position an.

ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN [--output OUTPUT] [-q]

Befehlsoptionen

--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subdomain
Geben Sie den Namen der Unterdomäne an. Führen Sie ibmcloud sat location dns ls --location <ID> aus, um vorhandene Unterdomänen aufzulisten.

Beispiele

Details zu einer registrierten Subdomain in einem Satellite-Standort anzeigen

ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN

ibmcloud sat location dns help

Hilfe anzeigen

ibmcloud sat location dns help

Beispiele

Hilfe anzeigen

ibmcloud sat location dns help

ibmcloud sat location dns ls

Satellite

Listen Sie registrierte Unterdomänen an einem Satellite-Standort auf.

ibmcloud sat location dns ls --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Auflistung der registrierten Subdomains an einem Satellite-Standort

ibmcloud sat location dns ls --location LOCATION

ibmcloud sat location dns register

Satellite

Legen Sie eine Unterdomäne für die Hosts fest, die der Steuerebene an einem Satellite-Standort zugewiesen sind.

ibmcloud sat location dns register --ip IP [--ip IP ...] --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--ip
Geben Sie die IP-Adresse für jeden Control-Plane-Host im Format an --ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Verwenden Sie für Mehrzonencluster eine IP-Adresse aus jeder Zone. Um die IP-Adresse zu ermitteln, führen Sie aus und ibmcloud sat host ls --location <location_ID_or_name> suchen Sie nach Worker IP für Hosts mit der Bezeichnung infrastructure.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Legen Sie eine Subdomain für die Hosts fest, die der Control Plane an einem Standort von Satellite zugewiesen sind

ibmcloud sat location dns register --ip IP --location LOCATION

ibmcloud sat location get

Satellite

Details zu einem Satellite-Standort anzeigen.

ibmcloud sat location get --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details zu einem Satellite-Standort anzeigen

ibmcloud sat location get --location LOCATION

ibmcloud sat location help

Hilfe anzeigen

ibmcloud sat location help

Beispiele

Hilfe anzeigen

ibmcloud sat location help

ibmcloud sat location ls

Satellite

Alle Satellite-Standorte in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat location ls [--output OUTPUT] [-q]

Befehlsoptionen

--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Satellite-Standorte in Ihrem IBM Cloud-Konto auf

ibmcloud sat location ls

ibmcloud sat location rm

Satellite

Löschen Sie einen Standort. Bevor Sie diesen Befehl ausführen, sollten Sie Ihre Konfigurationen sichern und alle Hosts und Cluster entfernen, die an diesem Standort ausgeführt werden. Beim Löschen eines Standorts wird die zugrunde liegende Hostinfrastruktur nicht automatisch auch gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.

ibmcloud sat location rm --location LOCATION [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Standort löschen

ibmcloud sat location rm --location LOCATION

ibmcloud sat location update

Satellite

Aktualisieren Sie den Namen oder die Beschreibung eines Satellite-Standorts.

ibmcloud sat location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]

Befehlsoptionen

--description
Geben Sie eine neue Beschreibung für den Standort Satellite ein. Die Länge der Beschreibung ist auf 400 Byte begrenzt.
--location-id
Die ID des Speicherorts Satellite. Um die Standort-ID zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Geben Sie einen neuen Namen für den Speicherort Satellite an. Ortsnamen müssen mit einem Buchstaben beginnen, dürfen Buchstaben, Ziffern, Punkte (.) und Bindestriche (-) enthalten und müssen kürzer als 36 Zeichen sein. Verwenden Sie keine Namen wieder, auch nicht die Namen von gelöschten Orten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Den Namen oder die Beschreibung eines Satellite-Standorts aktualisieren

ibmcloud sat location update --location-id ID

Befehle für Nachrichten

Zeigt die aktuellen Benutzernachrichten an.

ibmcloud sat messages

Virtual Private Cloud Classic infrastructure Satellite

Zeigt die aktuellen Benutzernachrichten an.

ibmcloud sat messages [-q]

Befehlsoptionen

-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Aktuelle Benutzermeldungen anzeigen

ibmcloud sat messages

Ressourcenbefehle

Suchen Sie nach Kubernetes-Ressourcen, die von einer Satellite-Konfiguration verwaltet werden, und zeigen Sie diese an.

ibmcloud sat resource get

Satellite

Zeigen Sie die Details einer Kubernetes-Ressource an, die von einer Satellite-Konfiguration verwaltet wird.

ibmcloud sat resource get --resource RESOURCE [--history HISTORY] [--output OUTPUT] [-q] [--save-data]

Befehlsoptionen

--history
Die Protokoll-ID für die Ressource.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--resource
Geben Sie die ID der Kubernetes-Ressource an. Um Kubernetes-Ressourcen zu finden, führen Sie folgenden Befehl aus: ibmcloud sat resource ls.
--save-data
Eine Kubernetes-Ressourcendefinition in eine temporäre Datei herunterladen und speichern.

Beispiele

Details zu einer Kubernetes-Ressource anzeigen, die von einer Satellite-Konfiguration verwaltet wird

ibmcloud sat resource get --resource RESOURCE

ibmcloud sat resource help

Hilfe anzeigen

ibmcloud sat resource help

Beispiele

Hilfe anzeigen

ibmcloud sat resource help

ibmcloud sat resource history get

Satellite

Verlauf für eine Kubernetes-Ressource abrufen.

ibmcloud sat resource history get --resource RESOURCE [--limit LIMIT] [--output OUTPUT] [-q]

Befehlsoptionen

--limit
Geben Sie die maximale Anzahl von Protokolleinträgen an, die zurückgegeben werden sollen.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--resource
Die Kubernetes-Ressourcen-ID.

Beispiele

Verlauf einer Kubernetes-Ressource abrufen

ibmcloud sat resource history get --resource RESOURCE

ibmcloud sat resource history help

Hilfe anzeigen

ibmcloud sat resource history help

Beispiele

Hilfe anzeigen

ibmcloud sat resource history help

ibmcloud sat resource ls

Satellite

Von Satellite verwaltete Kubernetes-Ressourcen durchsuchen.

ibmcloud sat resource ls [--limit LIMIT] [--output OUTPUT] [-q] [--search SEARCH] (--cluster CLUSTER | --subscription SUBSCRIPTION)

Befehlsoptionen

-c, --cluster
Geben Sie den Namen oder die ID des registrierten Clusters an, in dem die Kubernetes-Ressource ausgeführt wird. Um registrierte Cluster zu finden, führen Sie folgenden Befehl aus: ibmcloud sat cluster ls.
--limit
Geben Sie die maximale Anzahl von Ressourceneinträgen an, die von der Suche zurückgegeben werden sollen.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--search
Geben Sie die Zeichenfolge zum Filtern der Suchergebnisse von Kubernetes-Ressourcen an, z. B. den Namen eines Pods oder eines Namensbereichs.
--subscription
Geben Sie die ID oder den Namen des Satellite-Abonnements an. Um Abonnements zu finden, führen Sie folgenden Befehl aus ibmcloud sat cluster ls:.

Beispiele

Suchen Sie nach Ressourcen im Kubernetes, die von Satellite verwaltet werden

ibmcloud sat resource ls --cluster CLUSTER

'Service'-Befehle

Satellite-Servicecluster anzeigen.

ibmcloud sat service help

Hilfe anzeigen

ibmcloud sat service help

Beispiele

Hilfe anzeigen

ibmcloud sat service help

ibmcloud sat service ls

Satellite

Listen Sie alle Satellite-Service-Cluster an Ihrem Standort auf, um Details, wie z. B. angeforderte Hostressourcen, zu überprüfen.

ibmcloud sat service ls --location LOCATION [--output OUTPUT] [-q]

Befehlsoptionen

--location
Der Name oder die ID des Satellite-Standorts. Um die Standort-ID oder den Namen zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Satellite-Service-Cluster an Ihrem Standort auf, um Details wie die angeforderten Host-Ressourcen zu überprüfen

ibmcloud sat service ls --location LOCATION

Speicherbefehle

Satellite-Speicherressourcen anzeigen und verwalten.

ibmcloud sat storage assignment autopatch disable

Der Befehl storage assignment autopatch disable ist ein Beta-Feature.

Satellite

Deaktivieren Sie automatische Patches für eine Satellite-Speicherzuweisung.

ibmcloud sat storage assignment autopatch disable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)

Befehlsoptionen

--all
Automatische Patches für alle Satellite-Speicherzuordnungen einer Speicherkonfiguration inaktivieren.
--assignment
Die ID einer Satellite-Speicherzuweisung. Um die verfügbaren Speicherzuweisungen der Konfiguration aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage assignment ls --config CONFIG.
--config
Der Name oder die ID einer Satellite-Speicherkonfiguration. Führen Sie ibmcloud sat storage config ls aus, um die verfügbaren Speicherkonfigurationen aufzulisten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Automatische Patches für eine Satellite-Speicherzuweisung deaktivieren

ibmcloud sat storage assignment autopatch disable --config CONFIG --all

ibmcloud sat storage assignment autopatch enable

Der Befehl storage assignment autopatch enable ist ein Beta-Feature.

Satellite

Aktivieren Sie automatische Patches für eine Satellite-Speicherzuweisung.

ibmcloud sat storage assignment autopatch enable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)

Befehlsoptionen

--all
Automatische Patches für alle Satellite-Speicherzuordnungen einer Speicherkonfiguration aktivieren.
--assignment
Die ID einer Satellite-Speicherzuweisung. Um die verfügbaren Speicherzuweisungen der Konfiguration aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage assignment ls --config CONFIG.
--config
Der Name oder die ID einer Satellite-Speicherkonfiguration. Führen Sie ibmcloud sat storage config ls aus, um die verfügbaren Speicherkonfigurationen aufzulisten.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Automatische Patches für eine Satellite-Speicherzuweisung aktivieren

ibmcloud sat storage assignment autopatch enable --config CONFIG --all

ibmcloud sat storage assignment autopatch help

Hilfe anzeigen

ibmcloud sat storage assignment autopatch help

Beispiele

Hilfe anzeigen

ibmcloud sat storage assignment autopatch help

ibmcloud sat storage assignment create

Satellite

Abonnement erstellen, um Speicherkonfigurationen in den Clustern an Ihrem Satellite-Standort bereitzustellen.

ibmcloud sat storage assignment create --config CONFIG [--name NAME] [-q] (--cluster CLUSTER | --group GROUP | --service-cluster-id CLUSTER)

Befehlsoptionen

-c, --cluster
Geben Sie die ID des Satellite-Clusters für die Zuweisung an. Führen Sie ibmcloud oc cluster ls --provider satellite aus, um die Cluster-ID zu suchen.
--config
Geben Sie die Satellite-Speicherkonfiguration für die Zuweisung an. Um Konfigurationen zu suchen, führen Sie ibmcloud sat storage config ls aus.
-g, --group
Geben Sie die Clustergruppen für die Zuweisung an. Um Clustergruppen zu finden, führen Sie folgenden Befehl aus: ibmcloud sat group ls.
--name
Geben Sie einen Namen für die Zuweisung von Satellite-Speicher an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--service-cluster-id
Geben Sie die ID des Service-Clusters für die Zuweisung an. Um die Service-Cluster-ID zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat service ls --location <location>.

Beispiele

Erstellen Sie einen Auftrag, um Ihre Speicherkonfigurationen in Clustern an Ihrem Satellite-Standort bereitzustellen

ibmcloud sat storage assignment create --config CONFIG --cluster CLUSTER

ibmcloud sat storage assignment get

Satellite

Details einer Zuweisung von Satellite-Speicher abrufen.

ibmcloud sat storage assignment get --assignment ASSIGNMENT [--output OUTPUT] [-q]

Befehlsoptionen

--assignment
Geben Sie die ID einer Satellite-Speicherzuweisung an.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erfahren Sie mehr über eine Speicherzuweisung in Satellite

ibmcloud sat storage assignment get --assignment ASSIGNMENT

ibmcloud sat storage assignment help

Hilfe anzeigen

ibmcloud sat storage assignment help

Beispiele

Hilfe anzeigen

ibmcloud sat storage assignment help

ibmcloud sat storage assignment ls

Satellite

Satellite-Speicherzuweiungen in Ihrem IBM Cloud-Konto auflisten.

So listen Sie als Serviceadministrator alle Zuweisungen für einen Servicecluster auf: ibmcloud sat storage assignment ls--service-cluster-id CLUSTER.

So listen Sie als Standortadministrator alle Zuweisungen für einen Servicecluster auf: ibmcloud sat storage assignment ls--location STANDORT--service-cluster-id CLUSTER.

So listen Sie alle Zuweisungen für eine Konfiguration auf: ibmcloud sat storage assignment ls --config CONFIG.

ibmcloud sat storage assignment ls [--output OUTPUT] [-q] (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

Befehlsoptionen

-c, --cluster
Geben Sie die ID des Satellite-Clusters für die Zuweisungen an. Um die Cluster-ID abzurufen, führen Sie folgenden Befehl aus: ibmcloud oc cluster ls --provider satellite.
--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Führen Sie ibmcloud sat storage config ls aus, um die verfügbaren Speicherkonfigurationen aufzulisten.
--location
Geben Sie den Namen eines Satellite-Standorts an. Um die verfügbaren Standorte aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat location ls. Diese Option kann nicht vom Serviceadministrator verwendet werden.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--service-cluster-id
Geben Sie die ID des Service-Clusters für die Zuweisungen an. Um die Service-Cluster-ID zu ermitteln, führen Sie folgenden Befehl aus: ibmcloud sat service ls --location <location>.

Beispiele

Listen Sie die Satellite-Speicherzuweisungen in Ihrem IBM Cloud-Konto auf

ibmcloud sat storage assignment ls --cluster CLUSTER

ibmcloud sat storage assignment patch

Satellite

Wenden Sie Speicherkonfigurationsänderungen auf die zugeordneten Zuordnungen an.

ibmcloud sat storage assignment patch --assignment ASSIGNMENT [-f] [-q]

Aliasnamen: ibmcloud sat upgrade

Befehlsoptionen

--assignment
Geben Sie die ID einer Satellite-Speicherzuweisung an. Um die verfügbaren Aufgaben aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage assignment ls.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Speicherkonfigurationsänderungen auf die zugehörigen Zuweisungen anwenden

ibmcloud sat storage assignment patch --assignment ASSIGNMENT

ibmcloud sat storage assignment rm

Satellite

Entfernt eine Satellite-Speicherzuweisung. Die Kubernetes-Ressourcen werden aus allen Clustern an Ihrem Satellite-Standort gelöscht; die Konfiguration bleibt jedoch bestehen.

ibmcloud sat storage assignment rm --assignment ASSIGNMENT [-f] [-q]

Befehlsoptionen

--assignment
Geben Sie die ID einer Satellite-Speicherzuweisung an. Um Aufgaben zu finden, führen Sie folgenden Befehl aus: ibmcloud sat storage assignment ls.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Eine Speicherzuweisung für Satellite entfernen

ibmcloud sat storage assignment rm --assignment ASSIGNMENT

ibmcloud sat storage assignment update

Satellite

Satellite-Speicherzuweisung aktualisieren.

ibmcloud sat storage assignment update --assignment ASSIGNMENT [-f] [--group GROUP ...] [--name NAME] [-q]

Befehlsoptionen

--assignment
Geben Sie die ID einer Satellite-Speicherzuweisung an.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-g, --group
Geben Sie die neuen Clustergruppen für die Zuweisung an. Um die verfügbaren Gruppen aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat group ls.
--name
Geben Sie einen neuen Namen für die Zuweisung von Satellite-Speicher an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Eine Speicherzuweisung in Satellite aktualisieren

ibmcloud sat storage assignment update --assignment ASSIGNMENT

ibmcloud sat storage config class add

Satellite

Erstellen Sie eine angepasste Satellite-Speicherklasse.

ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM [--param PARAM ...] [-q]

Befehlsoptionen

--config-name
Geben Sie den Namen der Speicherkonfiguration für die angepasste Speicherklasse an. Um die Speicherkonfigurationen von Satellite aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat storage config ls:.
--name
Geben Sie einen Namen für die angepasste Speicherklasse an.
-p, --param
Geben Sie ein Paar key=value für die Speicherklassenparameter an. Um die Parameter der Speicherklasse in einer Speichervorlage anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat storage template get.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erstellen einer benutzerdefinierten Speicherklasse für Satellite

ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM

ibmcloud sat storage config class get

Satellite

Details einer Satellite-Speicherklasse abrufen.

ibmcloud sat storage config class get --class CLASS --config CONFIG [--output OUTPUT] [-q]

Befehlsoptionen

--class
Geben Sie den Namen einer Satellite-Speicherklasse an.
--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Um die Speicherkonfigurationen von Satellite aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat storage config ls:.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erfahren Sie mehr über die Speicherklasse Satellite

ibmcloud sat storage config class get --class CLASS --config CONFIG

ibmcloud sat storage config class help

Hilfe anzeigen

ibmcloud sat storage config class help

Beispiele

Hilfe anzeigen

ibmcloud sat storage config class help

ibmcloud sat storage config class ls

Satellite

Speicherklassen in einer Satellite-Speicherkonfiguration auflisten

ibmcloud sat storage config class ls --config CONFIG [--output OUTPUT] [-q] [--show-params]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Um die Speicherkonfigurationen von Satellite aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat storage config ls:.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--show-params
Beziehen Sie diese Option ein, um alle Speicherklassen-Parameterdetails aufzulisten.

Beispiele

Speicherklassen in einer Satellite-Speicherkonfiguration auflisten

ibmcloud sat storage config class ls --config CONFIG

ibmcloud sat storage config create

Satellite

Satellit-Speicherkonfiguration erstellen, um die Speichertreiber ihres Clusters zu installieren.

ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME [--param PARAM ...] [-q] [--template-version VERSION]

Befehlsoptionen

--location
Geben Sie die ID oder den Namen des Standorts für die Speicherkonfiguration ein. Um verfügbare Standorte zu finden, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--name
Geben Sie den Namen der Speicherkonfiguration an.
-p, --param
Geben Sie ein Paar key=value für Konfigurationsparameter an. Um die Konfigurationsparameter in einer Speicher-Vorlage anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat storage template get.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--template-name
Gibt den Vorlagennamen für die Satellite-Speicherkonfiguration an. Um die verfügbaren Vorlagen für Speicherkonfigurationen aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage template ls.
--template-version
Gibt die Vorlagenversion für die Satellite-Speicherkonfiguration an. Wenn Sie diese Option nicht einschließen, wird die Standardversion verwendet. Um die verfügbaren Vorlagen für Speicherkonfigurationen aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage template ls.

Beispiele

Erstellen Sie eine Satellite-Speicherkonfiguration, um Speichertreiber in Ihren Clustern zu installieren

ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME

ibmcloud sat storage config get

Satellite

Details einer Satellite-Speicherkonfiguration abrufen.

ibmcloud sat storage config get --config CONFIG [--output OUTPUT] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Führen Sie den Befehl ibmcloud sat storage config ls aus, um die verfügbaren Konfigurationen aufzulisten.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erfahren Sie mehr über die Speicherkonfiguration von Satellite

ibmcloud sat storage config get --config CONFIG

ibmcloud sat storage config help

Hilfe anzeigen

ibmcloud sat storage config help

Beispiele

Hilfe anzeigen

ibmcloud sat storage config help

ibmcloud sat storage config ls

Satellite

Satellite-Speicherkonfigurationen in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat storage config ls [--location LOCATION] [--output OUTPUT] [-q]

Befehlsoptionen

--location
Geben Sie die ID oder den Namen des Standorts an, der die aufzulistenden Konfigurationen enthält. Um verfügbare Standorte zu finden, führen Sie folgenden Befehl aus: ibmcloud sat location ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie die Satellite-Speicherkonfigurationen in Ihrem IBM Cloud-Konto auf

ibmcloud sat storage config ls

ibmcloud sat storage config param help

Hilfe anzeigen

ibmcloud sat storage config param help

Beispiele

Hilfe anzeigen

ibmcloud sat storage config param help

ibmcloud sat storage config param set

Satellite

Legen Sie die Konfiguration und Parameter für die geheimen Schlüssel einer Satellite-Speicherkonfiguration fest.

ibmcloud sat storage config param set --config CONFIG --param PARAM [--param PARAM ...] [--apply] [-f] [-q]

Befehlsoptionen

--apply
Wenden Sie die neueste Version der Satellite-Speicherkonfiguration auf alle Zuordnungen einer Konfiguration an. Um die Zuordnungen einer Konfiguration aufzulisten, führen Sie folgenden Befehl aus: ibmcloud sat storage assignment ls --config CONFIG.
--config
Geben Sie den Namen oder die ID der Speicherkonfiguration an. Um die Speicherkonfigurationen von Satellite aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat storage config ls:.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-p, --param
Geben Sie ein Paar key=value für Konfigurationsparameter an. Um die Konfigurationsparameter in einer Speicher-Vorlage anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat storage template get.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Konfigurieren Sie die Konfigurations- und Geheimparameter einer Satellite-Speicherkonfiguration

ibmcloud sat storage config param set --config CONFIG --param PARAM

ibmcloud sat storage config patch

Satellite

Wenden Sie die neuesten Patch-Updates auf eine Satellite-Speicherkonfiguration an. Patch-Updates enthalten Korrekturen von Sicherheitslücken und Fehlerkorrekturen innerhalb derselben Hauptversion.

ibmcloud sat storage config patch --config CONFIG [-f] [--include-assignments] [-q]

Aliasnamen: ibmcloud sat upgrade

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Führen Sie den Befehl ibmcloud sat storage config ls aus, um die verfügbaren Konfigurationen aufzulisten.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--include-assignments
Fügen Sie diese Option hinzu, um die Zuordnungen der Speicherkonfiguration auf die neueste Konfigurationsversion zu aktualisieren.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Wenden Sie die neuesten Patch-Updates auf eine Satellite-Speicherkonfiguration an

ibmcloud sat storage config patch --config CONFIG

ibmcloud sat storage config rm

Satellite

Eine Satellite-Speicherkonfiguration entfernen.

ibmcloud sat storage config rm --config CONFIG [-f] [--include-assignments] [-q]

Befehlsoptionen

--config
Geben Sie den Namen oder die ID einer Satellite-Speicherkonfiguration an. Führen Sie den Befehl ibmcloud sat storage config ls aus, um die verfügbaren Konfigurationen aufzulisten.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--include-assignments
Schließen Sie diese Option ein, um die Speicherkonfiguration sowie alle zugehörigen Zuordnungen zu entfernen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Eine Satellite-Speicherkonfiguration entfernen

ibmcloud sat storage config rm --config CONFIG

ibmcloud sat storage help

Hilfe anzeigen

ibmcloud sat storage help

Beispiele

Hilfe anzeigen

ibmcloud sat storage help

ibmcloud sat storage template get

Satellite

Details einer Satellite-Speichervorlage abrufen.

ibmcloud sat storage template get --name NAME --version VERSION [--output OUTPUT] [-q]

Befehlsoptionen

--name
Name der Speichervorlage angeben. Um die verfügbaren Speichervorlagen aufzulisten, führen Sie den folgenden Befehl aus: ibmcloud sat storage template ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--version
Version der Speichervorlage angeben. Um die verfügbaren Speichervorlagen aufzulisten, führen Sie den folgenden Befehl aus: ibmcloud sat storage template ls.

Beispiele

Details einer Satellite-Speichervorlage abrufen.

ibmcloud sat storage template get --name NAME --version VERSION

ibmcloud sat storage template help

Hilfe anzeigen

ibmcloud sat storage template help

Beispiele

Hilfe anzeigen

ibmcloud sat storage template help

ibmcloud sat storage template ls

Satellite

Verfügbare Satellite-Speichervorlagen auflisten.

ibmcloud sat storage template ls [-q]

Befehlsoptionen

-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Auflistung der verfügbaren Speicher-Vorlagen für Satellite

ibmcloud sat storage template ls

Subskriptionsbefehle

Satellite-Abonnements anzeigen und verwalten, um Kubernetes-Konfigurationsdateien in Ihren Clustern bereitzustellen.

ibmcloud sat subscription create

Satellite

Erstellen Sie ein Satellite-Abonnement für Cluster. Nach der Erstellung des Abonnements wird die zugehörige Satellite-Konfigurationsversion automatisch auf den abonnierten Clustern bereitgestellt.

ibmcloud sat subscription create --config CONFIG --group GROUP [--group GROUP ...] --name NAME [-q] (--auth-required --gitref GITREF --gitref-type TYPE --path PATH --repository REPOSITORY | --version VERSION)

Befehlsoptionen

--auth-required
Geben Sie den geheimen Schlüssel für die Authentifizierung an, der für die Herstellung einer Verbindung zum fernen Repository erforderlich ist. Details hierzu finden Sie unter https://ibm.biz/sat-config-private-repo. Strategie: GitOps.
--config
Geben Sie den Namen der Konfiguration an, die für das Abonnement verwendet werden soll. Um verfügbare Konfigurationen zu finden, führen Sie folgenden Befehl aus: ibmcloud sat config ls.
-g, --group
Geben Sie den Namen oder die ID der Clustergruppen an, die Ihre Konfiguration abonnieren sollen. Um verfügbare Clustergruppen zu finden, führen Sie folgenden Befehl aus: ibmcloud sat group ls.
--gitref
Geben Sie die GitRef an, die für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--gitref-type
Geben Sie den Typ von GitRef an, der für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps. Zulässige Werte: branch, commit, tag, release
--name
Geben Sie einen Namen für das Abonnement ein.
--path
Geben Sie den Pfad zu den Repository-Dateien oder Release-Assets im fernen Repository an, die für das Satellite-Abonnement verwendet werden sollen. Strategie: GitOps.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--repository
Geben Sie die URL des fernen Repositorys an, das für das Abonnement verwendet wird. Strategie: GitOps.
--version
Geben Sie den Namen oder die ID der vorhandenen Konfigurationsversion an, die für das Abonnement verwendet werden soll. Um Versionen zu finden, führen Sie folgenden Befehl aus: ibmcloud sat config get --config <configuration_name_or_ID>. Strategie: Direkter Upload.

Beispiele

Erstellen Sie ein Satellite-Abonnement für Cluster

ibmcloud sat subscription create \
  --config CONFIG \
  --group GROUP \
  --name NAME \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY

ibmcloud sat subscription get

Satellite

Detaillierte Informationen für ein Satellite-Abonnement abrufen.

ibmcloud sat subscription get --subscription SUBSCRIPTION [--output OUTPUT] [-q]

Befehlsoptionen

--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subscription
Geben Sie den Namen oder die ID eines Satellite-Abonnements ein. Um Abonnements zu finden, führen Sie folgenden Befehl aus ibmcloud sat subscription ls:.

Beispiele

Erhalten Sie detaillierte Informationen zum Satellite-Abonnement

ibmcloud sat subscription get --subscription SUBSCRIPTION

ibmcloud sat subscription help

Hilfe anzeigen

ibmcloud sat subscription help

Beispiele

Hilfe anzeigen

ibmcloud sat subscription help

ibmcloud sat subscription identity help

Hilfe anzeigen

ibmcloud sat subscription identity help

Beispiele

Hilfe anzeigen

ibmcloud sat subscription identity help

ibmcloud sat subscription identity set

Satellite

Aktualisieren Sie das Satellite-Abonnement, um Ihre Identität zur Verwaltung von Ressourcen zu nutzen.

ibmcloud sat subscription identity set --subscription SUBSCRIPTION [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subscription
Geben Sie den Namen oder die ID eines Satellite-Abonnements an. Um Abonnements aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat subscription ls:.

Beispiele

Aktualisieren Sie das Satellite-Abonnement, um Ressourcen mit Ihrer Identität zu verwalten

ibmcloud sat subscription identity set --subscription SUBSCRIPTION

ibmcloud sat subscription ls

Satellite

Alle Satellite-Abonnements in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat subscription ls [--cluster CLUSTER] [--output OUTPUT] [-q]

Befehlsoptionen

-c, --cluster
Gibt den Satellite-Clusternamen oder die Satellite-Cluster-ID an. Um registrierte Cluster zu finden, führen Sie folgenden Befehl aus: ibmcloud sat cluster ls.
--output
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Alle Satellite-Abonnements in Ihrem IBM Cloud-Konto auflisten

ibmcloud sat subscription ls

ibmcloud sat subscription rm

Satellite

Satellite-Abonnement entfernen. Die Kubernetes-Ressourcen werden nicht mehr in Ihren Clustern bereitgestellt.

ibmcloud sat subscription rm --subscription SUBSCRIPTION [-f] [-q]

Befehlsoptionen

-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subscription
Geben Sie den Namen oder die ID eines Satellite-Abonnements ein. Um Abonnements aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat subscription ls:.

Beispiele

Ein Satellite-Abonnement kündigen

ibmcloud sat subscription rm --subscription SUBSCRIPTION

ibmcloud sat subscription update

Satellite

Satellite-Abonnement aktualisieren.

ibmcloud sat subscription update --subscription SUBSCRIPTION [-f] [--group GROUP] [--name NAME] [-q] (--auth-required --gitref GITREF --gitref-type TYPE --path PATH --repository REPOSITORY | --version VERSION)

Befehlsoptionen

--auth-required
Geben Sie den geheimen Schlüssel für die Authentifizierung an, der für die Herstellung einer Verbindung zum fernen Repository erforderlich ist. Strategie: GitOps.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
-g, --group
Geben Sie die neuen Clustergruppen an, die Ihre Konfiguration abonnieren sollen.
--gitref
Geben Sie die GitRef an, die für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--gitref-type
Geben Sie den Typ von GitRef an, der für dieses Satellite-Abonnement verwendet werden soll. Strategie: GitOps. Zulässige Werte: branch, commit, tag, release
--name
Geben Sie einen neuen Namen für das Satellite-Abonnement ein.
--path
Geben Sie den Pfad zu den Repository-Dateien oder Release-Assets im fernen Repository an, die für das Satellite-Abonnement verwendet werden sollen. Strategie: GitOps.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--repository
Geben Sie die URL des fernen Repositorys an, das für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--subscription
Geben Sie den Namen oder die ID eines Satellite-Abonnements an. Um Abonnements aufzulisten, führen Sie folgenden Befehl aus ibmcloud sat subscription ls:.
--version
Geben Sie die vorhandene Konfigurationsversion an, die für das Satellite-Abonnement verwendet werden soll. Strategie: Direkter Upload.

Beispiele

Ein Satellite-Abonnement aktualisieren

ibmcloud sat subscription update \
  --subscription SUBSCRIPTION \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY