Guida di riferimento alla CLI per i comandi di Satellite

Consulta questi comandi CLI di Satellite quando desideri automatizzare la creazione e la gestione della tua istanza di Satellite, comprese le operazioni relative a istanza, host, cluster ed endpoint.

Per installare la CLI, vedi Installazione della CLI. Per visualizzare una mappa di alto livello di tutti i comandi di IBM Cloud Satellite, vedere la mappa della CLI.

  1. Installa la CLI IBM Cloud. Vedi "Guida introduttiva alla CLI di IBM Cloud ".

  2. Installa il plug-in " ks ".

    ibmcloud plugin install ks
    

Comandi Acl

Visualizza e gestisci gli elenchi di controllo degli accessi (ACL) dell' Satellite.

ibmcloud sat acl create

Satellite

Crea un ACL.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Nome o ID di un endpoint da abilitare per questa ACL.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--name
Il nome dell'ACL.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subnet
Un blocco IP o CIDR consentito da questa ACL. Il valore deve rientrare interamente nei seguenti CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Esempi

Creare un ACL

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

ibmcloud sat acl endpoint add

Satellite

Aggiungere uno o più endpoint abilitati a una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Nome o ID di un endpoint da abilitare per questa ACL.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Aggiungere uno o più endpoint abilitati a un ACL

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

ibmcloud sat acl endpoint help

Mostra la guida

ibmcloud sat acl endpoint help

Esempi

Mostra la guida

ibmcloud sat acl endpoint help

ibmcloud sat acl endpoint ls

Satellite

Elenca tutti gli endpoint abilitati per una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti gli endpoint abilitati per un ACL

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

ibmcloud sat acl endpoint rm

Satellite

Rimuovere uno o più endpoint abilitati da una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Nome o ID di un endpoint da disabilitare per questa ACL.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere uno o più endpoint abilitati da un ACL

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

ibmcloud sat acl get

Satellite

Visualizza i dettagli di un ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i dettagli di un ACL

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

ibmcloud sat acl help

Mostra la guida

ibmcloud sat acl help

Esempi

Mostra la guida

ibmcloud sat acl help

ibmcloud sat acl ls

Satellite

Elenca tutte le ACL relative a un connettore o a una posizione di Satellite.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutte le ACL relative a un connettore o a una posizione di Satellite

ibmcloud sat acl ls --connector-id ID

ibmcloud sat acl rm

Satellite

Eliminare una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elimina un ACL

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

ibmcloud sat acl subnet add

Satellite

Aggiungere una o più sottoreti a una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subnet
Un blocco IP o CIDR consentito da questa ACL. Il valore deve rientrare interamente nei seguenti CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Esempi

Aggiungere una o più sottoreti a un ACL

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

ibmcloud sat acl subnet help

Mostra la guida

ibmcloud sat acl subnet help

Esempi

Mostra la guida

ibmcloud sat acl subnet help

ibmcloud sat acl subnet rm

Satellite

Rimuovere una o più sottoreti da una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subnet
Un blocco IP o CIDR consentito da questa ACL. Il valore deve rientrare interamente nei seguenti CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Esempi

Rimuovere una o più sottoreti da un ACL

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

ibmcloud sat acl update

Satellite

Aggiorna il nome di una ACL.

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

Opzioni comando

--acl-id
Specificare l'ID della ACL. Per elencare tutte le ACL, eseguire ibmcloud sat acl ls.
--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--name
Il nuovo nome dell'ACL.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Aggiornare il nome di un ACL

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

Comandi agent

Allega o visualizza gli agenti del connettore Satellite.

ibmcloud sat agent attach

Satellite

Ottieni un agente di connessione Satellite per una piattaforma specifica. Scarica l' .zip e dell'Agent per Windows oppure ottieni un link alla documentazione per gli ambienti Docker.

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

Opzioni comando

--platform
La piattaforma per l'agente Connector Satellite. Per ulteriori informazioni su Docker, vedere la documentazione su https://ibm.biz/satconagent Opzioni disponibili: windows, docker
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni un agente di connessione “ Satellite ” per una piattaforma specifica

ibmcloud sat agent attach --platform PLATFORM

ibmcloud sat agent help

Mostra la guida

ibmcloud sat agent help

Esempi

Mostra la guida

ibmcloud sat agent help

ibmcloud sat agent ls

Satellite

Elenca tutti gli agenti per un connettore Satellite.

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

Opzioni comando

--connector-id
L'ID di un connettore Satellite.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti gli agenti per un connettore Satellite

ibmcloud sat agent ls --connector-id ID

Comandi cluster

Registrare e gestire i cluster da utilizzare con le configurazioni Satellite.

ibmcloud sat cluster get

Virtual Private Cloud Classic infrastructure Satellite

Ottenere i dettagli di un cluster registrato.

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

Opzioni comando

-c, --cluster
Specificare il nome o l'ID del cluster. Per visualizzare l'elenco dei cluster registrati, eseguire il comando ibmcloud sat cluster ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni i dettagli di un cluster registrato

ibmcloud sat cluster get --cluster CLUSTER

ibmcloud sat cluster help

Mostra la guida

ibmcloud sat cluster help

Esempi

Mostra la guida

ibmcloud sat cluster help

ibmcloud sat cluster ls

Virtual Private Cloud Classic infrastructure Satellite

Elencare tutti i cluster registrati nel proprio account IBM Cloud.

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

Opzioni comando

--filter
Filtrare i cluster registrati per ID cluster.
--limit
Limitare il numero di cluster restituiti.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti i cluster registrati nel tuo account IBM Cloud

ibmcloud sat cluster ls

ibmcloud sat cluster register

Satellite

Utilizza il comando kubectl per registrare il tuo cluster in una configurazione Satellite. Accedere al cluster ed eseguire questo comando per installare un agent Satellite Config. I cluster eseguiti nell'ubicazione Satellite installano automaticamente questo agent.

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

Opzioni comando

--name
Specificare il nome del cluster che si desidera registrare
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--silent
Modalità non presidiata. Restituire solo il comando di registrazione nell'output.

Esempi

Utilizza il comando kubectl per registrare il tuo cluster in una configurazione Satellite

ibmcloud sat cluster register --name NAME

ibmcloud sat cluster unregister

Satellite

Rimuovere una registrazione del cluster. Il cluster non è più sottoscritto ad una configurazione Satellite, ma il cluster e le relative risorse esistenti sono ancora in esecuzione.

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

Opzioni comando

-c, --cluster
Specificare il nome o l'ID del cluster. Per visualizzare l'elenco dei cluster registrati, eseguire il comando ibmcloud sat cluster ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere la registrazione di un cluster

ibmcloud sat cluster unregister --cluster CLUSTER

Comandi di configurazione

Visualizzare e gestire la configurazione Satellite.

ibmcloud sat config create

Satellite

Creare una configurazione per specificare quali risorse di Kubernetes si desidera distribuire ai cluster nei carichi di lavoro Satellite.

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

Opzioni comando

--data-location
Specificare la regione IBM in cui memorizzare i dati di configurazione di Satellite. Strategia: caricamento diretto.
--name
Fornire un nome per la configurazione Satellite.
--provider
Indicare il provider GitOps remoto per la configurazione Satellite. Questo provider memorizza le definizioni delle risorse Kubernetes. Strategia: GitOps. Valori consentiti: github, gitlab
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Crea una configurazione per specificare quali risorse di " Kubernetes " desideri distribuire nei tuoi cluster all'interno dei tuoi carichi di lavoro " Satellite "

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

ibmcloud sat config get

Satellite

Ottenere i dettagli di una configurazione Satellite, ad esempio le versioni o le sottoscrizioni associate alla configurazione.

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni i dettagli di una configurazione di Satellite, come le versioni o gli abbonamenti associati alla configurazione

ibmcloud sat config get --config CONFIG

ibmcloud sat config help

Mostra la guida

ibmcloud sat config help

Esempi

Mostra la guida

ibmcloud sat config help

ibmcloud sat config ls

Satellite

Elencare tutte le configurazioni Satellite nell'account IBM Cloud.

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

Opzioni comando

--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutte le configurazioni di " Satellite " nel tuo account IBM Cloud

ibmcloud sat config ls

ibmcloud sat config rename

Satellite

Rinominare una configurazione Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
--name
Fornire un nuovo nome per la configurazione Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rinominare una configurazione di Satellite

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

ibmcloud sat config rm

Satellite

Rimuovere una configurazione Satellite. Tutte le sottoscrizioni associate devono essere prima rimosse. Tutte le versioni vengono eliminate. Eseguire il backup di tutte le definizioni delle risorse che si desidera conservare.

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere una configurazione di Satellite

ibmcloud sat config rm --config CONFIG

ibmcloud sat config version create

Satellite

Creare una versione della configurazione per aggiornare le risorse Kubernetes esistenti per i carichi di lavoro Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID della configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
--description
Aggiungere una descrizione per la versione di configurazione Satellite.
--file-format
Indicare il formato file della versione di configurazione. Opzioni disponibili: yaml
--name
Fornire un nome per la versione di configurazione Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--read-config
Specificare il percorso file per il file della versione di configurazione.

Esempi

Crea una versione di configurazione per aggiornare le risorse esistenti di Kubernetes relative ai tuoi carichi di lavoro Satellite

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

ibmcloud sat config version get

Satellite

Acquisire i dettagli per una versione della configurazione Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID della configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--save-config
Scaricare e salvare la versione della configurazione in un file temporaneo.
--version
Specificare il nome o l'ID della versione di configurazione Satellite. Per visualizzare l'elenco delle versioni presenti nella configurazione, eseguire il comando ibmcloud sat config get --config <configuration_name_or_ID>``.

Esempi

Ottieni i dettagli relativi a una versione di configurazione di Satellite

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

ibmcloud sat config version help

Mostra la guida

ibmcloud sat config version help

Esempi

Mostra la guida

ibmcloud sat config version help

ibmcloud sat config version rm

Satellite

Rimuovere una versione della configurazione Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID della configurazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat config ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--version
Indicare il nome o l'ID della versione di configurazione Satellite. Per visualizzare l'elenco delle versioni, eseguire il comando ibmcloud sat config get --config <configuration_name_or_ID>``.

Esempi

Rimuovere una versione di configurazione di Satellite

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

Comandi dei connettori

Creare, visualizzare e modificare connettori Satellite.

ibmcloud sat connector create

Satellite

Creare un connettore Satellite.

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

Opzioni comando

--name
Il nome del connettore Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--region
La regione IBM Cloud per gestire il proprio connettore Satellite.

Esempi

Crea un connettore " Satellite "

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

ibmcloud sat connector get

Satellite

Visualizzare i dettagli di un connettore Satellite.

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

Opzioni comando

--connector-id
L'ID di un connettore Satellite.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i dettagli di un connettore " Satellite "

ibmcloud sat connector get --connector-id ID

ibmcloud sat connector help

Mostra la guida

ibmcloud sat connector help

Esempi

Mostra la guida

ibmcloud sat connector help

ibmcloud sat connector ls

Satellite

Visualizza i connettori " Satellite " nel tuo account IBM Cloud.

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

Opzioni comando

--after
Mostra i connettori Satellite dopo il cursore indicato.
--first
Visualizza i successivi Satellite, fino al primo numero di connettori.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i connettori " Satellite " nel tuo account IBM Cloud

ibmcloud sat connector ls

ibmcloud sat connector rm

Satellite

Eliminare un connettore Satellite.

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

Opzioni comando

--connector-id
L'ID di un connettore Satellite.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elimina un connettore “ Satellite ”

ibmcloud sat connector rm --connector-id ID

Comandi per gli endpoint

Visualizzare e gestire gli endpoint Satellite.

ibmcloud sat endpoint authn get

Satellite

Ottenere le impostazioni di autenticazione di un endpoint.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Recupera le impostazioni di autenticazione per un endpoint

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

ibmcloud sat endpoint authn help

Mostra la guida

ibmcloud sat endpoint authn help

Esempi

Mostra la guida

ibmcloud sat endpoint authn help

ibmcloud sat endpoint authn rotate

Satellite

Sostituire i certificati di autenticazione esistenti con quelli nuovi. Nel flusso della richiesta sono presenti due connessioni TLS. Le opzioni " source " si riferiscono alla procedura di handshake " TLS " tra la sorgente e il servizio Connector. Le opzioni " destination " si riferiscono alla procedura di handshake " TLS " tra il servizio Connector e il server di destinazione. È possibile fornire i certificati per una o entrambe queste connessioni. Vengono sostituiti solo i certificati specificati dall'utente.

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)

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--dest-ca-cert-file
Certificato CA attendibile o catena utilizzata per convalidare il certificato del server di destinazione. Ad esempio myCA.pem.
--dest-cert-file
Il certificato client utilizzato per l'autenticazione presso il server di destinazione. Ad esempio myCert.pem.
--dest-key-file
La chiave privata client utilizzata per codificare il certificato client. Ad esempio myKey.pem.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--source-ca-cert-file
Certificato CA attendibile o catena utilizzata per convalidare il certificato del client di origine quando source - tls - mode è reciproco. Ad esempio myCA.pem.
--source-cert-file
Il certificato server da presentare al client di origine. Ad esempio myCert.pem.
--source-key-file
La chiave privata del server utilizzata per codificare il certificato del server. Ad esempio myKey.pem.

Esempi

Sostituire i certificati di autenticazione esistenti con quelli nuovi

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

ibmcloud sat endpoint authn set

Satellite

Impostare le impostazioni di autenticazione per un endpoint. Nel flusso della richiesta sono presenti due connessioni TLS. Le opzioni " source " si riferiscono alla procedura di handshake " TLS " tra la sorgente e il servizio Connector. Le opzioni " destination " si riferiscono alla procedura di handshake " TLS " tra il servizio Connector e il server di destinazione. È possibile fornire i certificati per una o entrambe queste connessioni. Le impostazioni non specificate vengono impostate sui valori predefiniti.

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)

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--dest-ca-cert-file
Certificato CA attendibile o catena utilizzata per convalidare il certificato del server di destinazione. Ad esempio myCA.pem.
--dest-cert-file
Il certificato client utilizzato per l'autenticazione presso il server di destinazione. Ad esempio myCert.pem.
--dest-key-file
La chiave privata client utilizzata per codificare il certificato client. Ad esempio myKey.pem.
--dest-tls-mode
La modalità di destinazione TLS. Valori accettati:simple,mutual,none
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--source-ca-cert-file
Certificato CA attendibile o catena utilizzata per convalidare il certificato del client di origine quando source - tls - mode è reciproco. Ad esempio myCA.pem.
--source-cert-file
Il certificato server da presentare al client di origine. Ad esempio myCert.pem.
--source-key-file
La chiave privata del server utilizzata per codificare il certificato del server. Ad esempio myKey.pem.
--source-tls-mode
La fonte: modalità " TLS ". Valori accettati: simple, mutual

Esempi

Configurare le impostazioni di autenticazione per un endpoint

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

ibmcloud sat endpoint create

Satellite

Creare un endpoint.

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)

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--dest-hostname
Indicare il nome dominio completo (FQDN) o l'indirizzo IP accessibile esternamente della destinazione a cui connettersi. Per gli endpoint di tipo " cloud ", questo valore deve corrispondere a un indirizzo IP pubblico o a un indirizzo IP privato accessibile all'interno di IBM Cloud, come ad esempio l'endpoint di un servizio cloud privato. Per gli endpoint location, questo valore deve essere risolvibile e raggiungibile dagli host del piano di controllo per le posizioni Satellite o da dove è in esecuzione l’agente per Satellite Connector.
--dest-port
Fornire la porta su cui la risorsa di destinazione è in ascolto per le richieste in entrata. Assicurarsi che la porta corrisponda al protocollo di destinazione.
--dest-protocol
Specificare il protocollo della destinazione. Se non si specifica questa opzione, il protocollo di destinazione viene ereditato dal protocollo di origine. Valori accettati: TCP, TLS
--dest-type
Specificare dove viene eseguita la risorsa di destinazione: su IBM Cloud (cloud) oppure sul proprio Satellite (location). Opzioni disponibili: location, cloud
--idle-timeout-seconds
Specificare l'intervallo di timeout in secondi per le connessioni attive alla destinazione. Assicurarsi che il timeout sia compatibile con le impostazioni del servizio di destinazione e del protocollo keep-alive.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--name
Fornire un nome per l'endpoint.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--sni
Specificare l'indicatore del nome del server se si imposta il protocollo di origine tls o https e si desidera che venga aggiunto un nome host separato alla negoziazione TLS.
--source-protocol
Fornire il protocollo utilizzato dall'origine per connettere la risorsa di destinazione. Vedi http://ibm.biz/endpoint-protocols. Opzioni disponibili: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Esempi

Crea un endpoint

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

ibmcloud sat endpoint disable

Satellite

Disabilita un endpoint.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Disattivare un endpoint

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

ibmcloud sat endpoint enable

Satellite

Abilitare un endpoint.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Abilita un endpoint

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

ibmcloud sat endpoint get

Satellite

Visualizzare i dettagli di un endpoint.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i dettagli di un endpoint

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

ibmcloud sat endpoint help

Mostra la guida

ibmcloud sat endpoint help

Esempi

Mostra la guida

ibmcloud sat endpoint help

ibmcloud sat endpoint ls

Satellite

Elencare tutti gli endpoint in un'ubicazione Satellite.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti gli endpoint presenti in una posizione " Satellite "

ibmcloud sat endpoint ls --connector-id ID

ibmcloud sat endpoint rm

Satellite

Eliminare un endpoint.

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

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elimina un endpoint

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

ibmcloud sat endpoint update

Satellite

Aggiornare un endpoint. Vengono aggiornate solo le opzioni che si specificano.

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)

Opzioni comando

--connector-id
L'ID del connettore Satellite. Per trovare l'ID connettore, eseguire ibmcloud sat connector ls.
--dest-hostname
Indicare il nome dominio completo (FQDN) o l'indirizzo IP accessibile esternamente della destinazione a cui connettersi. Per gli endpoint di tipo " cloud ", questo valore deve corrispondere a un indirizzo IP pubblico o a un indirizzo IP privato accessibile all'interno di IBM Cloud, come ad esempio l'endpoint di un servizio cloud privato. Per gli endpoint location, questo valore deve essere risolvibile e raggiungibile dagli host del piano di controllo per le posizioni Satellite o da dove è in esecuzione l’agente per Satellite Connector.
--dest-port
Fornire la porta su cui la risorsa di destinazione è in ascolto per le richieste in entrata. Assicurarsi che la porta corrisponda al protocollo di destinazione.
--dest-protocol
Specificare il protocollo della destinazione. Se non si specifica questa opzione, il protocollo di destinazione viene ereditato dal protocollo di origine. Valori accettati: TCP, TLS
--endpoint
Specificare il nome o l'ID dell'endpoint. Per visualizzare l'elenco di tutti gli endpoint, eseguire il comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.
--idle-timeout-seconds
Specificare l'intervallo di timeout in secondi per le connessioni attive alla destinazione. Assicurarsi che il timeout sia compatibile con le impostazioni del servizio di destinazione e del protocollo keep-alive.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--name
Fornire un nuovo nome per l'endpoint.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--sni
Specificare l'indicatore del nome del server se si imposta il protocollo di origine tls o https e si desidera che venga aggiunto un nome host separato alla negoziazione TLS.
--source-protocol
Fornire il protocollo utilizzato dall'origine per connettere la risorsa di destinazione. Vedi http://ibm.biz/endpoint-protocols. Valori ammessi: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Esempi

Aggiornare un endpoint

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

Comandi sperimentali

[Expires on 2024-11-25] Sperimenta nuovi comandi. IMPORTANTE: i comandi qui riportati verranno dismessi dopo l' [date] e indicata nella loro descrizione.

ibmcloud sat experimental endpoint help

Mostra la guida

ibmcloud sat experimental endpoint help

Esempi

Mostra la guida

ibmcloud sat experimental endpoint help

ibmcloud sat experimental help

Mostra la guida

ibmcloud sat experimental help

Esempi

Mostra la guida

ibmcloud sat experimental help

Comandi GROUP

Visualizzare e gestire i gruppi di cluster Satellite. I gruppi di cluster vengono utilizzati per sottoscrivere i cluster alle configurazioni Satellite delle risorse Kubernetes.

ibmcloud sat group attach

Satellite

Aggiungere un cluster al gruppo di cluster. Il cluster può essere eseguito nell'ubicazione Satellite o in IBM Cloud. Per aggiungere un cluster eseguito in IBM Cloud, è necessario prima registrare il cluster con Satellite Config.

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

Opzioni comando

-c, --cluster
Specificare l'ID o il nome cluster. Per visualizzare l'elenco dei cluster registrati, eseguire il comando ibmcloud sat cluster ls``.
-g, --group
Specificare il nome o l'ID di un gruppo di cluster Satellite. Per visualizzare l'elenco dei gruppi di cluster disponibili, eseguire il comando ibmcloud sat group ls``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Aggiungi un cluster al tuo gruppo di cluster

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

ibmcloud sat group create

Satellite

Creare un gruppo di cluster. Quindi, è possibile sottoscrivere il gruppo di cluster ad una configurazione Satellite.

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

Opzioni comando

-c, --cluster
Specificare il nome o l'ID cluster da aggiungere al gruppo di cluster. Per visualizzare l'elenco dei cluster registrati, eseguire il comando ibmcloud sat cluster ls``.
--name
Fornire un nome del gruppo di cluster Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Crea un gruppo di cluster

ibmcloud sat group create --name NAME

ibmcloud sat group detach

Satellite

Rimuovere uno o più cluster dal gruppo di cluster Satellite ed elimina le risorse Kubernetes che vengono gestite dalle sottoscrizioni del gruppo.

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

Opzioni comando

-c, --cluster
Specificare l'ID o il nome cluster. Per visualizzare l'elenco dei cluster presenti nel proprio gruppo di cluster, eseguire il comando ibmcloud sat group get --group <cluster_group_name_or_ID>``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-g, --group
Specificare il nome o l'ID di un gruppo di cluster Satellite. Per visualizzare l'elenco dei gruppi di cluster disponibili, eseguire il comando ibmcloud sat group ls``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuove uno o più cluster dal gruppo di cluster " Satellite " ed elimina le risorse " Kubernetes " gestite dalle sottoscrizioni del gruppo

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

ibmcloud sat group get

Satellite

Acquisire le informazioni dettagliate per un gruppo di cluster Satellite.

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

Opzioni comando

-g, --group
Specificare il nome o l'ID di un gruppo di cluster Satellite. Per visualizzare l'elenco dei cluster registrati, eseguire il comando ibmcloud sat cluster ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni informazioni dettagliate su un gruppo di cluster Satellite

ibmcloud sat group get --group GROUP

ibmcloud sat group help

Mostra la guida

ibmcloud sat group help

Esempi

Mostra la guida

ibmcloud sat group help

ibmcloud sat group ls

Satellite

Elencare tutti i gruppi cluster Satellite nell'account IBM Cloud.

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

Opzioni comando

--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti i gruppi di cluster " Satellite " presenti nel tuo account IBM Cloud

ibmcloud sat group ls

ibmcloud sat group rm

Satellite

Rimuovere un gruppo di cluster Satellite, il che annulla la sottoscrizione dei cluster ed elimina le risorse Kubernetes che vengono gestite dalle sottoscrizioni del gruppo.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-g, --group
Specificare il nome o l'ID di un gruppo di cluster Satellite. Per visualizzare l'elenco dei gruppi di cluster disponibili, eseguire il comando ibmcloud sat group ls``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere un gruppo di cluster di Satellite: questa operazione annulla l'iscrizione dei cluster ed elimina le risorse Kubernetes gestite dalle sottoscrizioni del gruppo

ibmcloud sat group rm --group GROUP

Comandi host

Visualizzare e modificare gli host Satellite.

ibmcloud sat host assign

Satellite

Assegnare un host a un cluster o a un piano di controllo dell'ubicazione Satellite.

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

Opzioni comando

--cluster
Il nome o l'ID del cluster a cui assegnare l'host. Per visualizzare l'elenco dei cluster disponibili, eseguire il comando ibmcloud sat cluster ls``. Se non viene fornito alcun cluster, l'host viene automaticamente assegnato al piano di controllo Satellite.
--host
Il nome o l'ID dell'host da assegnare. Per assegnare automaticamente gli host in base alle etichette, non includere questa opzione. Per recuperare l'ID host, eseguire il comando ibmcloud sat host ls --location <location_ID_or_name>``.
--host-label, --hl
Inserisci eventuali etichette sotto forma di coppie chiave-valore per identificare l'host da assegnare al tuo piano di controllo Satellite o al tuo cluster Red Hat OpenShift. Il primo host non assegnato che ha questa etichetta viene automaticamente assegnato al piano di controllo o al cluster. Per individuare le etichette host disponibili, eseguire il comando ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-p, --worker-pool
Il nome o l'ID del pool di lavoro all'interno del cluster per assegnare l'host. Se non viene specificato alcun pool di nodi di lavoro, l'host viene assegnato al pool di nodi di lavoro predefinito.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--zone
Il nome o l'ID della zona per assegnare l'host. Per individuare le zone disponibili, esegui il comando ibmcloud sat location get --location <location_name_or_ID> e cerca il campo Host Zones .

Esempi

Assegnare un host a un piano di controllo di posizione o a un cluster di un’ Satellite

ibmcloud sat host assign --location LOCATION

ibmcloud sat host attach

Satellite

Creare e scaricare uno script che può essere eseguito sui propri host per collegarli alla propria ubicazione. Per le ubicazioni abilitate a RHCOS, lo script è un file ignition.

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

Opzioni comando

--host-label, --hl
Inserisci eventuali etichette sotto forma di coppie chiave-valore per identificare l'host da assegnare al tuo piano di controllo Satellite o al tuo cluster Red Hat OpenShift. Il primo host non assegnato che ha questa etichetta viene automaticamente assegnato al piano di controllo o al cluster. Per individuare le etichette host disponibili, eseguire il comando ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>``.
--host-link-agent-endpoint
L'endpoint che l'agent di collegamento utilizza per connettersi al server tunnel di collegamento.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--operating-system
Il sistema operativo degli host che si desidera allegare all'ubicazione. Per collegare gli host RHCOS, l'ubicazione deve essere abilitata a RHCOS. Valori accettati: RHEL, RHCOS
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--reset-key
Reimpostare il tasto utilizzato dal piano di controllo per collegare e assegnare gli host nell'ubicazione. Vedi https://ibm.biz/reset-key.

Esempi

Crea e scarica uno script che puoi eseguire sui tuoi host per associarli alla tua posizione

ibmcloud sat host attach --location LOCATION

ibmcloud sat host get

Satellite

Visualizzare i dettagli di un host Satellite.

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

Opzioni comando

--host
ID host Satellite. Per individuare l'ID dell'host, eseguire il comando ibmcloud sat host ls <location_ID_or_name>``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i dettagli di un host Satellite

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

ibmcloud sat host help

Mostra la guida

ibmcloud sat host help

Esempi

Mostra la guida

ibmcloud sat host help

ibmcloud sat host ls

Satellite

Elencare tutti gli host collegati ad un'ubicazione Satellite, inclusi gli host assegnati a cluster o al piano di controllo.

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

Opzioni comando

--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti gli host collegati a una posizione " Satellite ", compresi quelli assegnati a cluster o al piano di controllo

ibmcloud sat host ls --location LOCATION

ibmcloud sat host rm

Satellite

Rimuovere un host da un'ubicazione Satellite.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--host
Il nome o l'ID dell'host da rimuovere.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere un host da una posizione " Satellite "

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

ibmcloud sat host update

Satellite

Aggiornare le informazioni sull'host, come, ad esempio, le zone e le etichette.

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

Opzioni comando

--host
Il nome o l'ID dell'host da assegnare. Per assegnare automaticamente gli host in base alle etichette, non includere questa opzione.
--host-label, --hl
Inserisci eventuali etichette sotto forma di coppie chiave-valore per identificare l'host da assegnare al tuo piano di controllo Satellite o al tuo cluster Red Hat OpenShift. Il primo host non assegnato che ha questa etichetta viene automaticamente assegnato al piano di controllo o al cluster. Per individuare le etichette host disponibili, eseguire il comando ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>``.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--zone
Il nome o l'ID della zona a cui associare l'host. Non è possibile modificare la zona degli host assegnati a una risorsa, ad esempio un cluster. È necessario prima annullarne l'assegnazione. Per visualizzare l'elenco delle zone disponibili, eseguire il comando ibmcloud sat location get --location ``.

Esempi

Aggiornare le informazioni relative all'host, quali le zone e le etichette

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

Comandi da tastiera

Visualizzare e gestire le chiavi Satellite Config.

ibmcloud sat key help

Mostra la guida

ibmcloud sat key help

Esempi

Mostra la guida

ibmcloud sat key help

ibmcloud sat key ls

Satellite

Elencare tutte le chiavi Satellite Config nell'account IBM Cloud.

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

Opzioni comando

--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutte le chiavi di configurazione di " Satellite " nel tuo account IBM Cloud

ibmcloud sat key ls

ibmcloud sat key rm

Satellite

Rimuovere una chiave Satellite Config. Un cluster che utilizza ancora questa chiave non può connettersi a Satellite Config.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--key
Il nome o l'ID di una chiave di Satellite Config.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere una chiave di configurazione " Satellite "

ibmcloud sat key rm --key KEY

ibmcloud sat key rotate

Satellite

Generare una nuova chiave utilizzata dai cluster gestiti per connettersi a Satellite Config.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--name
Il nome della nuova chiave Satellite Config.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Genera una nuova chiave che i cluster gestiti potranno utilizzare per connettersi alla configurazione di Satellite

ibmcloud sat key rotate --name NAME

Comandi di posizione

Creare, visualizzare e modificare le ubicazioni Satellite.

ibmcloud sat location create

Satellite

Creare un'ubicazione Satellite. Un'ubicazione di Satellite è una rappresentazione di un ambiente nel provider dell'infrastruttura. Dopo aver creato una sede, associa gli host provenienti da zone distinte del tuo ambiente infrastrutturale di supporto utilizzando il comando ibmcloud sat host attach .

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]

Opzioni comando

--capability
Una capacità della posizione Satellite.
--coreos-enabled
Abilitare le funzioni Red Hat CoreOS per l'ubicazione Satellite. Questa azione non può essere annullata. Vedere https://ibm.biz/infra-os.
--cos-bucket
Specificare il nome del bucket IBM Cloud Object Storage in cui memorizzare i dati del piano di controllo della propria ubicazione Satellite. In caso contrario, verrà creato un nuovo bucket.
--description
Immettere una descrizione per l'ubicazione Satellite.
--ha-zone
Specificare la zona per l'ubicazione. Per garantire un’elevata disponibilità, specifica 3 zone per la tua sede, come indicato all’indirizzo --ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. I nomi delle zone devono corrispondere esattamente ai nomi delle zone corrispondenti nel provider dell'infrastruttura in cui si prevede di creare gli host.
--managed-from
Selezionare la regione IBM Cloud da cui gestire l'ubicazione Satellite. Scegliere una regione vicina al Data Center on-prem per ottenere migliori prestazioni. Vedi https://ibm.biz/sat-region.
--name
Specificare un nome per l'ubicazione Satellite. I nomi delle località devono iniziare con una lettera, possono contenere lettere, numeri, punti (.) e trattini (-), e devono avere una lunghezza inferiore a 36 caratteri. Non riutilizzare i nomi, anche se l'altra ubicazione viene eliminata.
--physical-address
L'indirizzo fisico della posizione Satellite.
--pod-network-interface-selection
Il metodo per la selezione dell'interfaccia di rete del nodo per la rete pod interna. Questa opzione può essere utilizzata solo se si abilita anche Red Hat CoreOS con l'opzione --coreos-enabled. Per fornire un indirizzo URL o IP diretto, specificare can-reach=<url> o can-reach=<ip_address>. Per selezionare un'interfaccia di rete, specificare interface=<network_interface>.
--pod-subnet
Specificare un CIDR di sottorete personalizzato per fornire gli indirizzi IP privati per i pod. Questa opzione viene utilizzata solo se si abilita Red Hat CoreOS con l'opzione --coreos-enabled. La sottorete deve essere di almeno /23. Vedere https://ibm.biz/sat-location-create. Valore predefinito: '172.16.0.0/16
--provider
Indicare il provider dell'infrastruttura da utilizzare per l'ubicazione Satellite. Se si include questa opzione, è necessario includere anche l'opzione " --provider-credential ". Valori accettati: aws, azure, gcp, vmware
--provider-credential
Specificare il percorso di un file JSON sulla macchina locale che disponga delle credenziali del provider dell'infrastruttura per l'ubicazione Satellite. Il formato delle credenziali è specifico del provider. Vedere http://ibm.biz/sat-infra-creds.
--provider-region
Specificare la regione nel provider dell'infrastruttura in cui si prevede di creare gli host per l'ubicazione Satellite. Se si include questa opzione, è necessario includere anche l'opzione " --provider ".
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--service-subnet
Specificare un CIDR di sottorete personalizzato per fornire gli indirizzi IP privati per i servizi. Questa opzione viene utilizzata solo se si abilita Red Hat CoreOS con l'opzione --coreos-enabled. La sottorete deve essere di almeno /24. Vedere https://ibm.biz/sat-location-create. Valore predefinito: 172.20.0.0/16

Esempi

Crea un'ubicazione Satellite

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

ibmcloud sat location dns get

Satellite

Visualizzare i dettagli di un sottodominio registrato in un'ubicazione Satellite.

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

Opzioni comando

--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subdomain
Specificare il nome del sottodominio. Per visualizzare l'elenco dei sottodomini esistenti, esegui il comando ibmcloud sat location dns ls --location <ID>.

Esempi

Visualizza i dettagli di un sottodominio registrato in una posizione " Satellite "

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

ibmcloud sat location dns help

Mostra la guida

ibmcloud sat location dns help

Esempi

Mostra la guida

ibmcloud sat location dns help

ibmcloud sat location dns ls

Satellite

Elencare i sottodomini registrati in un'ubicazione Satellite.

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

Opzioni comando

--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca i sottodomini registrati in una posizione “ Satellite ”

ibmcloud sat location dns ls --location LOCATION

ibmcloud sat location dns register

Satellite

Impostare un sottodominio per gli host assegnati al piano di controllo in un'ubicazione Satellite.

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

Opzioni comando

--ip
Specificare l'indirizzo IP per ciascun host del piano di controllo, nel formato --ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Per i cluster multizona, utilizzare un indirizzo IP da ogni zona. Per trovare l'indirizzo IP, esegui ibmcloud sat host ls --location <location_ID_or_name> e cerca Worker IP tra gli host contrassegnati con infrastructure.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Impostare un sottodominio per gli host assegnati al piano di controllo in una posizione Satellite

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

ibmcloud sat location get

Satellite

Visualizzare i dettagli di un'ubicazione Satellite.

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

Opzioni comando

--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i dettagli di una sede di “ Satellite ”

ibmcloud sat location get --location LOCATION

ibmcloud sat location help

Mostra la guida

ibmcloud sat location help

Esempi

Mostra la guida

ibmcloud sat location help

ibmcloud sat location ls

Satellite

Elencare tutte le ubicazioni Satellite nell'account IBM Cloud.

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

Opzioni comando

--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutte le sedi di " Satellite " nel tuo account IBM Cloud

ibmcloud sat location ls

ibmcloud sat location rm

Satellite

Eliminare un'ubicazione. Prima di eseguire questo comando, eseguire il backup delle configurazioni e rimuovere gli host e i cluster in esecuzione nell'ubicazione. L'infrastruttura host sottostante non viene eliminata automaticamente quando si elimina un'ubicazione. Questa azione non può essere annullata.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elimina una posizione

ibmcloud sat location rm --location LOCATION

ibmcloud sat location update

Satellite

Aggiornare il nome o la descrizione di una sede di Satellite.

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

Opzioni comando

--description
Inserisci una nuova descrizione per la sede " Satellite ". La lunghezza della descrizione è limitata a 400 byte.
--location-id
L'ID della posizione " Satellite ". Per individuare l'ID della posizione, eseguire il comando ibmcloud sat location ls.
--name
Specificare un nuovo nome per la posizione “ Satellite ”. I nomi delle località devono iniziare con una lettera, possono contenere lettere, numeri, punti (.) e trattini (-), e devono avere una lunghezza inferiore a 36 caratteri. Non riutilizzare i nomi, compresi quelli delle località cancellate.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Aggiornare il nome o la descrizione di una sede di Satellite

ibmcloud sat location update --location-id ID

Comandi dei messaggi

Visualizzare i messaggi utente correnti.

ibmcloud sat messages

Virtual Private Cloud Classic infrastructure Satellite

Visualizzare i messaggi utente correnti.

ibmcloud sat messages [-q]

Opzioni comando

-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Visualizza i messaggi dell'utente corrente

ibmcloud sat messages

Comandi relativi alle risorse

Ricercare e visualizzare le risorse Kubernetes gestite da una configurazione Satellite.

ibmcloud sat resource get

Satellite

Visualizzare i dettagli di una risorsa Kubernetes gestita da una configurazione Satellite.

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

Opzioni comando

--history
L'ID cronologia per la risorsa.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--resource
Specificare l'ID risorsa Kubernetes. Per trovare le risorse relative a " Kubernetes ", esegui il comando ibmcloud sat resource ls.
--save-data
Scaricare e salvare la definizione di risorsa Kubernetes in un file temporaneo.

Esempi

Visualizza i dettagli di una risorsa Kubernetes gestita da una configurazione Satellite

ibmcloud sat resource get --resource RESOURCE

ibmcloud sat resource help

Mostra la guida

ibmcloud sat resource help

Esempi

Mostra la guida

ibmcloud sat resource help

ibmcloud sat resource history get

Satellite

Acquisire la cronologia per una risorsa Kubernetes.

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

Opzioni comando

--limit
Specificare il numero massimo di voci della cronologia da restituire.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--resource
L'ID risorsa Kubernetes.

Esempi

Visualizza la cronologia di una risorsa Kubernetes

ibmcloud sat resource history get --resource RESOURCE

ibmcloud sat resource history help

Mostra la guida

ibmcloud sat resource history help

Esempi

Mostra la guida

ibmcloud sat resource history help

ibmcloud sat resource ls

Satellite

Ricercare le risorse Kubernetes gestite da Satellite.

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

Opzioni comando

-c, --cluster
Specificare il nome o l'ID del cluster registrato in cui viene eseguita la risorsa Kubernetes. Per individuare i cluster registrati, eseguire il comando ibmcloud sat cluster ls.
--limit
Specificare il numero massimo di voci di risorse da restituire nella ricerca.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--search
Indicare la stringa per filtrare i risultati della ricerca di risorse Kubernetes, ad esempio un nome pod o namespace.
--subscription
Specificare l'ID o il nome sottoscrizione Satellite. Per trovare gli abbonamenti, esegui il comando ibmcloud sat cluster ls``.

Esempi

Cerca le risorse di Kubernetes gestite da Satellite

ibmcloud sat resource ls --cluster CLUSTER

Comandi servizi

Visualizzare i cluster del servizio Satellite.

ibmcloud sat service help

Mostra la guida

ibmcloud sat service help

Esempi

Mostra la guida

ibmcloud sat service help

ibmcloud sat service ls

Satellite

Elencare tutti i cluster del servizio Satellite nell'ubicazione per esaminare i dettagli, ad esempio le risorse host richieste.

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

Opzioni comando

--location
Il nome o l'ID dell'ubicazione Satellite. Per individuare l'ID o il nome della posizione, esegui il comando ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti i cluster di servizi di " Satellite " presenti nella tua sede per esaminarne i dettagli, come le risorse host richieste

ibmcloud sat service ls --location LOCATION

Comandi per l'archiviazione

Visualizzare e gestire le risorse dello storage Satellite.

ibmcloud sat storage assignment autopatch disable

Il comando storage assignment autopatch disable è una funzione beta.

Satellite

Disattiva l'applicazione automatica delle patch per un'assegnazione di spazio di archiviazione di tipo " Satellite ".

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

Opzioni comando

--all
Disabilitare le patch automatiche per tutte le assegnazioni di memoria Satellite di una configurazione di memoria.
--assignment
L'ID di un'assegnazione dello storage Satellite. Per elencare le assegnazioni di memoria disponibili della configurazione, eseguire ibmcloud sat storage assignment ls --config CONFIG.
--config
Il nome o l'ID di una configurazione dello storage Satellite. Per visualizzare l'elenco delle configurazioni di archiviazione disponibili, eseguire il comando ibmcloud sat storage config ls``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Disattiva le patch automatiche per un'assegnazione di spazio di archiviazione di tipo “ Satellite ”

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

ibmcloud sat storage assignment autopatch enable

Il comando storage assignment autopatch enable è una funzione beta.

Satellite

Abilita l'applicazione automatica delle patch per un'assegnazione di spazio di archiviazione di tipo " Satellite ".

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

Opzioni comando

--all
Abilitare le patch automatiche per tutte le assegnazioni di memoria Satellite di una configurazione di memoria.
--assignment
L'ID di un'assegnazione dello storage Satellite. Per elencare le assegnazioni di memoria disponibili della configurazione, eseguire ibmcloud sat storage assignment ls --config CONFIG.
--config
Il nome o l'ID di una configurazione dello storage Satellite. Per visualizzare l'elenco delle configurazioni di archiviazione disponibili, eseguire il comando ibmcloud sat storage config ls``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Abilita l'applicazione automatica delle patch per un'assegnazione di spazio di archiviazione Satellite

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

ibmcloud sat storage assignment autopatch help

Mostra la guida

ibmcloud sat storage assignment autopatch help

Esempi

Mostra la guida

ibmcloud sat storage assignment autopatch help

ibmcloud sat storage assignment create

Satellite

Creare un'assegnazione per distribuire le configurazioni di storage tra i cluster nell'ubicazione Satellite.

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

Opzioni comando

-c, --cluster
Specificare l'ID del cluster Satellite per l'assegnazione. Per individuare l'ID del cluster, eseguire il comando ibmcloud oc cluster ls --provider satellite``.
--config
Specificare la configurazione di memoria Satellite per l'assegnazione. per trovare le configurazioni, eseguire ibmcloud sat storage config ls.
-g, --group
Specificare i gruppi di cluster per l'assegnazione. Per individuare i gruppi di cluster, eseguire il comando ibmcloud sat group ls``.
--name
Fornire un nome per l'assegnazione di archiviazione Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--service-cluster-id
Specificare l'ID del cluster del servizio per l'assegnazione. Per individuare l'ID del cluster di servizi, eseguire il comando ibmcloud sat service ls --location ``.

Esempi

Crea un'attività per distribuire le configurazioni di archiviazione ai cluster presenti nella tua sede “ Satellite ”

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

ibmcloud sat storage assignment get

Satellite

Acquisire i dettagli di un'assegnazione dello storage Satellite.

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

Opzioni comando

--assignment
Specificare l'ID di un'assegnazione di archiviazione Satellite.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni i dettagli di un incarico di stoccaggio " Satellite "

ibmcloud sat storage assignment get --assignment ASSIGNMENT

ibmcloud sat storage assignment help

Mostra la guida

ibmcloud sat storage assignment help

Esempi

Mostra la guida

ibmcloud sat storage assignment help

ibmcloud sat storage assignment ls

Satellite

Elencare le assegnazioni dello storage Satellite nell'account IBM Cloud.

Per elencare tutte le assegnazioni per un cluster di servizio come Amministratore del servizio: ibmcloud sat storage assegnation ls--service-cluster-id GRAPPOLO.

Per elencare tutte le assegnazioni per un cluster di servizio come Amministratore della posizione: ibmcloud sat storage assegnation ls--location POSIZIONE--service-cluster-id GRAPPOLO.

Per visualizzare tutti gli assegnamenti relativi a una configurazione: 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)

Opzioni comando

-c, --cluster
Specificare l'ID del cluster Satellite per le assegnazioni. Per ottenere l'ID del cluster, eseguire il comando ibmcloud oc cluster ls --provider satellite``.
--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni di archiviazione disponibili, eseguire il comando ibmcloud sat storage config ls``.
--location
Specificare il nome di un'ubicazione Satellite. Per visualizzare l'elenco delle sedi disponibili, eseguire il comando ibmcloud sat location ls``. Questa opzione non può essere utilizzata dall'amministratore del servizio.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--service-cluster-id
Specificare l'ID del cluster del servizio per le assegnazioni. Per individuare l'ID del cluster di servizi, eseguire il comando ibmcloud sat service ls --location ``.

Esempi

Elenca le assegnazioni di spazio di archiviazione " Satellite " nel tuo account IBM Cloud

ibmcloud sat storage assignment ls --cluster CLUSTER

ibmcloud sat storage assignment patch

Satellite

Applicare le modifiche di configurazione della memoria alle assegnazioni associate.

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

Alias: ibmcloud sat upgrade

Opzioni comando

--assignment
Specificare l'ID di un'assegnazione di archiviazione Satellite. Per visualizzare l'elenco delle assegnazioni disponibili, eseguire il comando ibmcloud sat storage assignment ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Applicare le modifiche alla configurazione dello storage alle assegnazioni associate

ibmcloud sat storage assignment patch --assignment ASSIGNMENT

ibmcloud sat storage assignment rm

Satellite

Rimuovere un'assegnazione dello storage Satellite. Le risorse Kubernetes vengono eliminate da tutti i cluster nell'ubicazione Satellite, ma la configurazione resta.

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

Opzioni comando

--assignment
Specificare l'ID di un'assegnazione di archiviazione Satellite. Per trovare i compiti, esegui il comando ibmcloud sat storage assignment ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere un'assegnazione di spazio su Satellite

ibmcloud sat storage assignment rm --assignment ASSIGNMENT

ibmcloud sat storage assignment update

Satellite

Aggiornare un'assegnazione dello storage Satellite.

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

Opzioni comando

--assignment
Specificare l'ID di un'assegnazione di archiviazione Satellite.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-g, --group
Specificare i nuovi gruppi di cluster per l'assegnazione. Per visualizzare l'elenco dei gruppi disponibili, eseguire il comando ibmcloud sat group ls``.
--name
Fornire un nuovo nome per l'assegnazione di archiviazione Satellite.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Aggiornare un'assegnazione di spazio di archiviazione " Satellite "

ibmcloud sat storage assignment update --assignment ASSIGNMENT

ibmcloud sat storage config class add

Satellite

Creare una classe di archiviazione Satellite.

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

Opzioni comando

--config-name
Specificare il nome della configurazione di archiviazione per la classe di archiviazione personalizzata. Per visualizzare l'elenco delle configurazioni di archiviazione di " Satellite ", eseguire il comando ibmcloud sat storage config ls``.
--name
Fornire un nome per la classe di archiviazione personalizzata.
-p, --param
Specificare una coppia key=value per i parametri della classe di archiviazione. Per visualizzare i parametri della classe di archiviazione in un modello di archiviazione, eseguire il comando ibmcloud sat storage template get.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Creare una classe di archiviazione personalizzata di tipo “ Satellite ”

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

ibmcloud sat storage config class get

Satellite

Acquisire i dettagli di una classe di storage Satellite.

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

Opzioni comando

--class
Specificare il nome della classe di archiviazione Satellite.
--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni di archiviazione di " Satellite ", eseguire il comando ibmcloud sat storage config ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni i dettagli relativi a una classe di archiviazione “ Satellite ”

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

ibmcloud sat storage config class help

Mostra la guida

ibmcloud sat storage config class help

Esempi

Mostra la guida

ibmcloud sat storage config class help

ibmcloud sat storage config class ls

Satellite

Elencare le classi di storage in una configurazione dello storage Satellite

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni di archiviazione di " Satellite ", eseguire il comando ibmcloud sat storage config ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--show-params
Includere questa opzione per elencare tutti i dettagli del parametro della classe di storage.

Esempi

Elencare le classi di storage in una configurazione dello storage Satellite

ibmcloud sat storage config class ls --config CONFIG

ibmcloud sat storage config create

Satellite

Creare una configurazione dello storage Satellite per installare i driver di storage nei cluster.

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

Opzioni comando

--location
Immettere l'ID o il nome dell'ubicazione per la configurazione di archiviazione. Per trovare le sedi disponibili, visita il sito ibmcloud sat location ls.
--name
Specificare il nome della configurazione di archiviazione.
-p, --param
Specificare una coppia key=value per i parametri di configurazione. Per visualizzare i parametri di configurazione di un modello di archiviazione, eseguire il comando ibmcloud sat storage template get``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--template-name
Specificare il nome del template di configurazione dello storage Satellite. Per visualizzare l'elenco dei modelli di configurazione dello storage disponibili, eseguire il comando ibmcloud sat storage template ls``.
--template-version
Specificare la versione del template di configurazione dello storage Satellite. Se non si include questa opzione, viene utilizzata la versione predefinita. Per visualizzare l'elenco dei modelli di configurazione dello storage disponibili, eseguire il comando ibmcloud sat storage template ls``.

Esempi

Crea una configurazione di archiviazione " Satellite " per installare i driver di archiviazione nei tuoi cluster

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

ibmcloud sat storage config get

Satellite

Acquisire i dettagli di una configurazione dello storage Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat storage config ls``.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Ottieni i dettagli relativi a una configurazione di archiviazione Satellite

ibmcloud sat storage config get --config CONFIG

ibmcloud sat storage config help

Mostra la guida

ibmcloud sat storage config help

Esempi

Mostra la guida

ibmcloud sat storage config help

ibmcloud sat storage config ls

Satellite

Elencare le configurazioni dello storage Satellite nell'account IBM Cloud.

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

Opzioni comando

--location
Specificare l'ID o il nome dell'ubicazione che contiene le configurazioni che si desidera elencare. Per trovare le sedi disponibili, visita il sito ibmcloud sat location ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca le configurazioni di archiviazione di “ Satellite ” nel tuo account IBM Cloud

ibmcloud sat storage config ls

ibmcloud sat storage config param help

Mostra la guida

ibmcloud sat storage config param help

Esempi

Mostra la guida

ibmcloud sat storage config param help

ibmcloud sat storage config param set

Satellite

Impostare i parametri di configurazione e i segreti di una configurazione di archiviazione Satellite.

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

Opzioni comando

--apply
Applicare l'ultima versione di configurazione dello storage Satellite a tutte le assegnazioni di una configurazione. Per visualizzare le assegnazioni di una configurazione, eseguire il comando ibmcloud sat storage assignment ls --config CONFIG``.
--config
Specificare il nome o l'ID della configurazione di archiviazione. Per visualizzare l'elenco delle configurazioni di archiviazione di " Satellite ", eseguire il comando ibmcloud sat storage config ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-p, --param
Specificare una coppia key=value per i parametri di configurazione. Per visualizzare i parametri di configurazione di un modello di archiviazione, eseguire il comando ibmcloud sat storage template get``.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Impostare i parametri di configurazione e i parametri segreti di una configurazione di archiviazione Satellite

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

ibmcloud sat storage config patch

Satellite

Applicare gli ultimi aggiornamenti delle patch a una configurazione di archiviazione Satellite. Gli aggiornamenti delle patch contengono correzioni di vulnerabilità e correzioni di bug all'interno della stessa versione principale.

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

Alias: ibmcloud sat upgrade

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat storage config ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--include-assignments
Includere questa opzione per aggiornare le assegnazioni della configurazione di archiviazione alla versione più recente della configurazione.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Applicare gli ultimi aggiornamenti delle patch a una configurazione di storage Satellite

ibmcloud sat storage config patch --config CONFIG

ibmcloud sat storage config rm

Satellite

Rimuovere una configurazione dello storage Satellite.

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

Opzioni comando

--config
Specificare il nome o l'ID di una configurazione di archiviazione Satellite. Per visualizzare l'elenco delle configurazioni disponibili, eseguire il comando ibmcloud sat storage config ls``.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
--include-assignments
Includere questa opzione per rimuovere la configurazione della memoria e tutte le assegnazioni associate.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Rimuovere una configurazione di archiviazione " Satellite "

ibmcloud sat storage config rm --config CONFIG

ibmcloud sat storage help

Mostra la guida

ibmcloud sat storage help

Esempi

Mostra la guida

ibmcloud sat storage help

ibmcloud sat storage template get

Satellite

Acquisire i dettagli di un template di storage Satellite

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

Opzioni comando

--name
Specificare il nome del template di storage. Per visualizzare l'elenco dei modelli di archiviazione disponibili, eseguire il comando ibmcloud sat storage template ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--version
Specificare la versione del template di storage. Per visualizzare l'elenco dei modelli di archiviazione disponibili, eseguire il comando ibmcloud sat storage template ls.

Esempi

Acquisire i dettagli di un template di storage Satellite

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

ibmcloud sat storage template help

Mostra la guida

ibmcloud sat storage template help

Esempi

Mostra la guida

ibmcloud sat storage template help

ibmcloud sat storage template ls

Satellite

Elencare i template dello storage Satellite disponibili.

ibmcloud sat storage template ls [-q]

Opzioni comando

-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca i modelli di archiviazione disponibili su Satellite

ibmcloud sat storage template ls

Comandi relativi all'abbonamento

Visualizzare e gestire le sottoscrizioni Satellite per distribuire i file di configurazione ai cluster.

ibmcloud sat subscription create

Satellite

Creare una sottoscrizione Satellite per i cluster. Dopo aver creato la sottoscrizione, la versione di configurazione Satellite associata viene distribuita automaticamente sui cluster con sottoscrizione.

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)

Opzioni comando

--auth-required
Fornire il segreto di autenticazione richiesto per connettersi al repository remoto. Consultare https://ibm.biz/sat-config-private-repo per i dettagli. Strategia: GitOps.
--config
Specificare il nome della configurazione da utilizzare per la sottoscrizione. Per visualizzare le configurazioni disponibili, esegui il comando ibmcloud sat config ls``.
-g, --group
Specificare il nome o l'ID dei gruppi di cluster da sottoscrivere alla propria configurazione. Per individuare i gruppi di cluster disponibili, eseguire il comando ibmcloud sat group ls``.
--gitref
Specificare il GitRef da utilizzare per la sottoscrizione Satellite. Strategia: GitOps.
--gitref-type
Indicare il tipo di GitRef da utilizzare per la sottoscrizione Satellite. Strategia: GitOps. Valori consentiti: branch, commit, tag, release
--name
Immettere un nome per la sottoscrizione.
--path
Fornire il percorso per i file del repository o gli asset di release nel repository remoto da utilizzare per la sottoscrizione Satellite. Strategia: GitOps.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--repository
Specificare l'URL del repository remoto da utilizzare per la sottoscrizione. Strategia: GitOps.
--version
Indicare il nome o l'ID della versione di configurazione esistente da utilizzare per la sottoscrizione. Per trovare le versioni, esegui il comando ibmcloud sat config get --config <configuration_name_or_ID>. Strategia: caricamento diretto.

Esempi

Crea un abbonamento " Satellite " per i cluster

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

ibmcloud sat subscription get

Satellite

Acquisire le informazioni dettagliate per una sottoscrizione Satellite.

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

Opzioni comando

--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subscription
Inserisci il nome o l'ID di un abbonamento a " Satellite ". Per trovare gli abbonamenti, esegui il comando ibmcloud sat subscription ls``.

Esempi

Ottieni informazioni dettagliate sull'abbonamento a “ Satellite ”

ibmcloud sat subscription get --subscription SUBSCRIPTION

ibmcloud sat subscription help

Mostra la guida

ibmcloud sat subscription help

Esempi

Mostra la guida

ibmcloud sat subscription help

ibmcloud sat subscription identity help

Mostra la guida

ibmcloud sat subscription identity help

Esempi

Mostra la guida

ibmcloud sat subscription identity help

ibmcloud sat subscription identity set

Satellite

Aggiorna l'abbonamento a " Satellite " per utilizzare la tua identità nella gestione delle risorse.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subscription
Specificare il nome o l'ID di una sottoscrizione Satellite. Per visualizzare l'elenco degli abbonamenti, eseguire il comando ibmcloud sat subscription ls``.

Esempi

Aggiorna l'abbonamento a " Satellite " per utilizzare la tua identità nella gestione delle risorse

ibmcloud sat subscription identity set --subscription SUBSCRIPTION

ibmcloud sat subscription ls

Satellite

Elencare tutte le sottoscrizioni Satellite nell'account IBM Cloud.

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

Opzioni comando

-c, --cluster
Specificare il nome o ID del cluster Satellite. Per individuare i cluster registrati, eseguire il comando ibmcloud sat cluster ls.
--output
Stampare l'output del comando nel formato fornito. Valori accettati: json
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.

Esempi

Elenca tutti gli abbonamenti a " Satellite " nel tuo account IBM Cloud

ibmcloud sat subscription ls

ibmcloud sat subscription rm

Satellite

Rimuovere una sottoscrizione Satellite. Le risorse Kubernetes non vengono più distribuite ai cluster.

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

Opzioni comando

-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--subscription
Fornire il nome o l'ID di una sottoscrizione Satellite. Per visualizzare l'elenco degli abbonamenti, eseguire il comando ibmcloud sat subscription ls``.

Esempi

Rimuovere un abbonamento a “ Satellite ”

ibmcloud sat subscription rm --subscription SUBSCRIPTION

ibmcloud sat subscription update

Satellite

Aggiornare una sottoscrizione Satellite.

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)

Opzioni comando

--auth-required
Fornire il segreto di autenticazione richiesto per connettersi al repository remoto. Strategia: GitOps.
-f
Forza l'esecuzione del comando senza richiedere l'intervento dell'utente.
-g, --group
Specificare i nuovi gruppi di cluster da sottoscrivere alla configurazione.
--gitref
Specificare il GitRef da utilizzare per la sottoscrizione Satellite. Strategia: GitOps.
--gitref-type
Indicare il tipo di GitRef da utilizzare per questa sottoscrizione Satellite. Strategia: GitOps. Valori consentiti: branch, commit, tag, release
--name
Fornire un nuovo nome della sottoscrizione Satellite.
--path
Indicare il percorso dei file del repository o degli asset di release nel repository remoto da utilizzare per la sottoscrizione Satellite. Strategia: GitOps.
-q
Non visualizza il messaggio dei promemoria di aggiornamento o del giorno.
--repository
Fornire l'URL del repository remoto da utilizzare per la sottoscrizione Satellite. Strategia: GitOps.
--subscription
Specificare il nome o l'ID di una sottoscrizione Satellite. Per visualizzare l'elenco degli abbonamenti, eseguire il comando ibmcloud sat subscription ls``.
--version
Indicare la versione di configurazione esistente da utilizzare per la sottoscrizione Satellite. Strategia: caricamento diretto.

Esempi

Aggiornare un abbonamento a " Satellite "

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