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.

Voraussetzungen

  • Installieren Sie die IBM Cloud-CLI.

  • Installieren Sie das Plug-in ks, indem Sie den folgenden Befehl ausführen:

    ibmcloud plugin install ks
    

ibmcloud sat-Befehle

In den folgenden Tabellen sind die ibmcloud sat-Befehlsgruppen aufgelistet. Eine vollständige Liste aller Befehle ibmcloud sat in der Struktur der CLI finden Sie in der CLI-Übersicht.

ibmcloud sat – CLI-Befehlsgruppen
Befehlsgruppe Beschreibung
ibmcloud sat connector Satellite-Connectors erstellen, anzeigen und ändern.
ibmcloud sat location Satellite-Standorte erstellen, anzeigen und ändern.
ibmcloud sat endpoint Satellite-Endpunkte anzeigen und verwalten.
ibmcloud sat acl Satellite-Zugriffskontrolllisten (ACLs) anzeigen und verwalten.
ibmcloud sat agent Satellite-Connector-Agenten anhängen oder anzeigen.
ibmcloud sat host Zeigen Sie Satellite-Hosts an und nehmen Sie Änderungen an ihnen vor.
ibmcloud sat cluster Registrieren und verwalten Sie Cluster für die Verwendung mit Satellite-Konfigurationen.
ibmcloud sat messages Zeigt die aktuellen Benutzernachrichten an.
ibmcloud sat group Satellite-Clustergruppen anzeigen und verwalten. Clustergruppen werden verwendet, um Cluster für Satellite-Konfigurationen von Kubernetes-Ressourcen zu abonnieren.
ibmcloud sat key Zeigen Sie Satellite Config-Schlüssel an und verwalten Sie sie.
ibmcloud sat config Satellite-Konfiguration anzeigen und verwalten.
ibmcloud sat resource Suchen Sie nach Kubernetes-Ressourcen, die von einer Satellite-Konfiguration verwaltet werden, und zeigen Sie diese an.
ibmcloud sat service Satellite-Servicecluster anzeigen.
ibmcloud sat storage Satellite-Speicherressourcen anzeigen und verwalten.
ibmcloud sat subscription Satellite-Abonnements anzeigen und verwalten, um Kubernetes-Konfigurationsdateien in Ihren Clustern bereitzustellen.

ibmcloud sat acl-Befehle

Satellite-Zugriffskontrolllisten (ACLs) anzeigen und verwalten.

ibmcloud sat acl create

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--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.
--name NAME
Der Name der ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subnet 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

Erstellen Sie eine ACL.

ibmcloud sat acl create --location LOCATION --connector-id CONNECTOR_ID --name NAME

ibmcloud sat acl endpoint add

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 ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--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

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

ibmcloud sat acl endpoint add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl endpoint ls

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 ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 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 \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl endpoint rm

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 ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL deaktiviert werden soll.
--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

Entfernen Sie einen oder mehrere aktivierte Endpunkte aus einer ACL.

ibmcloud sat acl endpoint rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl get

Details einer ACL anzeigen.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details einer ACL anzeigen.

ibmcloud sat acl get --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID

ibmcloud sat acl ls

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 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 --location LOCATION --connector-id CONNECTOR_ID --output json

ibmcloud sat acl rm

Eine ACL löschen.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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

Eine ACL löschen.

ibmcloud sat acl rm --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID

ibmcloud sat acl subnet add

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 ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--subnet 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

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

ibmcloud sat acl subnet add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl subnet rm

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 ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--subnet 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

Entfernen Sie ein oder mehrere Subnetze aus einer ACL.

ibmcloud sat acl subnet rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl update

Aktualisieren Sie den Namen einer ACL.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--name NAME
Der neue Name für die ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Aktualisieren Sie den Namen einer ACL.

ibmcloud sat acl update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

Befehle für den IBM Cloud SAT-Agenten

Satellite-Connector-Agenten anhängen oder anzeigen.

ibmcloud sat agent attach

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

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

Befehlsoptionen

--platform 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

Laden Sie einen „ Satellite “-Connector-Agenten für eine bestimmte Plattform herunter.

ibmcloud sat agent attach --platform PLATFORM -q

ibmcloud sat agent ls

Alle Agenten für einen „ Satellite “-Konnektor auflisten.

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

Befehlsoptionen

--connector-id ID
Die ID eines Satellite-Connectors.
--output 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 CONNECTOR_ID --output json -q

ibmcloud sat cluster-Befehle

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

ibmcloud sat cluster get

Virtual Private Cloud Klassische Infrastruktur Satellite

Rufen Sie die Details eines registrierten Clusters ab.

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

Befehlsoptionen

--cluster CLUSTER, -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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Rufen Sie die Details eines registrierten Clusters ab.

ibmcloud sat cluster get --cluster CLUSTER_NAME_OR_ID --output json -q

ibmcloud sat cluster ls

Virtual Private Cloud Klassische Infrastruktur 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 FILTER
Filtern Sie registrierte Cluster nach Cluster-ID.
--limit LIMIT
Begrenzt die Anzahl der zurückgegebenen Cluster.
--output 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 --filter FILTER --limit LIMIT --output json

ibmcloud sat cluster register

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 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

Rufen Sie einen Befehl kubectl auf, um Ihren Cluster in einer Satellite-Konfiguration zu registrieren.

ibmcloud sat cluster register --silent SILENT --name NAME -q

ibmcloud sat cluster unregister

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

--cluster CLUSTER, -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

Entfernen Si eine Clusterregistrierung.

ibmcloud sat cluster unregister --cluster CLUSTER_NAME_OR_ID -f -q

ibmcloud sat config-Befehle

Satellite-Konfiguration anzeigen und verwalten.

ibmcloud sat config create

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 LOCATION
Geben Sie die IBM-Region an, in der die Daten der Satellite-Konfiguration gespeichert werden sollen. Strategie: Direkter Upload.
--name NAME
Geben Sie einen Namen für die Satellite-Konfiguration an.
--provider 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 in Ihrer Satellite-Workload bereitstellen möchten.

ibmcloud sat config create \
  --name NAME \
  --data-location LOCATION \
  --provider PROVIDER_ID

ibmcloud sat config get

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 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

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

ibmcloud sat config get --config CONFIG --output json -q

ibmcloud sat config ls

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

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat config ls --output json -q

ibmcloud sat config rename

Satellite-Konfiguration umbenennen.

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

Befehlsoptionen

--config 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 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 -q

ibmcloud sat config rm

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 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 -f -q

ibmcloud sat config version create

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 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 DESCRIPTION
Fügen Sie eine Beschreibung für die Version der Satellite-Konfiguration hinzu.
--file-format FORMAT
Geben Sie das Dateiformat der Konfigurationsversion an. Verfügbare Optionen: yaml
--name NAME
Geben Sie einen Namen für die Version der Satellite-Konfiguration an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--read-config CONFIG
Geben Sie den Dateipfad für die Datei mit der Konfigurationsversion an.

Beispiele

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

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

ibmcloud sat config version get

Detaillierte Informationen zu einer Satellite-Konfigurationsversion abrufen.

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

Befehlsoptionen

--config 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 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 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

Detaillierte Informationen zu einer Satellite-Konfigurationsversion abrufen.

ibmcloud sat config version get \
  --config CONFIG \
  --version VERSION \
  --save-config SAVE-CONFIG

ibmcloud sat config version rm

Satellite-Konfigurationsversion entfernen.

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

Befehlsoptionen

--config 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 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

Satellite-Konfigurationsversion entfernen.

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

Befehle für den IBM Cloud SAT-Connector

Satellite-Connectors erstellen, anzeigen und ändern.

ibmcloud sat connector create

Erstellen Sie einen Satellite-Connector.

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

Befehlsoptionen

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

Beispiele

Erstellen Sie einen Satellite-Connector.

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

ibmcloud sat connector get

Details eines Satellite-Connectors anzeigen.

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

Befehlsoptionen

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

Beispiele

Details eines Satellite-Connectors anzeigen.

ibmcloud sat connector get --connector-id CONNECTOR_ID --output json -q

ibmcloud sat connector ls

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

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat connector ls --after AFTER --first FIRST --output json

ibmcloud sat connector rm

Löschen Sie einen Satellite-Connector.

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

Befehlsoptionen

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

Beispiele

Löschen Sie einen Satellite-Connector.

ibmcloud sat connector rm --connector-id CONNECTOR_ID -f -q

ibmcloud sat Endpunktbefehle

Satellite-Endpunkte anzeigen und verwalten.

ibmcloud sat endpoint authn get

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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 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 \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint authn rotate

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 „ 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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file FILE
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file FILE
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file FILE
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--endpoint 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 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 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 FILE
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file 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 \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint authn set

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 „ 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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file FILE
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file FILE
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file FILE
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--dest-tls-mode MODE
Das Ziel TLS Modus. Akzeptierte Werte:simple,mutual,none
--endpoint 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 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 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 FILE
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file FILE
Der private Serverschlüssel, der zum Verschlüsseln des Serverzertifikats verwendet wird Beispiel: myKey.pem.
--source-tls-mode MODE
Die Quelle: TLS-Modus. Akzeptierte Werte: simple, mutual

Beispiele

Legen Sie die Authentifizierungseinstellungen für einen Endpunkt fest.

ibmcloud sat endpoint authn set \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint create

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-hostname 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 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 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 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 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 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 NAME
Geben Sie einen Namen für den Endpunkt an.
--output OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--sni SNI
Geben Sie den Servernamen-Indikator an, wenn Sie ein oder tls https Quellprotokoll angeben und möchten, dass dem TLS-Handshake ein separater Hostname hinzugefügt wird.
--source-protocol 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 \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --name NAME

ibmcloud sat endpoint disable

Deaktivieren eines Endpunkts.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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

Deaktivieren eines Endpunkts.

ibmcloud sat endpoint disable \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint enable

Aktivieren Sie einen Endpunkt.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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

Aktivieren Sie einen Endpunkt.

ibmcloud sat endpoint enable \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint get

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Zeigen Sie die Details zu einem Endpunkt an.

ibmcloud sat endpoint get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint ls

Listen Sie alle Endpunkte an einem Satellite-Standort auf.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Listen Sie alle Endpunkte an einem Satellite-Standort auf.

ibmcloud sat endpoint ls --location LOCATION --connector-id CONNECTOR_ID --output json

ibmcloud sat endpoint rm

Endpunkt löschen.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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 \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint update

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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-hostname 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 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 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 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 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 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 NAME
Geben Sie einen neuen Namen für den Endpunkt an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--sni SNI
Geben Sie den Servernamen-Indikator an, wenn Sie ein oder tls https Quellprotokoll angeben und möchten, dass dem TLS-Handshake ein separater Hostname hinzugefügt wird.
--source-protocol 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

Einen Endpunkt aktualisieren.

ibmcloud sat endpoint update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimentelle Befehle

[Gültig bis 2024-11-25] Probieren Sie neue Befehle aus. WICHTIG: Die hier aufgeführten Befehle werden nach dem in ihrer Beschreibung angegebenen [Datum] eingestellt.

ibmcloud sat experimental acl create

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl create] Erstellen Sie eine ACL.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--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.
--name NAME
Der Name der ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subnet 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

Erstellen Sie eine ACL.

ibmcloud sat experimental acl create \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --name NAME

ibmcloud sat experimental acl endpoint add

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl endpoint add] Fügen Sie einen oder mehrere aktivierte Endpunkte zu einer ACL hinzu.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL aktiviert werden soll.
--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

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

ibmcloud sat experimental acl endpoint add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl endpoint ls

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl endpoint ls] Alle aktivierten Endpunkte für eine ACL auflisten.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 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 experimental acl endpoint ls \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl endpoint rm

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl endpoint rm] Entfernen Sie einen oder mehrere aktivierte Endpunkte aus einer ACL.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint ENDPOINT
Ein Name oder eine ID eines Endpunkts, der für diese ACL deaktiviert werden soll.
--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

Entfernen Sie einen oder mehrere aktivierte Endpunkte aus einer ACL.

ibmcloud sat experimental acl endpoint rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl get

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl get] Zeigen Sie die Details einer ACL an.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details einer ACL anzeigen.

ibmcloud sat experimental acl get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl ls

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen „ ibmcloud sat acl ls “ anstelle von „] “, um alle ACLs für einen „ Satellite “-Konnektor oder -Standort aufzulisten.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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 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 experimental acl ls \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --output json

ibmcloud sat experimental acl rm

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl rm] Löschen Sie eine ACL.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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

Eine ACL löschen.

ibmcloud sat experimental acl rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl subnet add

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl subnet add] Fügen Sie ein oder mehrere Subnetze zu einer ACL hinzu.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--subnet 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

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

ibmcloud sat experimental acl subnet add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl subnet rm

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl subnet rm] Entfernen Sie ein oder mehrere Subnetze aus einer ACL.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--subnet 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

Entfernen Sie ein oder mehrere Subnetze aus einer ACL.

ibmcloud sat experimental acl subnet rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl update

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat acl update] Aktualisieren Sie den Namen einer ACL.

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

Befehlsoptionen

--acl-id ID
Geben Sie die ID der ACL an. Um alle ACLs aufzulisten, führen Sie ibmcloud sat acl ls aus.
--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--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.
--name NAME
Der neue Name für die ACL.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Aktualisieren Sie den Namen einer ACL.

ibmcloud sat experimental acl update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental agent attach

[Deaktiviert auf 2024-09-01! Verwenden Sie „ ibmcloud sat agent attach “ anstelle von „] “. Rufen Sie den „ Satellite Connector Agent“ für eine bestimmte Plattform ab. Laden Sie die Agent- .zip für Windows herunter oder rufen Sie einen Link zur Dokumentation für „ Docker “-Umgebungen auf.

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

Befehlsoptionen

--platform 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

Laden Sie einen „ Satellite “-Connector-Agenten für eine bestimmte Plattform herunter.

ibmcloud sat experimental agent attach --platform PLATFORM -q

ibmcloud sat experimental agent ls

[Deaktiviert auf 2024-09-01! Verwenden Sie stattdessen „ ibmcloud sat agent ls “ anstelle von „] “, um alle Agenten für einen „ Satellite “-Konnektor aufzulisten.

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

Befehlsoptionen

--connector-id ID
Die ID eines Satellite-Connectors.
--output 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 experimental agent ls --connector-id CONNECTOR_ID --output json -q

ibmcloud sat experimental connector create

[Deaktiviert auf 2024-11-18! Verwenden Sie stattdessen „ ibmcloud sat connector create “ statt „] “. Erstellen Sie einen „ Satellite “-Konnektor.

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

Befehlsoptionen

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

Beispiele

Erstellen Sie einen Satellite-Connector.

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

ibmcloud sat experimental connector get

[Deaktiviert auf 2024-11-18! Verwenden Sie stattdessen ibmcloud sat connector get statt] . Zeigen Sie die Details eines „ Satellite “-Konnektors an.

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

Befehlsoptionen

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

Beispiele

Details eines Satellite-Connectors anzeigen.

ibmcloud sat experimental connector get --connector-id CONNECTOR_ID --output json -q

ibmcloud sat experimental connector ls

[Deaktiviert auf 2024-11-18! Verwenden Sie stattdessen ibmcloud sat connector ls statt] . Rufen Sie die „ Satellite “-Konnektoren in Ihrem IBM Cloud-Konto auf.

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat experimental connector ls --after AFTER --first FIRST --output json

ibmcloud sat experimental connector rm

[Deaktiviert auf 2024-11-18! Verwenden Sie stattdessen „ ibmcloud sat connector rm “] Einen „ Satellite “-Konnektor löschen.

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

Befehlsoptionen

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

Beispiele

Löschen Sie einen Satellite-Connector.

ibmcloud sat experimental connector rm --connector-id CONNECTOR_ID -f -q

ibmcloud sat experimental endpoint authn get

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat endpoint authn get] Rufen Sie die Authentifizierungseinstellungen für einen Endpunkt ab.

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

Befehlsoptionen

--connector-id ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--endpoint 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 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 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 experimental endpoint authn get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental endpoint authn rotate

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat endpoint authn rotate] 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 „ TLS “-Handshake 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 experimental 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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file FILE
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file FILE
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file FILE
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--endpoint 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 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 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 FILE
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file 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 experimental endpoint authn rotate \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental endpoint authn set

[Deaktiviert auf 2024-10-01! Verwenden Sie stattdessen ibmcloud sat endpoint authn set] 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 „ TLS “-Handshake 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 experimental 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 ID
Die ID des Satellite-Konnektors. Führen Sie ibmcloud sat connector ls aus, um die Connector-ID zu suchen.
--dest-ca-cert-file FILE
Anerkanntes CA-Zertifikat oder Zertifikatskette zur Validierung des Zertifikats des Zielservers. Beispiel: myCA.pem.
--dest-cert-file FILE
Das Client-Zertifikat, das zur Authentifizierung beim Zielserver verwendet wird. Beispiel: myCert.pem.
--dest-key-file FILE
Der zum Verschlüsseln des Clientzertifikats verwendete private Clientschlüssel. Beispiel: myKey.pem.
--dest-tls-mode MODE
Das Ziel TLS Modus. Akzeptierte Werte:simple,mutual,none
--endpoint 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 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 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 FILE
Das Serverzertifikat, das dem Quellenclient präsentiert werden soll. Beispiel: myCert.pem.
--source-key-file FILE
Der private Serverschlüssel, der zum Verschlüsseln des Serverzertifikats verwendet wird Beispiel: myKey.pem.
--source-tls-mode MODE
Die Quelle: TLS-Modus. Akzeptierte Werte: simple, mutual

Beispiele

Legen Sie die Authentifizierungseinstellungen für einen Endpunkt fest.

ibmcloud sat experimental endpoint authn set \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental location update

[Deaktiviert auf 2024-11-25! Verwenden Sie stattdessen ibmcloud sat location update statt] . Aktualisieren Sie den Namen oder die Beschreibung eines Standorts unter Satellite.

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

Befehlsoptionen

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

Beispiele

Aktualisieren Sie den Namen oder die Beschreibung einer Satellite.

ibmcloud sat experimental location update \
  --location-id LOCATION \
  --name NAME \
  --description IP_ADDRESS

ibmcloud sat 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

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

--cluster CLUSTER, -c CLUSTER
Gibt den Clusternamen oder die Cluster-ID an. Führen Sie den Befehl ibmcloud sat cluster ls aus, um registrierte Cluster aufzulisten.
--group GROUP, -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 einen Cluster zu Ihrer Clustergruppe hinzu.

ibmcloud sat group attach --group GROUP --cluster CLUSTER_NAME_OR_ID -q

ibmcloud sat group create

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

--cluster CLUSTER, -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 NAME
Geben Sie einen Namen für die Satellite-Clustergruppe an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Erstellen Sie eine Clustergruppe.

ibmcloud sat group create --name NAME --cluster CLUSTER_NAME_OR_ID -q

ibmcloud sat group detach

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

--cluster CLUSTER, -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.
--group GROUP, -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 Kubernetes-Ressourcen, die von dieser verwaltet wurden.

ibmcloud sat group detach --group GROUP --cluster CLUSTER_NAME_OR_ID -f

ibmcloud sat group get

Detaillierte Informationen zu einer Satellite-Clustergruppe abrufen.

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

Befehlsoptionen

--group GROUP, -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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Detaillierte Informationen zu einer Satellite-Clustergruppe abrufen.

ibmcloud sat group get --group GROUP --output json -q

ibmcloud sat group ls

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

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat group ls --output json -q

ibmcloud sat group rm

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.
--group GROUP, -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 dieser Gruppe verwaltet wurden, gelöscht.

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

ibmcloud SAT-Host-Befehle

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

ibmcloud sat host assign

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 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 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 LABEL, --hl LABEL
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 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.
--worker-pool POOL, -p 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.
--zone 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 einer Steuerebene oder einem Cluster eines Satellite-Standorts einen Host zu.

ibmcloud sat host assign \
  --location LOCATION \
  --cluster CLUSTER_NAME_OR_ID \
  --worker-pool POOL_NAME

ibmcloud sat host attach

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 LABEL, --hl LABEL
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 ENDPOINT
Der Endpunkt, über den der Linkagent eine Verbindung zum Link-Tunnel-Server herstellt.
--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.
--operating-system 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 Script herunter, das Sie auf Ihren Hosts ausführen können, um diese an Ihren Standort anzuhängen.

ibmcloud sat host attach \
  --location LOCATION \
  --host-label HOSTNAME \
  --reset-key RESET-KEY

ibmcloud sat host get

Details zu einem Satellite-Host anzeigen.

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

Befehlsoptionen

--host 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 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 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 --location LOCATION --host HOSTNAME --output json

ibmcloud sat host ls

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 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 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 dem Control Panel zugewiesen sind.

ibmcloud sat host ls --location LOCATION --output json -q

ibmcloud sat host rm

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 HOST
Der Name oder die ID des Hosts, der entfernt werden soll.
--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

Host aus einem Satellite-Standort entfernen.

ibmcloud sat host rm --location LOCATION --host HOSTNAME -f

ibmcloud sat host update

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

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

Befehlsoptionen

--host 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 LABEL, --hl LABEL
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 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 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

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

ibmcloud sat host update --location LOCATION --host-label HOSTNAME --zone ZONE

ibmcloud sat-Befehle

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

ibmcloud sat key ls

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

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat key ls --output json -q

ibmcloud sat key rm

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 KEY
Der Name oder die ID eines Satellite Config-Schlüssels.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Entfernen Sie einen Satellite Config-Schlüssel.

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

ibmcloud sat key rotate

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 NAME
Der Name des neuen Satellite Config-Schlüssels.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

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

ibmcloud-Befehle zur Standortbestimmung

Satellite-Standorte erstellen, anzeigen und ändern.

ibmcloud sat location create

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 CAPABILITY
Eine Funktion des Standorts Satellite.
--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 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 DESCRIPTION
Geben Sie eine Beschreibung für den Satellite-Standort ein.
--ha-zone 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 REGION
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 NAME
Geben Sie einen Namen für den Satellite-Standort an. Ortsnamen müssen mit einem Buchstaben beginnen, dürfen Buchstaben, Zahlen, Punkte (.) und Bindestriche (-) enthalten und dürfen nicht länger als 36 Zeichen sein. Vermeiden Sie die Wiederverwendung von Namen, selbst wenn der andere Standort gelöscht wird.
--physical-address ADDRESS
Die physische Adresse des Satellite-Standorts.
--pod-network-interface-selection 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 unter 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 SUBNET
Gibt ein angepasstes Teilnetz-CIDR an, um private IP-Adressen für Pods bereitzustellen. Diese Option wird nur verwendet, wenn Sie Red Hat unter 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 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 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 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 SUBNET
Gibt ein angepasstes Teilnetz-CIDR an, um private IP-Adressen für Services bereitzustellen. Diese Option wird nur verwendet, wenn Sie Red Hat unter 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

Erstellen Sie einen Satellite-Standort.

ibmcloud sat location create \
  --pod-subnet SUBNET_CIDR \
  --service-subnet SUBNET_CIDR \
  --name NAME

ibmcloud sat location dns get

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 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subdomain 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

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

ibmcloud sat location dns get --location LOCATION --subdomain DOMAIN --output json

ibmcloud sat location dns ls

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

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

Befehlsoptionen

--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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

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

ibmcloud sat location dns ls --location LOCATION --output json -q

ibmcloud sat location dns register

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 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 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

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

ibmcloud sat location dns register --location LOCATION --ip IP_ADDRESS --output json

ibmcloud sat location get

Details zu einem Satellite-Standort anzeigen.

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

Befehlsoptionen

--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 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 --output json -q

ibmcloud sat location ls

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

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

Befehlsoptionen

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

Beispiele

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

ibmcloud sat location ls --output json -q

ibmcloud sat location rm

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 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

Löschen Sie einen Standort.

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

ibmcloud sat location update

Aktualisieren Sie den Namen oder die Beschreibung einer Satellite.

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

Befehlsoptionen

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

Beispiele

Aktualisieren Sie den Namen oder die Beschreibung einer Satellite.

ibmcloud sat location update \
  --location-id LOCATION \
  --name NAME \
  --description IP_ADDRESS

ibmcloud sat-Meldungen Befehle

Zeigt die aktuellen Benutzernachrichten an.

ibmcloud sat messages

Zeigt die aktuellen Benutzernachrichten an.

ibmcloud sat messages [-q]

Befehlsoptionen

-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Zeigt die aktuellen Benutzernachrichten an.

ibmcloud sat messages -q

ibmcloud sat-Ressourcenbefehle

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

ibmcloud sat resource get

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 HISTORY
Die Protokoll-ID für die Ressource.
--output OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--resource RESOURCE
Geben Sie die ID der Kubernetes-Ressource an. Um Ressourcen zu Kubernetes 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

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

ibmcloud sat resource get \
  --resource RESOURCE \
  --history HISTORY \
  --save-data SAVE-DATA

ibmcloud sat resource history get

Verlauf für eine Kubernetes-Ressource abrufen.

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

Befehlsoptionen

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

Beispiele

Verlauf für eine Kubernetes-Ressource abrufen.

ibmcloud sat resource history get --resource RESOURCE --limit LIMIT --output json

ibmcloud sat resource ls

Von Satellite verwaltete Kubernetes-Ressourcen durchsuchen.

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

Befehlsoptionen

--cluster CLUSTER, -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 LIMIT
Geben Sie die maximale Anzahl von Ressourceneinträgen an, die von der Suche zurückgegeben werden sollen.
--output OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--search SEARCH
Geben Sie die Zeichenfolge zum Filtern der Suchergebnisse von Kubernetes-Ressourcen an, z. B. den Namen eines Pods oder eines Namensbereichs.
--subscription 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

Von Satellite verwaltete Kubernetes-Ressourcen durchsuchen.

ibmcloud sat resource ls --search SEARCH --limit LIMIT --cluster CLUSTER_NAME_OR_ID

ibmcloud SAT-Dienstbefehle

Satellite-Servicecluster anzeigen.

ibmcloud sat service ls

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 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 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 z. B. angeforderte Hostressourcen, zu überprüfen.

ibmcloud sat service ls --location LOCATION --output json -q

ibmcloud-Befehle für SAT-Speicher

Satellite-Speicherressourcen anzeigen und verwalten.

ibmcloud sat storage assignment autopatch disable

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

Deaktivieren Sie automatische Patches für eine Speicherzuweisung vom Typ „ Satellite “.

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 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 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

Deaktivieren Sie automatische Patches für eine Speicherzuweisung vom Typ „ Satellite “.

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

ibmcloud sat storage assignment autopatch enable

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

Aktivieren Sie automatische Patches für eine Speicherzuweisung vom Typ „ Satellite “.

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 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 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

Aktivieren Sie automatische Patches für eine Speicherzuweisung vom Typ „ Satellite “.

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

ibmcloud sat storage assignment create

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

--cluster CLUSTER, -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 CONFIG
Geben Sie die Satellite-Speicherkonfiguration für die Zuweisung an. Um Konfigurationen zu suchen, führen Sie ibmcloud sat storage config ls aus.
--group GROUP, -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 NAME
Geben Sie einen Namen für die Zuweisung von Satellite-Speicher an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--service-cluster-id CLUSTER
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

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

ibmcloud sat storage assignment create \
  --name NAME \
  --group GROUP \
  --service-cluster-id CLUSTER_NAME_OR_ID

ibmcloud sat storage assignment get

Details einer Zuweisung von Satellite-Speicher abrufen.

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

Befehlsoptionen

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

Beispiele

Details einer Zuweisung von Satellite-Speicher abrufen.

ibmcloud sat storage assignment get --assignment ASSIGNMENT --output json -q

ibmcloud sat storage assignment ls

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

--cluster CLUSTER, -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 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 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--service-cluster-id CLUSTER
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

Satellite-Speicherzuweiungen in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat storage assignment ls \
  --service-cluster-id CLUSTER_NAME_OR_ID \
  --cluster CLUSTER_NAME_OR_ID \
  --config CONFIG

ibmcloud sat storage assignment patch

Wenden Sie Speicherkonfigurationsänderungen auf die zugeordneten Zuordnungen an.

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

Aliasnamen: ibmcloud sat upgrade

Befehlsoptionen

--assignment 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

Wenden Sie Speicherkonfigurationsänderungen auf die zugeordneten Zuordnungen an.

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

ibmcloud sat storage assignment rm

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 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

Entfernt eine Satellite-Speicherzuweisung.

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

ibmcloud sat storage assignment update

Satellite-Speicherzuweisung aktualisieren.

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

Befehlsoptionen

--assignment ASSIGNMENT
Geben Sie die ID einer Satellite-Speicherzuweisung an.
-f
Erzwingt die Ausführung des Befehls ohne Eingabeaufforderungen.
--group GROUP, -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 NAME
Geben Sie einen neuen Namen für die Zuweisung von Satellite-Speicher an.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Satellite-Speicherzuweisung aktualisieren.

ibmcloud sat storage assignment update \
  --assignment ASSIGNMENT \
  --name NAME \
  --group GROUP

ibmcloud sat storage config class add

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 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 NAME
Geben Sie einen Namen für die angepasste Speicherklasse an.
--param PARAM, -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 Sie eine angepasste Satellite-Speicherklasse.

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

ibmcloud sat storage config class get

Details einer Satellite-Speicherklasse abrufen.

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

Befehlsoptionen

--class CLASS
Geben Sie den Namen einer Satellite-Speicherklasse an.
--config 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details einer Satellite-Speicherklasse abrufen.

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

ibmcloud sat storage config class ls

Speicherklassen in einer Satellite-Speicherkonfiguration auflisten

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

Befehlsoptionen

--config 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 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

Listen Sie die Speicherklassen in einer Satellite-Speicherkonfiguration auf.

ibmcloud sat storage config class ls \
  --config CONFIG \
  --show-params SHOW-PARAMS \
  --output json

ibmcloud sat storage config create

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 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 NAME
Geben Sie den Namen der Speicherkonfiguration an.
--param PARAM, -p PARAM
Geben Sie ein Paar key=value für Konfigurationsparameter an. Um die Konfigurationsparameter in einer Speichervorlage anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat storage template get.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--template-name 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 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

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

ibmcloud sat storage config create \
  --name NAME \
  --template-name NAME \
  --template-version VERSION

ibmcloud sat storage config get

Details einer Satellite-Speicherkonfiguration abrufen.

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

Befehlsoptionen

--config 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Details einer Satellite-Speicherkonfiguration abrufen.

ibmcloud sat storage config get --config CONFIG --output json -q

ibmcloud sat storage config ls

Satellite-Speicherkonfigurationen in Ihrem IBM Cloud-Konto auflisten.

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

Befehlsoptionen

--location 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 OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Satellite-Speicherkonfigurationen in Ihrem IBM Cloud-Konto auflisten.

ibmcloud sat storage config ls --location LOCATION --output json -q

ibmcloud sat storage config param set

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 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.
--param PARAM, -p PARAM
Geben Sie ein Paar key=value für Konfigurationsparameter an. Um die Konfigurationsparameter in einer Speichervorlage anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat storage template get.
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

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 --apply APPLY

ibmcloud sat storage config patch

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 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 \
  --include-assignments INCLUDE-ASSIGNMENTS \
  -f

ibmcloud sat storage config rm

Eine Satellite-Speicherkonfiguration entfernen.

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

Befehlsoptionen

--config 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 \
  --include-assignments INCLUDE-ASSIGNMENTS \
  -f

ibmcloud sat storage template get

Details einer Satellite-Speichervorlage abrufen.

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

Befehlsoptionen

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

Beispiele

Erfahren Sie mehr über eine Satellite-Speichervorlage.

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

ibmcloud sat storage template ls

Verfügbare Satellite-Speichervorlagen auflisten.

ibmcloud sat storage template ls [-q]

Befehlsoptionen

-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.

Beispiele

Verfügbare Satellite-Speichervorlagen auflisten.

ibmcloud sat storage template ls -q

Befehle für das ibmcloud-SAT-Abonnement

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

ibmcloud sat subscription create

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 CONFIG
Geben Sie den Namen der Konfiguration an, die für das Abonnement verwendet werden soll. Um die verfügbaren Konfigurationen anzuzeigen, führen Sie folgenden Befehl aus: ibmcloud sat config ls.
--gitref GITREF
Geben Sie die GitRef an, die für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--gitref-type 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
--group GROUP, -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.
--name NAME
Geben Sie einen Namen für das Abonnement ein.
--path 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 REPOSITORY
Geben Sie die URL des fernen Repositorys an, das für das Abonnement verwendet wird. Strategie: GitOps.
--version 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 \
  --auth-required AUTH-REQUIRED \
  --name NAME \
  --group GROUP \
  --config CONFIG

ibmcloud sat subscription get

Detaillierte Informationen für ein Satellite-Abonnement abrufen.

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

Befehlsoptionen

--output OUTPUT
Befehlsausgabe im bereitgestellten Format. Gültige Werte: json
-q
Keine Tagesnachricht oder Aktualisierungserinnerung anzeigen.
--subscription 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

Detaillierte Informationen für ein Satellite-Abonnement abrufen.

ibmcloud sat subscription get --subscription IP_ADDRESS --output json -q

ibmcloud sat subscription identity set

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 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 Ihre Identität zur Verwaltung von Ressourcen zu nutzen.

ibmcloud sat subscription identity set --subscription IP_ADDRESS -f -q

ibmcloud sat subscription ls

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

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

Befehlsoptionen

--cluster CLUSTER, -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 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 --cluster CLUSTER_NAME_OR_ID --output json -q

ibmcloud sat subscription rm

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 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

Satellite-Abonnement entfernen.

ibmcloud sat subscription rm --subscription IP_ADDRESS -f -q

ibmcloud sat subscription update

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.
--gitref GITREF
Geben Sie die GitRef an, die für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--gitref-type 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
--group GROUP, -g GROUP
Geben Sie die neuen Clustergruppen an, die Ihre Konfiguration abonnieren sollen.
--name NAME
Geben Sie einen neuen Namen für das Satellite-Abonnement ein.
--path 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 REPOSITORY
Geben Sie die URL des fernen Repositorys an, das für das Satellite-Abonnement verwendet werden soll. Strategie: GitOps.
--subscription 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 VERSION
Geben Sie die vorhandene Konfigurationsversion an, die für das Satellite-Abonnement verwendet werden soll. Strategie: Direkter Upload.

Beispiele

Satellite-Abonnement aktualisieren.

ibmcloud sat subscription update \
  --auth-required AUTH-REQUIRED \
  --subscription IP_ADDRESS \
  --name NAME \
  --group GROUP