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 entorno de Satellite, incluidas las operaciones relacionadas con la ubicación, el host, el clúster y los puntos de conexión.
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.
-
Instale la CLI de IBM Cloud. Configure Iniciación a la CLI de IBM Cloud.
-
Instala el complemento
ks.ibmcloud plugin install ks
Comandos Acl
Ver y gestionar las listas de control de acceso (ACL) de Satellite.
ibmcloud sat acl create
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name- El nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--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
Crear una ACL
ibmcloud sat acl create --name NAME --subnet SUBNET --connector-id ID
ibmcloud sat acl endpoint add
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint- Un nombre o ID de un endpoint a habilitar para esta ACL.
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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ñadir uno o más puntos de conexión habilitados a una ACL
ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT --connector-id ID
ibmcloud sat acl endpoint help
Mostrar ayuda
ibmcloud sat acl endpoint help
Ejemplos
Mostrar ayuda
ibmcloud sat acl endpoint help
ibmcloud sat acl endpoint ls
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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
Enumerar todos los puntos de conexión habilitados para una ACL
ibmcloud sat acl endpoint ls --acl-id ID --connector-id ID
ibmcloud sat acl endpoint rm
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --endpoint- Un nombre o ID de un endpoint a deshabilitar para esta ACL.
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 uno o varios puntos finales habilitados de una ACL
ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT --connector-id ID
ibmcloud sat acl get
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 --acl-id ID --connector-id ID
ibmcloud sat acl help
Mostrar ayuda
ibmcloud sat acl help
Ejemplos
Mostrar ayuda
ibmcloud sat acl help
ibmcloud sat acl ls
Satellite
Enumerar 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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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
Enumerar todas las ACL de un conector o una ubicación de Satellite
ibmcloud sat acl ls --connector-id ID
ibmcloud sat acl rm
Satellite
Borrar una ACL.
ibmcloud sat acl rm --acl-id ID [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--acl-id- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 una ACL
ibmcloud sat acl rm --acl-id ID --connector-id ID
ibmcloud sat acl subnet add
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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- 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ñadir una o más subredes a una ACL
ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET --connector-id ID
ibmcloud sat acl subnet help
Mostrar ayuda
ibmcloud sat acl subnet help
Ejemplos
Mostrar ayuda
ibmcloud sat acl subnet help
ibmcloud sat acl subnet rm
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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- 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
Eliminar una o varias subredes de una ACL
ibmcloud sat acl subnet rm --acl-id ID --subnet SUBNET --connector-id ID
ibmcloud sat acl update
Satellite
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- Especifique el ID de la ACL. Para listar todas las ACL, ejecute
ibmcloud sat acl ls. --connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name- El nuevo nombre de la ACL.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Actualizar el nombre de una ACL
ibmcloud sat acl update --acl-id ID --name NAME --connector-id ID
Mandatos de agente
Adjuntar o consultar los agentes del conector « Satellite ».
ibmcloud sat agent attach
Satellite
Consigue un agente de conexión Satellite para una plataforma específica. Descarga el agente .zip para Windows u obtén un enlace a la documentación para entornos de Docker.
ibmcloud sat agent attach --platform PLATFORM [-q]
Opciones de comando
--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 s para una plataforma específica
ibmcloud sat agent attach --platform PLATFORM
ibmcloud sat agent help
Mostrar ayuda
ibmcloud sat agent help
Ejemplos
Mostrar ayuda
ibmcloud sat agent help
ibmcloud sat agent ls
Satellite
Enumera todos los agentes de un conector de Satellite.
ibmcloud sat agent ls --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id- El ID de un conector de Satellite.
--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
Enumerar todos los agentes de un conector de Satellite
ibmcloud sat agent ls --connector-id ID
Mandatos de clúster
Registre y gestione clústeres para su uso con configuraciones de Satellite.
ibmcloud sat cluster get
Virtual Private Cloud Classic infrastructure Satellite
Obtenga los detalles de un clúster registrado.
ibmcloud sat cluster get --cluster CLUSTER [--output OUTPUT] [-q]
Opciones de comando
-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- 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 un clúster registrado
ibmcloud sat cluster get --cluster CLUSTER
ibmcloud sat cluster help
Mostrar ayuda
ibmcloud sat cluster help
Ejemplos
Mostrar ayuda
ibmcloud sat cluster help
ibmcloud sat cluster ls
Virtual Private Cloud Classic infrastructure 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- Filtrar clústeres registrados por ID de clúster.
--limit- Limitar el número de clústeres que se devuelven.
--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 clústeres registrados en tu cuenta de IBM Cloud
ibmcloud sat cluster ls
ibmcloud sat cluster register
Satellite
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- 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 --name NAME
ibmcloud sat cluster unregister
Satellite
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
-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
Eliminar el registro de un clúster
ibmcloud sat cluster unregister --cluster CLUSTER
Mandatos de configuración (config)
Ver y gestionar la configuración de Satellite.
ibmcloud sat config create
Satellite
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- Especifique la región de IBM para almacenar los datos de configuración de Satellite. Estrategia: Carga directa.
--name- Proporcione un nombre para la configuración de Satellite.
--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 tus cargas de trabajo de Satellite
ibmcloud sat config create --name NAME --data-location LOCATION
ibmcloud sat config get
Satellite
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- Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --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
ibmcloud sat config help
Mostrar ayuda
ibmcloud sat config help
Ejemplos
Mostrar ayuda
ibmcloud sat config help
ibmcloud sat config ls
Satellite
Listar todas las configuraciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat config ls [--output OUTPUT] [-q]
Opciones de comando
--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 todas las configuraciones de Satellite en tu cuenta de IBM Cloud
ibmcloud sat config ls
ibmcloud sat config rename
Satellite
Renombrar una configuración de Satellite.
ibmcloud sat config rename --config CONFIG --name NAME [-q]
Opciones de comando
--config- Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --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
Cambiar el nombre de una configuración de Satellite
ibmcloud sat config rename --config CONFIG --name NAME
ibmcloud sat config rm
Satellite
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- 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
Eliminar una configuración de Satellite
ibmcloud sat config rm --config CONFIG
ibmcloud sat config version create
Satellite
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- Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --description- Añada una descripción para la versión de configuración de Satellite.
--file-format- Indique el formato de archivo de la versión de configuración. Opciones disponibles: yaml
--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- Especifique la vía de acceso de archivo para el archivo de versión de configuración.
Ejemplos
Crea una versión de configuración para actualizar los recursos existentes de Kubernetes para tus cargas de trabajo de Satellite
ibmcloud sat config version create \
--config CONFIG \
--file-format FORMAT \
--name NAME \
--read-config CONFIG
ibmcloud sat config version get
Satellite
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- Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute
ibmcloud sat config ls. --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- 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 detalles sobre una versión de configuración de Satellite
ibmcloud sat config version get --config CONFIG --version VERSION
ibmcloud sat config version help
Mostrar ayuda
ibmcloud sat config version help
Ejemplos
Mostrar ayuda
ibmcloud sat config version help
ibmcloud sat config version rm
Satellite
Eliminar una versión de configuración de Satellite.
ibmcloud sat config version rm --config CONFIG --version VERSION [-f] [-q]
Opciones de comando
--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- 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
Comandos conector
Crear, ver y modificar conectores de Satellite.
ibmcloud sat connector create
Satellite
Cree un conector de Satellite.
ibmcloud sat connector create --name NAME --region REGION [-q]
Opciones de comando
--name- El nombre del conector de Satellite.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--region- La región de IBM Cloud para gestionar el conector de Satellite.
Ejemplos
Crear un conector de Satellite
ibmcloud sat connector create --name NAME --region REGION
ibmcloud sat connector get
Satellite
Ver los detalles de un conector Satellite.
ibmcloud sat connector get --connector-id ID [--output OUTPUT] [-q]
Opciones de comando
--connector-id- El ID de un conector de Satellite.
--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 de Satellite
ibmcloud sat connector get --connector-id ID
ibmcloud sat connector help
Mostrar ayuda
ibmcloud sat connector help
Ejemplos
Mostrar ayuda
ibmcloud sat connector help
ibmcloud sat connector ls
Satellite
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- Mostrar Satellite tras el cursor dado.
--first- Ver los siguientes Satellite, hasta el primer número de Conectores.
--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
ibmcloud sat connector rm
Satellite
Suprimir un conector de Satellite.
ibmcloud sat connector rm --connector-id ID [-f] [-q]
Opciones de comando
--connector-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
Eliminar un conector de Satellite
ibmcloud sat connector rm --connector-id ID
Mandatos de punto final (endpoint)
Ver y gestionar puntos finales de Satellite.
ibmcloud sat endpoint authn get
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 punto final
ibmcloud sat endpoint authn get --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint authn help
Mostrar ayuda
ibmcloud sat endpoint authn help
Ejemplos
Mostrar ayuda
ibmcloud sat endpoint authn help
ibmcloud sat endpoint authn rotate
Satellite
Sustituya los certificados de autenticación existentes por otros nuevos. Hay dos conexiones 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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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- 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- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem.
Ejemplos
Sustituir los certificados de autenticación existentes por otros nuevos
ibmcloud sat endpoint authn rotate --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint authn set
Satellite
Establezca la configuración de autenticación para un punto final. Hay dos conexiones 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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-ca-cert-file- Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo,
myCA.pem. --dest-cert-file- El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo,
myCert.pem. --dest-key-file- La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo,
myKey.pem. --dest-tls-mode- El modo TLS de destino. Valores aceptados:
simple,mutual,none --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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- 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- El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo,
myCert.pem. --source-key-file- La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo,
myKey.pem. --source-tls-mode- La fuente: modo « TLS ». Valores aceptados:
simple,mutual
Ejemplos
Configurar los parámetros de autenticación de un punto final
ibmcloud sat endpoint authn set --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint create
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-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 por ejemplo 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- 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- 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- 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- 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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name- Proporcione un nombre para el punto final.
--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- 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- 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 \
--dest-hostname HOSTNAME \
--dest-port PORT \
--dest-type TYPE \
--name NAME \
--source-protocol PROTOCOL \
--connector-id ID
ibmcloud sat endpoint disable
Satellite
Desactivar un punto final.
ibmcloud sat endpoint disable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint enable
Satellite
Habilitar un punto final.
ibmcloud sat endpoint enable --endpoint ENDPOINT [-f] [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint get
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint help
Mostrar ayuda
ibmcloud sat endpoint help
Ejemplos
Mostrar ayuda
ibmcloud sat endpoint help
ibmcloud sat endpoint ls
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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
Enumerar todos los puntos finales en una ubicación de Satellite
ibmcloud sat endpoint ls --connector-id ID
ibmcloud sat endpoint rm
Satellite
Suprimir un punto final.
ibmcloud sat endpoint rm --endpoint ENDPOINT [-q] (--connector-id ID | --location LOCATION)
Opciones de comando
--connector-id- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 punto final
ibmcloud sat endpoint rm --endpoint ENDPOINT --connector-id ID
ibmcloud sat endpoint update
Satellite
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- El ID del conector Satellite. Para buscar el ID de conector, ejecute
ibmcloud sat connector ls. --dest-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 por ejemplo 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- 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- 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- 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- 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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --name- Proporcione un nuevo nombre para el punto final.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--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- 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 --endpoint ENDPOINT --connector-id ID
Comandos experimentales
[Expires on 2024-11-25] Experimentar con nuevos comandos. IMPORTANTE: Comandos aparecen aquí dejarán de utilizarse tras la fecha indicada en [date] su descripción.
ibmcloud sat experimental endpoint help
Mostrar ayuda
ibmcloud sat experimental endpoint help
Ejemplos
Mostrar ayuda
ibmcloud sat experimental endpoint help
ibmcloud sat experimental help
Mostrar ayuda
ibmcloud sat experimental help
Ejemplos
Mostrar ayuda
ibmcloud sat experimental help
Mandatos 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 group attach
Satellite
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
-c,--cluster- Especifique el ID o nombre de clúster. Para ver una lista de los clústeres registrados, ejecute
ibmcloud sat cluster ls. -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ñadir un clúster a tu grupo de clústeres
ibmcloud sat group attach --cluster CLUSTER --group GROUP
ibmcloud sat group create
Satellite
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
-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- 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
Crear un grupo de clústeres
ibmcloud sat group create --name NAME
ibmcloud sat group detach
Satellite
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
-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.
-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 elimina los recursos Kubernetes que gestionaban las suscripciones del grupo
ibmcloud sat group detach --cluster CLUSTER --group GROUP
ibmcloud sat group get
Satellite
Obtener información detallada de un grupo de clústeres de Satellite.
ibmcloud sat group get --group GROUP [--output OUTPUT] [-q]
Opciones de comando
-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- 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
Obtén información detallada sobre un grupo de clústeres de Satellite
ibmcloud sat group get --group GROUP
ibmcloud sat group help
Mostrar ayuda
ibmcloud sat group help
Ejemplos
Mostrar ayuda
ibmcloud sat group help
ibmcloud sat group ls
Satellite
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- 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 grupos de clústeres de Satellite en tu cuenta de IBM Cloud
ibmcloud sat group ls
ibmcloud sat group rm
Satellite
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.
-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
Eliminar un grupo de clústeres de Satellite, lo que da de baja a los clústeres y elimina los recursos de Kubernetes que eran gestionados por las suscripciones del grupo
ibmcloud sat group rm --group GROUP
Mandatos de host
Vea y modifique los hosts de Satellite.
ibmcloud sat host assign
Satellite
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- El nombre o ID del clúster al que asignar el host. Para ver la lista de clústeres disponibles, ejecute
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- 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,--hl- Introduce cualquier etiqueta en forma de 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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. -p,--worker-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.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
--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
Asignar un host a un plano de control de ubicación de Satellite o a un clúster
ibmcloud sat host assign --location LOCATION
ibmcloud sat host attach
Satellite
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,--hl- Introduce cualquier etiqueta en forma de 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- Punto final usado por el agente de enlace para conectarse con el servidor de túneles de enlace.
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --operating-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
Crea y descarga un script que puedas ejecutar en tus hosts para vincularlos a tu ubicación
ibmcloud sat host attach --location LOCATION
ibmcloud sat host get
Satellite
Ver los detalles de un host de Satellite.
ibmcloud sat host get --host HOST --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--host- El ID de host de Satellite. Para encontrar el ID del host, ejecuta
ibmcloud sat host ls <location_ID_or_name>. --location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 --host HOST --location LOCATION
ibmcloud sat host help
Mostrar ayuda
ibmcloud sat host help
Ejemplos
Mostrar ayuda
ibmcloud sat host help
ibmcloud sat host ls
Satellite
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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 plano de control
ibmcloud sat host ls --location LOCATION
ibmcloud sat host rm
Satellite
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- Nombre o ID del host a eliminar.
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 --host HOST --location LOCATION
ibmcloud sat host update
Satellite
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- Nombre o ID del host que se asignará. Para asignar automáticamente hosts basados en etiquetas, no incluya esta opción.
--host-label,--hl- Introduce cualquier etiqueta en forma de 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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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- 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 del host, como las zonas y las etiquetas
ibmcloud sat host update --host HOST --location LOCATION
Comandos clave
Ver y gestionar las claves de configuración de Satellite.
ibmcloud sat key help
Mostrar ayuda
ibmcloud sat key help
Ejemplos
Mostrar ayuda
ibmcloud sat key help
ibmcloud sat key ls
Satellite
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- 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 todas las claves de configuración de Satellite en tu cuenta de IBM Cloud
ibmcloud sat key ls
ibmcloud sat key rm
Satellite
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- 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
Eliminar una clave de configuración de Satellite
ibmcloud sat key rm --key KEY
ibmcloud sat key rotate
Satellite
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- 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
Genera una nueva clave para que los clústeres gestionados puedan conectarse a la configuración de Satellite
ibmcloud sat key rotate --name NAME
Mandatos de ubicación (location)
Crear, ver y modificar ubicaciones de Satellite.
ibmcloud sat location create
Satellite
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 con
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- 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- 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- Especifique una descripción para la ubicación de Satellite.
--ha-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- 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. Consulta https://ibm.biz/sat-region.
--name- Especifique un nombre para la ubicación de Satellite. Los nombres de las ubicaciones deben empezar por 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- La dirección física de la ubicación del Satellite.
--pod-network-interface-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- 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- 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- 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- 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- 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
Crear una ubicación de Satellite
ibmcloud sat location create --managed-from REGION --name NAME
ibmcloud sat location dns get
Satellite
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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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- 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 SUBDOMAIN
ibmcloud sat location dns help
Mostrar ayuda
ibmcloud sat location dns help
Ejemplos
Mostrar ayuda
ibmcloud sat location dns help
ibmcloud sat location dns ls
Satellite
Liste los subdominios registrados en una ubicación de Satellite.
ibmcloud sat location dns ls --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 los subdominios registrados en una ubicación Satellite
ibmcloud sat location dns ls --location LOCATION
ibmcloud sat location dns register
Satellite
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- Especifica 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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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
Configurar un subdominio para los hosts asignados al plano de control en una ubicación de Satellite
ibmcloud sat location dns register --ip IP --location LOCATION
ibmcloud sat location get
Satellite
Ver los detalles de una ubicación de Satellite.
ibmcloud sat location get --location LOCATION [--output OUTPUT] [-q]
Opciones de comando
--location- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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
ibmcloud sat location help
Mostrar ayuda
ibmcloud sat location help
Ejemplos
Mostrar ayuda
ibmcloud sat location help
ibmcloud sat location ls
Satellite
Listar todas las ubicaciones de Satellite en la cuenta de IBM Cloud.
ibmcloud sat location ls [--output OUTPUT] [-q]
Opciones de comando
--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 todas las ubicaciones de Satellite en tu cuenta de IBM Cloud
ibmcloud sat location ls
ibmcloud sat location rm
Satellite
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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador 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 una ubicación
ibmcloud sat location rm --location LOCATION
ibmcloud sat location update
Satellite
Actualizar el nombre o la descripción de una ubicación de Satellite.
ibmcloud sat location update --location-id ID [--description DESCRIPTION] [--name NAME] [-q]
Opciones de comando
--description- Introduce una nueva descripción para la ubicación Satellite. La longitud de la descripción está limitada a 400 bytes.
--location-id- El identificador de la ubicación de Satellite. Para encontrar el ID de ubicación, ejecuta
ibmcloud sat location ls. --name- Especifica un nuevo nombre para la ubicación Satellite. Los nombres de las ubicaciones deben empezar por 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
Actualizar el nombre o la descripción de una ubicación de Satellite
ibmcloud sat location update --location-id ID
Mensajes y comandos
Ver los mensajes del usuario actual.
ibmcloud sat messages
Virtual Private Cloud Classic infrastructure Satellite
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 actuales para el usuario
ibmcloud sat messages
Mandatos de recursos (resource)
Busque y vea los recursos de Kubernetes gestionados por una configuración de Satellite.
ibmcloud sat resource get
Satellite
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- El ID de historial del recurso.
--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- 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
Ver los detalles de un recurso de Kubernetes gestionado por una configuración de Satellite
ibmcloud sat resource get --resource RESOURCE
ibmcloud sat resource help
Mostrar ayuda
ibmcloud sat resource help
Ejemplos
Mostrar ayuda
ibmcloud sat resource help
ibmcloud sat resource history get
Satellite
Obtener el historial de un recurso de Kubernetes.
ibmcloud sat resource history get --resource RESOURCE [--limit LIMIT] [--output OUTPUT] [-q]
Opciones de comando
--limit- Especifique el número máximo de entradas de historial a devolver.
--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- El ID de recurso de Kubernetes.
Ejemplos
Consultar el historial de un recurso de Kubernetes
ibmcloud sat resource history get --resource RESOURCE
ibmcloud sat resource history help
Mostrar ayuda
ibmcloud sat resource history help
Ejemplos
Mostrar ayuda
ibmcloud sat resource history help
ibmcloud sat resource ls
Satellite
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
-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- Especifique el número máximo de entradas de recurso que debe devolver la búsqueda.
--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- 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- Especifique el ID o nombre de suscripción de Satellite. Para buscar suscripciones, ejecuta
ibmcloud sat cluster ls.
Ejemplos
Busca recursos de Kubernetes gestionados por Satellite
ibmcloud sat resource ls --cluster CLUSTER
Mandatos de servicio
Ver clústeres de servicios de Satellite.
ibmcloud sat service help
Mostrar ayuda
ibmcloud sat service help
Ejemplos
Mostrar ayuda
ibmcloud sat service help
ibmcloud sat service ls
Satellite
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- Nombre o ID de la ubicación de Satellite. Para encontrar el identificador o el nombre de la ubicación, ejecuta
ibmcloud sat location ls. --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 clústeres del servicio Satellite de tu ubicación para consultar detalles, como los recursos de host solicitados
ibmcloud sat service ls --location LOCATION
Mandatos de almacenamiento
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.
Satellite
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- 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- 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 --all
ibmcloud sat storage assignment autopatch enable
El mandato storage assignment autopatch enable es una característica beta.
Satellite
Habilitar 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- 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- 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
Habilitar las actualizaciones automáticas para una asignación de almacenamiento de Satellite
ibmcloud sat storage assignment autopatch enable --config CONFIG --all
ibmcloud sat storage assignment autopatch help
Mostrar ayuda
ibmcloud sat storage assignment autopatch help
Ejemplos
Mostrar ayuda
ibmcloud sat storage assignment autopatch help
ibmcloud sat storage assignment create
Satellite
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
-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- Especifique la configuración de almacenamiento de Satellite para la asignación. para buscar configuraciones, ejecute
ibmcloud sat storage config ls. -g,--group- Especifique los grupos de clúster para la asignación. Para buscar grupos de clústeres, ejecuta
ibmcloud sat group ls. --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- 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
Crea una tarea para implementar tus configuraciones de almacenamiento en los clústeres de tu ubicación de Satellite
ibmcloud sat storage assignment create --config CONFIG --cluster CLUSTER
ibmcloud sat storage assignment get
Satellite
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- Especifique el ID de una asignación de almacenamiento de Satellite.
--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 asignación de almacenamiento en Satellite
ibmcloud sat storage assignment get --assignment ASSIGNMENT
ibmcloud sat storage assignment help
Mostrar ayuda
ibmcloud sat storage assignment help
Ejemplos
Mostrar ayuda
ibmcloud sat storage assignment help
ibmcloud sat storage assignment ls
Satellite
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 ver una lista de 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
-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- 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- 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- 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- 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
Enumera las asignaciones de almacenamiento de Satellite en tu cuenta de IBM Cloud
ibmcloud sat storage assignment ls --cluster CLUSTER
ibmcloud sat storage assignment patch
Satellite
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- 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 los cambios de configuración de almacenamiento a las asignaciones asociadas
ibmcloud sat storage assignment patch --assignment ASSIGNMENT
ibmcloud sat storage assignment rm
Satellite
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- 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
ibmcloud sat storage assignment update
Satellite
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- Especifique el ID de una asignación de almacenamiento de Satellite.
-f- Forzar que el mandato se ejecute sin solicitudes de usuario.
-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- 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 en Satellite
ibmcloud sat storage assignment update --assignment ASSIGNMENT
ibmcloud sat storage config class add
Satellite
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- 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- Proporcione un nombre para la clase de almacenamiento personalizada.
-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
Crear una clase de almacenamiento personalizada de Satellite
ibmcloud sat storage config class add --config-name NAME --name NAME --param PARAM
ibmcloud sat storage config class get
Satellite
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- Especifique el nombre de una clase de almacenamiento Satellite.
--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- 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 clase de almacenamiento Satellite
ibmcloud sat storage config class get --class CLASS --config CONFIG
ibmcloud sat storage config class help
Mostrar ayuda
ibmcloud sat storage config class help
Ejemplos
Mostrar ayuda
ibmcloud sat storage config class help
ibmcloud sat storage config class ls
Satellite
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- 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- 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
Listar las clases de almacenamiento en una configuración de almacenamiento de Satellite
ibmcloud sat storage config class ls --config CONFIG
ibmcloud sat storage config create
Satellite
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- 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- Especifique el nombre de la configuración de almacenamiento.
-p,--param- Especifica un par
key=valuede parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecutaibmcloud sat storage template get. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
--template-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- 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
Crea una configuración de almacenamiento Satellite para instalar los controladores de almacenamiento en tus clústeres
ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME
ibmcloud sat storage config get
Satellite
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- 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- 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 almacenamiento de Satellite
ibmcloud sat storage config get --config CONFIG
ibmcloud sat storage config help
Mostrar ayuda
ibmcloud sat storage config help
Ejemplos
Mostrar ayuda
ibmcloud sat storage config help
ibmcloud sat storage config ls
Satellite
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- 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- 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 las configuraciones de almacenamiento de Satellite en tu cuenta de IBM Cloud
ibmcloud sat storage config ls
ibmcloud sat storage config param help
Mostrar ayuda
ibmcloud sat storage config param help
Ejemplos
Mostrar ayuda
ibmcloud sat storage config param help
ibmcloud sat storage config param set
Satellite
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 las asignaciones de una configuración, ejecuta
ibmcloud sat storage assignment ls --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.
-p,--param- Especifica un par
key=valuede parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecutaibmcloud sat storage template get. -q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Configurar los parámetros de configuración y secretos de una configuración de almacenamiento de Satellite
ibmcloud sat storage config param set --config CONFIG --param PARAM
ibmcloud sat storage config patch
Satellite
Aplica las últimas actualizaciones de parches a una configuración de almacenamiento 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- 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 configuración.
-q- No mostrar el mensaje del día ni los recordatorios de actualización.
Ejemplos
Aplicar las últimas actualizaciones de parches a una configuración de almacenamiento de Satellite
ibmcloud sat storage config patch --config CONFIG
ibmcloud sat storage config rm
Satellite
Eliminar una configuración de almacenamiento de Satellite.
ibmcloud sat storage config rm --config CONFIG [-f] [--include-assignments] [-q]
Opciones de comando
--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
ibmcloud sat storage help
Mostrar ayuda
ibmcloud sat storage help
Ejemplos
Mostrar ayuda
ibmcloud sat storage help
ibmcloud sat storage template get
Satellite
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- Especifique el nombre de la plantilla de almacenamiento. Para ver la lista de plantillas de almacenamiento disponibles, ejecute
ibmcloud sat storage template ls. --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- 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
Obtener los detalles de una plantilla de almacenamiento de Satellite
ibmcloud sat storage template get --name NAME --version VERSION
ibmcloud sat storage template help
Mostrar ayuda
ibmcloud sat storage template help
Ejemplos
Mostrar ayuda
ibmcloud sat storage template help
ibmcloud sat storage template ls
Satellite
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
Enumera las plantillas de almacenamiento disponibles de Satellite
ibmcloud sat storage template ls
Mandatos de suscripción
Ver y gestionar suscripciones de Satellite para desplegar archivos de configuración de Kubernetes en los clústeres.
ibmcloud sat subscription create
Satellite
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- Especifique el nombre de la configuración que se utilizará para la suscripción. Para consultar las configuraciones disponibles, ejecute
ibmcloud sat config ls. -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. --gitref- Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type- Indique el tipo de GitRef que se debe utilizar para la suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--name- Especifique un nombre para la suscripción.
--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- Especifique el URL del repositorio remoto que se utilizará para la suscripción. Estrategia: GitOps.
--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
Crear una suscripción a Satellite para clústeres
ibmcloud sat subscription create \
--config CONFIG \
--group GROUP \
--name NAME \
--auth-required \
--gitref GITREF \
--gitref-type TYPE \
--path PATH \
--repository REPOSITORY
ibmcloud sat subscription get
Satellite
Obtener información detallada de una suscripción de Satellite.
ibmcloud sat subscription get --subscription SUBSCRIPTION [--output OUTPUT] [-q]
Opciones de comando
--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- Introduce el nombre o el ID de una suscripción a Satellite. Para buscar suscripciones, ejecuta
ibmcloud sat subscription ls.
Ejemplos
Obtén información detallada sobre la suscripción a Satellite
ibmcloud sat subscription get --subscription SUBSCRIPTION
ibmcloud sat subscription help
Mostrar ayuda
ibmcloud sat subscription help
Ejemplos
Mostrar ayuda
ibmcloud sat subscription help
ibmcloud sat subscription identity help
Mostrar ayuda
ibmcloud sat subscription identity help
Ejemplos
Mostrar ayuda
ibmcloud sat subscription identity help
ibmcloud sat subscription identity set
Satellite
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- 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 SUBSCRIPTION
ibmcloud sat subscription ls
Satellite
Listar todas las suscripciones de Satellite de la cuenta de IBM Cloud.
ibmcloud sat subscription ls [--cluster CLUSTER] [--output OUTPUT] [-q]
Opciones de comando
-c,--cluster- Especificar el ID o nombre de clúster de Satellite. Para buscar clústeres registrados, ejecuta
ibmcloud sat cluster ls. --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 todas las suscripciones a Satellite en tu cuenta de IBM Cloud
ibmcloud sat subscription ls
ibmcloud sat subscription rm
Satellite
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- Proporcione el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta
ibmcloud sat subscription ls.
Ejemplos
Cancelar una suscripción a Satellite
ibmcloud sat subscription rm --subscription SUBSCRIPTION
ibmcloud sat subscription update
Satellite
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.
-g,--group- Especifique los nuevos grupos de clústeres que se suscribirán a la configuración.
--gitref- Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type- Indique el tipo de GitRef que se debe utilizar para esta suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--name- Proporcione un nombre nuevo de la suscripción de Satellite.
--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- Proporcione el URL del repositorio remoto que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--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- 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 a Satellite
ibmcloud sat subscription update \
--subscription SUBSCRIPTION \
--auth-required \
--gitref GITREF \
--gitref-type TYPE \
--path PATH \
--repository REPOSITORY