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.
| 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 lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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
cloudEndpunkten 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. BeilocationEndpunkten 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-alivekompatibel 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
tlshttpsQuellprotokoll 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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
cloudEndpunkten 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. BeilocationEndpunkten 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-alivekompatibel 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
tlshttpsQuellprotokoll 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 lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus. --connector-id ID- Die ID des Satellite-Konnektors. Führen Sie
ibmcloud sat connector lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 lsaus, 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 FeldHost 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-enabledaktivieren. Um eine direkte URL oder IP-Adresse anzugeben, geben Siecan-reach=<url>odercan-reach=<ip_address>an. Geben Sieinterface=<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-enabledaktivieren. Das Subnetz muss/23oder 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-credentialangegeben 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
--providerangegeben 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-enabledaktivieren. Das Subnetz muss/24oder 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 undibmcloud sat host ls --location <location_ID_or_name>suchen Sie nachWorker IPfür Hosts mit der Bezeichnunginfrastructure. --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 lsaus, 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 lsaus, 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 satelliteaus, 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 lsaus. --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 lsaus, 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=valuefü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=valuefü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 lsaus, 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=valuefü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 lsaus, 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 lsaus, 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