Référence d'interface de ligne de commande des commandes Satellite
Reportez-vous à ces commandes CLI d’ Satellite lorsque vous souhaitez automatiser la création et la gestion de votre emplacement Satellite, y compris les opérations relatives à l’emplacement, à l’hôte, au cluster et aux points de terminaison.
Pour installer l'interface de ligne de commande, voir Installation de l'interface de ligne de commande. Pour afficher une carte de haut niveau de toutes les commandes IBM Cloud Satellite, voir la carte CLI.
Prérequis
-
Installez l'interface de ligne de commande IBM Cloud.
-
Installez le plug-in
ksen exécutant la commande suivante :ibmcloud plugin install ks
Commandes ibmcloud sat
Les tableaux suivants répertorient les groupes de commandes ibmcloud sat. Pour obtenir la liste complète de toutes les commandes ibmcloud sat telles qu'elles sont organisées dans l'interface CLI, consultez la carte CLI.
| Groupe de commandes | Description |
|---|---|
ibmcloud sat connector |
Créez, affichez et modifiez des connecteurs Satellite. |
ibmcloud sat location |
Créez, affichez et modifiez les emplacements Satellite. |
ibmcloud sat endpoint |
Affichez et gérez les noeuds finaux Satellite. |
ibmcloud sat acl |
Afficher et gérer les listes de contrôle d'accès (ACL) d' Satellite. |
ibmcloud sat agent |
Ajouter ou consulter les agents du connecteur « Satellite ». |
ibmcloud sat host |
Affichez et modifiez des hôtes Satellite. |
ibmcloud sat cluster |
Enregistrez et gérez des clusters à utiliser avec les configurations Satellite. |
ibmcloud sat messages |
Afficher les messages utilisateur en cours. |
ibmcloud sat group |
Affichez et gérez les groupes de clusters Satellite. Les groupes de clusters sont utilisés pour abonner des clusters aux configurations Satellite des ressources Kubernetes. |
ibmcloud sat key |
Affichez et gérez les clés Satellite Config. |
ibmcloud sat config |
Affichez et gérez la configuration Satellite. |
ibmcloud sat resource |
Recherchez et affichez les ressources Kubernetes qui sont gérées par une configuration Satellite. |
ibmcloud sat service |
Affichez les clusters de services Satellite. |
ibmcloud sat storage |
Affichez et gérez des ressources de stockage Satellite. |
ibmcloud sat subscription |
Affichez et gérez les abonnements Satellite pour déployer les fichiers de configuration Kubernetes dans vos clusters. |
ibmcloud : commandes ACL
Afficher et gérer les listes de contrôle d'accès (ACL) d' Satellite.
ibmcloud sat acl create
Créez une liste de contrôle d'accès.
ibmcloud sat acl create --name NAME --subnet SUBNET [--subnet SUBNET ...] [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à activer pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Nom de la liste de contrôle d'accès (ACL).
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Créez une liste de contrôle d'accès.
ibmcloud sat acl create --location LOCATION --connector-id CONNECTOR_ID --name NAME
ibmcloud sat acl endpoint add
Ajouter un ou plusieurs points d'extrémité activés à une liste de contrôle d'accès.
ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à activer pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Ajouter un ou plusieurs points d'extrémité activés à une liste de contrôle d'accès.
ibmcloud sat acl endpoint add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl endpoint ls
Liste de tous les points d'extrémité activés pour un ACL.
ibmcloud sat acl endpoint ls --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Liste de tous les points d'extrémité activés pour un ACL.
ibmcloud sat acl endpoint ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl endpoint rm
Supprimer un ou plusieurs points de terminaison activés d'une liste de contrôle d'accès (ACL).
ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à désactiver pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimer un ou plusieurs points de terminaison activés d'une liste de contrôle d'accès (ACL).
ibmcloud sat acl endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl get
Afficher les détails d'une liste de contrôle d'accès (ACL).
ibmcloud sat acl get --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Afficher les détails d'une liste de contrôle d'accès (ACL).
ibmcloud sat acl get --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID
ibmcloud sat acl ls
Répertorier toutes les listes de contrôle d'accès (ACL) associées à un connecteur ou à un emplacement d' Satellite.
ibmcloud sat acl ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertorier toutes les listes de contrôle d'accès (ACL) associées à un connecteur ou à un emplacement d' Satellite.
ibmcloud sat acl ls --location LOCATION --connector-id CONNECTOR_ID --output json
ibmcloud sat acl rm
Supprimer une ACL.
ibmcloud sat acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimer une ACL.
ibmcloud sat acl rm --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID
ibmcloud sat acl subnet add
Ajouter un ou plusieurs sous-réseaux à une ACL.
ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Ajouter un ou plusieurs sous-réseaux à une ACL.
ibmcloud sat acl subnet add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl subnet rm
Supprimer un ou plusieurs sous-réseaux d'une liste de contrôle d'accès.
ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Supprimer un ou plusieurs sous-réseaux d'une liste de contrôle d'accès.
ibmcloud sat acl subnet rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl update
Mettre à jour le nom d'un ACL.
ibmcloud sat acl update --acl-id ID --name NAME [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Le nouveau nom de l'ACL.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Mettre à jour le nom d'un ACL.
ibmcloud sat acl update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
Commandes de l'agent sat d'IBM Cloud
Ajouter ou consulter les agents du connecteur « Satellite ».
ibmcloud sat agent attach
Obtenir un agent de connexion « Satellite » pour une plateforme spécifique. Téléchargez l' .zip de l'agent pour Windows ou obtenez un lien vers la documentation relative aux environnements « Docker ».
ibmcloud sat agent attach --platform PLATFORM [-q]
Options de commande
--platform PLATFORM- La plate-forme de l'agent connecteur Satellite. Pour plus d'informations sur Docker, consultez la documentation à l'adresse https://ibm.biz/satconagent Options disponibles : windows, docker
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir un agent de connexion « Satellite » pour une plateforme spécifique.
ibmcloud sat agent attach --platform PLATFORM -q
ibmcloud sat agent ls
Répertorier tous les agents d'un connecteur « Satellite ».
ibmcloud sat agent ls --connector-id ID [--output OUTPUT] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertorier tous les agents d'un connecteur « Satellite ».
ibmcloud sat agent ls --connector-id CONNECTOR_ID --output json -q
Commandes du cluster SAT d'IBM Cloud
Enregistrez et gérez des clusters à utiliser avec les configurations Satellite.
ibmcloud sat cluster get
Cloud privé virtuel Infrastructure classique Satellite
Obtenez les détails d'un cluster enregistré.
ibmcloud sat cluster get --cluster CLUSTER [--output OUTPUT] [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez l'ID ou le nom du cluster. Pour afficher la liste des clusters enregistrés, exécutez la commande
ibmcloud sat cluster ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenez les détails d'un cluster enregistré.
ibmcloud sat cluster get --cluster CLUSTER_NAME_OR_ID --output json -q
ibmcloud sat cluster ls
Cloud privé virtuel Infrastructure classique Satellite
Répertoriez tous les clusters enregistrés sur votre compte IBM Cloud.
ibmcloud sat cluster ls [--filter FILTER] [--limit LIMIT] [--output OUTPUT] [-q]
Options de commande
--filter FILTER- Filtrez les clusters enregistrés par ID de cluster.
--limit LIMIT- Permet de limiter le nombre de clusters renvoyés.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les clusters enregistrés sur votre compte IBM Cloud.
ibmcloud sat cluster ls --filter FILTER --limit LIMIT --output json
ibmcloud sat cluster register
Obtenez une commande kubectl pour enregistrer votre cluster dans une configuration Satellite. Connectez-vous à votre cluster et exécutez cette commande pour installer un agent Satellite Config. Les clusters que vous exécutez dans
votre emplacement Satellite installent automatiquement cet agent.
ibmcloud sat cluster register --name NAME [-q] [--silent]
Options de commande
--name NAME- Spécifiez le nom du cluster à enregistrer
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--silent- Mode silencieux. Renvoie uniquement la commande d'enregistrement dans la sortie.
Exemples
Obtenez une commande kubectl pour enregistrer votre cluster dans une configuration Satellite.
ibmcloud sat cluster register --silent SILENT --name NAME -q
ibmcloud sat cluster unregister
Retirez un enregistrement de cluster. Le cluster n'est plus abonné à une configuration Satellite, mais le cluster et ses ressources existantes continuent de s'exécuter.
ibmcloud sat cluster unregister --cluster CLUSTER [-f] [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez l'ID ou le nom du cluster. Pour afficher la liste des clusters enregistrés, exécutez la commande
ibmcloud sat cluster ls. -f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Retirez un enregistrement de cluster.
ibmcloud sat cluster unregister --cluster CLUSTER_NAME_OR_ID -f -q
Commandes de configuration sat d'IBM Cloud
Affichez et gérez la configuration Satellite.
ibmcloud sat config create
Créez une configuration pour spécifier les ressources Kubernetes à déployer dans vos clusters, dans vos charges de travail Satellite.
ibmcloud sat config create --name NAME [-q] (--data-location LOCATION | --provider PROVIDER)
Options de commande
--data-location LOCATION- Spécifiez la région IBM dans laquelle stocker les données de configuration Satellite. Stratégie : Transfert direct.
--name NAME- Indiquez un nom pour la configuration Satellite.
--provider PROVIDER- Indiquez le fournisseur GitOps distant pour la configuration Satellite. Ce fournisseur stocke les définitions de ressource Kubernetes. Stratégie : GitOps. Valeurs autorisées: github, gitlab
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Créez une configuration pour spécifier les ressources d' Kubernetes s que vous souhaitez déployer sur vos clusters dans votre environnement de travail Satellite.
ibmcloud sat config create \
--name NAME \
--data-location LOCATION \
--provider PROVIDER_ID
ibmcloud sat config get
Obtenez les détails d'une configuration Satellite, par exemple les versions ou les abonnements associés à la configuration.
ibmcloud sat config get --config CONFIG [--output OUTPUT] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenez des détails sur une configuration d' Satellite, tels que les versions ou les abonnements associés à cette configuration.
ibmcloud sat config get --config CONFIG --output json -q
ibmcloud sat config ls
Répertoriez toutes les configurations Satellite dans votre compte IBM Cloud.
ibmcloud sat config ls [--output OUTPUT] [-q]
Options de commande
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez toutes les configurations Satellite dans votre compte IBM Cloud.
ibmcloud sat config ls --output json -q
ibmcloud sat config rename
Renommez une configuration Satellite.
ibmcloud sat config rename --config CONFIG --name NAME [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. --name NAME- Indiquez un nouveau nom pour la configuration Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Renommez une configuration Satellite.
ibmcloud sat config rename --config CONFIG --name NAME -q
ibmcloud sat config rm
Retirez une configuration Satellite. Vous devez d'abord retirer tous les abonnements associés. Toutes les versions sont supprimées. Effectuez une sauvegarde des définitions de ressource que vous voulez conserver.
ibmcloud sat config rm --config CONFIG [-f] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. -f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Retirez une configuration Satellite.
ibmcloud sat config rm --config CONFIG -f -q
ibmcloud sat config version create
Créez une version de configuration pour mettre à jour les ressources Kubernetes existantes pour vos charges de travail Satellite.
ibmcloud sat config version create --config CONFIG --file-format FORMAT --name NAME --read-config CONFIG [--description DESCRIPTION] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID de la configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. --description DESCRIPTION- Ajoutez une description de la version de configuration Satellite.
--file-format FORMAT- Indiquez le format de fichier de la version de configuration. Options disponibles: yaml
--name NAME- Indiquez un nom pour la version de configuration Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--read-config CONFIG- Spécifiez le chemin d'accès au fichier de version de configuration.
Exemples
Créez une version de configuration pour mettre à jour les ressources Kubernetes existantes pour vos charges de travail Satellite.
ibmcloud sat config version create \
--name NAME \
--config CONFIG \
--file-format FILE_PATH
ibmcloud sat config version get
Obtenez de détails sur une version de configuration Satellite.
ibmcloud sat config version get --config CONFIG --version VERSION [--output OUTPUT] [-q] [--save-config]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID de la configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--save-config- Téléchargez et sauvegardez la version de configuration dans un fichier temporaire.
--version VERSION- Spécifiez le nom ou l'ID de la version de configuration Satellite. Pour afficher la liste des versions de votre configuration, exécutez
ibmcloud sat config get --config <configuration_name_or_ID>.
Exemples
Obtenez de détails sur une version de configuration Satellite.
ibmcloud sat config version get \
--config CONFIG \
--version VERSION \
--save-config SAVE-CONFIG
ibmcloud sat config version rm
Retirez une version de configuration Satellite.
ibmcloud sat config version rm --config CONFIG --version VERSION [-f] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID de la configuration Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat config ls. -f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--version VERSION- Indiquez le nom ou l'ID de la version de configuration Satellite. Pour afficher la liste des versions, exécutez
ibmcloud sat config get --config <configuration_name_or_ID>.
Exemples
Retirez une version de configuration Satellite.
ibmcloud sat config version rm --config CONFIG --version VERSION -f
Commandes du connecteur SAT d'IBM Cloud
Créez, affichez et modifiez des connecteurs Satellite.
ibmcloud sat connector create
Créez un connecteur Satellite.
ibmcloud sat connector create --name NAME --region REGION [-q]
Options de commande
--name NAME- Nom du connecteur Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--region REGION- Région IBM Cloud pour la gestion de votre connecteur Satellite.
Exemples
Créez un connecteur Satellite.
ibmcloud sat connector create --name NAME --region REGION -q
ibmcloud sat connector get
Affichez les détails d'un connecteur Satellite.
ibmcloud sat connector get --connector-id ID [--output OUTPUT] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez les détails d'un connecteur Satellite.
ibmcloud sat connector get --connector-id CONNECTOR_ID --output json -q
ibmcloud sat connector ls
Consultez les connecteurs Satellite dans votre compte IBM Cloud.
ibmcloud sat connector ls [--after AFTER] [--first FIRST] [--output OUTPUT] [-q]
Options de commande
--after AFTER- Afficher les connecteurs Satellite après le curseur donné.
--first FIRST- Visualiser les connecteurs suivants Satellite, jusqu'au premier nombre de connecteurs.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Consultez les connecteurs Satellite dans votre compte IBM Cloud.
ibmcloud sat connector ls --after AFTER --first FIRST --output json
ibmcloud sat connector rm
Supprimez un connecteur Satellite.
ibmcloud sat connector rm --connector-id ID [-f] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
-f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez un connecteur Satellite.
ibmcloud sat connector rm --connector-id CONNECTOR_ID -f -q
Commandes de l'endpoint ibmcloud sat
Affichez et gérez les noeuds finaux Satellite.
ibmcloud sat endpoint authn get
Obtenir les paramètres d'authentification d'un point d'accès.
ibmcloud sat endpoint authn get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir les paramètres d'authentification d'un point d'accès.
ibmcloud sat endpoint authn get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint authn rotate
Remplacer les certificats d'authentification existants par de nouveaux. Le flux de requêtes comporte deux connexions « TLS ». Les options « source » font référence à la procédure d'établissement de la connexion « TLS » entre la
source et le service Connector. Les options « destination » (Configuration de la connexion) concernent la procédure d'établissement de la connexion TLS entre le service Connector et votre serveur de destination. Vous pouvez
fournir des certificats pour l'une de ces connexions ou les deux. Seuls les certificats que vous spécifiez sont remplacés.
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)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du serveur de destination. Par exemple,
myCA.pem. --dest-cert-file FILE- Le certificat client utilisé pour s'authentifier auprès du serveur de destination. Par exemple,
myCert.pem. --dest-key-file FILE- Clé privée du client utilisée pour chiffrer le certificat client. Par exemple,
myKey.pem. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--source-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du client source lorsque le mode source-tls-mode est mutuel. Par exemple,
myCA.pem. --source-cert-file FILE- Certificat serveur à présenter au client source. Par exemple,
myCert.pem. --source-key-file FILE- Clé privée du serveur utilisée pour chiffrer le certificat du serveur. Par exemple,
myKey.pem.
Exemples
Remplacer les certificats d'authentification existants par de nouveaux.
ibmcloud sat endpoint authn rotate \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint authn set
Définir les paramètres d'authentification pour un point d'extrémité. Le flux de requêtes comporte deux connexions « TLS ». Les options « source » font référence à la procédure d'établissement de la connexion « TLS » entre la source
et le service Connector. Les options « destination » (Configuration de la connexion) concernent la procédure d'établissement de la connexion TLS entre le service Connector et votre serveur de destination. Vous pouvez fournir
des certificats pour l'une de ces connexions ou les deux. Les paramètres non spécifiés sont définis sur leurs valeurs par défaut.
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)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du serveur de destination. Par exemple,
myCA.pem. --dest-cert-file FILE- Le certificat client utilisé pour s'authentifier auprès du serveur de destination. Par exemple,
myCert.pem. --dest-key-file FILE- Clé privée du client utilisée pour chiffrer le certificat client. Par exemple,
myKey.pem. --dest-tls-mode MODE- Le mode de destination TLS. Valeurs acceptées :
simple,mutual,none --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--source-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du client source lorsque le mode source-tls-mode est mutuel. Par exemple,
myCA.pem. --source-cert-file FILE- Certificat serveur à présenter au client source. Par exemple,
myCert.pem. --source-key-file FILE- Clé privée du serveur utilisée pour chiffrer le certificat du serveur. Par exemple,
myKey.pem. --source-tls-mode MODE- Mode « source- TLS ». Valeurs acceptées:
simple,mutual
Exemples
Définir les paramètres d'authentification pour un point d'extrémité.
ibmcloud sat endpoint authn set \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint create
Créez un noeud final.
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)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-hostname HOSTNAME- Indiquez le nom de domaine complet ou l'adresse IP accessible en externe de la destination à laquelle vous voulez vous connecter. Pour les points
cloudde terminaison, cette valeur doit correspondre à une adresse IP publique ou à une adresse IP privée accessible au sein d' IBM Cloud, comme un point de terminaison de service cloud privé. Pour les pointslocationde terminaison, cette valeur doit pouvoir être résolue et être accessible depuis les hôtes du plan de contrôle pour les emplacements d’ Satellite, ou depuis l’endroit où l’agent s’exécute pour le connecteur Satellite. --dest-port PORT- Indiquez le port sur lequel la ressource de destination est à l'écoute des demandes entrantes. Assurez-vous que le port correspond au protocole de destination.
--dest-protocol PROTOCOL- Spécifiez le protocole de la destination. Si vous ne spécifiez pas cette option, le protocole de destination est hérité du protocole source. Valeurs acceptées:
TCP,TLS --dest-type TYPE- Précisez où la ressource de destination s'exécute, soit dans IBM Cloud (
cloud) soit dans votre emplacement Satellite (location). Options disponibles : emplacement, cloud --idle-timeout-seconds SECONDS- Indiquez le délai d'attente en secondes pour les connexions actives à la destination. Vérifiez que votre délai d'attente est compatible avec les paramètres du service de destination et du protocole
keep-alive. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Indiquez un nom pour le noeud final.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--sni SNI- Spécifiez l'indicateur de nom de serveur si vous indiquez un protocole source
httpsoutlset que vous souhaitez qu'un nom d'hôte distinct soit ajouté à la négociation de connexion TLS. --source-protocol PROTOCOL- Indiquez le protocole utilisé par la source pour connecter la ressource de destination. Voir http://ibm.biz/endpoint-protocols. Options disponibles : TCP, TLS, HTTP, HTTPS, HTTP-tunnel
Exemples
Créez un noeud final.
ibmcloud sat endpoint create \
--location LOCATION \
--connector-id CONNECTOR_ID \
--name NAME
ibmcloud sat endpoint disable
Désactiver un point d'extrémité.
ibmcloud sat endpoint disable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). -f- Force la commande à s'exécuter sans invites utilisateur.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Désactiver un point d'extrémité.
ibmcloud sat endpoint disable \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint enable
Activer un point d'extrémité.
ibmcloud sat endpoint enable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). -f- Force la commande à s'exécuter sans invites utilisateur.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Activer un point d'extrémité.
ibmcloud sat endpoint enable \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint get
Permet d'afficher les détails d'un noeud final.
ibmcloud sat endpoint get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Permet d'afficher les détails d'un noeud final.
ibmcloud sat endpoint get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint ls
Répertoriez tous les noeuds finaux se trouvant dans un emplacement Satellite.
ibmcloud sat endpoint ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les noeuds finaux se trouvant dans un emplacement Satellite.
ibmcloud sat endpoint ls --location LOCATION --connector-id CONNECTOR_ID --output json
ibmcloud sat endpoint rm
Supprimez un noeud final.
ibmcloud sat endpoint rm --endpoint ENDPOINT [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez un noeud final.
ibmcloud sat endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint update
Mettez à jour un noeud final. Seules les options que vous spécifiez sont mises à jour.
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)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-hostname HOSTNAME- Indiquez le nom de domaine complet ou l'adresse IP accessible en externe de la destination à laquelle vous voulez vous connecter. Pour les points
cloudde terminaison, cette valeur doit correspondre à une adresse IP publique ou à une adresse IP privée accessible au sein d' IBM Cloud, comme un point de terminaison de service cloud privé. Pour les pointslocationde terminaison, cette valeur doit pouvoir être résolue et être accessible depuis les hôtes du plan de contrôle pour les emplacements d’ Satellite, ou depuis l’endroit où l’agent s’exécute pour le connecteur Satellite. --dest-port PORT- Indiquez le port sur lequel la ressource de destination est à l'écoute des demandes entrantes. Assurez-vous que le port correspond au protocole de destination.
--dest-protocol PROTOCOL- Spécifiez le protocole de la destination. Si vous ne spécifiez pas cette option, le protocole de destination est hérité du protocole source. Valeurs acceptées:
TCP,TLS --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --idle-timeout-seconds SECONDS- Indiquez le délai d'attente en secondes pour les connexions actives à la destination. Vérifiez que votre délai d'attente est compatible avec les paramètres du service de destination et du protocole
keep-alive. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Indiquez un nouveau nom pour le noeud final.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--sni SNI- Spécifiez l'indicateur de nom de serveur si vous indiquez un protocole source
httpsoutlset que vous souhaitez qu'un nom d'hôte distinct soit ajouté à la négociation de connexion TLS. --source-protocol PROTOCOL- Indiquez le protocole utilisé par la source pour connecter la ressource de destination. Voir http://ibm.biz/endpoint-protocols. Valeurs autorisées :
TCP,TLS,HTTP,HTTPS,HTTP-tunnel
Exemples
Mettez à jour un noeud final.
ibmcloud sat endpoint update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud : commandes expérimentales
[Date d'expiration : 2024-11-25] Testez de nouvelles commandes. IMPORTANT : les commandes mentionnées ici seront retirées après la [date] indiquée dans leur description.
ibmcloud sat experimental acl create
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat acl create au lieu de] Créer une ACL.
ibmcloud sat experimental acl create --name NAME --subnet SUBNET [--subnet SUBNET ...] [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à activer pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Nom de la liste de contrôle d'accès (ACL).
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Créez une liste de contrôle d'accès.
ibmcloud sat experimental acl create \
--location LOCATION \
--connector-id CONNECTOR_ID \
--name NAME
ibmcloud sat experimental acl endpoint add
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat acl endpoint add au lieu de] Ajouter un ou plusieurs points de terminaison activés à une liste de contrôle d'accès.
ibmcloud sat experimental acl endpoint add --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à activer pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Ajouter un ou plusieurs points d'extrémité activés à une liste de contrôle d'accès.
ibmcloud sat experimental acl endpoint add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl endpoint ls
[Désactivé sur 2024-10-01! Utilisez ibmcloud sat acl endpoint ls au lieu de] Liste de tous les points de terminaison activés pour une ACL.
ibmcloud sat experimental acl endpoint ls --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Liste de tous les points d'extrémité activés pour un ACL.
ibmcloud sat experimental acl endpoint ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl endpoint rm
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat acl endpoint rm au lieu de] Supprimer un ou plusieurs points de terminaison activés d'une liste de contrôle d'accès.
ibmcloud sat experimental acl endpoint rm --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Nom ou ID d'un terminal à désactiver pour cet ACL.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimer un ou plusieurs points de terminaison activés d'une liste de contrôle d'accès (ACL).
ibmcloud sat experimental acl endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl get
[Désactivé sur 2024-10-01! Utilisez ibmcloud sat acl get au lieu de] Affichez les détails d'une ACL.
ibmcloud sat experimental acl get --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Afficher les détails d'une liste de contrôle d'accès (ACL).
ibmcloud sat experimental acl get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl ls
[Désactivé sur 2024-10-01! Utilisez plutôt ibmcloud sat acl ls] pour répertorier toutes les listes de contrôle d'accès (ACL) d'un connecteur ou d'un emplacement Satellite.
ibmcloud sat experimental acl ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertorier toutes les listes de contrôle d'accès (ACL) associées à un connecteur ou à un emplacement d' Satellite.
ibmcloud sat experimental acl ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--output json
ibmcloud sat experimental acl rm
[Désactivé sur 2024-10-01! Utilisez ibmcloud sat acl rm au lieu de] Supprimer une ACL.
ibmcloud sat experimental acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimer une ACL.
ibmcloud sat experimental acl rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl subnet add
[Désactivé sur 2024-10-01! Utilisez ibmcloud sat acl subnet add au lieu de] Ajoutez un ou plusieurs sous-réseaux à une liste de contrôle d'accès.
ibmcloud sat experimental acl subnet add --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Ajouter un ou plusieurs sous-réseaux à une ACL.
ibmcloud sat experimental acl subnet add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl subnet rm
[Désactivé sur 2024-10-01! Utilisez ibmcloud sat acl subnet rm au lieu de] Supprimez un ou plusieurs sous-réseaux d'une liste de contrôle d'accès.
ibmcloud sat experimental acl subnet rm --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subnet SUBNET- Un bloc IP ou CIDR autorisé par cette ACL. La valeur doit être entièrement comprise dans les CIDR suivants : 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Exemples
Supprimer un ou plusieurs sous-réseaux d'une liste de contrôle d'accès.
ibmcloud sat experimental acl subnet rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl update
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat acl update au lieu de] Mettre à jour le nom d'une ACL.
ibmcloud sat experimental acl update --acl-id ID --name NAME [-q] (--connector-id ID | --location LOCATION)
Options de commande
--acl-id ID- Spécifiez l'ID de l'ACL. Pour lister toutes les ACL, exécutez
ibmcloud sat acl ls. --connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Le nouveau nom de l'ACL.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Mettre à jour le nom d'un ACL.
ibmcloud sat experimental acl update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental agent attach
[Désactivé sur 2024-09-01! Utilisez plutôt ibmcloud sat agent attach au lieu de] . Procurez-vous un agent de connexion Satellite pour une plateforme spécifique. Téléchargez l' .zip de l'agent pour Windows ou obtenez
un lien vers la documentation relative aux environnements Docker.
ibmcloud sat experimental agent attach --platform PLATFORM [-q]
Options de commande
--platform PLATFORM- La plate-forme de l'agent connecteur Satellite. Pour plus d'informations sur Docker, consultez la documentation à l'adresse https://ibm.biz/satconagent Options disponibles : windows, docker
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir un agent de connexion « Satellite » pour une plateforme spécifique.
ibmcloud sat experimental agent attach --platform PLATFORM -q
ibmcloud sat experimental agent ls
[Désactivé sur 2024-09-01! Utilisez plutôt ibmcloud sat agent ls] pour répertorier tous les agents d'un connecteur Satellite.
ibmcloud sat experimental agent ls --connector-id ID [--output OUTPUT] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertorier tous les agents d'un connecteur « Satellite ».
ibmcloud sat experimental agent ls --connector-id CONNECTOR_ID --output json -q
ibmcloud sat experimental connector create
[Désactivé sur 2024-11-18! Utilisez ibmcloud sat connector create à la place de] . Créez un connecteur Satellite.
ibmcloud sat experimental connector create --name NAME --region REGION [-q]
Options de commande
--name NAME- Nom du connecteur Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--region REGION- Région IBM Cloud pour la gestion de votre connecteur Satellite.
Exemples
Créez un connecteur Satellite.
ibmcloud sat experimental connector create --name NAME --region REGION -q
ibmcloud sat experimental connector get
[Désactivé sur 2024-11-18! Utilisez plutôt ibmcloud sat connector get au lieu de] . Consultez les détails d'un connecteur Satellite.
ibmcloud sat experimental connector get --connector-id ID [--output OUTPUT] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez les détails d'un connecteur Satellite.
ibmcloud sat experimental connector get --connector-id CONNECTOR_ID --output json -q
ibmcloud sat experimental connector ls
[Désactivé sur 2024-11-18! Utilisez plutôt ibmcloud sat connector ls au lieu de] . Consultez les connecteurs Satellite dans votre compte IBM Cloud.
ibmcloud sat experimental connector ls [--after AFTER] [--first FIRST] [--output OUTPUT] [-q]
Options de commande
--after AFTER- Afficher les connecteurs Satellite après le curseur donné.
--first FIRST- Visualiser les connecteurs suivants Satellite, jusqu'au premier nombre de connecteurs.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Consultez les connecteurs Satellite dans votre compte IBM Cloud.
ibmcloud sat experimental connector ls --after AFTER --first FIRST --output json
ibmcloud sat experimental connector rm
[Désactivé sur 2024-11-18! Utilisez plutôt ibmcloud sat connector rm au lieu de] Supprimer un connecteur Satellite.
ibmcloud sat experimental connector rm --connector-id ID [-f] [-q]
Options de commande
--connector-id ID- ID d'un connecteur Satellite.
-f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez un connecteur Satellite.
ibmcloud sat experimental connector rm --connector-id CONNECTOR_ID -f -q
ibmcloud sat experimental endpoint authn get
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat endpoint authn get au lieu de] Obtenir les paramètres d'authentification pour un point d'extrémité.
ibmcloud sat experimental endpoint authn get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir les paramètres d'authentification d'un point d'accès.
ibmcloud sat experimental endpoint authn get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental endpoint authn rotate
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat endpoint authn rotate au lieu de] Remplacer les certificats d'authentification existants par de nouveaux. Le flux de requêtes comporte deux connexions « TLS ». Les options « source » font référence à la procédure d'établissement de la connexion ( TLS ) entre la source et le service Connector. Les options « destination » (Configuration de la connexion) concernent la procédure d'établissement de la connexion
( TLS ) entre le service Connector et votre serveur de destination. Vous pouvez fournir des certificats pour l'une de ces connexions ou les deux. Seuls les certificats que vous spécifiez sont remplacés.
ibmcloud sat experimental endpoint authn rotate --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du serveur de destination. Par exemple,
myCA.pem. --dest-cert-file FILE- Le certificat client utilisé pour s'authentifier auprès du serveur de destination. Par exemple,
myCert.pem. --dest-key-file FILE- Clé privée du client utilisée pour chiffrer le certificat client. Par exemple,
myKey.pem. --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--source-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du client source lorsque le mode source-tls-mode est mutuel. Par exemple,
myCA.pem. --source-cert-file FILE- Certificat serveur à présenter au client source. Par exemple,
myCert.pem. --source-key-file FILE- Clé privée du serveur utilisée pour chiffrer le certificat du serveur. Par exemple,
myKey.pem.
Exemples
Remplacer les certificats d'authentification existants par de nouveaux.
ibmcloud sat experimental endpoint authn rotate \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental endpoint authn set
[Désactivé sur 2024-10-01! Utiliser ibmcloud sat endpoint authn set au lieu de] Définir les paramètres d'authentification pour un point d'extrémité. Le flux de requêtes comporte deux connexions « TLS ». Les options « source » font référence à la procédure d'établissement de la connexion ( TLS ) entre la source et le service Connector. Les options « destination » (Configuration de la connexion) concernent la procédure d'établissement de la connexion
( TLS ) entre le service Connector et votre serveur de destination. Vous pouvez fournir des certificats pour l'une de ces connexions ou les deux. Les paramètres non spécifiés sont définis sur leurs valeurs par défaut.
ibmcloud sat experimental endpoint authn set --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [--dest-tls-mode MODE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] [--source-tls-mode MODE] (--connector-id ID | --location LOCATION)
Options de commande
--connector-id ID- L'identifiant du connecteur Satellite. Pour trouver l'ID de connecteur, exécutez
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du serveur de destination. Par exemple,
myCA.pem. --dest-cert-file FILE- Le certificat client utilisé pour s'authentifier auprès du serveur de destination. Par exemple,
myCert.pem. --dest-key-file FILE- Clé privée du client utilisée pour chiffrer le certificat client. Par exemple,
myKey.pem. --dest-tls-mode MODE- Le mode de destination TLS. Valeurs acceptées :
simple,mutual,none --endpoint ENDPOINT- Spécifiez le nom ou l'ID du noeud final. Pour répertorier tous les points de terminaison, exécutez
ibmcloud sat endpoint ls. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--source-ca-cert-file FILE- Certificat ou chaîne de l'autorité de certification digne de confiance utilisé pour valider le certificat du client source lorsque le mode source-tls-mode est mutuel. Par exemple,
myCA.pem. --source-cert-file FILE- Certificat serveur à présenter au client source. Par exemple,
myCert.pem. --source-key-file FILE- Clé privée du serveur utilisée pour chiffrer le certificat du serveur. Par exemple,
myKey.pem. --source-tls-mode MODE- Mode « source- TLS ». Valeurs acceptées:
simple,mutual
Exemples
Définir les paramètres d'authentification pour un point d'extrémité.
ibmcloud sat experimental endpoint authn set \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental location update
[Désactivé sur 2024-11-25! Utilisez plutôt ibmcloud sat location update] Mettre à jour le nom ou la description d'un lieu sur Satellite.
ibmcloud sat experimental location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]
Options de commande
--description DESCRIPTION- Saisissez une nouvelle description pour l'emplacement Satellite. La longueur de la description est limitée à 400 octets.
--location-id ID- L'identifiant de l'emplacement de l' Satellite. Pour trouver l'identifiant d'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Spécifiez un nouveau nom pour l'emplacement Satellite. Les noms de lieux doivent commencer par une lettre, peuvent contenir des lettres, des chiffres, des points (.) et des tirets (-), et doivent comporter moins de 36 caractères. Ne pas réutiliser les noms, y compris les noms des lieux supprimés.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Mettre à jour le nom ou la description d'un emplacement Satellite
ibmcloud sat experimental location update \
--location-id LOCATION \
--name NAME \
--description IP_ADDRESS
Commandes du groupe ibmcloud sat
Affichez et gérez les groupes de clusters Satellite. Les groupes de clusters sont utilisés pour abonner des clusters aux configurations Satellite des ressources Kubernetes.
ibmcloud sat group attach
Ajoutez un cluster à votre groupe de clusters. Le cluster peut s'exécuter dans votre emplacement Satellite ou dans IBM Cloud. Pour ajouter un cluster qui s'exécute dans IBM Cloud, vous devez d'abord enregistrer le cluster auprès de Satellite Config.
ibmcloud sat group attach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifier le nom ou l'ID du cluster. Pour afficher la liste des clusters enregistrés, exécutez la commande
ibmcloud sat cluster ls. --group GROUP,-g GROUP- Spécifiez le nom ou l'ID d'un groupe de clusters Satellite. Pour afficher les groupes de clusters disponibles, exécutez
ibmcloud sat group ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Ajoutez un cluster à votre groupe de clusters.
ibmcloud sat group attach --group GROUP --cluster CLUSTER_NAME_OR_ID -q
ibmcloud sat group create
créez un groupe de clusters. Vous pouvez ensuite abonner le groupe de clusters à une configuration Satellite.
ibmcloud sat group create --name NAME [--cluster CLUSTER ...] [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez l'ID ou le nom de cluster à ajouter au groupe de clusters. Pour afficher la liste des clusters enregistrés, exécutez la commande
ibmcloud sat cluster ls. --name NAME- Indiquez un nom pour le groupe de clusters Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
créez un groupe de clusters.
ibmcloud sat group create --name NAME --cluster CLUSTER_NAME_OR_ID -q
ibmcloud sat group detach
Retire un ou plusieurs clusters de votre groupe de clusters Satellite et supprime les ressources Kubernetes gérées par les abonnements du groupe.
ibmcloud sat group detach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-f] [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifier le nom ou l'ID du cluster. Pour répertorier les clusters de votre groupe de clusters, exécutez la commande
ibmcloud sat group get --group <cluster_group_name_or_ID>. -f- Force la commande à s'exécuter sans invites utilisateur.
--group GROUP,-g GROUP- Spécifiez le nom ou l'ID d'un groupe de clusters Satellite. Pour afficher les groupes de clusters disponibles, exécutez
ibmcloud sat group ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprime un ou plusieurs clusters de votre groupe de clusters Satellite et supprime les ressources Kubernetes qui étaient gérées par celui-ci.
ibmcloud sat group detach --group GROUP --cluster CLUSTER_NAME_OR_ID -f
ibmcloud sat group get
Obtenez des informations détaillées sur un groupe de clusters Satellite.
ibmcloud sat group get --group GROUP [--output OUTPUT] [-q]
Options de commande
--group GROUP,-g GROUP- Spécifiez le nom ou l'ID d'un groupe de clusters Satellite. Pour afficher la liste des clusters enregistrés, exécutez la commande
ibmcloud sat cluster ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenez des informations détaillées sur un groupe de clusters Satellite.
ibmcloud sat group get --group GROUP --output json -q
ibmcloud sat group ls
Répertoriez tous les groupes de clusters Satellite dans votre compte IBM Cloud.
ibmcloud sat group ls [--output OUTPUT] [-q]
Options de commande
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les groupes de clusters Satellite dans votre compte IBM Cloud.
ibmcloud sat group ls --output json -q
ibmcloud sat group rm
Retirez un groupe de clusters Satellite, ce qui désabonne les clusters et supprime les ressources Kubernetes gérées par les abonnements du groupe.
ibmcloud sat group rm --group GROUP [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
--group GROUP,-g GROUP- Spécifiez le nom ou l'ID d'un groupe de clusters Satellite. Pour afficher les groupes de clusters disponibles, exécutez
ibmcloud sat group ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimer un groupe de clusters d' Satellite, ce qui désabonne les clusters et supprime les ressources Kubernetes qui étaient gérées par ce groupe.
ibmcloud sat group rm --group GROUP -f -q
Commandes SAT d'IBM Cloud
Affichez et modifiez des hôtes Satellite.
ibmcloud sat host assign
Affectez un hôte à un cluster ou à un plan de contrôle d'emplacement Satellite.
ibmcloud sat host assign --location LOCATION [--cluster CLUSTER] [--host HOST] [--host-label LABEL ...] [-q] [--worker-pool POOL] [--zone ZONE]
Options de commande
--cluster CLUSTER- Nom ou ID du cluster auquel affecter l'hôte. Pour répertorier les clusters disponibles, exécutez
ibmcloud sat cluster ls. Si aucun cluster n'est fourni, l'hôte est automatiquement affecté au plan de contrôle Satellite. --host HOST- Nom ou ID de l'hôte à affecter. Pour affecter automatiquement des hôtes en fonction de libellés, n'incluez pas cette option. Pour extraire l'ID de l'hôte, exécutez
ibmcloud sat host ls --location <location_ID_or_name>. --host-label LABEL,--hl LABEL- Saisissez les étiquettes sous forme de paires clé-valeur afin d’identifier l’hôte à attribuer à votre plan de contrôle Satellite ou à votre cluster Red Hat OpenShift. Le premier hôte associé à ce libellé et qui n'est pas affecté est affecté
automatiquement au plan de contrôle ou au cluster. Pour rechercher les libellés d'hôte disponibles, exécutez
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--worker-pool POOL,-p POOL- Nom ou ID du pool de noeuds worker du cluster auquel affecter l'hôte. Si aucun pool de noeuds worker n'est spécifié, l'hôte est affecté au pool de noeuds worker par défaut.
--zone ZONE- Nom ou ID de la zone auquel affecter l'hôte. Pour connaître les zones disponibles, exécutez
ibmcloud sat location get --location <location_name_or_ID>et recherchez le champHost Zones.
Exemples
Affectez un hôte à un cluster ou à un plan de contrôle d'emplacement Satellite.
ibmcloud sat host assign \
--location LOCATION \
--cluster CLUSTER_NAME_OR_ID \
--worker-pool POOL_NAME
ibmcloud sat host attach
Créez et téléchargez un script que vous pouvez exécuter sur vos hôtes pour les connecter à votre emplacement. Pour les emplacements pour lesquels RHCOS est activé, le script est un fichier ignition.
ibmcloud sat host attach --location LOCATION [--host-label LABEL ...] [--host-link-agent-endpoint ENDPOINT] [--operating-system SYSTEM] [-q] [--reset-key]
Options de commande
--host-label LABEL,--hl LABEL- Saisissez les étiquettes sous forme de paires clé-valeur afin d’identifier l’hôte à attribuer à votre plan de contrôle Satellite ou à votre cluster Red Hat OpenShift. Le premier hôte associé à ce libellé et qui n'est pas affecté est affecté
automatiquement au plan de contrôle ou au cluster. Pour rechercher les libellés d'hôte disponibles, exécutez
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --host-link-agent-endpoint ENDPOINT- Noeud final utilisé par l'agent de liaison pour se connecter au serveur de tunnel de liaison.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --operating-system SYSTEM- Système d'exploitation des hôtes que vous souhaitez connecter à votre emplacement. Pour que vous puissiez connecter des hôtes RHCOS, RHCOS doit être activé pour votre emplacement. Valeurs acceptées:
RHEL,RHCOS -q- Permet de masquer le message du jour et les rappels de mise à jour.
--reset-key- Réinitialisez la clé utilisée par le plan de contrôle pour connecter et attribuer des hôtes dans l'emplacement. Voir https://ibm.biz/reset-key.
Exemples
Créez et téléchargez un script que vous pouvez exécuter sur vos hôtes pour les connecter à votre emplacement.
ibmcloud sat host attach \
--location LOCATION \
--host-label HOSTNAME \
--reset-key RESET-KEY
ibmcloud sat host get
Affichez les détails d'un hôte Satellite.
ibmcloud sat host get --host HOST --location LOCATION [--output OUTPUT] [-q]
Options de commande
--host HOST- ID de l'hôte Satellite. Pour trouver l'ID de l'hôte, exécutez
ibmcloud sat host ls <location_ID_or_name>. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez les détails d'un hôte Satellite.
ibmcloud sat host get --location LOCATION --host HOSTNAME --output json
ibmcloud sat host ls
Répertoriez tous les hôtes associés à un emplacement Satellite, notamment les hôtes affectés aux clusters ou au plan de contrôle.
ibmcloud sat host ls --location LOCATION [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les hôtes associés à un emplacement d' Satellite, y compris ceux affectés à des clusters ou au panneau de contrôle.
ibmcloud sat host ls --location LOCATION --output json -q
ibmcloud sat host rm
Retirez un hôte d'un emplacement Satellite.
ibmcloud sat host rm --host HOST --location LOCATION [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
--host HOST- Nom ou ID de l'hôte à retirer.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Retirez un hôte d'un emplacement Satellite.
ibmcloud sat host rm --location LOCATION --host HOSTNAME -f
ibmcloud sat host update
Mettez à jour les informations d'hôte, telles que les zones et les libellés.
ibmcloud sat host update --host HOST --location LOCATION [--host-label LABEL ...] [-q] [--zone ZONE]
Options de commande
--host HOST- Nom ou ID de l'hôte à affecter. Pour affecter automatiquement des hôtes en fonction de libellés, n'incluez pas cette option.
--host-label LABEL,--hl LABEL- Saisissez les étiquettes sous forme de paires clé-valeur afin d’identifier l’hôte à attribuer à votre plan de contrôle Satellite ou à votre cluster Red Hat OpenShift. Le premier hôte associé à ce libellé et qui n'est pas affecté est affecté
automatiquement au plan de contrôle ou au cluster. Pour rechercher les libellés d'hôte disponibles, exécutez
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--zone ZONE- Le nom ou l'ID de la zone à associer à l'hôte. Vous ne pouvez pas changer la zone des hôtes qui sont affectés à une ressource, par exemple un cluster. Vous devez d'abord annuler l'affectation des hôtes. Pour afficher la liste des zones
disponibles, exécutez
ibmcloud sat location get --location <ID>.
Exemples
Mettez à jour les informations d'hôte, telles que les zones et les libellés.
ibmcloud sat host update --location LOCATION --host-label HOSTNAME --zone ZONE
Commandes clés de sat pour IBM Cloud
Affichez et gérez les clés Satellite Config.
ibmcloud sat key ls
Répertoriez toutes les clés de configuration Satellite dans votre compte IBM Cloud.
ibmcloud sat key ls [--output OUTPUT] [-q]
Options de commande
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez toutes les clés de configuration Satellite dans votre compte IBM Cloud.
ibmcloud sat key ls --output json -q
ibmcloud sat key rm
Supprimez une clé Satellite Config. Les clusters qui utilisent encore cette clé ne peuvent pas se connecter à Satellite Config.
ibmcloud sat key rm --key KEY [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
--key KEY- Nom ou ID d'une clé Satellite Config.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez une clé Satellite Config.
ibmcloud sat key rm --key KEY -f -q
ibmcloud sat key rotate
Générez une nouvelle clé à utiliser par les clusters gérés pour vous connecter à Satellite Config.
ibmcloud sat key rotate --name NAME [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
--name NAME- Nom de la nouvelle clé Satellite Config.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Générez une nouvelle clé à utiliser par les clusters gérés pour vous connecter à Satellite Config.
ibmcloud sat key rotate --name NAME -f -q
Commandes de localisation sat ibmcloud
Créez, affichez et modifiez les emplacements Satellite.
ibmcloud sat location create
Créez un emplacement Satellite. Un emplacement Satellite est la représentation d'un environnement dans votre fournisseur d'infrastructure. Une fois que vous avez créé un emplacement, associez-y des hôtes provenant de zones distinctes de votre
environnement d'infrastructure sous-jacente à l'aide de la commande 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]
Options de commande
--capability CAPABILITY- Une fonctionnalité de l' Satellite.
--coreos-enabled- Activez les fonctions Red Hat CoreOS pour l'emplacement Satellite. Cette action ne peut pas être annulée. Voir https://ibm.biz/infra-os.
--cos-bucket BUCKET- Spécifiez le nom du compartiment IBM Cloud Object Storage dans lequel stocker vos données de plan de contrôle de l'emplacement Satellite. Autrement, un nouveau compartiment sera créé automatiquement.
--description DESCRIPTION- Entrez une description de l'emplacement Satellite.
--ha-zone ZONE- Spécifiez la zone pour votre emplacement. Pour garantir une haute disponibilité, spécifiez 3 zones pour votre emplacement comme suit :
--ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. Les noms des zones doivent être exactement identiques aux noms des zones correspondantes dans le fournisseur d'infrastructure dans lequel vous prévoyez de créer des hôtes. --managed-from REGION- Sélectionnez la région IBM Cloud à partir de laquelle gérer votre emplacement Satellite. Choisissez une région proche de votre centre de données sur site pour de meilleures performances. Voir https://ibm.biz/sat-region.
--name NAME- Spécifiez un nom pour l'emplacement Satellite. Les noms de lieux doivent commencer par une lettre, peuvent contenir des lettres, des chiffres, des points (.) et des tirets (-), et doivent comporter moins de 36 caractères. Ne réutilisez pas les noms, même si l'autre emplacement est supprimé.
--physical-address ADDRESS- L'adresse physique de l'emplacement du Satellite.
--pod-network-interface-selection SELECTION- Méthode de sélection de l'interface réseau de noeud pour le réseau de pod interne. Cette option ne peut être utilisée que si vous activez également Red Hat CoreOS avec l'option
--coreos-enabled. Pour fournir une adresse URL ou IP directe, spécifiezcan-reach=<url>oucan-reach=<ip_address>. Pour choisir une interface réseau, spécifiezinterface=<network_interface>. --pod-subnet SUBNET- Spécifiez un routage CIDR de sous-réseau personnalisé pour fournir les adresses IP privées des pods. Cette option n'est utilisée que si vous activez Red Hat CoreOS avec l'option
--coreos-enabled. Le sous-réseau doit avoir une taille d'au moins ou/23plus. Voir https://ibm.biz/sat-location-create. Valeur par défaut : '172.16.0.0/16 --provider PROVIDER- Indiquez le fournisseur d'infrastructure à utiliser pour l'emplacement Satellite. Si vous incluez cette option, vous devez également inclure l'option
--provider-credential. Valeurs acceptées:aws,azure,gcp,vmware --provider-credential CREDENTIAL- Spécifiez le chemin d'accès à un fichier JSON sur votre machine locale qui possède les données d'identification du fournisseur d'infrastructure pour l'emplacement Satellite. Le format des données d'identification est spécifique au fournisseur. Voir http://ibm.biz/sat-infra-creds.
--provider-region REGION- Spécifiez la région du fournisseur d'infrastructure dans laquelle vous prévoyez de créer les hôtes pour l'emplacement Satellite. Si vous incluez cette option, vous devez également inclure l'option
--provider. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--service-subnet SUBNET- Spécifiez un routage CIDR de sous-réseau personnalisé pour fournir les adresses IP privées des services. Cette option n'est utilisée que si vous activez Red Hat CoreOS avec l'option
--coreos-enabled. Le sous-réseau doit avoir une taille d'au moins ou/24plus. Voir https://ibm.biz/sat-location-create. Valeur par défaut :172.20.0.0/16
Exemples
Créez un emplacement Satellite.
ibmcloud sat location create \
--pod-subnet SUBNET_CIDR \
--service-subnet SUBNET_CIDR \
--name NAME
ibmcloud sat location dns get
Affichez les détails d'un sous-domaine enregistré dans un emplacement Satellite.
ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subdomain SUBDOMAIN- Spécifiez le nom de sous-domaine. Pour afficher la liste des sous-domaines existants, exécutez
ibmcloud sat location dns ls --location <ID>.
Exemples
Affichez les détails d'un sous-domaine enregistré dans un emplacement Satellite.
ibmcloud sat location dns get --location LOCATION --subdomain DOMAIN --output json
ibmcloud sat location dns ls
Répertoriez les sous-domaines enregistrés dans un emplacement Satellite.
ibmcloud sat location dns ls --location LOCATION [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez les sous-domaines enregistrés dans un emplacement Satellite.
ibmcloud sat location dns ls --location LOCATION --output json -q
ibmcloud sat location dns register
Définissez un sous-domaine pour les hôtes affectés au plan de contrôle dans un emplacement Satellite.
ibmcloud sat location dns register --ip IP [--ip IP ...] --location LOCATION [--output OUTPUT] [-q]
Options de commande
--ip IP- Indiquez l'adresse IP de chaque hôte du plan de contrôle, au format
--ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Pour les clusters multizones, utilisez une adresse IP pour chaque zone. Pour trouver l'adresse IP, exécutezibmcloud sat host ls --location <location_ID_or_name>et recherchezWorker IPpour les hôtes portant la mentioninfrastructure. --location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Définissez un sous-domaine pour les hôtes affectés au plan de contrôle dans un emplacement Satellite.
ibmcloud sat location dns register --location LOCATION --ip IP_ADDRESS --output json
ibmcloud sat location get
Affichez les détails d'un emplacement Satellite.
ibmcloud sat location get --location LOCATION [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez les détails d'un emplacement Satellite.
ibmcloud sat location get --location LOCATION --output json -q
ibmcloud sat location ls
Répertoriez tous les emplacements Satellite de votre compte IBM Cloud.
ibmcloud sat location ls [--output OUTPUT] [-q]
Options de commande
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les emplacements Satellite de votre compte IBM Cloud.
ibmcloud sat location ls --output json -q
ibmcloud sat location rm
Supprimez un emplacement. Avant d'exécuter cette commande, effectuez une sauvegarde de vos configurations et retirez les hôtes et les clusters qui s'exécutent dans l'emplacement. L'infrastructure hôte sous-jacente n'est pas supprimée automatiquement lorsque vous supprimez un emplacement. Cette action ne peut pas être annulée.
ibmcloud sat location rm --location LOCATION [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez un emplacement.
ibmcloud sat location rm --location LOCATION -f -q
ibmcloud sat location update
Mettre à jour le nom ou la description d'un emplacement Satellite
ibmcloud sat location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]
Options de commande
--description DESCRIPTION- Saisissez une nouvelle description pour l'emplacement Satellite. La longueur de la description est limitée à 400 octets.
--location-id ID- L'identifiant de l'emplacement de l' Satellite. Pour trouver l'identifiant d'emplacement, exécutez
ibmcloud sat location ls. --name NAME- Spécifiez un nouveau nom pour l'emplacement Satellite. Les noms de lieux doivent commencer par une lettre, peuvent contenir des lettres, des chiffres, des points (.) et des tirets (-), et doivent comporter moins de 36 caractères. Ne pas réutiliser les noms, y compris les noms des lieux supprimés.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Mettre à jour le nom ou la description d'un emplacement Satellite
ibmcloud sat location update \
--location-id LOCATION \
--name NAME \
--description IP_ADDRESS
ibmcloud messages SAT commandes
Afficher les messages utilisateur en cours.
ibmcloud sat messages
Afficher les messages utilisateur en cours.
ibmcloud sat messages [-q]
Options de commande
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Afficher les messages utilisateur en cours.
ibmcloud sat messages -q
Commandes de la ressource ibmcloud sat
Recherchez et affichez les ressources Kubernetes qui sont gérées par une configuration Satellite.
ibmcloud sat resource get
Affichez les détails d'une ressource Kubernetes qui est gérée par une configuration Satellite.
ibmcloud sat resource get --resource RESOURCE [--history HISTORY] [--output OUTPUT] [-q] [--save-data]
Options de commande
--history HISTORY- ID d'historique de la ressource.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--resource RESOURCE- Spécifiez l'ID de ressource Kubernetes. Pour trouver des ressources sur l' Kubernetes, exécutez
ibmcloud sat resource ls. --save-data- Téléchargez et sauvegardez une définition de ressource Kubernetes dans un fichier temporaire.
Exemples
Affichez les détails d'une ressource Kubernetes qui est gérée par une configuration Satellite.
ibmcloud sat resource get \
--resource RESOURCE \
--history HISTORY \
--save-data SAVE-DATA
ibmcloud sat resource history get
Obtenez l'historique d'une ressource Kubernetes.
ibmcloud sat resource history get --resource RESOURCE [--limit LIMIT] [--output OUTPUT] [-q]
Options de commande
--limit LIMIT- Spécifiez le nombre maximal d'entrées d'historique à renvoyer.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--resource RESOURCE- ID de ressource Kubernetes.
Exemples
Obtenez l'historique d'une ressource Kubernetes.
ibmcloud sat resource history get --resource RESOURCE --limit LIMIT --output json
ibmcloud sat resource ls
Effectuez des recherches dans les ressources Kubernetes gérées par Satellite.
ibmcloud sat resource ls [--limit LIMIT] [--output OUTPUT] [-q] [--search SEARCH] (--cluster CLUSTER | --subscription SUBSCRIPTION)
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez le nom ou l'ID du cluster enregistré dans lequel la ressource Kubernetes s'exécute. Pour rechercher les clusters enregistrés, exécutez
ibmcloud sat cluster ls. --limit LIMIT- Spécifiez le nombre maximal d'entrées de ressource que la recherche doit renvoyer.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--search SEARCH- Indiquez la chaîne permettant de filtrer les résultats de la recherche de ressources Kubernetes, telles qu'un nom de pod ou d'espace de nom.
--subscription SUBSCRIPTION- Spécifiez l'ID ou le nom de l'abonnement Satellite. Pour rechercher des abonnements, exécutez
ibmcloud sat cluster ls.
Exemples
Effectuez des recherches dans les ressources Kubernetes gérées par Satellite.
ibmcloud sat resource ls --search SEARCH --limit LIMIT --cluster CLUSTER_NAME_OR_ID
Commandes du service sat d'IBM Cloud
Affichez les clusters de services Satellite.
ibmcloud sat service ls
Répertoriez tous les clusters de service Satellite se trouvant dans votre emplacement afin de consulter leurs détails, tels que les ressources hôte demandées.
ibmcloud sat service ls --location LOCATION [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Nom ou ID de l'emplacement Satellite. Pour trouver l'identifiant ou le nom de l'emplacement, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les clusters de service Satellite se trouvant dans votre emplacement afin de consulter leurs détails, tels que les ressources hôte demandées.
ibmcloud sat service ls --location LOCATION --output json -q
Commandes de stockage SAT d'IBM Cloud
Affichez et gérez des ressources de stockage Satellite.
ibmcloud sat storage assignment autopatch disable
La commande storage assignment autopatch disable est une fonction bêta.
Désactiver les correctifs automatiques pour une affectation de stockage « Satellite ».
ibmcloud sat storage assignment autopatch disable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)
Options de commande
--all- Désactivez les correctifs automatiques pour toutes les affectations de stockage Satellite d'une configuration de stockage.
--assignment ASSIGNMENT- ID de l'affectation de stockage Satellite. Pour répertorier les affectations de stockage disponibles pour la configuration, exécutez
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- Nom ou ID d'une configuration de stockage Satellite. Pour répertorier les configurations de stockage disponibles, exécutez
ibmcloud sat storage config ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Désactiver les correctifs automatiques pour une affectation de stockage « Satellite ».
ibmcloud sat storage assignment autopatch disable \
--config CONFIG \
--assignment ASSIGNMENT \
--all
ibmcloud sat storage assignment autopatch enable
La commande storage assignment autopatch enable est une fonction bêta.
Activer les correctifs automatiques pour une affectation de stockage « Satellite ».
ibmcloud sat storage assignment autopatch enable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)
Options de commande
--all- Activez les correctifs automatiques pour toutes les affectations de stockage Satellite d'une configuration de stockage.
--assignment ASSIGNMENT- ID de l'affectation de stockage Satellite. Pour répertorier les affectations de stockage disponibles pour la configuration, exécutez
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- Nom ou ID d'une configuration de stockage Satellite. Pour répertorier les configurations de stockage disponibles, exécutez
ibmcloud sat storage config ls. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Activer les correctifs automatiques pour une affectation de stockage « Satellite ».
ibmcloud sat storage assignment autopatch enable \
--config CONFIG \
--assignment ASSIGNMENT \
--all
ibmcloud sat storage assignment create
Créez une affectation pour déployer vos configurations de stockage sur des clusters de votre emplacement Satellite.
ibmcloud sat storage assignment create --config CONFIG [--name NAME] [-q] (--cluster CLUSTER | --group GROUP | --service-cluster-id CLUSTER)
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez l'ID du cluster Satellite pour l'affectation. Pour rechercher l'ID de cluster, exécutez
ibmcloud oc cluster ls --provider satellite. --config CONFIG- Indiquez la configuration de stockage Satellite pour l'affectation. pour rechercher des configurations, exécutez
ibmcloud sat storage config ls. --group GROUP,-g GROUP- Spécifiez les groupes de clusters pour l'affectation. Pour rechercher des groupes de clusters, exécutez
ibmcloud sat group ls. --name NAME- Indiquez un nom pour l'affectation de stockage Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--service-cluster-id CLUSTER- Spécifiez l'ID du cluster de service pour l'affectation. Pour trouver l'ID du cluster de services, exécutez
ibmcloud sat service ls --location <location>.
Exemples
Créez une affectation pour déployer vos configurations de stockage sur des clusters de votre emplacement Satellite.
ibmcloud sat storage assignment create \
--name NAME \
--group GROUP \
--service-cluster-id CLUSTER_NAME_OR_ID
ibmcloud sat storage assignment get
Obtenir les détails d'une affectation de stockage Satellite.
ibmcloud sat storage assignment get --assignment ASSIGNMENT [--output OUTPUT] [-q]
Options de commande
--assignment ASSIGNMENT- Spécifiez l'ID d'une affectation de stockage Satellite.
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir les détails d'une affectation de stockage Satellite.
ibmcloud sat storage assignment get --assignment ASSIGNMENT --output json -q
ibmcloud sat storage assignment ls
Affichez la liste des affectations de stockage Satellite dans votre compte IBM Cloud.
Pour répertorier toutes les affectations d'un cluster de services en tant qu'administrateur de service : ibmcloud sat storage assignation ls--service-cluster-id GRAPPE.
Pour répertorier toutes les affectations d'un cluster de services en tant qu'administrateur d'emplacement : ibmcloud sat storage assignation ls--location EMPLACEMENT--service-cluster-id GRAPPE.
Pour répertorier toutes les affectations d'une configuration : 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)
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez l'ID du cluster Satellite pour les affectations. Pour obtenir l'ID du cluster, exécutez
ibmcloud oc cluster ls --provider satellite. --config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour répertorier les configurations de stockage disponibles, exécutez
ibmcloud sat storage config ls. --location LOCATION- Spécifiez le nom d'un emplacement Satellite. Pour afficher la liste des emplacements disponibles, exécutez
ibmcloud sat location ls. Cette option ne peut pas être utilisée par l'administrateur de service. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--service-cluster-id CLUSTER- Spécifiez l'ID du cluster de service pour les affectations. Pour trouver l'ID du cluster de services, exécutez
ibmcloud sat service ls --location <location>.
Exemples
Affichez la liste des affectations de stockage Satellite dans votre compte IBM Cloud.
ibmcloud sat storage assignment ls \
--service-cluster-id CLUSTER_NAME_OR_ID \
--cluster CLUSTER_NAME_OR_ID \
--config CONFIG
ibmcloud sat storage assignment patch
Appliquez les modifications de configuration de stockage aux affectations associées.
ibmcloud sat storage assignment patch --assignment ASSIGNMENT [-f] [-q]
Alias : ibmcloud sat upgrade
Options de commande
--assignment ASSIGNMENT- Spécifiez l'ID d'une affectation de stockage Satellite. Pour afficher la liste des missions disponibles, exécutez
ibmcloud sat storage assignment ls. -f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Appliquez les modifications de configuration de stockage aux affectations associées.
ibmcloud sat storage assignment patch --assignment ASSIGNMENT -f -q
ibmcloud sat storage assignment rm
Supprimez une assignation de stockage Satellite. Les ressources Kubernetes sont supprimées de tous les clusters dans votre emplacement Satellite, mais la configuration est conservée.
ibmcloud sat storage assignment rm --assignment ASSIGNMENT [-f] [-q]
Options de commande
--assignment ASSIGNMENT- Spécifiez l'ID d'une affectation de stockage Satellite. Pour trouver des missions, lancez
ibmcloud sat storage assignment ls. -f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Supprimez une assignation de stockage Satellite.
ibmcloud sat storage assignment rm --assignment ASSIGNMENT -f -q
ibmcloud sat storage assignment update
Mettez à jour une affectation de stockage Satellite.
ibmcloud sat storage assignment update --assignment ASSIGNMENT [-f] [--group GROUP ...] [--name NAME] [-q]
Options de commande
--assignment ASSIGNMENT- Spécifiez l'ID d'une affectation de stockage Satellite.
-f- Force la commande à s'exécuter sans invites utilisateur.
--group GROUP,-g GROUP- Spécifiez les nouveaux groupes de clusters pour l'affectation. Pour afficher la liste des groupes disponibles, exécutez
ibmcloud sat group ls. --name NAME- Indiquez un nouveau nom pour l'affectation de stockage Satellite.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Mettez à jour une affectation de stockage Satellite.
ibmcloud sat storage assignment update \
--assignment ASSIGNMENT \
--name NAME \
--group GROUP
ibmcloud sat storage config class add
Créez une classe de stockage Satellite personnalisée.
ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM [--param PARAM ...] [-q]
Options de commande
--config-name NAME- Spécifiez le nom de la configuration de stockage pour la classe de stockage personnalisée. Pour répertorier les configurations de stockage d' Satellite, exécutez
ibmcloud sat storage config ls. --name NAME- Indiquez un nom pour la classe de stockage personnalisée.
--param PARAM,-p PARAM- Spécifiez une paire
key=valuede paramètres de classe de stockage. Pour afficher les paramètres de classe de stockage dans un modèle de stockage, exécutezibmcloud sat storage template get. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Créez une classe de stockage Satellite personnalisée.
ibmcloud sat storage config class add --name NAME --config-name NAME --param PARAM
ibmcloud sat storage config class get
Obtenir les détails d'une classe de stockage Satellite.
ibmcloud sat storage config class get --class CLASS --config CONFIG [--output OUTPUT] [-q]
Options de commande
--class CLASS- Spécifiez le nom d'une classe de stockage Satellite.
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour répertorier les configurations de stockage d' Satellite, exécutez
ibmcloud sat storage config ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir les détails d'une classe de stockage Satellite.
ibmcloud sat storage config class get --class CLASS --config CONFIG --output json
ibmcloud sat storage config class ls
Répertorier les classes de stockage dans une configuration de stockage Satellite
ibmcloud sat storage config class ls --config CONFIG [--output OUTPUT] [-q] [--show-params]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour répertorier les configurations de stockage d' Satellite, exécutez
ibmcloud sat storage config ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--show-params- Incluez cette option pour répertorier tous les détails des paramètres de classe de stockage.
Exemples
Énumérez les classes de stockage dans une configuration de stockage Satellite.
ibmcloud sat storage config class ls \
--config CONFIG \
--show-params SHOW-PARAMS \
--output json
ibmcloud sat storage config create
Créez une configuration de stockage Satellite pour installer des pilotes de stockage dans vos clusters.
ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME [--param PARAM ...] [-q] [--template-version VERSION]
Options de commande
--location LOCATION- Entrez l'ID ou le nom de l'emplacement de la configuration de stockage. Pour connaître les lieux disponibles, exécutez
ibmcloud sat location ls. --name NAME- Spécifiez le nom de la configuration de stockage.
--param PARAM,-p PARAM- Spécifiez une paire
key=valuede paramètres de configuration. Pour afficher les paramètres de configuration d'un modèle de stockage, exécutezibmcloud sat storage template get. -q- Permet de masquer le message du jour et les rappels de mise à jour.
--template-name NAME- Indiquez le nom de modèle de configuration de stockage Satellite. Pour afficher la liste des modèles de configuration de stockage disponibles, exécutez
ibmcloud sat storage template ls. --template-version VERSION- Indiquez la version des modèles de configuration de stockage Satellite. Si vous n'incluez pas cette option, la version par défaut est utilisée. Pour afficher la liste des modèles de configuration de stockage disponibles, exécutez
ibmcloud sat storage template ls.
Exemples
Créez une configuration de stockage Satellite pour installer des pilotes de stockage dans vos clusters.
ibmcloud sat storage config create \
--name NAME \
--template-name NAME \
--template-version VERSION
ibmcloud sat storage config get
Obtenir les détails d'une configuration de stockage Satellite.
ibmcloud sat storage config get --config CONFIG [--output OUTPUT] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat storage config ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Obtenir les détails d'une configuration de stockage Satellite.
ibmcloud sat storage config get --config CONFIG --output json -q
ibmcloud sat storage config ls
Affichez la liste des configurations de stockage Satellite dans votre compte IBM Cloud.
ibmcloud sat storage config ls [--location LOCATION] [--output OUTPUT] [-q]
Options de commande
--location LOCATION- Spécifiez l'ID ou le nom de l'emplacement contenant les configurations à répertorier. Pour connaître les lieux disponibles, exécutez
ibmcloud sat location ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez la liste des configurations de stockage Satellite dans votre compte IBM Cloud.
ibmcloud sat storage config ls --location LOCATION --output json -q
ibmcloud sat storage config param set
Définissez les paramètres de configuration et de secret d'une configuration de stockage Satellite.
ibmcloud sat storage config param set --config CONFIG --param PARAM [--param PARAM ...] [--apply] [-f] [-q]
Options de commande
--apply- Appliquez la dernière version de la configuration de stockage Satellite à toutes les affectations d'une configuration. Pour afficher les affectations d'une configuration, exécutez
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- Spécifiez le nom ou l'ID de la configuration de stockage. Pour répertorier les configurations de stockage d' Satellite, exécutez
ibmcloud sat storage config ls. -f- Force la commande à s'exécuter sans invites utilisateur.
--param PARAM,-p PARAM- Spécifiez une paire
key=valuede paramètres de configuration. Pour afficher les paramètres de configuration d'un modèle de stockage, exécutezibmcloud sat storage template get. -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Définissez les paramètres de configuration et de secret d'une configuration de stockage Satellite.
ibmcloud sat storage config param set --config CONFIG --param PARAM --apply APPLY
ibmcloud sat storage config patch
Appliquer les derniers correctifs à une configuration de stockage « Satellite ». Les mises à jour de correctif contiennent des correctifs de vulnérabilité et des correctifs de bogue dans la même version majeure.
ibmcloud sat storage config patch --config CONFIG [-f] [--include-assignments] [-q]
Alias : ibmcloud sat upgrade
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat storage config ls. -f- Force la commande à s'exécuter sans invites utilisateur.
--include-assignments- Incluez cette option pour mettre à jour les affectations de la configuration de stockage vers la dernière version de configuration.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Appliquer les derniers correctifs à une configuration de stockage « Satellite ».
ibmcloud sat storage config patch \
--config CONFIG \
--include-assignments INCLUDE-ASSIGNMENTS \
-f
ibmcloud sat storage config rm
Retirer une configuration de stockage Satellite.
ibmcloud sat storage config rm --config CONFIG [-f] [--include-assignments] [-q]
Options de commande
--config CONFIG- Spécifiez le nom ou l'ID d'une configuration de stockage Satellite. Pour afficher la liste des configurations disponibles, exécutez la commande
ibmcloud sat storage config ls. -f- Force la commande à s'exécuter sans invites utilisateur.
--include-assignments- Incluez cette option pour supprimer la configuration de stockage ainsi que les affectations associées.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Retirer une configuration de stockage Satellite.
ibmcloud sat storage config rm \
--config CONFIG \
--include-assignments INCLUDE-ASSIGNMENTS \
-f
ibmcloud sat storage template get
Obtenir les détails d'un modèle de stockage Satellite
ibmcloud sat storage template get --name NAME --version VERSION [--output OUTPUT] [-q]
Options de commande
--name NAME- Indiquez le nom de modèle de stockage. Pour afficher la liste des modèles de stockage disponibles, exécutez
ibmcloud sat storage template ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--version VERSION- Indiquez la version de modèle de stockage. Pour afficher la liste des modèles de stockage disponibles, exécutez
ibmcloud sat storage template ls.
Exemples
Découvrez les détails d'un modèle de stockage Satellite.
ibmcloud sat storage template get --name NAME --version VERSION --output json
ibmcloud sat storage template ls
Affichez la liste des modèles de stockage Satellite disponibles.
ibmcloud sat storage template ls [-q]
Options de commande
-q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Affichez la liste des modèles de stockage Satellite disponibles.
ibmcloud sat storage template ls -q
Commandes d'abonnement à IBM Cloud SAT
Affichez et gérez les abonnements Satellite pour déployer les fichiers de configuration Kubernetes dans vos clusters.
ibmcloud sat subscription create
Créez un abonnement Satellite pour les clusters. Une fois l'abonnement créé, la version de configuration Satellite associée est déployée automatiquement dans les clusters abonnés.
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)
Options de commande
--auth-required- Indiquez le secret d'authentification requis pour la connexion au référentiel distant. Pour plus d'informations, voir https://ibm.biz/sat-config-private-repo. Stratégie : GitOps.
--config CONFIG- Spécifiez le nom de la configuration à utiliser pour l'abonnement. Pour connaître les configurations disponibles, exécutez
ibmcloud sat config ls. --gitref GITREF- Spécifiez le GitRef à utiliser pour l'abonnement Satellite. Stratégie : GitOps.
--gitref-type TYPE- Indiquez le type de GitRef à utiliser pour l'abonnement Satellite. Stratégie : GitOps. Valeurs autorisées: branch, commit, tag, release
--group GROUP,-g GROUP- Spécifiez le nom ou l'ID des groupes de clusters à abonner à votre configuration. Pour rechercher les groupes de clusters disponibles, exécutez
ibmcloud sat group ls. --name NAME- Entrez un nom pour l'abonnement.
--path PATH- Indiquez le chemin d'accès aux fichiers de référentiel ou aux actifs d'édition dans le référentiel distant à utiliser pour l'abonnement Satellite. Stratégie : GitOps.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--repository REPOSITORY- Spécifiez l'URL du référentiel distant à utiliser pour l'abonnement. Stratégie : GitOps.
--version VERSION- Indiquez le nom ou l'ID de la version de configuration existante à utiliser pour l'abonnement. Pour trouver les versions, exécutez
ibmcloud sat config get --config <configuration_name_or_ID>. Stratégie : Transfert direct.
Exemples
Créez un abonnement Satellite pour les clusters.
ibmcloud sat subscription create \
--auth-required AUTH-REQUIRED \
--name NAME \
--group GROUP \
--config CONFIG
ibmcloud sat subscription get
Obtenez des informations détaillées sur un abonnement Satellite.
ibmcloud sat subscription get --subscription SUBSCRIPTION [--output OUTPUT] [-q]
Options de commande
--output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
--subscription SUBSCRIPTION- Saisissez le nom ou l'identifiant d'un abonnement à l' Satellite. Pour rechercher des abonnements, exécutez
ibmcloud sat subscription ls.
Exemples
Obtenez des informations détaillées sur un abonnement Satellite.
ibmcloud sat subscription get --subscription IP_ADDRESS --output json -q
ibmcloud sat subscription identity set
Mettez à jour l'abonnement Satellite afin d'utiliser votre identité pour gérer les ressources.
ibmcloud sat subscription identity set --subscription SUBSCRIPTION [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--subscription SUBSCRIPTION- Spécifiez le nom ou l'ID d'un abonnement Satellite. Pour afficher la liste des abonnements, exécutez
ibmcloud sat subscription ls.
Exemples
Mettez à jour l'abonnement Satellite afin d'utiliser votre identité pour gérer les ressources.
ibmcloud sat subscription identity set --subscription IP_ADDRESS -f -q
ibmcloud sat subscription ls
Répertoriez tous les abonnements Satellite dans votre compte IBM Cloud.
ibmcloud sat subscription ls [--cluster CLUSTER] [--output OUTPUT] [-q]
Options de commande
--cluster CLUSTER,-c CLUSTER- Spécifiez le nom ou l'ID du cluster Satellite. Pour rechercher les clusters enregistrés, exécutez
ibmcloud sat cluster ls. --output OUTPUT- Imprime la sortie de commande dans le format fourni. Valeurs acceptées :
json -q- Permet de masquer le message du jour et les rappels de mise à jour.
Exemples
Répertoriez tous les abonnements Satellite dans votre compte IBM Cloud.
ibmcloud sat subscription ls --cluster CLUSTER_NAME_OR_ID --output json -q
ibmcloud sat subscription rm
Retirez un abonnement Satellite. Les ressources Kubernetes ne sont plus déployées dans vos clusters.
ibmcloud sat subscription rm --subscription SUBSCRIPTION [-f] [-q]
Options de commande
-f- Force la commande à s'exécuter sans invites utilisateur.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--subscription SUBSCRIPTION- Indiquez le nom ou l'ID d'un abonnement Satellite. Pour afficher la liste des abonnements, exécutez
ibmcloud sat subscription ls.
Exemples
Retirez un abonnement Satellite.
ibmcloud sat subscription rm --subscription IP_ADDRESS -f -q
ibmcloud sat subscription update
Mettez à jour un abonnement 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)
Options de commande
--auth-required- Indiquez le secret d'authentification requis pour la connexion au référentiel distant. Stratégie : GitOps.
-f- Force la commande à s'exécuter sans invites utilisateur.
--gitref GITREF- Spécifiez le GitRef à utiliser pour l'abonnement Satellite. Stratégie : GitOps.
--gitref-type TYPE- Indiquez le type de GitRef à utiliser pour cet abonnement Satellite. Stratégie : GitOps. Valeurs autorisées: branch, commit, tag, release
--group GROUP,-g GROUP- Spécifiez les nouveaux groupes de clusters à abonner à votre configuration.
--name NAME- Indiquez un nouveau nom pour l'abonnement Satellite.
--path PATH- Indiquez le chemin d'accès aux fichiers de référentiel ou aux actifs d'édition dans le référentiel distant à utiliser pour l'abonnement Satellite. Stratégie : GitOps.
-q- Permet de masquer le message du jour et les rappels de mise à jour.
--repository REPOSITORY- Indiquez l'URL du référentiel distant à utiliser pour l'abonnement Satellite. Stratégie : GitOps.
--subscription SUBSCRIPTION- Spécifiez le nom ou l'ID d'un abonnement Satellite. Pour afficher la liste des abonnements, exécutez
ibmcloud sat subscription ls. --version VERSION- Indiquez la version de configuration existante à utiliser pour l'abonnement Satellite. Stratégie : Transfert direct.
Exemples
Mettez à jour un abonnement Satellite.
ibmcloud sat subscription update \
--auth-required AUTH-REQUIRED \
--subscription IP_ADDRESS \
--name NAME \
--group GROUP