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.

  1. Instale la CLI de IBM Cloud. Configure Iniciación a la CLI de IBM Cloud.

  2. 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 cloud finales, 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 puntos location finales, 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 https o tls y 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 cloud finales, 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 puntos location finales, 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 https o tls y 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 campo Host 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, especifique can-reach=<url> o can-reach=<ip_address>. Para elegir una interfaz de red, especifique interface=<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 /23 o 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 /24 o 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 y ibmcloud sat host ls --location <location_ID_or_name> busca los hosts etiquetados como Worker IP infrastructure.
--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=value de parámetros de clase de almacenamiento. Para ver los parámetros de clase de almacenamiento en una plantilla de almacenamiento, ejecute ibmcloud 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=value de parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecuta ibmcloud 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=value de parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecuta ibmcloud 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