Referencia de la CLI para comandos de Satellite

Consulte estos comandos de la interfaz de línea de comandos (CLI) de Satellite cuando desee automatizar la creación y la gestión de su ubicación de Satellite, incluidas las operaciones relacionadas con la ubicación, el host, el clúster y el punto final.

Para instalar la CLI, consulte Instalación de la CLI. Para ver un mapa de alto nivel de todos los comandos de IBM Cloud Satellite, consulte el mapa de la CLI.

Requisitos previos

  • Instale la CLI de IBM Cloud.

  • Instala el complemento ks ejecutando el siguiente comando :

    ibmcloud plugin install ks
    

mandatos ibmcloud sat

Las tablas siguientes listan los grupos de mandatos de ibmcloud sat. Para obtener una lista completa de todos comandos ibmcloud sat tal y como están estructurados en la CLI, consulta el mapa de la CLI.

Grupos comando de la CLI de IBM Cloud SAT
Grupo de mandatos Descripción
ibmcloud sat connector Crear, ver y modificar conectores de Satellite.
ibmcloud sat location Crear, ver y modificar ubicaciones de Satellite.
ibmcloud sat endpoint Ver y gestionar puntos finales de Satellite.
ibmcloud sat acl Ver y gestionar las listas de control de acceso (ACL) de Satellite.
ibmcloud sat agent Adjuntar o consultar los agentes del conector « Satellite ».
ibmcloud sat host Vea y modifique los hosts de Satellite.
ibmcloud sat cluster Registre y gestione clústeres para su uso con configuraciones de Satellite.
ibmcloud sat messages Ver los mensajes del usuario actual.
ibmcloud sat group Ver y gestionar grupos de clústeres de Satellite. Los grupos de clústeres se utilizan para suscribir clústeres a las configuraciones de Satellite de los recursos de Kubernetes.
ibmcloud sat key Ver y gestionar las claves de configuración de Satellite.
ibmcloud sat config Ver y gestionar la configuración de Satellite.
ibmcloud sat resource Busque y vea los recursos de Kubernetes gestionados por una configuración de Satellite.
ibmcloud sat service Ver clústeres de servicios de Satellite.
ibmcloud sat storage Ver y gestionar recursos de almacenamiento de Satellite.
ibmcloud sat subscription Ver y gestionar suscripciones de Satellite para desplegar archivos de configuración de Kubernetes en los clústeres.

ibmcloud sat acl comandos

Ver y gestionar las listas de control de acceso (ACL) de Satellite.

ibmcloud sat acl create

Cree una ACL.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
El nombre de la ACL.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Cree una ACL.

ibmcloud sat acl create --location LOCATION --connector-id CONNECTOR_ID --name NAME

ibmcloud sat acl endpoint add

Añade uno o más puntos finales habilitados a una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Añade uno o más puntos finales habilitados a una ACL.

ibmcloud sat acl endpoint add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl endpoint ls

Lista todos los puntos finales habilitados para una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Lista todos los puntos finales habilitados para una ACL.

ibmcloud sat acl endpoint ls \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl endpoint rm

Elimina uno o más puntos finales habilitados de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a deshabilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimina uno o más puntos finales habilitados de una ACL.

ibmcloud sat acl endpoint rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl get

Ver los detalles de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de una ACL.

ibmcloud sat acl get --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID

ibmcloud sat acl ls

Mostrar todas las ACL de un conector o una ubicación de « Satellite ».

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Mostrar todas las ACL de un conector o una ubicación de « Satellite ».

ibmcloud sat acl ls --location LOCATION --connector-id CONNECTOR_ID --output json

ibmcloud sat acl rm

Borrar una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Borrar una ACL.

ibmcloud sat acl rm --location LOCATION --connector-id CONNECTOR_ID --acl-id ACL_ID

ibmcloud sat acl subnet add

Añade una o varias subredes a una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Añade una o varias subredes a una ACL.

ibmcloud sat acl subnet add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl subnet rm

Elimina una o varias subredes de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Elimina una o varias subredes de una ACL.

ibmcloud sat acl subnet rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat acl update

Actualiza el nombre de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
El nuevo nombre de la ACL.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Actualiza el nombre de una ACL.

ibmcloud sat acl update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

Comandos agente SAT de IBM Cloud

Adjuntar o consultar los agentes del conector « Satellite ».

ibmcloud sat agent attach

Consigue un agente de conexión de Satellite para una plataforma concreta. Descarga el agente .zip para Windows u obtén un enlace a la documentación para entornos Docker.

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

Opciones de comando

--platform PLATFORM
La plataforma para el Agente Conector Satellite. Para obtener más información sobre Docker, consulte la documentación en https://ibm.biz/satconagent Opciones disponibles: windows, docker
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Consigue un agente de conexión de Satellite para una plataforma concreta.

ibmcloud sat agent attach --platform PLATFORM -q

ibmcloud sat agent ls

Mostrar todos los agentes de un conector de Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Mostrar todos los agentes de un conector de Satellite.

ibmcloud sat agent ls --connector-id CONNECTOR_ID --output json -q

Comandos clúster SAT de IBM Cloud

Registre y gestione clústeres para su uso con configuraciones de Satellite.

ibmcloud sat cluster get

Nube privada virtual Infraestructura clásica Satellite

Obtenga los detalles de un clúster registrado.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el nombre de clúster o el ID. Para ver una lista de los clústeres registrados, ejecute ibmcloud sat cluster ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtenga los detalles de un clúster registrado.

ibmcloud sat cluster get --cluster CLUSTER_NAME_OR_ID --output json -q

ibmcloud sat cluster ls

Nube privada virtual Infraestructura clásica Satellite

Liste todos los clústeres registrados en su cuenta de IBM Cloud.

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

Opciones de comando

--filter FILTER
Filtrar clústeres registrados por ID de clúster.
--limit LIMIT
Limitar el número de clústeres que se devuelven.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Liste todos los clústeres registrados en su cuenta de IBM Cloud.

ibmcloud sat cluster ls --filter FILTER --limit LIMIT --output json

ibmcloud sat cluster register

Consigue un comando kubectl para registrar tu clúster en una configuración de Satellite. Inicie sesión en el clúster y ejecute este mandato para instalar un agente de Satellite Config. Los clústeres que ejecuta en la ubicación de Satellite instalan automáticamente este agente.

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

Opciones de comando

--name NAME
Especifique el nombre del clúster que desea registrar
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--silent
Silenciosa. Devolver solo el mandato de registro en la salida.

Ejemplos

Consigue un comando kubectl para registrar tu clúster en una configuración de Satellite.

ibmcloud sat cluster register --silent SILENT --name NAME -q

ibmcloud sat cluster unregister

Elimine un registro de clúster. El clúster ya no está suscrito a una configuración de Satellite, pero el clúster y sus recursos existentes todavía se ejecutan.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el nombre de clúster o el ID. Para ver una lista de los clústeres registrados, ejecute ibmcloud sat cluster ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimine un registro de clúster.

ibmcloud sat cluster unregister --cluster CLUSTER_NAME_OR_ID -f -q

Comandos de configuración de ibmcloud sat

Ver y gestionar la configuración de Satellite.

ibmcloud sat config create

Cree una configuración para especificar qué recursos de Kubernetes desea desplegar en los clústeres en las cargas de trabajo de Satellite.

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

Opciones de comando

--data-location LOCATION
Especifique la región de IBM para almacenar los datos de configuración de Satellite. Estrategia: Carga directa.
--name NAME
Proporcione un nombre para la configuración de Satellite.
--provider PROVIDER
Indique el proveedor de GitOps remoto para la configuración de Satellite. Este proveedor almacena las definiciones de recursos de Kubernetes. Estrategia: GitOps. Valores permitidos: github, gitlab
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Crea una configuración para especificar qué recursos de Kubernetes deseas implementar en tus clústeres dentro de tu entorno de trabajo de Satellite.

ibmcloud sat config create \
  --name NAME \
  --data-location LOCATION \
  --provider PROVIDER_ID

ibmcloud sat config get

Obtenga detalles de una configuración de Satellite, como por ejemplo las versiones o suscripciones que están asociadas con la configuración.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Consulta los detalles de una configuración de Satellite, como las versiones o las suscripciones asociadas a dicha configuración.

ibmcloud sat config get --config CONFIG --output json -q

ibmcloud sat config ls

Listar todas las configuraciones de Satellite en la cuenta de IBM Cloud.

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

Opciones de comando

--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar todas las configuraciones de Satellite en la cuenta de IBM Cloud.

ibmcloud sat config ls --output json -q

ibmcloud sat config rename

Renombrar una configuración de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
--name NAME
Proporcione un nuevo nombre para la configuración de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Renombrar una configuración de Satellite.

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

ibmcloud sat config rm

Elimine una configuración de Satellite. Primero deben eliminarse todas las suscripciones asociadas. Se suprimen todas las versiones. Realice una copia de seguridad de las definiciones de recursos que desee conservar.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimine una configuración de Satellite.

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

ibmcloud sat config version create

Cree una versión de configuración para actualizar los recursos de Kubernetes existentes para las cargas de trabajo de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
--description DESCRIPTION
Añada una descripción para la versión de configuración de Satellite.
--file-format FORMAT
Indique el formato de archivo de la versión de configuración. Opciones disponibles: yaml
--name NAME
Proporcione un nombre para la versión de configuración de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--read-config CONFIG
Especifique la vía de acceso de archivo para el archivo de versión de configuración.

Ejemplos

Cree una versión de configuración para actualizar los recursos de Kubernetes existentes para las cargas de trabajo de Satellite.

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

ibmcloud sat config version get

Obtener información detallada de una versión de configuración de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--save-config
Descargar y guardar la versión de configuración en un archivo temporal.
--version VERSION
Especifique el nombre o el ID de la versión de configuración de Satellite. Para listar las versiones de su configuración, ejecute ibmcloud sat config get --config <configuration_name_or_ID>.

Ejemplos

Obtener información detallada de una versión de configuración de Satellite.

ibmcloud sat config version get \
  --config CONFIG \
  --version VERSION \
  --save-config SAVE-CONFIG

ibmcloud sat config version rm

Eliminar una versión de configuración de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de la configuración de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat config ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--version VERSION
Indique el nombre o el ID de la versión de configuración de Satellite. Para ver la lista de versiones, ejecuta ibmcloud sat config get --config <configuration_name_or_ID>.

Ejemplos

Eliminar una versión de configuración de Satellite.

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

Comandos conector SAT de IBM Cloud

Crear, ver y modificar conectores de Satellite.

ibmcloud sat connector create

Cree un conector de Satellite.

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

Opciones de comando

--name NAME
El nombre del conector de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--region REGION
La región de IBM Cloud para gestionar el conector de Satellite.

Ejemplos

Cree un conector de Satellite.

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

ibmcloud sat connector get

Ver los detalles de un conector Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de un conector Satellite.

ibmcloud sat connector get --connector-id CONNECTOR_ID --output json -q

ibmcloud sat connector ls

Consulta los conectores de Satellite en tu cuenta de IBM Cloud.

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

Opciones de comando

--after AFTER
Mostrar Satellite tras el cursor dado.
--first FIRST
Ver los siguientes Satellite, hasta el primer número de Conectores.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Consulta los conectores de Satellite en tu cuenta de IBM Cloud.

ibmcloud sat connector ls --after AFTER --first FIRST --output json

ibmcloud sat connector rm

Suprimir un conector de Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Suprimir un conector de Satellite.

ibmcloud sat connector rm --connector-id CONNECTOR_ID -f -q

Comandos punto final de ibmcloud sat

Ver y gestionar puntos finales de Satellite.

ibmcloud sat endpoint authn get

Obtener la configuración de autenticación de un endpoint.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtener la configuración de autenticación de un endpoint.

ibmcloud sat endpoint authn get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint authn rotate

Sustituya los certificados de autenticación existentes por otros nuevos. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre la fuente y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Solo se sustituyen los certificados que especifiques.

ibmcloud sat endpoint authn rotate --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo, myCA.pem.
--dest-cert-file FILE
El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo, myCert.pem.
--dest-key-file FILE
La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo, myKey.pem.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo, myCA.pem.
--source-cert-file FILE
El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo, myCert.pem.
--source-key-file FILE
La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo, myKey.pem.

Ejemplos

Sustituya los certificados de autenticación existentes por otros nuevos.

ibmcloud sat endpoint authn rotate \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint authn set

Establezca la configuración de autenticación para un punto final. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre la fuente y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Los valores no especificados se establecen en sus valores predeterminados.

ibmcloud sat endpoint authn set --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [--dest-tls-mode MODE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] [--source-tls-mode MODE] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo, myCA.pem.
--dest-cert-file FILE
El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo, myCert.pem.
--dest-key-file FILE
La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo, myKey.pem.
--dest-tls-mode MODE
El modo TLS de destino. Valores aceptados:simple,mutual,none
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo, myCA.pem.
--source-cert-file FILE
El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo, myCert.pem.
--source-key-file FILE
La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo, myKey.pem.
--source-tls-mode MODE
La fuente: modo « TLS ». Valores aceptados: simple, mutual

Ejemplos

Establezca la configuración de autenticación para un punto final.

ibmcloud sat endpoint authn set \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint create

Crear un punto final.

ibmcloud sat endpoint create --dest-hostname HOSTNAME --dest-port PORT --dest-type TYPE --name NAME --source-protocol PROTOCOL [--dest-protocol PROTOCOL] [--idle-timeout-seconds SECONDS] [--output OUTPUT] [-q] [--sni SNI] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-hostname HOSTNAME
Indique el nombre de dominio completo (FQDN) o la dirección IP accesible desde el exterior del destino al que desea conectarse. En el caso de los puntos 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 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 PORT
Indique el puerto en el que el recurso de destino escucha las solicitudes entrantes. Asegúrese de que el puerto coincida con el protocolo de destino.
--dest-protocol PROTOCOL
Especifique el protocolo del destino. Si no especifica esta opción, el protocolo de destino se hereda del protocolo de origen. Valores aceptados: TCP, TLS
--dest-type TYPE
Especifica dónde se ejecuta el recurso de destino, ya sea en IBM Cloud (cloud) o en tu ubicación Satellite (location). Opciones disponibles: ubicación, nube
--idle-timeout-seconds SECONDS
Especifique el intervalo de tiempo de espera en segundos para las conexiones activas con el destino. Asegúrese de que el tiempo de espera sea compatible con los valores del servicio de destino y del protocolo keep-alive.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
Proporcione un nombre para el punto final.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--sni SNI
Especifique el indicador de nombre de servidor si indica un protocolo de origen https o tls y desea que se añada un nombre de host independiente al protocolo de enlace de TLS.
--source-protocol PROTOCOL
Indique el protocolo que el origen utiliza para conectar el recurso de destino. Véase http://ibm.biz/endpoint-protocols. Opciones disponibles: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Ejemplos

Crear un punto final.

ibmcloud sat endpoint create \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --name NAME

ibmcloud sat endpoint disable

Desactivar un punto final.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Desactivar un punto final.

ibmcloud sat endpoint disable \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint enable

Habilitar un punto final.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Habilitar un punto final.

ibmcloud sat endpoint enable \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint get

Ver los detalles de un punto final.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de un punto final.

ibmcloud sat endpoint get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint ls

Liste todos los puntos finales en una ubicación de Satellite.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Liste todos los puntos finales en una ubicación de Satellite.

ibmcloud sat endpoint ls --location LOCATION --connector-id CONNECTOR_ID --output json

ibmcloud sat endpoint rm

Suprimir un punto final.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Suprimir un punto final.

ibmcloud sat endpoint rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat endpoint update

Actualizar un punto final. Solo se actualizan las opciones que especifique.

ibmcloud sat endpoint update --endpoint ENDPOINT [--dest-hostname HOSTNAME] [--dest-port PORT] [--dest-protocol PROTOCOL] [--idle-timeout-seconds SECONDS] [--name NAME] [-q] [--sni SNI] [--source-protocol PROTOCOL] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-hostname HOSTNAME
Indique el nombre de dominio completo (FQDN) o la dirección IP accesible desde el exterior del destino al que desea conectarse. En el caso de los puntos 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 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 PORT
Indique el puerto en el que el recurso de destino escucha las solicitudes entrantes. Asegúrese de que el puerto coincida con el protocolo de destino.
--dest-protocol PROTOCOL
Especifique el protocolo del destino. Si no especifica esta opción, el protocolo de destino se hereda del protocolo de origen. Valores aceptados: TCP, TLS
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION).
--idle-timeout-seconds SECONDS
Especifique el intervalo de tiempo de espera en segundos para las conexiones activas con el destino. Asegúrese de que el tiempo de espera sea compatible con los valores del servicio de destino y del protocolo keep-alive.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
Proporcione un nuevo nombre para el punto final.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--sni SNI
Especifique el indicador de nombre de servidor si indica un protocolo de origen https o tls y desea que se añada un nombre de host independiente al protocolo de enlace de TLS.
--source-protocol PROTOCOL
Indique el protocolo que el origen utiliza para conectar el recurso de destino. Véase http://ibm.biz/endpoint-protocols. Valores admitidos: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Ejemplos

Actualizar un punto final.

ibmcloud sat endpoint update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud: comandos experimentales de sat

[Caduca el 2024-11-25] Prueba nuevos comandos. IMPORTANTE: Comandos aparecen aquí dejarán de estar disponibles a partir de la [fecha] indicada en su descripción.

ibmcloud sat experimental acl create

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl create en lugar de] Crear una ACL.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
El nombre de la ACL.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Cree una ACL.

ibmcloud sat experimental acl create \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --name NAME

ibmcloud sat experimental acl endpoint add

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint add en su lugar] Añada uno o más puntos finales habilitados a una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a habilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Añade uno o más puntos finales habilitados a una ACL.

ibmcloud sat experimental acl endpoint add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl endpoint ls

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint ls en lugar de] Enumerar todos los extremos habilitados para una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Lista todos los puntos finales habilitados para una ACL.

ibmcloud sat experimental acl endpoint ls \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl endpoint rm

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl endpoint rm en lugar de] Elimine uno o más puntos finales habilitados de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Un nombre o ID de un endpoint a deshabilitar para esta ACL.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimina uno o más puntos finales habilitados de una ACL.

ibmcloud sat experimental acl endpoint rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl get

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl get en lugar de] Ver los detalles de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de una ACL.

ibmcloud sat experimental acl get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl ls

[¡Desactivado en 2024-10-01! Utiliza « ibmcloud sat acl ls » en lugar de «] » para mostrar todas las ACL de un conector o una ubicación de Satellite.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Mostrar todas las ACL de un conector o una ubicación de « Satellite ».

ibmcloud sat experimental acl ls \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --output json

ibmcloud sat experimental acl rm

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl rm en lugar de] Eliminar una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Borrar una ACL.

ibmcloud sat experimental acl rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl subnet add

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl subnet add en lugar de] Añada una o varias subredes a una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Añade una o varias subredes a una ACL.

ibmcloud sat experimental acl subnet add \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl subnet rm

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl subnet rm en lugar de] Elimine una o varias subredes de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subnet SUBNET
Un bloque IP o CIDR permitido por esta ACL. El valor debe estar completamente incluido en los siguientes CIDR: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Ejemplos

Elimina una o varias subredes de una ACL.

ibmcloud sat experimental acl subnet rm \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental acl update

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat acl update en lugar de] Actualice el nombre de una ACL.

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

Opciones de comando

--acl-id ID
Especifique el ID de la ACL. Para listar todas las ACL, ejecute ibmcloud sat acl ls.
--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--name NAME
El nuevo nombre de la ACL.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Actualiza el nombre de una ACL.

ibmcloud sat experimental acl update \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --acl-id ACL_ID

ibmcloud sat experimental agent attach

[¡Desactivado en 2024-09-01! Utiliza ibmcloud sat agent attach en lugar de] . Descarga un agente de conexión de Satellite para una plataforma concreta. Descarga el agente .zip para Windows u obtén un enlace a la documentación para entornos Docker.

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

Opciones de comando

--platform PLATFORM
La plataforma para el Agente Conector Satellite. Para obtener más información sobre Docker, consulte la documentación en https://ibm.biz/satconagent Opciones disponibles: windows, docker
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Consigue un agente de conexión de Satellite para una plataforma concreta.

ibmcloud sat experimental agent attach --platform PLATFORM -q

ibmcloud sat experimental agent ls

[¡Desactivado en 2024-09-01! Utiliza ibmcloud sat agent ls en lugar de] para obtener una lista de todos los agentes de un conector Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Mostrar todos los agentes de un conector de Satellite.

ibmcloud sat experimental agent ls --connector-id CONNECTOR_ID --output json -q

ibmcloud sat experimental connector create

[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector create en lugar de] . Crea un conector Satellite.

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

Opciones de comando

--name NAME
El nombre del conector de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--region REGION
La región de IBM Cloud para gestionar el conector de Satellite.

Ejemplos

Cree un conector de Satellite.

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

ibmcloud sat experimental connector get

[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector get en lugar de] . Consulta los detalles de un conector de Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de un conector Satellite.

ibmcloud sat experimental connector get --connector-id CONNECTOR_ID --output json -q

ibmcloud sat experimental connector ls

[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector ls en lugar de] . Consulta los conectores de Satellite en tu cuenta de IBM Cloud.

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

Opciones de comando

--after AFTER
Mostrar Satellite tras el cursor dado.
--first FIRST
Ver los siguientes Satellite, hasta el primer número de Conectores.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Consulta los conectores de Satellite en tu cuenta de IBM Cloud.

ibmcloud sat experimental connector ls --after AFTER --first FIRST --output json

ibmcloud sat experimental connector rm

[¡Desactivado en 2024-11-18! Utiliza ibmcloud sat connector rm en lugar de] . Elimina un conector de Satellite.

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

Opciones de comando

--connector-id ID
El ID de un conector de Satellite.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Suprimir un conector de Satellite.

ibmcloud sat experimental connector rm --connector-id CONNECTOR_ID -f -q

ibmcloud sat experimental endpoint authn get

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn get en lugar de] Obtenga la configuración de autenticación de un endpoint.

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

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtener la configuración de autenticación de un endpoint.

ibmcloud sat experimental endpoint authn get \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental endpoint authn rotate

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn rotate en su lugar] Sustituya los certificados de autenticación existentes por otros nuevos. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre el origen y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Solo se sustituyen los certificados que especifiques.

ibmcloud sat experimental endpoint authn rotate --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo, myCA.pem.
--dest-cert-file FILE
El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo, myCert.pem.
--dest-key-file FILE
La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo, myKey.pem.
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo, myCA.pem.
--source-cert-file FILE
El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo, myCert.pem.
--source-key-file FILE
La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo, myKey.pem.

Ejemplos

Sustituya los certificados de autenticación existentes por otros nuevos.

ibmcloud sat experimental endpoint authn rotate \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental endpoint authn set

[¡Desactivado en 2024-10-01! Utilice ibmcloud sat endpoint authn set en lugar de] Establezca la configuración de autenticación para un punto final. Hay dos conexiones de tipo « TLS » en el flujo de la solicitud. Las opciones « source » se refieren al protocolo de enlace « TLS » entre el origen y el servicio Connector. Las opciones « destination » se refieren al protocolo de enlace « TLS » entre el servicio Connector y el servidor de destino. Puede proporcionar certificados para una o ambas de estas conexiones. Los valores no especificados se establecen en sus valores predeterminados.

ibmcloud sat experimental endpoint authn set --endpoint ENDPOINT [--dest-ca-cert-file FILE] [--dest-cert-file FILE] [--dest-key-file FILE] [--dest-tls-mode MODE] [-q] [--source-ca-cert-file FILE] [--source-cert-file FILE] [--source-key-file FILE] [--source-tls-mode MODE] (--connector-id ID | --location LOCATION)

Opciones de comando

--connector-id ID
El ID del conector Satellite. Para buscar el ID de conector, ejecute ibmcloud sat connector ls.
--dest-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del servidor de destino. Por ejemplo, myCA.pem.
--dest-cert-file FILE
El certificado de cliente utilizado para autenticarse en el servidor de destino. Por ejemplo, myCert.pem.
--dest-key-file FILE
La clave privada de cliente utilizada para cifrar el certificado de cliente. Por ejemplo, myKey.pem.
--dest-tls-mode MODE
El modo TLS de destino. Valores aceptados:simple,mutual,none
--endpoint ENDPOINT
Especifique el nombre o el ID del punto final. Para ver una lista de todos los puntos finales, ejecuta ibmcloud sat endpoint ls.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--source-ca-cert-file FILE
Cadena o certificado de CA de confianza utilizado para validar el certificado del cliente de origen cuando source-tls-mode es mutuo. Por ejemplo, myCA.pem.
--source-cert-file FILE
El certificado de servidor que se va a presentar al cliente de origen. Por ejemplo, myCert.pem.
--source-key-file FILE
La clave privada de servidor utilizada para cifrar el certificado de servidor. Por ejemplo, myKey.pem.
--source-tls-mode MODE
La fuente: modo « TLS ». Valores aceptados: simple, mutual

Ejemplos

Establezca la configuración de autenticación para un punto final.

ibmcloud sat experimental endpoint authn set \
  --location LOCATION \
  --connector-id CONNECTOR_ID \
  --endpoint ENDPOINT

ibmcloud sat experimental location update

[¡Desactivado en 2024-11-25! Utiliza ibmcloud sat location update en lugar de] . Actualiza el nombre o la descripción de una ubicación de Satellite.

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

Opciones de comando

--description DESCRIPTION
Introduce una nueva descripción para la ubicación Satellite. La longitud de la descripción está limitada a 400 bytes.
--location-id ID
El identificador de la ubicación de Satellite. Para encontrar el ID de ubicación, ejecuta ibmcloud sat location ls.
--name NAME
Especifica un nuevo nombre para la ubicación Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice los nombres, incluidos los de las ubicaciones eliminadas.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Actualiza el nombre o la descripción de una localización de Satellite.

ibmcloud sat experimental location update \
  --location-id LOCATION \
  --name NAME \
  --description IP_ADDRESS

Comandos del grupo sat de ibmcloud

Ver y gestionar grupos de clústeres de Satellite. Los grupos de clústeres se utilizan para suscribir clústeres a las configuraciones de Satellite de los recursos de Kubernetes.

ibmcloud sat group attach

Añada un clúster al grupo de clústeres. El clúster se puede ejecutar en la ubicación de Satellite o en IBM Cloud. Para añadir un clúster que se ejecute en IBM Cloud, primero debe registrar el clúster con Satellite Config.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el ID o nombre de clúster. Para ver una lista de los clústeres registrados, ejecute ibmcloud sat cluster ls.
--group GROUP, -g GROUP
Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute ibmcloud sat group ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Añada un clúster al grupo de clústeres.

ibmcloud sat group attach --group GROUP --cluster CLUSTER_NAME_OR_ID -q

ibmcloud sat group create

Cree un grupo de clústeres. A continuación, puede suscribir el grupo de clústeres a una configuración de Satellite.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el nombre o el ID de clúster que desea añadir al grupo de clústeres. Para ver una lista de los clústeres registrados, ejecute ibmcloud sat cluster ls.
--name NAME
Proporcione un nombre del grupo de clústeres de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Cree un grupo de clústeres.

ibmcloud sat group create --name NAME --cluster CLUSTER_NAME_OR_ID -q

ibmcloud sat group detach

Elimina uno o varios clústeres del grupo de clústeres de Satellite, y suprime los recursos de Kubernetes que estaban gestionados por las suscripciones del grupo.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el ID o nombre de clúster. Para ver la lista de clústeres de tu grupo de clústeres, ejecuta ibmcloud sat group get --group <cluster_group_name_or_ID>.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP, -g GROUP
Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute ibmcloud sat group ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimina uno o varios clústeres de su grupo de clústeres Satellite y borra los recursos Kubernetes que gestionaba dicho grupo.

ibmcloud sat group detach --group GROUP --cluster CLUSTER_NAME_OR_ID -f

ibmcloud sat group get

Obtener información detallada de un grupo de clústeres de Satellite.

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

Opciones de comando

--group GROUP, -g GROUP
Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los clústeres registrados, ejecute ibmcloud sat cluster ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtener información detallada de un grupo de clústeres de Satellite.

ibmcloud sat group get --group GROUP --output json -q

ibmcloud sat group ls

Listar todos los grupos de clústeres de Satellite de la cuenta de IBM Cloud.

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

Opciones de comando

--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar todos los grupos de clústeres de Satellite de la cuenta de IBM Cloud.

ibmcloud sat group ls --output json -q

ibmcloud sat group rm

Eliminar un grupo de clústeres de Satellite, con lo que se anula la suscripción de los clústeres y se suprimen los recursos de Kubernetes que estaban gestionados por las suscripciones del grupo.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP, -g GROUP
Especifique el nombre o el ID de un grupo de clústeres de Satellite. Para ver una lista de los grupos de clústeres disponibles, ejecute ibmcloud sat group ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimina un grupo de clústeres de Satellite, lo que da de baja a los clústeres y elimina los recursos de Kubernetes que gestionaba dicho grupo.

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

Comandos del servidor sat de IBM Cloud

Vea y modifique los hosts de Satellite.

ibmcloud sat host assign

Asigne un host a un clúster o plano de control de ubicación de Satellite.

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

Opciones de comando

--cluster CLUSTER
El nombre o ID del clúster al que asignar el host. Para ver la lista de clústeres disponibles, ejecuta ibmcloud sat cluster ls. Si no se proporciona ningún clúster, el host se asigna automáticamente al plano de control de Satellite.
--host HOST
Nombre o ID del host que se asignará. Para asignar automáticamente hosts basados en etiquetas, no incluya esta opción. Para recuperar el ID del host, ejecute ibmcloud sat host ls --location <location_ID_or_name>.
--host-label LABEL, --hl LABEL
Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--worker-pool POOL, -p POOL
Nombre o ID de la agrupación de trabajadores en el clúster que se asignará al host. Si no se especifica ninguna agrupación de nodos trabajadores, el host se asigna a la agrupación de nodos trabajadores predeterminada.
--zone ZONE
Nombre o ID de la zona que se asignará al host. Para encontrar las zonas disponibles, ejecuta y ibmcloud sat location get --location <location_name_or_ID> busca el campo Host Zones.

Ejemplos

Asigne un host a un clúster o plano de control de ubicación de Satellite.

ibmcloud sat host assign \
  --location LOCATION \
  --cluster CLUSTER_NAME_OR_ID \
  --worker-pool POOL_NAME

ibmcloud sat host attach

Cree y descargue un script que pueda ejecutar en los hosts para adjuntarlos a su ubicación. Para las ubicaciones habilitadas para RHCOS, el script es un archivo de encendido.

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

Opciones de comando

--host-label LABEL, --hl LABEL
Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.
--host-link-agent-endpoint ENDPOINT
Punto final usado por el agente de enlace para conectarse con el servidor de túneles de enlace.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--operating-system SYSTEM
El sistema operativo de los hosts que desea conectar a su ubicación. Para conectar hosts RHCOS, la ubicación debe estar habilitada para RHCOS. Valores aceptados: RHEL, RHCOS
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--reset-key
Restablece la clave que utiliza el plano de control para conectar y asignar hosts en la ubicación. Consulta https://ibm.biz/reset-key.

Ejemplos

Cree y descargue un script que pueda ejecutar en los hosts para adjuntarlos a su ubicación.

ibmcloud sat host attach \
  --location LOCATION \
  --host-label HOSTNAME \
  --reset-key RESET-KEY

ibmcloud sat host get

Ver los detalles de un host de Satellite.

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

Opciones de comando

--host HOST
El ID de host de Satellite. Para encontrar el ID del host, ejecuta ibmcloud sat host ls <location_ID_or_name>.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de un host de Satellite.

ibmcloud sat host get --location LOCATION --host HOSTNAME --output json

ibmcloud sat host ls

Listar todos los hosts conectados a una ubicación de Satellite, incluidos los hosts asignados a clústeres o al plano de control.

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

Opciones de comando

--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Enumera todos los hosts asociados a una ubicación de Satellite, incluidos los hosts asignados a clústeres o al panel de control.

ibmcloud sat host ls --location LOCATION --output json -q

ibmcloud sat host rm

Eliminar un host de una ubicación de Satellite.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--host HOST
Nombre o ID del host a eliminar.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Eliminar un host de una ubicación de Satellite.

ibmcloud sat host rm --location LOCATION --host HOSTNAME -f

ibmcloud sat host update

Actualizar la información de host, como por ejemplo zonas y etiquetas.

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

Opciones de comando

--host HOST
Nombre o ID del host que se asignará. Para asignar automáticamente hosts basados en etiquetas, no incluya esta opción.
--host-label LABEL, --hl LABEL
Introduce las etiquetas como pares clave-valor para identificar el host que se asignará a tu plano de control de Satellite o a tu clúster de Red Hat OpenShift. El primer host que tenga esta etiqueta y que no esté asignado se asigna automáticamente al plano de control o clúster. Para buscar etiquetas de host disponibles, ejecute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--zone ZONE
El nombre o ID de la zona que se asociará al host. No puede cambiar la zona de hosts asignados a un recurso, como un clúster. Primero debe desasignarlos. Para ver la lista de zonas disponibles, ejecute ibmcloud sat location get --location <ID>.

Ejemplos

Actualizar la información de host, como por ejemplo zonas y etiquetas.

ibmcloud sat host update --location LOCATION --host-label HOSTNAME --zone ZONE

Comandos clave de ibmcloud sat

Ver y gestionar las claves de configuración de Satellite.

ibmcloud sat key ls

Listar todas las claves de configuración de Satellite en la cuenta de IBM Cloud.

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

Opciones de comando

--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar todas las claves de configuración de Satellite en la cuenta de IBM Cloud.

ibmcloud sat key ls --output json -q

ibmcloud sat key rm

Elimine una clave de configuración de Satellite. Cualquier clúster que siga utilizando esta clave no podrá conectarse a la configuración de Satellite.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--key KEY
El nombre o el ID de una clave de configuración de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Elimine una clave de configuración de Satellite.

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

ibmcloud sat key rotate

Genere una nueva clave para que la utilicen los clústeres gestionados para conectarse a la configuración de Satellite.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--name NAME
El nombre de la nueva clave de configuración de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Genere una nueva clave para que la utilicen los clústeres gestionados para conectarse a la configuración de Satellite.

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

Comandos localización de IBM Cloud SAT

Crear, ver y modificar ubicaciones de Satellite.

ibmcloud sat location create

Cree una ubicación de Satellite. Una ubicación de Satellite es una representación de un entorno en el proveedor de infraestructura. Una vez creada una ubicación, asigne hosts de zonas distintas de su entorno de infraestructura subyacente mediante el comando ibmcloud sat host attach.

ibmcloud sat location create --managed-from REGION --name NAME [--capability CAPABILITY ...] [--coreos-enabled] [--cos-bucket BUCKET] [--description DESCRIPTION] [--ha-zone ZONE ...] [--physical-address ADDRESS] [--pod-network-interface-selection SELECTION] [--pod-subnet SUBNET] [--provider PROVIDER] [--provider-credential CREDENTIAL] [--provider-region REGION] [-q] [--service-subnet SUBNET]

Opciones de comando

--capability CAPABILITY
Una funcionalidad de la ubicación Satellite.
--coreos-enabled
Habilite las características de Red Hat CoreOS para la ubicación de Satellite. Esta acción no se puede deshacer. Consulte https://ibm.biz/infra-os.
--cos-bucket BUCKET
Especifique el nombre del grupo IBM Cloud Object Storage para almacenar los datos del plano de control de ubicación de Satellite. De lo contrario, se creará automáticamente un nuevo grupo.
--description DESCRIPTION
Especifique una descripción para la ubicación de Satellite.
--ha-zone ZONE
Especifique la zona para su ubicación. Para garantizar una alta disponibilidad, especifica tres zonas para tu ubicación como --ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. Los nombres de las zonas deben coincidir exactamente con los nombres de las zonas correspondientes en el proveedor de infraestructura donde tiene previsto crear hosts.
--managed-from REGION
Seleccione la región de IBM Cloud desde la que gestionar la ubicación de Satellite. Elija una región cercana a su centro de datos local para mejorar el rendimiento. Consulte https://ibm.biz/sat-region.
--name NAME
Especifique un nombre para la ubicación de Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice nombres, aunque se suprima la otra ubicación.
--physical-address ADDRESS
La dirección física de la ubicación del Satellite.
--pod-network-interface-selection SELECTION
El método para seleccionar la interfaz de red de nodo para la red de pod interna. Esta opción solo se puede utilizar si también se habilita Red Hat CoreOS con la opción --coreos-enabled. Para proporcionar una dirección IP o URL, especifique can-reach=<url> o can-reach=<ip_address>. Para elegir una interfaz de red, especifique interface=<network_interface>.
--pod-subnet SUBNET
Especifique un CIDR de subred personalizado para proporcionar direcciones IP privadas para pods. Esta opción solo se utiliza si se habilita Red Hat CoreOS con la opción --coreos-enabled. La subred debe tener un tamaño de /23 o superior. Consulte https://ibm.biz/sat-location-create. Valor predeterminado: '172.16.0.0/16
--provider PROVIDER
Indique el proveedor de infraestructura que se debe utilizar para la ubicación de Satellite. Si incluye esta opción, también debe incluir la opción --provider-credential. Valores aceptados: aws, azure, gcp, vmware
--provider-credential CREDENTIAL
Especifique la vía de acceso a un archivo JSON en la máquina local que tenga las credenciales del proveedor de infraestructura para la ubicación de Satellite. El formato de credencial es específico del proveedor. Consulte http://ibm.biz/sat-infra-creds.
--provider-region REGION
Especifique la región en el proveedor de infraestructura donde tiene previsto crear los hosts para la ubicación de Satellite. Si incluye esta opción, también debe incluir la opción --provider.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--service-subnet SUBNET
Especifique un CIDR de subred personalizado para proporcionar direcciones IP privadas para servicios. Esta opción solo se utiliza si se habilita Red Hat CoreOS con la opción --coreos-enabled. La subred debe tener un tamaño de /24 o superior. Consulte https://ibm.biz/sat-location-create. Valor predeterminado: 172.20.0.0/16

Ejemplos

Cree una ubicación de Satellite.

ibmcloud sat location create \
  --pod-subnet SUBNET_CIDR \
  --service-subnet SUBNET_CIDR \
  --name NAME

ibmcloud sat location dns get

Ver los detalles de un subdominio registrado en una ubicación de Satellite.

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

Opciones de comando

--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subdomain SUBDOMAIN
Especifique el nombre de subdominio. Para listar los subdominios existentes, ejecute ibmcloud sat location dns ls --location <ID>.

Ejemplos

Ver los detalles de un subdominio registrado en una ubicación de Satellite.

ibmcloud sat location dns get --location LOCATION --subdomain DOMAIN --output json

ibmcloud sat location dns ls

Liste los subdominios registrados en una ubicación de Satellite.

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

Opciones de comando

--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Liste los subdominios registrados en una ubicación de Satellite.

ibmcloud sat location dns ls --location LOCATION --output json -q

ibmcloud sat location dns register

Establezca un subdominio para los hosts asignados al plano de control en una ubicación de Satellite.

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

Opciones de comando

--ip IP
Especifique la dirección IP de cada host del plano de control, en el formato --ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Para clústeres multizona, utilice una dirección IP de cada zona. Para encontrar la dirección IP, ejecuta y ibmcloud sat host ls --location <location_ID_or_name> busca los hosts etiquetados como Worker IP infrastructure.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Establezca un subdominio para los hosts asignados al plano de control en una ubicación de Satellite.

ibmcloud sat location dns register --location LOCATION --ip IP_ADDRESS --output json

ibmcloud sat location get

Ver los detalles de una ubicación de Satellite.

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

Opciones de comando

--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los detalles de una ubicación de Satellite.

ibmcloud sat location get --location LOCATION --output json -q

ibmcloud sat location ls

Listar todas las ubicaciones de Satellite en la cuenta de IBM Cloud.

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

Opciones de comando

--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar todas las ubicaciones de Satellite en la cuenta de IBM Cloud.

ibmcloud sat location ls --output json -q

ibmcloud sat location rm

Suprimir una ubicación. Antes de ejecutar este mandato, realice una copia de seguridad de las configuraciones y elimine los hosts y clústeres que se ejecuten en la ubicación. La infraestructura de host subyacente no se suprime automáticamente al suprimir una ubicación. Esta acción no se puede deshacer.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Suprimir una ubicación.

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

ibmcloud sat location update

Actualiza el nombre o la descripción de una localización de Satellite.

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

Opciones de comando

--description DESCRIPTION
Introduce una nueva descripción para la ubicación Satellite. La longitud de la descripción está limitada a 400 bytes.
--location-id ID
El identificador de la ubicación de Satellite. Para encontrar el ID de ubicación, ejecuta ibmcloud sat location ls.
--name NAME
Especifica un nuevo nombre para la ubicación Satellite. Los nombres de las ubicaciones deben comenzar con una letra, pueden contener letras, números, puntos (.) y guiones (-), y deben tener menos de 36 caracteres. No reutilice los nombres, incluidos los de las ubicaciones eliminadas.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Actualiza el nombre o la descripción de una localización de Satellite.

ibmcloud sat location update \
  --location-id LOCATION \
  --name NAME \
  --description IP_ADDRESS

ibmcloud mensajes de SAT comandos

Ver los mensajes del usuario actual.

ibmcloud sat messages

Ver los mensajes del usuario actual.

ibmcloud sat messages [-q]

Opciones de comando

-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Ver los mensajes del usuario actual.

ibmcloud sat messages -q

Comandos recursos de IBM Cloud SAT

Busque y vea los recursos de Kubernetes gestionados por una configuración de Satellite.

ibmcloud sat resource get

Vea los detalles de un recurso de Kubernetes gestionado por una configuración de Satellite.

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

Opciones de comando

--history HISTORY
El ID de historial del recurso.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--resource RESOURCE
Especifique el ID de recurso de Kubernetes. Para encontrar recursos de Kubernetes, ejecuta ibmcloud sat resource ls.
--save-data
Descargar y guardar una definición de recurso de Kubernetes en un archivo temporal.

Ejemplos

Vea los detalles de un recurso de Kubernetes gestionado por una configuración de Satellite.

ibmcloud sat resource get \
  --resource RESOURCE \
  --history HISTORY \
  --save-data SAVE-DATA

ibmcloud sat resource history get

Obtener el historial de un recurso de Kubernetes.

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

Opciones de comando

--limit LIMIT
Especifique el número máximo de entradas de historial a devolver.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--resource RESOURCE
El ID de recurso de Kubernetes.

Ejemplos

Obtener el historial de un recurso de Kubernetes.

ibmcloud sat resource history get --resource RESOURCE --limit LIMIT --output json

ibmcloud sat resource ls

Buscar los recursos de Kubernetes que están gestionados por Satellite.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el nombre o el ID del clúster registrado en el que se ejecuta el recurso Kubernetes. Para buscar clústeres registrados, ejecuta ibmcloud sat cluster ls.
--limit LIMIT
Especifique el número máximo de entradas de recurso que debe devolver la búsqueda.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--search SEARCH
Indique la serie para filtrar los resultados de búsqueda de los recursos de Kubernetes, como un pod o un nombre de espacio de nombres.
--subscription SUBSCRIPTION
Especifique el ID o nombre de suscripción de Satellite. Para buscar suscripciones, ejecuta ibmcloud sat cluster ls.

Ejemplos

Buscar los recursos de Kubernetes que están gestionados por Satellite.

ibmcloud sat resource ls --search SEARCH --limit LIMIT --cluster CLUSTER_NAME_OR_ID

Comandos servicio SAT de IBM Cloud

Ver clústeres de servicios de Satellite.

ibmcloud sat service ls

Liste todos los clústeres de servicio de Satellite en su ubicación para revisar los detalles, como los recursos de host solicitados.

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

Opciones de comando

--location LOCATION
Nombre o ID de la ubicación de Satellite. Para encontrar el ID o el nombre de la ubicación, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Liste todos los clústeres de servicio de Satellite en su ubicación para revisar los detalles, como los recursos de host solicitados.

ibmcloud sat service ls --location LOCATION --output json -q

Comandos almacenamiento SAT de IBM Cloud

Ver y gestionar recursos de almacenamiento de Satellite.

ibmcloud sat storage assignment autopatch disable

El mandato storage assignment autopatch disable es una característica beta.

Desactivar las actualizaciones automáticas para una asignación de almacenamiento de Satellite.

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

Opciones de comando

--all
Inhabilite los parches automáticos para todas las asignaciones de almacenamiento de Satellite de una configuración de almacenamiento.
--assignment ASSIGNMENT
El ID de una asignación de almacenamiento de Satellite. Para ver la lista de asignaciones de almacenamiento disponibles de la configuración, ejecuta ibmcloud sat storage assignment ls --config CONFIG.
--config CONFIG
El nombre o el ID de una configuración de almacenamiento Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute ibmcloud sat storage config ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Desactivar las actualizaciones automáticas para una asignación de almacenamiento de Satellite.

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

ibmcloud sat storage assignment autopatch enable

El mandato storage assignment autopatch enable es una característica beta.

Activar las actualizaciones automáticas para una asignación de almacenamiento de « Satellite ».

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

Opciones de comando

--all
Habilite los parches automáticos para todas las asignaciones de almacenamiento de Satellite de una configuración de almacenamiento.
--assignment ASSIGNMENT
El ID de una asignación de almacenamiento de Satellite. Para ver la lista de asignaciones de almacenamiento disponibles de la configuración, ejecuta ibmcloud sat storage assignment ls --config CONFIG.
--config CONFIG
El nombre o el ID de una configuración de almacenamiento Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute ibmcloud sat storage config ls.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Activar las actualizaciones automáticas para una asignación de almacenamiento de « Satellite ».

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

ibmcloud sat storage assignment create

Crear una asignación para desplegar las configuraciones de almacenamiento en clústeres en su ubicación de Satellite.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el ID del clúster de Satellite para la asignación. Para buscar el ID del clúster, ejecute ibmcloud oc cluster ls --provider satellite.
--config CONFIG
Especifique la configuración de almacenamiento de Satellite para la asignación. para buscar configuraciones, ejecute ibmcloud sat storage config ls.
--group GROUP, -g GROUP
Especifique los grupos de clúster para la asignación. Para buscar grupos de clústeres, ejecuta ibmcloud sat group ls.
--name NAME
Proporcione un nombre para la asignación de almacenamiento de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--service-cluster-id CLUSTER
Especifique el ID del clúster de servicio para la asignación. Para encontrar el ID del clúster del servicio, ejecuta ibmcloud sat service ls --location <location>.

Ejemplos

Crear una asignación para desplegar las configuraciones de almacenamiento en clústeres en su ubicación de Satellite.

ibmcloud sat storage assignment create \
  --name NAME \
  --group GROUP \
  --service-cluster-id CLUSTER_NAME_OR_ID

ibmcloud sat storage assignment get

Obtener los detalles de una asignación de almacenamiento de Satellite.

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

Opciones de comando

--assignment ASSIGNMENT
Especifique el ID de una asignación de almacenamiento de Satellite.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtener los detalles de una asignación de almacenamiento de Satellite.

ibmcloud sat storage assignment get --assignment ASSIGNMENT --output json -q

ibmcloud sat storage assignment ls

Listar las asignaciones de almacenamiento de Satellite en su cuenta de IBM Cloud.

Para enumerar todas las asignaciones de un clúster de servicios como administrador de servicios: asignación de almacenamiento satelital de ibmcloud ls--service-cluster-id GRUPO.

Para enumerar todas las asignaciones para un clúster de servicios como administrador de ubicación: asignación de almacenamiento satelital de ibmcloud ls--location UBICACIÓN--service-cluster-id GRUPO.

Para mostrar todas las asignaciones de una configuración: ibmcloud sat storage assignment ls --config CONFIG.

ibmcloud sat storage assignment ls [--output OUTPUT] [-q] (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especifique el ID del clúster de Satellite para las asignaciones. Para obtener el ID del clúster, ejecuta ibmcloud oc cluster ls --provider satellite.
--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones de almacenamiento disponibles, ejecute ibmcloud sat storage config ls.
--location LOCATION
Especifique el nombre de una ubicación de Satellite. Para ver la lista de ubicaciones disponibles, ejecuta ibmcloud sat location ls. El administrador del servicio no puede utilizar esta opción.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--service-cluster-id CLUSTER
Especifique el ID del clúster de servicio para las asignaciones. Para encontrar el ID del clúster del servicio, ejecuta ibmcloud sat service ls --location <location>.

Ejemplos

Listar las asignaciones de almacenamiento de Satellite en su cuenta de IBM Cloud.

ibmcloud sat storage assignment ls \
  --service-cluster-id CLUSTER_NAME_OR_ID \
  --cluster CLUSTER_NAME_OR_ID \
  --config CONFIG

ibmcloud sat storage assignment patch

Aplicar cambios de configuración de almacenamiento a las asignaciones asociadas.

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

Alias: ibmcloud sat upgrade

Opciones de comando

--assignment ASSIGNMENT
Especifique el ID de una asignación de almacenamiento de Satellite. Para ver la lista de tareas disponibles, ejecuta ibmcloud sat storage assignment ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Aplicar cambios de configuración de almacenamiento a las asignaciones asociadas.

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

ibmcloud sat storage assignment rm

Eliminar una asignación de almacenamiento de Satellite. Los recursos de Kubernetes se suprimen de todos los clústeres de la ubicación de Satellite, pero se conserva la configuración.

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

Opciones de comando

--assignment ASSIGNMENT
Especifique el ID de una asignación de almacenamiento de Satellite. Para buscar tareas, ejecuta ibmcloud sat storage assignment ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Eliminar una asignación de almacenamiento de Satellite.

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

ibmcloud sat storage assignment update

Actualizar una asignación de almacenamiento de Satellite.

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

Opciones de comando

--assignment ASSIGNMENT
Especifique el ID de una asignación de almacenamiento de Satellite.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--group GROUP, -g GROUP
Especifique los nuevos grupos de clústeres para la asignación. Para ver la lista de grupos disponibles, ejecuta ibmcloud sat group ls.
--name NAME
Proporcione un nuevo nombre para la asignación de almacenamiento de Satellite.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Actualizar una asignación de almacenamiento de Satellite.

ibmcloud sat storage assignment update \
  --assignment ASSIGNMENT \
  --name NAME \
  --group GROUP

ibmcloud sat storage config class add

Cree una clase de almacenamiento Satellite personalizada.

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

Opciones de comando

--config-name NAME
Especifique el nombre de la configuración de almacenamiento para la clase de almacenamiento personalizada. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta ibmcloud sat storage config ls.
--name NAME
Proporcione un nombre para la clase de almacenamiento personalizada.
--param PARAM, -p PARAM
Especifique un par key=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

Cree una clase de almacenamiento Satellite personalizada.

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

ibmcloud sat storage config class get

Obtenga los detalles de una clase de almacenamiento de Satellite.

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

Opciones de comando

--class CLASS
Especifique el nombre de una clase de almacenamiento Satellite.
--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta ibmcloud sat storage config ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtenga los detalles de una clase de almacenamiento de Satellite.

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

ibmcloud sat storage config class ls

Listar las clases de almacenamiento en una configuración de almacenamiento de Satellite

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta ibmcloud sat storage config ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--show-params
Incluya esta opción para listar todos los detalles de parámetro de clase de almacenamiento.

Ejemplos

Enumera las clases de almacenamiento en una configuración de almacenamiento de Satellite.

ibmcloud sat storage config class ls \
  --config CONFIG \
  --show-params SHOW-PARAMS \
  --output json

ibmcloud sat storage config create

Cree una configuración de almacenamiento de Satellite para instalar controladores de almacenamiento en los clústeres.

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

Opciones de comando

--location LOCATION
Especifique el ID o el nombre de la ubicación para la configuración de almacenamiento. Para ver las ubicaciones disponibles, ejecuta ibmcloud sat location ls.
--name NAME
Especifique el nombre de la configuración de almacenamiento.
--param PARAM, -p PARAM
Especifique un par key=value de parámetros de configuración. Para ver los parámetros de configuración de una plantilla de almacenamiento, ejecute ibmcloud sat storage template get.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--template-name NAME
Especifique el nombre de plantilla de configuración de almacenamiento de Satellite. Para ver la lista de plantillas de configuración de almacenamiento disponibles, ejecute ibmcloud sat storage template ls.
--template-version VERSION
Especifique la versión de plantilla de configuración de almacenamiento de Satellite. Si no incluye esta opción, se utiliza la versión predeterminada. Para ver la lista de plantillas de configuración de almacenamiento disponibles, ejecute ibmcloud sat storage template ls.

Ejemplos

Cree una configuración de almacenamiento de Satellite para instalar controladores de almacenamiento en los clústeres.

ibmcloud sat storage config create \
  --name NAME \
  --template-name NAME \
  --template-version VERSION

ibmcloud sat storage config get

Obtener los detalles de una configuración de almacenamiento de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat storage config ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Obtener los detalles de una configuración de almacenamiento de Satellite.

ibmcloud sat storage config get --config CONFIG --output json -q

ibmcloud sat storage config ls

Listar las configuraciones de almacenamiento de Satellite en su cuenta de IBM Cloud.

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

Opciones de comando

--location LOCATION
Especifique el ID o el nombre de la ubicación que contiene las configuraciones que desea listar. Para ver las ubicaciones disponibles, ejecuta ibmcloud sat location ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar las configuraciones de almacenamiento de Satellite en su cuenta de IBM Cloud.

ibmcloud sat storage config ls --location LOCATION --output json -q

ibmcloud sat storage config param set

Establezca los parámetros de configuración y secreto de una configuración de almacenamiento de Satellite.

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

Opciones de comando

--apply
Aplique la última versión de la configuración de almacenamiento de Satellite a todas las asignaciones de una configuración. Para ver la lista de asignaciones de una configuración, ejecute ibmcloud sat storage assignment ls --config CONFIG.
--config CONFIG
Especifique el nombre o el ID de la configuración de almacenamiento. Para ver una lista de las configuraciones de almacenamiento de Satellite, ejecuta ibmcloud sat storage config ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--param PARAM, -p PARAM
Especifique un par key=value de parámetros de configuración. Para ver los parámetros de configuración de 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

Establezca los parámetros de configuración y secreto de una configuración de almacenamiento de Satellite.

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

ibmcloud sat storage config patch

Aplica las últimas actualizaciones de parches a una configuración de almacenamiento de « Satellite ». Las actualizaciones de parches contienen correcciones de vulnerabilidades y correcciones de errores en la misma versión principal.

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

Alias: ibmcloud sat upgrade

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat storage config ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--include-assignments
Incluye esta opción para actualizar las asignaciones de la configuración de almacenamiento a la última versión de la configuración.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Aplica las últimas actualizaciones de parches a una configuración de almacenamiento de « Satellite ».

ibmcloud sat storage config patch \
  --config CONFIG \
  --include-assignments INCLUDE-ASSIGNMENTS \
  -f

ibmcloud sat storage config rm

Eliminar una configuración de almacenamiento de Satellite.

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

Opciones de comando

--config CONFIG
Especifique el nombre o el ID de una configuración de almacenamiento de Satellite. Para listar las configuraciones disponibles, ejecute ibmcloud sat storage config ls.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--include-assignments
Incluya esta opción para eliminar la configuración de almacenamiento así como las asignaciones asociadas.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Eliminar una configuración de almacenamiento de Satellite.

ibmcloud sat storage config rm \
  --config CONFIG \
  --include-assignments INCLUDE-ASSIGNMENTS \
  -f

ibmcloud sat storage template get

Obtener los detalles de una plantilla de almacenamiento de Satellite

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

Opciones de comando

--name NAME
Especifique el nombre de la plantilla de almacenamiento. Para ver la lista de plantillas de almacenamiento disponibles, ejecute ibmcloud sat storage template ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--version VERSION
Especifique la versión de la plantilla de almacenamiento. Para ver la lista de plantillas de almacenamiento disponibles, ejecute ibmcloud sat storage template ls.

Ejemplos

Consulta los detalles de una plantilla de almacenamiento de Satellite.

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

ibmcloud sat storage template ls

Listar las plantillas de almacenamiento de Satellite disponibles.

ibmcloud sat storage template ls [-q]

Opciones de comando

-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar las plantillas de almacenamiento de Satellite disponibles.

ibmcloud sat storage template ls -q

Comandos de suscripción a IBM Cloud SAT

Ver y gestionar suscripciones de Satellite para desplegar archivos de configuración de Kubernetes en los clústeres.

ibmcloud sat subscription create

Cree una suscripción de Satellite para clústeres. Después de crear la suscripción, la versión de configuración de Satellite asociada se despliega automáticamente en los clústeres suscritos.

ibmcloud sat subscription create --config CONFIG --group GROUP [--group GROUP ...] --name NAME [-q] (--auth-required --gitref GITREF --gitref-type TYPE --path PATH --repository REPOSITORY | --version VERSION)

Opciones de comando

--auth-required
Proporcione el secreto de autenticación necesario para conectarse al repositorio remoto. Consulte https://ibm.biz/sat-config-private-repo para obtener más detalles. Estrategia: GitOps.
--config CONFIG
Especifique el nombre de la configuración que se utilizará para la suscripción. Para ver las configuraciones disponibles, ejecuta ibmcloud sat config ls.
--gitref GITREF
Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type TYPE
Indique el tipo de GitRef que se debe utilizar para la suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--group GROUP, -g GROUP
Especifique el nombre o el ID de los grupos de clústeres para suscribirse a la configuración. Para encontrar los grupos de clústeres disponibles, ejecuta ibmcloud sat group ls.
--name NAME
Especifique un nombre para la suscripción.
--path PATH
Proporcione la vía de acceso a los archivos de repositorio o activos de release en el repositorio remoto para utilizarlos para la suscripción de Satellite. Estrategia: GitOps.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--repository REPOSITORY
Especifique el URL del repositorio remoto que se utilizará para la suscripción. Estrategia: GitOps.
--version VERSION
Indique el nombre o el ID de la versión de configuración existente que se utilizará para la suscripción. Para buscar versiones, ejecuta ibmcloud sat config get --config <configuration_name_or_ID>. Estrategia: Carga directa.

Ejemplos

Cree una suscripción de Satellite para clústeres.

ibmcloud sat subscription create \
  --auth-required AUTH-REQUIRED \
  --name NAME \
  --group GROUP \
  --config CONFIG

ibmcloud sat subscription get

Obtener información detallada de una suscripción de Satellite.

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

Opciones de comando

--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION
Introduce el nombre o el ID de una suscripción a Satellite. Para buscar suscripciones, ejecuta ibmcloud sat subscription ls.

Ejemplos

Obtener información detallada de una suscripción de Satellite.

ibmcloud sat subscription get --subscription IP_ADDRESS --output json -q

ibmcloud sat subscription identity set

Actualiza la suscripción a Satellite para utilizar tu identidad a la hora de gestionar recursos.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION
Especifique el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta ibmcloud sat subscription ls.

Ejemplos

Actualiza la suscripción a Satellite para utilizar tu identidad a la hora de gestionar recursos.

ibmcloud sat subscription identity set --subscription IP_ADDRESS -f -q

ibmcloud sat subscription ls

Listar todas las suscripciones de Satellite de la cuenta de IBM Cloud.

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

Opciones de comando

--cluster CLUSTER, -c CLUSTER
Especificar el ID o nombre de clúster de Satellite. Para buscar clústeres registrados, ejecuta ibmcloud sat cluster ls.
--output OUTPUT
Imprime la salida del mandato en el formato proporcionado. Valores aceptados: json
-q
No mostrar el mensaje del día ni los recordatorios de actualización.

Ejemplos

Listar todas las suscripciones de Satellite de la cuenta de IBM Cloud.

ibmcloud sat subscription ls --cluster CLUSTER_NAME_OR_ID --output json -q

ibmcloud sat subscription rm

Eliminar una suscripción de Satellite. Los recursos de Kubernetes ya no se despliegan en los clústeres.

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

Opciones de comando

-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--subscription SUBSCRIPTION
Proporcione el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta ibmcloud sat subscription ls.

Ejemplos

Eliminar una suscripción de Satellite.

ibmcloud sat subscription rm --subscription IP_ADDRESS -f -q

ibmcloud sat subscription update

Actualizar una suscripción de Satellite.

ibmcloud sat subscription update --subscription SUBSCRIPTION [-f] [--group GROUP] [--name NAME] [-q] (--auth-required --gitref GITREF --gitref-type TYPE --path PATH --repository REPOSITORY | --version VERSION)

Opciones de comando

--auth-required
Proporcione el secreto de autenticación necesario para conectarse al repositorio remoto. Estrategia: GitOps.
-f
Forzar que el mandato se ejecute sin solicitudes de usuario.
--gitref GITREF
Especifique el GitRef que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--gitref-type TYPE
Indique el tipo de GitRef que se debe utilizar para esta suscripción de Satellite. Estrategia: GitOps. Valores permitidos: branch, commit, tag, release
--group GROUP, -g GROUP
Especifique los nuevos grupos de clústeres que se suscribirán a la configuración.
--name NAME
Proporcione un nombre nuevo de la suscripción de Satellite.
--path PATH
Indique la vía de acceso a los archivos de repositorio o a los activos de release del repositorio remoto que se van a utilizar para la suscripción de Satellite. Estrategia: GitOps.
-q
No mostrar el mensaje del día ni los recordatorios de actualización.
--repository REPOSITORY
Proporcione el URL del repositorio remoto que se utilizará para la suscripción de Satellite. Estrategia: GitOps.
--subscription SUBSCRIPTION
Especifique el nombre o el ID de una suscripción de Satellite. Para ver la lista de suscripciones, ejecuta ibmcloud sat subscription ls.
--version VERSION
Indique la versión de configuración existente que se utilizará para la suscripción de Satellite. Estrategia: Carga directa.

Ejemplos

Actualizar una suscripción de Satellite.

ibmcloud sat subscription update \
  --auth-required AUTH-REQUIRED \
  --subscription IP_ADDRESS \
  --name NAME \
  --group GROUP