Referencia de la CLI para comandos de Satellite
Consulte estos comandos de la interfaz de línea de comandos (CLI) de Satellite cuando desee automatizar la creación y la gestión de su ubicación de Satellite, incluidas las operaciones relacionadas con la ubicación, el host, el clúster y el punto final.
Para instalar la CLI, consulte Instalación de la CLI. Para ver un mapa de alto nivel de todos los comandos de IBM Cloud Satellite, consulte el mapa de la CLI.
Requisitos previos
-
Instale la CLI de IBM Cloud.
-
Instala el complemento
ksejecutando el siguiente comando :ibmcloud plugin install ks
mandatos ibmcloud sat
Las tablas siguientes listan los grupos de mandatos de ibmcloud sat. Para obtener una lista completa de todos comandos ibmcloud sat tal y como están estructurados en la CLI, consulta el mapa de la CLI.
| Grupo de mandatos | Descripción |
|---|---|
ibmcloud sat connector |
Crear, ver y modificar conectores de Satellite. |
ibmcloud sat location |
Crear, ver y modificar ubicaciones de Satellite. |
ibmcloud sat endpoint |
Ver y gestionar puntos finales de Satellite. |
ibmcloud sat acl |
Ver y gestionar las listas de control de acceso (ACL) de Satellite. |
ibmcloud sat agent |
Adjuntar o consultar los agentes del conector « Satellite ». |
ibmcloud sat host |
Vea y modifique los hosts de Satellite. |
ibmcloud sat cluster |
Registre y gestione clústeres para su uso con configuraciones de Satellite. |
ibmcloud sat messages |
Ver los mensajes del usuario actual. |
ibmcloud sat group |
Ver y gestionar grupos de clústeres de Satellite. Los grupos de clústeres se utilizan para suscribir clústeres a las configuraciones de Satellite de los recursos de Kubernetes. |
ibmcloud sat key |
Ver y gestionar las claves de configuración de Satellite. |
ibmcloud sat config |
Ver y gestionar la configuración de Satellite. |
ibmcloud sat resource |
Busque y vea los recursos de Kubernetes gestionados por una configuración de Satellite. |
ibmcloud sat service |
Ver clústeres de servicios de Satellite. |
ibmcloud sat storage |
Ver y gestionar recursos de almacenamiento de Satellite. |
ibmcloud sat subscription |
Ver y gestionar suscripciones de Satellite para desplegar archivos de configuración de Kubernetes en los clústeres. |
ibmcloud sat acl comandos
Ver y gestionar las listas de control de acceso (ACL) de Satellite.
ibmcloud sat acl create
Cree una ACL.
ibmcloud sat acl create --name NAME --subnet SUBNET [--subnet SUBNET ...] [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- El nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Cree una ACL.
ibmcloud sat acl create --location LOCATION --connector-id CONNECTOR_ID --name NAME
ibmcloud sat acl endpoint add
Añade uno o más puntos finales habilitados a una ACL.
ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Añade uno o más puntos finales habilitados a una ACL.
ibmcloud sat acl endpoint add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl endpoint ls
Lista todos los puntos finales habilitados para una ACL.
ibmcloud sat acl endpoint ls --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Lista todos los puntos finales habilitados para una ACL.
ibmcloud sat acl endpoint ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl endpoint rm
Elimina uno o más puntos finales habilitados de una ACL.
ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a deshabilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimina uno o más puntos finales habilitados de una ACL.
ibmcloud sat acl endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl get
Ver los detalles de una ACL.
ibmcloud sat acl get --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de una ACL.
ibmcloud sat acl get --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID
ibmcloud sat acl ls
Mostrar todas las ACL de un conector o una ubicación de « Satellite ».
ibmcloud sat acl ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Mostrar todas las ACL de un conector o una ubicación de « Satellite ».
ibmcloud sat acl ls --location LOCATION --connector-id CONNECTOR_ID --output json
ibmcloud sat acl rm
Borrar una ACL.
ibmcloud sat acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Borrar una ACL.
ibmcloud sat acl rm --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID
ibmcloud sat acl subnet add
Añade una o varias subredes a una ACL.
ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Añade una o varias subredes a una ACL.
ibmcloud sat acl subnet add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl subnet rm
Elimina una o varias subredes de una ACL.
ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Elimina una o varias subredes de una ACL.
ibmcloud sat acl subnet rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat acl update
Actualiza el nombre de una ACL.
ibmcloud sat acl update --acl-id ID --name NAME [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- El nuevo nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualiza el nombre de una ACL.
ibmcloud sat acl update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
Comandos agente SAT de IBM Cloud
Adjuntar o consultar los agentes del conector « Satellite ».
ibmcloud sat agent attach
Consigue un agente de conexión de Satellite para una plataforma concreta. Descarga el agente .zip para Windows u obtén un enlace a la documentación para entornos Docker.
ibmcloud sat agent attach --platform PLATFORM [-q]
Opciones de comando
--platform PLATFORM- La plataforma para el Agente Conector Satellite. Para obtener más información sobre Docker, consulte la documentación en https://ibm.biz/satconagent Opciones disponibles: windows, docker
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Consigue un agente de conexión de Satellite para una plataforma concreta.
ibmcloud sat agent attach --platform PLATFORM -q
ibmcloud sat agent ls
Mostrar todos los agentes de un conector de Satellite.
ibmcloud sat agent ls --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Mostrar todos los agentes de un conector de Satellite.
ibmcloud sat agent ls --connector-id CONNECTOR_ID --output json -q
Comandos clúster SAT de IBM Cloud
Registre y gestione clústeres para su uso con configuraciones de Satellite.
ibmcloud sat cluster get
Nube privada virtual Infraestructura clásica Satellite
Obtenga los detalles de un clúster registrado.
ibmcloud sat cluster get --cluster CLUSTER [--output OUTPUT] [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el nombre de clúster o el ID. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtenga los detalles de un clúster registrado.
ibmcloud sat cluster get --cluster CLUSTER_NAME_OR_ID --output json -q
ibmcloud sat cluster ls
Nube privada virtual Infraestructura clásica Satellite
Liste todos los clústeres registrados en su cuenta de IBM Cloud.
ibmcloud sat cluster ls [--filter FILTER] [--limit LIMIT] [--output OUTPUT] [-q]
Opciones de comando
--filter FILTER- Filtrar clústeres registrados por ID de clúster.
--limit LIMIT- Limitar el número de clústeres que se devuelven.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Liste todos los clústeres registrados en su cuenta de IBM Cloud.
ibmcloud sat cluster ls --filter FILTER --limit LIMIT --output json
ibmcloud sat cluster register
Consigue un comando kubectl para registrar tu clúster en una configuración de Satellite. Inicie sesión en el clúster y ejecute este mandato para instalar un agente de Satellite Config. Los clústeres que ejecuta en la ubicación
de Satellite instalan automáticamente este agente.
ibmcloud sat cluster register --name NAME [-q] [--silent]
Opciones de comando
--name NAME- Especifique el nombre del clúster que desea registrar
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--silent- Silenciosa. Devolver solo el mandato de registro en la salida.
Ejemplos
Consigue un comando kubectl para registrar tu clúster en una configuración de Satellite.
ibmcloud sat cluster register --silent SILENT --name NAME -q
ibmcloud sat cluster unregister
Elimine un registro de clúster. El clúster ya no está suscrito a una configuración de Satellite, pero el clúster y sus recursos existentes todavía se ejecutan.
ibmcloud sat cluster unregister --cluster CLUSTER [-f] [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el nombre de clúster o el ID. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimine un registro de clúster.
ibmcloud sat cluster unregister --cluster CLUSTER_NAME_OR_ID -f -q
Comandos de configuración de ibmcloud sat
Ver y gestionar la configuración de Satellite.
ibmcloud sat config create
Cree una configuración para especificar qué recursos de Kubernetes desea desplegar en los clústeres en las cargas de trabajo de Satellite.
ibmcloud sat config create --name NAME [-q] (--data-location LOCATION | --provider PROVIDER)
Opciones de comando
--data-location LOCATION- Especifique la región de IBM para almacenar los datos de configuración de Satellite. Estrategia: Carga directa.
--name NAME- Proporcione un nombre para la configuración de Satellite.
--provider PROVIDER- Indique el proveedor de GitOps remoto para la configuración de Satellite. Este proveedor almacena las definiciones de recursos de Kubernetes. Estrategia: GitOps. Valores permitidos: github, gitlab
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Crea una configuración para especificar qué recursos de Kubernetes deseas implementar en tus clústeres dentro de tu entorno de trabajo de Satellite.
ibmcloud sat config create \
--name NAME \
--data-location LOCATION \
--provider PROVIDER_ID
ibmcloud sat config get
Obtenga detalles de una configuración de Satellite, como por ejemplo las versiones o suscripciones que están asociadas con la configuración.
ibmcloud sat config get --config CONFIG [--output OUTPUT] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Consulta los detalles de una configuración de Satellite, como las versiones o las suscripciones asociadas a dicha configuración.
ibmcloud sat config get --config CONFIG --output json -q
ibmcloud sat config ls
Listar todas las configuraciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat config ls [--output OUTPUT] [-q]
Opciones de comando
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar todas las configuraciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat config ls --output json -q
ibmcloud sat config rename
Renombrar una configuración de Satellite.
ibmcloud sat config rename --config CONFIG --name NAME [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --name NAME- Proporcione un nuevo nombre para la configuración de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Renombrar una configuración de Satellite.
ibmcloud sat config rename --config CONFIG --name NAME -q
ibmcloud sat config rm
Elimine una configuración de Satellite. Primero deben eliminarse todas las suscripciones asociadas. Se suprimen todas las versiones. Realice una copia de seguridad de las definiciones de recursos que desee conservar.
ibmcloud sat config rm --config CONFIG [-f] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimine una configuración de Satellite.
ibmcloud sat config rm --config CONFIG -f -q
ibmcloud sat config version create
Cree una versión de configuración para actualizar los recursos de Kubernetes existentes para las cargas de trabajo de Satellite.
ibmcloud sat config version create --config CONFIG --file-format FORMAT --name NAME --read-config CONFIG [--description DESCRIPTION] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --description DESCRIPTION- Añada una descripción para la versión de configuración de Satellite.
--file-format FORMAT- Indique el formato de archivo de la versión de configuración. Opciones disponibles: yaml
--name NAME- Proporcione un nombre para la versión de configuración de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--read-config CONFIG- Especifique la vía de acceso de archivo para el archivo de versión de configuración.
Ejemplos
Cree una versión de configuración para actualizar los recursos de Kubernetes existentes para las cargas de trabajo de Satellite.
ibmcloud sat config version create \
--name NAME \
--config CONFIG \
--file-format FILE_PATH
ibmcloud sat config version get
Obtener información detallada de una versión de configuración de Satellite.
ibmcloud sat config version get --config CONFIG --version VERSION [--output OUTPUT] [-q] [--save-config]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--save-config- Descargar y guardar la versión de configuración en un archivo temporal.
--version VERSION- Especifique el nombre o el ID de la versión de configuración de Satellite. Para listar las versiones de su configuración, ejecute
ibmcloud sat config get --config <configuration_name_or_ID>.
Ejemplos
Obtener información detallada de una versión de configuración de Satellite.
ibmcloud sat config version get \
--config CONFIG \
--version VERSION \
--save-config SAVE-CONFIG
ibmcloud sat config version rm
Eliminar una versión de configuración de Satellite.
ibmcloud sat config version rm --config CONFIG --version VERSION [-f] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--version VERSION- Indique el nombre o el ID de la versión de configuración de Satellite. Para ver la lista de versiones, ejecuta
ibmcloud sat config get --config <configuration_name_or_ID>.
Ejemplos
Eliminar una versión de configuración de Satellite.
ibmcloud sat config version rm --config CONFIG --version VERSION -f
Comandos conector SAT de IBM Cloud
Crear, ver y modificar conectores de Satellite.
ibmcloud sat connector create
Cree un conector de Satellite.
ibmcloud sat connector create --name NAME --region REGION [-q]
Opciones de comando
--name NAME- El nombre del conector de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--region REGION- La región de IBM Cloud para gestionar el conector de Satellite.
Ejemplos
Cree un conector de Satellite.
ibmcloud sat connector create --name NAME --region REGION -q
ibmcloud sat connector get
Ver los detalles de un conector Satellite.
ibmcloud sat connector get --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de un conector Satellite.
ibmcloud sat connector get --connector-id CONNECTOR_ID --output json -q
ibmcloud sat connector ls
Consulta los conectores de Satellite en tu cuenta de IBM Cloud.
ibmcloud sat connector ls [--after AFTER] [--first FIRST] [--output OUTPUT] [-q]
Opciones de comando
--after AFTER- Mostrar Satellite tras el cursor dado.
--first FIRST- Ver los siguientes Satellite, hasta el primer número de Conectores.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Consulta los conectores de Satellite en tu cuenta de IBM Cloud.
ibmcloud sat connector ls --after AFTER --first FIRST --output json
ibmcloud sat connector rm
Suprimir un conector de Satellite.
ibmcloud sat connector rm --connector-id ID [-f] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Suprimir un conector de Satellite.
ibmcloud sat connector rm --connector-id CONNECTOR_ID -f -q
Comandos punto final de ibmcloud sat
Ver y gestionar puntos finales de Satellite.
ibmcloud sat endpoint authn get
Obtener la configuración de autenticación de un endpoint.
ibmcloud sat endpoint authn get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtener la configuración de autenticación de un endpoint.
ibmcloud sat endpoint authn get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint authn rotate
Sustituya los certificados de autenticación existentes por otros nuevos. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre la fuente y el servicio
Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Solo se sustituyen
los certificados que especifiques.
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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file FILE- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file FILE- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo,
myCA.pem. --source-cert-file FILE- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file FILE- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem.
Ejemplos
Sustituya los certificados de autenticación existentes por otros nuevos.
ibmcloud sat endpoint authn rotate \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint authn set
Establezca la configuración de autenticación para un punto final. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre la fuente y el servicio
Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Los valores no especificados
se establecen en sus valores predeterminados.
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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file FILE- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file FILE- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --dest-tls-mode MODE- El modo TLS de destino. Valores aceptados:
simple,mutual,none --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo,
myCA.pem. --source-cert-file FILE- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file FILE- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem. --source-tls-mode MODE- La fuente: modo « TLS ». Valores aceptados:
simple,mutual
Ejemplos
Establezca la configuración de autenticación para un punto final.
ibmcloud sat endpoint authn set \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint create
Crear un punto 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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-hostname HOSTNAME- Indique el nombre de dominio completo (FQDN) o la dirección IP accesible desde el exterior del destino al que desea conectarse. En el caso de los puntos
cloudfinales, este valor debe resolverse en una dirección IP pública o en una dirección IP privada a la que se pueda acceder desde IBM Cloud, como un punto final de un servicio en la nube privada. En el caso de los puntoslocationfinales, este valor debe resolverse y ser accesible desde los hosts del plano de control para las ubicaciones de Satellite, o desde donde se ejecuta el agente para Satellite Connector. --dest-port PORT- Indique el puerto en el que el recurso de destino escucha las solicitudes entrantes. Asegúrese de que el puerto coincida con el protocolo de destino.
--dest-protocol PROTOCOL- Especifique el protocolo del destino. Si no especifica esta opción, el protocolo de destino se hereda del protocolo de origen. Valores aceptados:
TCP,TLS --dest-type TYPE- Especifica dónde se ejecuta el recurso de destino, ya sea en IBM Cloud (
cloud) o en tu ubicación Satellite (location). Opciones disponibles: ubicación, nube --idle-timeout-seconds SECONDS- Especifique el intervalo de tiempo de espera en segundos para las conexiones activas con el destino. Asegúrese de que el tiempo de espera sea compatible con los valores del servicio de destino y del protocolo
keep-alive. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- Proporcione un nombre para el punto final.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--sni SNI- Especifique el indicador de nombre de servidor si indica un protocolo de origen
httpsotlsy desea que se añada un nombre de host independiente al protocolo de enlace de TLS. --source-protocol PROTOCOL- Indique el protocolo que el origen utiliza para conectar el recurso de destino. Véase http://ibm.biz/endpoint-protocols. Opciones disponibles: TCP, TLS, HTTP, HTTPS, HTTP-tunnel
Ejemplos
Crear un punto final.
ibmcloud sat endpoint create \
--location LOCATION \
--connector-id CONNECTOR_ID \
--name NAME
ibmcloud sat endpoint disable
Desactivar un punto final.
ibmcloud sat endpoint disable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Desactivar un punto final.
ibmcloud sat endpoint disable \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint enable
Habilitar un punto final.
ibmcloud sat endpoint enable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Habilitar un punto final.
ibmcloud sat endpoint enable \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint get
Ver los detalles de un punto final.
ibmcloud sat endpoint get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de un punto final.
ibmcloud sat endpoint get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint ls
Liste todos los puntos finales en una ubicación de Satellite.
ibmcloud sat endpoint ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Liste todos los puntos finales en una ubicación de Satellite.
ibmcloud sat endpoint ls --location LOCATION --connector-id CONNECTOR_ID --output json
ibmcloud sat endpoint rm
Suprimir un punto final.
ibmcloud sat endpoint rm --endpoint ENDPOINT [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Suprimir un punto final.
ibmcloud sat endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat endpoint update
Actualizar un punto final. Solo se actualizan las opciones que especifique.
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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-hostname HOSTNAME- Indique el nombre de dominio completo (FQDN) o la dirección IP accesible desde el exterior del destino al que desea conectarse. En el caso de los puntos
cloudfinales, este valor debe resolverse en una dirección IP pública o en una dirección IP privada a la que se pueda acceder desde IBM Cloud, como un punto final de un servicio en la nube privada. En el caso de los puntoslocationfinales, este valor debe resolverse y ser accesible desde los hosts del plano de control para las ubicaciones de Satellite, o desde donde se ejecuta el agente para Satellite Connector. --dest-port PORT- Indique el puerto en el que el recurso de destino escucha las solicitudes entrantes. Asegúrese de que el puerto coincida con el protocolo de destino.
--dest-protocol PROTOCOL- Especifique el protocolo del destino. Si no especifica esta opción, el protocolo de destino se hereda del protocolo de origen. Valores aceptados:
TCP,TLS --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION). --idle-timeout-seconds SECONDS- Especifique el intervalo de tiempo de espera en segundos para las conexiones activas con el destino. Asegúrese de que el tiempo de espera sea compatible con los valores del servicio de destino y del protocolo
keep-alive. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- Proporcione un nuevo nombre para el punto final.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--sni SNI- Especifique el indicador de nombre de servidor si indica un protocolo de origen
httpsotlsy desea que se añada un nombre de host independiente al protocolo de enlace de TLS. --source-protocol PROTOCOL- Indique el protocolo que el origen utiliza para conectar el recurso de destino. Véase http://ibm.biz/endpoint-protocols. Valores admitidos:
TCP,TLS,HTTP,HTTPS,HTTP-tunnel
Ejemplos
Actualizar un punto final.
ibmcloud sat endpoint update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud: comandos experimentales de sat
[Caduca el 2024-11-25] Prueba nuevos comandos. IMPORTANTE: Comandos aparecen aquí dejarán de estar disponibles a partir de la [fecha] indicada en su descripción.
ibmcloud sat experimental acl create
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl create en lugar de] Crear una ACL.
ibmcloud sat experimental acl create --name NAME --subnet SUBNET [--subnet SUBNET ...] [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- El nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Cree una ACL.
ibmcloud sat experimental acl create \
--location LOCATION \
--connector-id CONNECTOR_ID \
--name NAME
ibmcloud sat experimental acl endpoint add
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint add en su lugar] Añada uno o más puntos finales habilitados a una ACL.
ibmcloud sat experimental acl endpoint add --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Añade uno o más puntos finales habilitados a una ACL.
ibmcloud sat experimental acl endpoint add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl endpoint ls
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint ls en lugar de] Enumerar todos los extremos habilitados para una ACL.
ibmcloud sat experimental acl endpoint ls --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Lista todos los puntos finales habilitados para una ACL.
ibmcloud sat experimental acl endpoint ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl endpoint rm
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint rm en lugar de] Elimine uno o más puntos finales habilitados de una ACL.
ibmcloud sat experimental acl endpoint rm --acl-id ID --endpoint ENDPOINT [--endpoint ENDPOINT ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Un nombre o ID de un endpoint a deshabilitar para esta ACL.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimina uno o más puntos finales habilitados de una ACL.
ibmcloud sat experimental acl endpoint rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl get
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl get en lugar de] Ver los detalles de una ACL.
ibmcloud sat experimental acl get --acl-id ID [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de una ACL.
ibmcloud sat experimental acl get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl ls
[¡Desactivado en 2024-10-01! Utiliza « ibmcloud sat acl ls » en lugar de «] » para mostrar todas las ACL de un conector o una ubicación de Satellite.
ibmcloud sat experimental acl ls [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Mostrar todas las ACL de un conector o una ubicación de « Satellite ».
ibmcloud sat experimental acl ls \
--location LOCATION \
--connector-id CONNECTOR_ID \
--output json
ibmcloud sat experimental acl rm
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl rm en lugar de] Eliminar una ACL.
ibmcloud sat experimental acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Borrar una ACL.
ibmcloud sat experimental acl rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl subnet add
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl subnet add en lugar de] Añada una o varias subredes a una ACL.
ibmcloud sat experimental acl subnet add --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Añade una o varias subredes a una ACL.
ibmcloud sat experimental acl subnet add \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl subnet rm
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl subnet rm en lugar de] Elimine una o varias subredes de una ACL.
ibmcloud sat experimental acl subnet rm --acl-id ID --subnet SUBNET [--subnet SUBNET ...] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET- Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.
Ejemplos
Elimina una o varias subredes de una ACL.
ibmcloud sat experimental acl subnet rm \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental acl update
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl update en lugar de] Actualice el nombre de una ACL.
ibmcloud sat experimental acl update --acl-id ID --name NAME [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id ID- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name NAME- El nuevo nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualiza el nombre de una ACL.
ibmcloud sat experimental acl update \
--location LOCATION \
--connector-id CONNECTOR_ID \
--acl-id ACL_ID
ibmcloud sat experimental agent attach
[¡Desactivado en 2024-09-01! Utiliza ibmcloud sat agent attach en lugar de] . Descarga un agente de conexión de Satellite para una plataforma concreta. Descarga el agente .zip para Windows u obtén un enlace a la documentación
para entornos Docker.
ibmcloud sat experimental agent attach --platform PLATFORM [-q]
Opciones de comando
--platform PLATFORM- La plataforma para el Agente Conector Satellite. Para obtener más información sobre Docker, consulte la documentación en https://ibm.biz/satconagent Opciones disponibles: windows, docker
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Consigue un agente de conexión de Satellite para una plataforma concreta.
ibmcloud sat experimental agent attach --platform PLATFORM -q
ibmcloud sat experimental agent ls
[¡Desactivado en 2024-09-01! Utiliza ibmcloud sat agent ls en lugar de] para obtener una lista de todos los agentes de un conector Satellite.
ibmcloud sat experimental agent ls --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Mostrar todos los agentes de un conector de Satellite.
ibmcloud sat experimental agent ls --connector-id CONNECTOR_ID --output json -q
ibmcloud sat experimental connector create
[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector create en lugar de] . Crea un conector Satellite.
ibmcloud sat experimental connector create --name NAME --region REGION [-q]
Opciones de comando
--name NAME- El nombre del conector de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--region REGION- La región de IBM Cloud para gestionar el conector de Satellite.
Ejemplos
Cree un conector de Satellite.
ibmcloud sat experimental connector create --name NAME --region REGION -q
ibmcloud sat experimental connector get
[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector get en lugar de] . Consulta los detalles de un conector de Satellite.
ibmcloud sat experimental connector get --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de un conector Satellite.
ibmcloud sat experimental connector get --connector-id CONNECTOR_ID --output json -q
ibmcloud sat experimental connector ls
[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector ls en lugar de] . Consulta los conectores de Satellite en tu cuenta de IBM Cloud.
ibmcloud sat experimental connector ls [--after AFTER] [--first FIRST] [--output OUTPUT] [-q]
Opciones de comando
--after AFTER- Mostrar Satellite tras el cursor dado.
--first FIRST- Ver los siguientes Satellite, hasta el primer número de Conectores.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Consulta los conectores de Satellite en tu cuenta de IBM Cloud.
ibmcloud sat experimental connector ls --after AFTER --first FIRST --output json
ibmcloud sat experimental connector rm
[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector rm en lugar de] . Elimina un conector de Satellite.
ibmcloud sat experimental connector rm --connector-id ID [-f] [-q]
Opciones de comando
--connector-id ID- El ID de un conector de Satellite.
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Suprimir un conector de Satellite.
ibmcloud sat experimental connector rm --connector-id CONNECTOR_ID -f -q
ibmcloud sat experimental endpoint authn get
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn get en lugar de] Obtenga la configuración de autenticación de un endpoint.
ibmcloud sat experimental endpoint authn get --endpoint ENDPOINT [--output OUTPUT] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtener la configuración de autenticación de un endpoint.
ibmcloud sat experimental endpoint authn get \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental endpoint authn rotate
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn rotate en su lugar] Sustituya los certificados de autenticación existentes por otros nuevos. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las
opciones « source » se refieren al protocolo de enlace « TLS » entre el origen y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor
de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Solo se sustituyen los certificados que especifiques.
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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file FILE- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file FILE- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo,
myCA.pem. --source-cert-file FILE- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file FILE- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem.
Ejemplos
Sustituya los certificados de autenticación existentes por otros nuevos.
ibmcloud sat experimental endpoint authn rotate \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental endpoint authn set
[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn set en lugar de] Establezca la configuración de autenticación para un punto final. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones «
source » se refieren al protocolo de enlace « TLS » entre el origen y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino.
Puede proporcionar certificados para una o ambas de estas conexiones. Los valores no especificados se establecen en sus valores predeterminados.
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)
Opciones de comando
--connector-id ID- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file FILE- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file FILE- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --dest-tls-mode MODE- El modo TLS de destino. Valores aceptados:
simple,mutual,none --endpoint ENDPOINT- Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta
ibmcloud sat endpoint ls. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE- Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo,
myCA.pem. --source-cert-file FILE- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file FILE- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem. --source-tls-mode MODE- La fuente: modo « TLS ». Valores aceptados:
simple,mutual
Ejemplos
Establezca la configuración de autenticación para un punto final.
ibmcloud sat experimental endpoint authn set \
--location LOCATION \
--connector-id CONNECTOR_ID \
--endpoint ENDPOINT
ibmcloud sat experimental location update
[¡Desactivado en 2024-11-25! Utiliza ibmcloud sat location update en lugar de] . Actualiza el nombre o la descripción de una ubicación de Satellite.
ibmcloud sat experimental location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]
Opciones de comando
--description DESCRIPTION- Introduce una nueva descripción para la ubicación Satellite. La longitud de la descripción está limitada a 400 bytes.
--location-id ID- El identificador de la ubicación de Satellite. Para encontrar el ID de ubicación, ejecuta
ibmcloud sat location ls. --name NAME- Especifica un nuevo nombre para la ubicación Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice los nombres, incluidos los de las ubicaciones eliminadas.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualiza el nombre o la descripción de una localización de Satellite.
ibmcloud sat experimental location update \
--location-id LOCATION \
--name NAME \
--description IP_ADDRESS
Comandos del grupo sat de ibmcloud
Ver y gestionar grupos de clústeres de Satellite. Los grupos de clústeres se utilizan para suscribir clústeres a las configuraciones de Satellite de los recursos de Kubernetes.
ibmcloud sat group attach
Añada un clúster al grupo de clústeres. El clúster se puede ejecutar en la ubicación de Satellite o en IBM Cloud. Para añadir un clúster que se ejecute en IBM Cloud, primero debe registrar el clúster con Satellite Config.
ibmcloud sat group attach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el ID o nombre de clúster. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. --group GROUP,-g GROUP- Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute
ibmcloud sat group ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Añada un clúster al grupo de clústeres.
ibmcloud sat group attach --group GROUP --cluster CLUSTER_NAME_OR_ID -q
ibmcloud sat group create
Cree un grupo de clústeres. A continuación, puede suscribir el grupo de clústeres a una configuración de Satellite.
ibmcloud sat group create --name NAME [--cluster CLUSTER ...] [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el nombre o el ID de clúster que desea añadir al grupo de clústeres. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. --name NAME- Proporcione un nombre del grupo de clústeres de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Cree un grupo de clústeres.
ibmcloud sat group create --name NAME --cluster CLUSTER_NAME_OR_ID -q
ibmcloud sat group detach
Elimina uno o varios clústeres del grupo de clústeres de Satellite, y suprime los recursos de Kubernetes que estaban gestionados por las suscripciones del grupo.
ibmcloud sat group detach --cluster CLUSTER [--cluster CLUSTER ...] --group GROUP [-f] [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el ID o nombre de clúster. Para ver la lista de clústeres de tu grupo de clústeres, ejecuta
ibmcloud sat group get --group <cluster_group_name_or_ID>. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP,-g GROUP- Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute
ibmcloud sat group ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimina uno o varios clústeres de su grupo de clústeres Satellite y borra los recursos Kubernetes que gestionaba dicho grupo.
ibmcloud sat group detach --group GROUP --cluster CLUSTER_NAME_OR_ID -f
ibmcloud sat group get
Obtener información detallada de un grupo de clústeres de Satellite.
ibmcloud sat group get --group GROUP [--output OUTPUT] [-q]
Opciones de comando
--group GROUP,-g GROUP- Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtener información detallada de un grupo de clústeres de Satellite.
ibmcloud sat group get --group GROUP --output json -q
ibmcloud sat group ls
Listar todos los grupos de clústeres de Satellite de la cuenta de IBM Cloud.
ibmcloud sat group ls [--output OUTPUT] [-q]
Opciones de comando
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar todos los grupos de clústeres de Satellite de la cuenta de IBM Cloud.
ibmcloud sat group ls --output json -q
ibmcloud sat group rm
Eliminar un grupo de clústeres de Satellite, con lo que se anula la suscripción de los clústeres y se suprimen los recursos de Kubernetes que estaban gestionados por las suscripciones del grupo.
ibmcloud sat group rm --group GROUP [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP,-g GROUP- Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute
ibmcloud sat group ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimina un grupo de clústeres de Satellite, lo que da de baja a los clústeres y elimina los recursos de Kubernetes que gestionaba dicho grupo.
ibmcloud sat group rm --group GROUP -f -q
Comandos del servidor sat de IBM Cloud
Vea y modifique los hosts de Satellite.
ibmcloud sat host assign
Asigne un host a un clúster o plano de control de ubicación de Satellite.
ibmcloud sat host assign --location LOCATION [--cluster CLUSTER] [--host HOST] [--host-label LABEL ...] [-q] [--worker-pool POOL] [--zone ZONE]
Opciones de comando
--cluster CLUSTER- El nombre o ID del clúster al que asignar el host. Para ver la lista de clústeres disponibles, ejecuta
ibmcloud sat cluster ls. Si no se proporciona ningún clúster, el host se asigna automáticamente al plano de control de Satellite. --host HOST- Nombre o ID del host que se asignará. Para asignar automáticamente hosts basados en etiquetas, no incluya esta opción. Para recuperar el ID del host, ejecute
ibmcloud sat host ls --location <location_ID_or_name>. --host-label LABEL,--hl LABEL- Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente
al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--worker-pool POOL,-p POOL- Nombre o ID de la agrupación de trabajadores en el clúster que se asignará al host. Si no se especifica ninguna agrupación de nodos trabajadores, el host se asigna a la agrupación de nodos trabajadores predeterminada.
--zone ZONE- Nombre o ID de la zona que se asignará al host. Para encontrar las zonas disponibles, ejecuta y
ibmcloud sat location get --location <location_name_or_ID>busca el campoHost Zones.
Ejemplos
Asigne un host a un clúster o plano de control de ubicación de Satellite.
ibmcloud sat host assign \
--location LOCATION \
--cluster CLUSTER_NAME_OR_ID \
--worker-pool POOL_NAME
ibmcloud sat host attach
Cree y descargue un script que pueda ejecutar en los hosts para adjuntarlos a su ubicación. Para las ubicaciones habilitadas para RHCOS, el script es un archivo de encendido.
ibmcloud sat host attach --location LOCATION [--host-label LABEL ...] [--host-link-agent-endpoint ENDPOINT] [--operating-system SYSTEM] [-q] [--reset-key]
Opciones de comando
--host-label LABEL,--hl LABEL- Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente
al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --host-link-agent-endpoint ENDPOINT- Punto final usado por el agente de enlace para conectarse con el servidor de túneles de enlace.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --operating-system SYSTEM- El sistema operativo de los hosts que desea conectar a su ubicación. Para conectar hosts RHCOS, la ubicación debe estar habilitada para RHCOS. Valores aceptados:
RHEL,RHCOS -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--reset-key- Restablece la clave que utiliza el plano de control para conectar y asignar hosts en la ubicación. Consulta https://ibm.biz/reset-key.
Ejemplos
Cree y descargue un script que pueda ejecutar en los hosts para adjuntarlos a su ubicación.
ibmcloud sat host attach \
--location LOCATION \
--host-label HOSTNAME \
--reset-key RESET-KEY
ibmcloud sat host get
Ver los detalles de un host de Satellite.
ibmcloud sat host get --host HOST --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--host HOST- El ID de host de Satellite. Para encontrar el ID del host, ejecuta
ibmcloud sat host ls <location_ID_or_name>. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de un host de Satellite.
ibmcloud sat host get --location LOCATION --host HOSTNAME --output json
ibmcloud sat host ls
Listar todos los hosts conectados a una ubicación de Satellite, incluidos los hosts asignados a clústeres o al plano de control.
ibmcloud sat host ls --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Enumera todos los hosts asociados a una ubicación de Satellite, incluidos los hosts asignados a clústeres o al panel de control.
ibmcloud sat host ls --location LOCATION --output json -q
ibmcloud sat host rm
Eliminar un host de una ubicación de Satellite.
ibmcloud sat host rm --host HOST --location LOCATION [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--host HOST- Nombre o ID del host a eliminar.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Eliminar un host de una ubicación de Satellite.
ibmcloud sat host rm --location LOCATION --host HOSTNAME -f
ibmcloud sat host update
Actualizar la información de host, como por ejemplo zonas y etiquetas.
ibmcloud sat host update --host HOST --location LOCATION [--host-label LABEL ...] [-q] [--zone ZONE]
Opciones de comando
--host HOST- Nombre o ID del host que se asignará. Para asignar automáticamente hosts basados en etiquetas, no incluya esta opción.
--host-label LABEL,--hl LABEL- Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente
al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute
ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--zone ZONE- El nombre o ID de la zona que se asociará al host. No puede cambiar la zona de hosts asignados a un recurso, como un clúster. Primero debe desasignarlos. Para ver la lista de zonas disponibles, ejecute
ibmcloud sat location get --location <ID>.
Ejemplos
Actualizar la información de host, como por ejemplo zonas y etiquetas.
ibmcloud sat host update --location LOCATION --host-label HOSTNAME --zone ZONE
Comandos clave de ibmcloud sat
Ver y gestionar las claves de configuración de Satellite.
ibmcloud sat key ls
Listar todas las claves de configuración de Satellite en la cuenta de IBM Cloud.
ibmcloud sat key ls [--output OUTPUT] [-q]
Opciones de comando
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar todas las claves de configuración de Satellite en la cuenta de IBM Cloud.
ibmcloud sat key ls --output json -q
ibmcloud sat key rm
Elimine una clave de configuración de Satellite. Cualquier clúster que siga utilizando esta clave no podrá conectarse a la configuración de Satellite.
ibmcloud sat key rm --key KEY [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--key KEY- El nombre o el ID de una clave de configuración de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Elimine una clave de configuración de Satellite.
ibmcloud sat key rm --key KEY -f -q
ibmcloud sat key rotate
Genere una nueva clave para que la utilicen los clústeres gestionados para conectarse a la configuración de Satellite.
ibmcloud sat key rotate --name NAME [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--name NAME- El nombre de la nueva clave de configuración de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Genere una nueva clave para que la utilicen los clústeres gestionados para conectarse a la configuración de Satellite.
ibmcloud sat key rotate --name NAME -f -q
Comandos localización de IBM Cloud SAT
Crear, ver y modificar ubicaciones de Satellite.
ibmcloud sat location create
Cree una ubicación de Satellite. Una ubicación de Satellite es una representación de un entorno en el proveedor de infraestructura. Una vez creada una ubicación, asigne hosts de zonas distintas de su entorno de infraestructura subyacente mediante
el comando ibmcloud sat host attach.
ibmcloud sat location create --managed-from REGION --name NAME [--capability CAPABILITY ...] [--coreos-enabled] [--cos-bucket BUCKET] [--description DESCRIPTION] [--ha-zone ZONE ...] [--physical-address ADDRESS] [--pod-network-interface-selection SELECTION] [--pod-subnet SUBNET] [--provider PROVIDER] [--provider-credential CREDENTIAL] [--provider-region REGION] [-q] [--service-subnet SUBNET]
Opciones de comando
--capability CAPABILITY- Una funcionalidad de la ubicación Satellite.
--coreos-enabled- Habilite las características de Red Hat CoreOS para la ubicación de Satellite. Esta acción no se puede deshacer. Consulte https://ibm.biz/infra-os.
--cos-bucket BUCKET- Especifique el nombre del grupo IBM Cloud Object Storage para almacenar los datos del plano de control de ubicación de Satellite. De lo contrario, se creará automáticamente un nuevo grupo.
--description DESCRIPTION- Especifique una descripción para la ubicación de Satellite.
--ha-zone ZONE- Especifique la zona para su ubicación. Para garantizar una alta disponibilidad, especifica tres zonas para tu ubicación como
--ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. Los nombres de las zonas deben coincidir exactamente con los nombres de las zonas correspondientes en el proveedor de infraestructura donde tiene previsto crear hosts. --managed-from REGION- Seleccione la región de IBM Cloud desde la que gestionar la ubicación de Satellite. Elija una región cercana a su centro de datos local para mejorar el rendimiento. Consulte https://ibm.biz/sat-region.
--name NAME- Especifique un nombre para la ubicación de Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice nombres, aunque se suprima la otra ubicación.
--physical-address ADDRESS- La dirección física de la ubicación del Satellite.
--pod-network-interface-selection SELECTION- El método para seleccionar la interfaz de red de nodo para la red de pod interna. Esta opción solo se puede utilizar si también se habilita Red Hat CoreOS con la opción
--coreos-enabled. Para proporcionar una dirección IP o URL, especifiquecan-reach=<url>ocan-reach=<ip_address>. Para elegir una interfaz de red, especifiqueinterface=<network_interface>. --pod-subnet SUBNET- Especifique un CIDR de subred personalizado para proporcionar direcciones IP privadas para pods. Esta opción solo se utiliza si se habilita Red Hat CoreOS con la opción
--coreos-enabled. La subred debe tener un tamaño de/23o superior. Consulte https://ibm.biz/sat-location-create. Valor predeterminado: '172.16.0.0/16 --provider PROVIDER- Indique el proveedor de infraestructura que se debe utilizar para la ubicación de Satellite. Si incluye esta opción, también debe incluir la opción
--provider-credential. Valores aceptados:aws,azure,gcp,vmware --provider-credential CREDENTIAL- Especifique la vía de acceso a un archivo JSON en la máquina local que tenga las credenciales del proveedor de infraestructura para la ubicación de Satellite. El formato de credencial es específico del proveedor. Consulte http://ibm.biz/sat-infra-creds.
--provider-region REGION- Especifique la región en el proveedor de infraestructura donde tiene previsto crear los hosts para la ubicación de Satellite. Si incluye esta opción, también debe incluir la opción
--provider. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--service-subnet SUBNET- Especifique un CIDR de subred personalizado para proporcionar direcciones IP privadas para servicios. Esta opción solo se utiliza si se habilita Red Hat CoreOS con la opción
--coreos-enabled. La subred debe tener un tamaño de/24o superior. Consulte https://ibm.biz/sat-location-create. Valor predeterminado:172.20.0.0/16
Ejemplos
Cree una ubicación de Satellite.
ibmcloud sat location create \
--pod-subnet SUBNET_CIDR \
--service-subnet SUBNET_CIDR \
--name NAME
ibmcloud sat location dns get
Ver los detalles de un subdominio registrado en una ubicación de Satellite.
ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subdomain SUBDOMAIN- Especifique el nombre de subdominio. Para listar los subdominios existentes, ejecute
ibmcloud sat location dns ls --location <ID>.
Ejemplos
Ver los detalles de un subdominio registrado en una ubicación de Satellite.
ibmcloud sat location dns get --location LOCATION --subdomain DOMAIN --output json
ibmcloud sat location dns ls
Liste los subdominios registrados en una ubicación de Satellite.
ibmcloud sat location dns ls --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Liste los subdominios registrados en una ubicación de Satellite.
ibmcloud sat location dns ls --location LOCATION --output json -q
ibmcloud sat location dns register
Establezca un subdominio para los hosts asignados al plano de control en una ubicación de Satellite.
ibmcloud sat location dns register --ip IP [--ip IP ...] --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--ip IP- Especifique la dirección IP de cada host del plano de control, en el formato
--ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Para clústeres multizona, utilice una dirección IP de cada zona. Para encontrar la dirección IP, ejecuta yibmcloud sat host ls --location <location_ID_or_name>busca los hosts etiquetados comoWorker IPinfrastructure. --location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Establezca un subdominio para los hosts asignados al plano de control en una ubicación de Satellite.
ibmcloud sat location dns register --location LOCATION --ip IP_ADDRESS --output json
ibmcloud sat location get
Ver los detalles de una ubicación de Satellite.
ibmcloud sat location get --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los detalles de una ubicación de Satellite.
ibmcloud sat location get --location LOCATION --output json -q
ibmcloud sat location ls
Listar todas las ubicaciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat location ls [--output OUTPUT] [-q]
Opciones de comando
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar todas las ubicaciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat location ls --output json -q
ibmcloud sat location rm
Suprimir una ubicación. Antes de ejecutar este mandato, realice una copia de seguridad de las configuraciones y elimine los hosts y clústeres que se ejecuten en la ubicación. La infraestructura de host subyacente no se suprime automáticamente al suprimir una ubicación. Esta acción no se puede deshacer.
ibmcloud sat location rm --location LOCATION [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Suprimir una ubicación.
ibmcloud sat location rm --location LOCATION -f -q
ibmcloud sat location update
Actualiza el nombre o la descripción de una localización de Satellite.
ibmcloud sat location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]
Opciones de comando
--description DESCRIPTION- Introduce una nueva descripción para la ubicación Satellite. La longitud de la descripción está limitada a 400 bytes.
--location-id ID- El identificador de la ubicación de Satellite. Para encontrar el ID de ubicación, ejecuta
ibmcloud sat location ls. --name NAME- Especifica un nuevo nombre para la ubicación Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice los nombres, incluidos los de las ubicaciones eliminadas.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualiza el nombre o la descripción de una localización de Satellite.
ibmcloud sat location update \
--location-id LOCATION \
--name NAME \
--description IP_ADDRESS
ibmcloud mensajes de SAT comandos
Ver los mensajes del usuario actual.
ibmcloud sat messages
Ver los mensajes del usuario actual.
ibmcloud sat messages [-q]
Opciones de comando
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Ver los mensajes del usuario actual.
ibmcloud sat messages -q
Comandos recursos de IBM Cloud SAT
Busque y vea los recursos de Kubernetes gestionados por una configuración de Satellite.
ibmcloud sat resource get
Vea los detalles de un recurso de Kubernetes gestionado por una configuración de Satellite.
ibmcloud sat resource get --resource RESOURCE [--history HISTORY] [--output OUTPUT] [-q] [--save-data]
Opciones de comando
--history HISTORY- El ID de historial del recurso.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--resource RESOURCE- Especifique el ID de recurso de Kubernetes. Para encontrar recursos de Kubernetes, ejecuta
ibmcloud sat resource ls. --save-data- Descargar y guardar una definición de recurso de Kubernetes en un archivo temporal.
Ejemplos
Vea los detalles de un recurso de Kubernetes gestionado por una configuración de Satellite.
ibmcloud sat resource get \
--resource RESOURCE \
--history HISTORY \
--save-data SAVE-DATA
ibmcloud sat resource history get
Obtener el historial de un recurso de Kubernetes.
ibmcloud sat resource history get --resource RESOURCE [--limit LIMIT] [--output OUTPUT] [-q]
Opciones de comando
--limit LIMIT- Especifique el número máximo de entradas de historial a devolver.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--resource RESOURCE- El ID de recurso de Kubernetes.
Ejemplos
Obtener el historial de un recurso de Kubernetes.
ibmcloud sat resource history get --resource RESOURCE --limit LIMIT --output json
ibmcloud sat resource ls
Buscar los recursos de Kubernetes que están gestionados por Satellite.
ibmcloud sat resource ls [--limit LIMIT] [--output OUTPUT] [-q] [--search SEARCH] (--cluster CLUSTER | --subscription SUBSCRIPTION)
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el nombre o el ID del clúster registrado en el que se ejecuta el recurso Kubernetes. Para buscar clústeres registrados, ejecuta
ibmcloud sat cluster ls. --limit LIMIT- Especifique el número máximo de entradas de recurso que debe devolver la búsqueda.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--search SEARCH- Indique la serie para filtrar los resultados de búsqueda de los recursos de Kubernetes, como un pod o un nombre de espacio de nombres.
--subscription SUBSCRIPTION- Especifique el ID o nombre de suscripción de Satellite. Para buscar suscripciones, ejecuta
ibmcloud sat cluster ls.
Ejemplos
Buscar los recursos de Kubernetes que están gestionados por Satellite.
ibmcloud sat resource ls --search SEARCH --limit LIMIT --cluster CLUSTER_NAME_OR_ID
Comandos servicio SAT de IBM Cloud
Ver clústeres de servicios de Satellite.
ibmcloud sat service ls
Liste todos los clústeres de servicio de Satellite en su ubicación para revisar los detalles, como los recursos de host solicitados.
ibmcloud sat service ls --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Liste todos los clústeres de servicio de Satellite en su ubicación para revisar los detalles, como los recursos de host solicitados.
ibmcloud sat service ls --location LOCATION --output json -q
Comandos almacenamiento SAT de IBM Cloud
Ver y gestionar recursos de almacenamiento de Satellite.
ibmcloud sat storage assignment autopatch disable
El mandato storage assignment autopatch disable es una característica beta.
Desactivar las actualizaciones automáticas para una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment autopatch disable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)
Opciones de comando
--all- Inhabilite los parches automáticos para todas las asignaciones de almacenamiento de Satellite de una configuración de almacenamiento.
--assignment ASSIGNMENT- El ID de una asignación de almacenamiento de Satellite. Para ver la lista de asignaciones de almacenamiento disponibles de la configuración, ejecuta
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- El nombre o el ID de una configuración de almacenamiento Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute
ibmcloud sat storage config ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Desactivar las actualizaciones automáticas para una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment autopatch disable \
--config CONFIG \
--assignment ASSIGNMENT \
--all
ibmcloud sat storage assignment autopatch enable
El mandato storage assignment autopatch enable es una característica beta.
Activar las actualizaciones automáticas para una asignación de almacenamiento de « Satellite ».
ibmcloud sat storage assignment autopatch enable --config CONFIG [-q] (--all | --assignment ASSIGNMENT)
Opciones de comando
--all- Habilite los parches automáticos para todas las asignaciones de almacenamiento de Satellite de una configuración de almacenamiento.
--assignment ASSIGNMENT- El ID de una asignación de almacenamiento de Satellite. Para ver la lista de asignaciones de almacenamiento disponibles de la configuración, ejecuta
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- El nombre o el ID de una configuración de almacenamiento Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute
ibmcloud sat storage config ls. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Activar las actualizaciones automáticas para una asignación de almacenamiento de « Satellite ».
ibmcloud sat storage assignment autopatch enable \
--config CONFIG \
--assignment ASSIGNMENT \
--all
ibmcloud sat storage assignment create
Crear una asignación para desplegar las configuraciones de almacenamiento en clústeres en su ubicación de Satellite.
ibmcloud sat storage assignment create --config CONFIG [--name NAME] [-q] (--cluster CLUSTER | --group GROUP | --service-cluster-id CLUSTER)
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el ID del clúster de Satellite para la asignación. Para buscar el ID del clúster, ejecute
ibmcloud oc cluster ls --provider satellite. --config CONFIG- Especifique la configuración de almacenamiento de Satellite para la asignación. para buscar configuraciones, ejecute
ibmcloud sat storage config ls. --group GROUP,-g GROUP- Especifique los grupos de clúster para la asignación. Para buscar grupos de clústeres, ejecuta
ibmcloud sat group ls. --name NAME- Proporcione un nombre para la asignación de almacenamiento de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--service-cluster-id CLUSTER- Especifique el ID del clúster de servicio para la asignación. Para encontrar el ID del clúster del servicio, ejecuta
ibmcloud sat service ls --location <location>.
Ejemplos
Crear una asignación para desplegar las configuraciones de almacenamiento en clústeres en su ubicación de Satellite.
ibmcloud sat storage assignment create \
--name NAME \
--group GROUP \
--service-cluster-id CLUSTER_NAME_OR_ID
ibmcloud sat storage assignment get
Obtener los detalles de una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment get --assignment ASSIGNMENT [--output OUTPUT] [-q]
Opciones de comando
--assignment ASSIGNMENT- Especifique el ID de una asignación de almacenamiento de Satellite.
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtener los detalles de una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment get --assignment ASSIGNMENT --output json -q
ibmcloud sat storage assignment ls
Listar las asignaciones de almacenamiento de Satellite en su cuenta de IBM Cloud.
Para enumerar todas las asignaciones de un clúster de servicios como administrador de servicios: asignación de almacenamiento satelital de ibmcloud ls--service-cluster-id GRUPO.
Para enumerar todas las asignaciones para un clúster de servicios como administrador de ubicación: asignación de almacenamiento satelital de ibmcloud ls--location UBICACIÓN--service-cluster-id GRUPO.
Para mostrar todas las asignaciones de una configuración: 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)
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especifique el ID del clúster de Satellite para las asignaciones. Para obtener el ID del clúster, ejecuta
ibmcloud oc cluster ls --provider satellite. --config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute
ibmcloud sat storage config ls. --location LOCATION- Especifique el nombre de una ubicación de Satellite. Para ver la lista de ubicaciones disponibles, ejecuta
ibmcloud sat location ls. El administrador del servicio no puede utilizar esta opción. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--service-cluster-id CLUSTER- Especifique el ID del clúster de servicio para las asignaciones. Para encontrar el ID del clúster del servicio, ejecuta
ibmcloud sat service ls --location <location>.
Ejemplos
Listar las asignaciones de almacenamiento de Satellite en su cuenta de 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
Aplicar cambios de configuración de almacenamiento a las asignaciones asociadas.
ibmcloud sat storage assignment patch --assignment ASSIGNMENT [-f] [-q]
Alias: ibmcloud sat upgrade
Opciones de comando
--assignment ASSIGNMENT- Especifique el ID de una asignación de almacenamiento de Satellite. Para ver la lista de tareas disponibles, ejecuta
ibmcloud sat storage assignment ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Aplicar cambios de configuración de almacenamiento a las asignaciones asociadas.
ibmcloud sat storage assignment patch --assignment ASSIGNMENT -f -q
ibmcloud sat storage assignment rm
Eliminar una asignación de almacenamiento de Satellite. Los recursos de Kubernetes se suprimen de todos los clústeres de la ubicación de Satellite, pero se conserva la configuración.
ibmcloud sat storage assignment rm --assignment ASSIGNMENT [-f] [-q]
Opciones de comando
--assignment ASSIGNMENT- Especifique el ID de una asignación de almacenamiento de Satellite. Para buscar tareas, ejecuta
ibmcloud sat storage assignment ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Eliminar una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment rm --assignment ASSIGNMENT -f -q
ibmcloud sat storage assignment update
Actualizar una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment update --assignment ASSIGNMENT [-f] [--group GROUP ...] [--name NAME] [-q]
Opciones de comando
--assignment ASSIGNMENT- Especifique el ID de una asignación de almacenamiento de Satellite.
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP,-g GROUP- Especifique los nuevos grupos de clústeres para la asignación. Para ver la lista de grupos disponibles, ejecuta
ibmcloud sat group ls. --name NAME- Proporcione un nuevo nombre para la asignación de almacenamiento de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualizar una asignación de almacenamiento de Satellite.
ibmcloud sat storage assignment update \
--assignment ASSIGNMENT \
--name NAME \
--group GROUP
ibmcloud sat storage config class add
Cree una clase de almacenamiento Satellite personalizada.
ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM [--param PARAM ...] [-q]
Opciones de comando
--config-name NAME- Especifique el nombre de la configuración de almacenamiento para la clase de almacenamiento personalizada. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta
ibmcloud sat storage config ls. --name NAME- Proporcione un nombre para la clase de almacenamiento personalizada.
--param PARAM,-p PARAM- Especifique un par
key=valuede parámetros de clase de almacenamiento. Para ver los parámetros de clase de almacenamiento en una plantilla de almacenamiento, ejecuteibmcloud sat storage template get. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Cree una clase de almacenamiento Satellite personalizada.
ibmcloud sat storage config class add --name NAME --config-name NAME --param PARAM
ibmcloud sat storage config class get
Obtenga los detalles de una clase de almacenamiento de Satellite.
ibmcloud sat storage config class get --class CLASS --config CONFIG [--output OUTPUT] [-q]
Opciones de comando
--class CLASS- Especifique el nombre de una clase de almacenamiento Satellite.
--config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta
ibmcloud sat storage config ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtenga los detalles de una clase de almacenamiento de Satellite.
ibmcloud sat storage config class get --class CLASS --config CONFIG --output json
ibmcloud sat storage config class ls
Listar las clases de almacenamiento en una configuración de almacenamiento de Satellite
ibmcloud sat storage config class ls --config CONFIG [--output OUTPUT] [-q] [--show-params]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta
ibmcloud sat storage config ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--show-params- Incluya esta opción para listar todos los detalles de parámetro de clase de almacenamiento.
Ejemplos
Enumera las clases de almacenamiento en una configuración de almacenamiento de Satellite.
ibmcloud sat storage config class ls \
--config CONFIG \
--show-params SHOW-PARAMS \
--output json
ibmcloud sat storage config create
Cree una configuración de almacenamiento de Satellite para instalar controladores de almacenamiento en los clústeres.
ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME [--param PARAM ...] [-q] [--template-version VERSION]
Opciones de comando
--location LOCATION- Especifique el ID o el nombre de la ubicación para la configuración de almacenamiento. Para ver las ubicaciones disponibles, ejecuta
ibmcloud sat location ls. --name NAME- Especifique el nombre de la configuración de almacenamiento.
--param PARAM,-p PARAM- Especifique un par
key=valuede parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecuteibmcloud sat storage template get. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--template-name NAME- Especifique el nombre de plantilla de configuración de almacenamiento de Satellite. Para ver la lista de plantillas de configuración de almacenamiento disponibles, ejecute
ibmcloud sat storage template ls. --template-version VERSION- Especifique la versión de plantilla de configuración de almacenamiento de Satellite. Si no incluye esta opción, se utiliza la versión predeterminada. Para ver la lista de plantillas de configuración de almacenamiento disponibles, ejecute
ibmcloud sat storage template ls.
Ejemplos
Cree una configuración de almacenamiento de Satellite para instalar controladores de almacenamiento en los clústeres.
ibmcloud sat storage config create \
--name NAME \
--template-name NAME \
--template-version VERSION
ibmcloud sat storage config get
Obtener los detalles de una configuración de almacenamiento de Satellite.
ibmcloud sat storage config get --config CONFIG [--output OUTPUT] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat storage config ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Obtener los detalles de una configuración de almacenamiento de Satellite.
ibmcloud sat storage config get --config CONFIG --output json -q
ibmcloud sat storage config ls
Listar las configuraciones de almacenamiento de Satellite en su cuenta de IBM Cloud.
ibmcloud sat storage config ls [--location LOCATION] [--output OUTPUT] [-q]
Opciones de comando
--location LOCATION- Especifique el ID o el nombre de la ubicación que contiene las configuraciones que desea listar. Para ver las ubicaciones disponibles, ejecuta
ibmcloud sat location ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar las configuraciones de almacenamiento de Satellite en su cuenta de IBM Cloud.
ibmcloud sat storage config ls --location LOCATION --output json -q
ibmcloud sat storage config param set
Establezca los parámetros de configuración y secreto de una configuración de almacenamiento de Satellite.
ibmcloud sat storage config param set --config CONFIG --param PARAM [--param PARAM ...] [--apply] [-f] [-q]
Opciones de comando
--apply- Aplique la última versión de la configuración de almacenamiento de Satellite a todas las asignaciones de una configuración. Para ver la lista de asignaciones de una configuración, ejecute
ibmcloud sat storage assignment ls --config CONFIG. --config CONFIG- Especifique el nombre o el ID de la configuración de almacenamiento. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta
ibmcloud sat storage config ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--param PARAM,-p PARAM- Especifique un par
key=valuede parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecuteibmcloud sat storage template get. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Establezca los parámetros de configuración y secreto de una configuración de almacenamiento de Satellite.
ibmcloud sat storage config param set --config CONFIG --param PARAM --apply APPLY
ibmcloud sat storage config patch
Aplica las últimas actualizaciones de parches a una configuración de almacenamiento de « Satellite ». Las actualizaciones de parches contienen correcciones de vulnerabilidades y correcciones de errores en la misma versión principal.
ibmcloud sat storage config patch --config CONFIG [-f] [--include-assignments] [-q]
Alias: ibmcloud sat upgrade
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat storage config ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--include-assignments- Incluye esta opción para actualizar las asignaciones de la configuración de almacenamiento a la última versión de la configuración.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Aplica las últimas actualizaciones de parches a una configuración de almacenamiento de « Satellite ».
ibmcloud sat storage config patch \
--config CONFIG \
--include-assignments INCLUDE-ASSIGNMENTS \
-f
ibmcloud sat storage config rm
Eliminar una configuración de almacenamiento de Satellite.
ibmcloud sat storage config rm --config CONFIG [-f] [--include-assignments] [-q]
Opciones de comando
--config CONFIG- Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat storage config ls. -f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--include-assignments- Incluya esta opción para eliminar la configuración de almacenamiento así como las asignaciones asociadas.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Eliminar una configuración de almacenamiento de Satellite.
ibmcloud sat storage config rm \
--config CONFIG \
--include-assignments INCLUDE-ASSIGNMENTS \
-f
ibmcloud sat storage template get
Obtener los detalles de una plantilla de almacenamiento de Satellite
ibmcloud sat storage template get --name NAME --version VERSION [--output OUTPUT] [-q]
Opciones de comando
--name NAME- Especifique el nombre de la plantilla de almacenamiento. Para ver la lista de plantillas de almacenamiento disponibles, ejecute
ibmcloud sat storage template ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--version VERSION- Especifique la versión de la plantilla de almacenamiento. Para ver la lista de plantillas de almacenamiento disponibles, ejecute
ibmcloud sat storage template ls.
Ejemplos
Consulta los detalles de una plantilla de almacenamiento de Satellite.
ibmcloud sat storage template get --name NAME --version VERSION --output json
ibmcloud sat storage template ls
Listar las plantillas de almacenamiento de Satellite disponibles.
ibmcloud sat storage template ls [-q]
Opciones de comando
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar las plantillas de almacenamiento de Satellite disponibles.
ibmcloud sat storage template ls -q
Comandos de suscripción a IBM Cloud SAT
Ver y gestionar suscripciones de Satellite para desplegar archivos de configuración de Kubernetes en los clústeres.
ibmcloud sat subscription create
Cree una suscripción de Satellite para clústeres. Después de crear la suscripción, la versión de configuración de Satellite asociada se despliega automáticamente en los clústeres suscritos.
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)
Opciones de comando
--auth-required- Proporcione el secreto de autenticación necesario para conectarse al repositorio remoto. Consulte https://ibm.biz/sat-config-private-repo para obtener más detalles. Estrategia: GitOps.
--config CONFIG- Especifique el nombre de la configuración que se utilizará para la suscripción. Para ver las configuraciones disponibles, ejecuta
ibmcloud sat config ls. --gitref GITREF- Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type TYPE- Indique el tipo de GitRef que se debe utilizar para la suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--group GROUP,-g GROUP- Especifique el nombre o el ID de los grupos de clústeres para suscribirse a la configuración. Para encontrar los grupos de clústeres disponibles, ejecuta
ibmcloud sat group ls. --name NAME- Especifique un nombre para la suscripción.
--path PATH- Proporcione la vía de acceso a los archivos de repositorio o activos de release en el repositorio remoto para utilizarlos para la suscripción de Satellite. Estrategia: GitOps.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--repository REPOSITORY- Especifique el URL del repositorio remoto que se utilizará para la suscripción. Estrategia: GitOps.
--version VERSION- Indique el nombre o el ID de la versión de configuración existente que se utilizará para la suscripción. Para buscar versiones, ejecuta
ibmcloud sat config get --config <configuration_name_or_ID>. Estrategia: Carga directa.
Ejemplos
Cree una suscripción de Satellite para clústeres.
ibmcloud sat subscription create \
--auth-required AUTH-REQUIRED \
--name NAME \
--group GROUP \
--config CONFIG
ibmcloud sat subscription get
Obtener información detallada de una suscripción de Satellite.
ibmcloud sat subscription get --subscription SUBSCRIPTION [--output OUTPUT] [-q]
Opciones de comando
--output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION- Introduce el nombre o el ID de una suscripción a Satellite. Para buscar suscripciones, ejecuta
ibmcloud sat subscription ls.
Ejemplos
Obtener información detallada de una suscripción de Satellite.
ibmcloud sat subscription get --subscription IP_ADDRESS --output json -q
ibmcloud sat subscription identity set
Actualiza la suscripción a Satellite para utilizar tu identidad a la hora de gestionar recursos.
ibmcloud sat subscription identity set --subscription SUBSCRIPTION [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION- Especifique el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta
ibmcloud sat subscription ls.
Ejemplos
Actualiza la suscripción a Satellite para utilizar tu identidad a la hora de gestionar recursos.
ibmcloud sat subscription identity set --subscription IP_ADDRESS -f -q
ibmcloud sat subscription ls
Listar todas las suscripciones de Satellite de la cuenta de IBM Cloud.
ibmcloud sat subscription ls [--cluster CLUSTER] [--output OUTPUT] [-q]
Opciones de comando
--cluster CLUSTER,-c CLUSTER- Especificar el ID o nombre de clúster de Satellite. Para buscar clústeres registrados, ejecuta
ibmcloud sat cluster ls. --output OUTPUT- Imprime la salida del mandato en el formato proporcionado. Valores aceptados:
json -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Listar todas las suscripciones de Satellite de la cuenta de IBM Cloud.
ibmcloud sat subscription ls --cluster CLUSTER_NAME_OR_ID --output json -q
ibmcloud sat subscription rm
Eliminar una suscripción de Satellite. Los recursos de Kubernetes ya no se despliegan en los clústeres.
ibmcloud sat subscription rm --subscription SUBSCRIPTION [-f] [-q]
Opciones de comando
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION- Proporcione el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta
ibmcloud sat subscription ls.
Ejemplos
Eliminar una suscripción de Satellite.
ibmcloud sat subscription rm --subscription IP_ADDRESS -f -q
ibmcloud sat subscription update
Actualizar una suscripción de 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)
Opciones de comando
--auth-required- Proporcione el secreto de autenticación necesario para conectarse al repositorio remoto. Estrategia: GitOps.
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
--gitref GITREF- Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type TYPE- Indique el tipo de GitRef que se debe utilizar para esta suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--group GROUP,-g GROUP- Especifique los nuevos grupos de clústeres que se suscribirán a la configuración.
--name NAME- Proporcione un nombre nuevo de la suscripción de Satellite.
--path PATH- Indique la vía de acceso a los archivos de repositorio o a los activos de release del repositorio remoto que se van a utilizar para la suscripción de Satellite. Estrategia: GitOps.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--repository REPOSITORY- Proporcione el URL del repositorio remoto que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--subscription SUBSCRIPTION- Especifique el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta
ibmcloud sat subscription ls. --version VERSION- Indique la versión de configuración existente que se utilizará para la suscripción de Satellite. Estrategia: Carga directa.
Ejemplos
Actualizar una suscripción de Satellite.
ibmcloud sat subscription update \
--auth-required AUTH-REQUIRED \
--subscription IP_ADDRESS \
--name NAME \
--group GROUP