Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser ativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

O nome da ACL.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Crie uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser ativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Adicione um ou mais pontos de extremidade habilitados a uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Lista todos os pontos de extremidade habilitados para uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser desativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover um ou mais pontos de extremidade habilitados de uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualizar os detalhes de uma ACL.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todas as ACLs de um conector ou local do Satellite.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Excluir uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Adicione uma ou mais sub-redes a uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Remover uma ou mais sub-redes de uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

O novo nome da ACL.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Atualizar o nome de uma ACL.

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

Opções de comando

--platform PLATFORM

A plataforma para o Satellite Connector Agent. Para obter mais informações sobre o Docker, consulte a documentação em https://ibm.biz/satconagent Opções disponíveis: windows, docker

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obtenha um Agente de Conector do Satellite para uma plataforma específica.

ibmcloud sat agent attach --platform PLATFORM -q

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todos os agentes de um conector do Satellite.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o nome ou ID do cluster. Para listar os clusters registrados, execute ibmcloud sat cluster ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obtenha os detalhes de um cluster registrado.

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

Opções de comando

--filter FILTER

Filtrar clusters registrados por ID do cluster.

--limit LIMIT

Limite o número de clusters que são retornados.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todos os clusters registrados em sua conta da IBM Cloud.

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

Opções de comando

--name NAME

Especifique o nome do cluster que deseja registrar

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--silent

Silencioso. Retornar apenas o comando de registro na saída.

Exemplos

Obtenha um comando kubectl para registrar seu cluster em uma configuração Satellite.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o nome ou ID do cluster. Para listar os clusters registrados, execute ibmcloud sat cluster ls.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover um registro de cluster.

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

Opções de comando

--data-location LOCATION

Especifique a região da IBM para armazenar os dados de configuração do Satellite. Estratégia: upload direto.

--name NAME

Forneça um nome para a configuração do Satellite.

--provider PROVIDER

Indique o provedor GitOps remoto para a configuração do Satellite. Esse provedor armazena as definições de recurso do Kubernetes. Estratégia: GitOps. Valores permitidos: github, gitlab

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Crie uma configuração para especificar quais recursos do Kubernetes você deseja implantar nos seus clusters no seu ambiente de trabalho do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obtenha detalhes sobre uma configuração do Satellite, como as versões ou assinaturas associadas à configuração.

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

Opções de comando

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todas as configurações do Satellite em sua conta do IBM Cloud.

ibmcloud sat config ls --output json -q

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

--name NAME

Forneça um novo nome para a configuração do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Renomear uma configuração do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover uma configuração do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID da configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

--description DESCRIPTION

Inclua uma descrição para a versão de configuração do Satellite.

--file-format FORMAT

Indique o formato de arquivo da versão de configuração. Opções disponíveis: yaml

--name NAME

Forneça um nome para a versão de configuração do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--read-config CONFIG

Especifique o caminho de arquivo para o arquivo de versão de configuração.

Exemplos

Criar uma versão de configuração para atualizar os recursos existentes do Kubernetes para suas cargas de trabalho do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID da configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--save-config

Fazer download e salvar a versão de configuração em um arquivo temporário.

--version VERSION

Especifique o nome ou ID da versão de configuração do Satellite. Para listar versões em sua configuração, execute ibmcloud sat config get --config <configuration_name_or_ID>.

Exemplos

Obter detalhes para uma versão de configuração do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID da configuração do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat config ls.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--version VERSION

Indique o nome ou ID da versão de configuração do Satellite. Para listar as versões, execute o comando ibmcloud sat config get --config <configuration_name_or_ID>``.

Exemplos

Remover uma versão de configuração do Satellite.

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

Opções de comando

--name NAME

O nome para o conector do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--region REGION

A região da IBM Cloud para gerenciar seu conector do Satellite.

Exemplos

Crie um conector do Satellite.

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

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os detalhes de um conector do Satellite.

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

Opções de comando

--after AFTER

Mostrar Satellite após o cursor fornecido.

--first FIRST

Visualize os próximos Satellite, até o primeiro número de conectores.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os conectores do Satellite na sua conta do IBM Cloud.

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

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Exclua um conector do Satellite.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obter as configurações de autenticação de um ponto de extremidade.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do servidor de destino. Por exemplo, myCA.pem.

--dest-cert-file FILE

O certificado do cliente utilizado para autenticação no servidor de destino. Por exemplo, myCert.pem.

--dest-key-file FILE

A chave privada do cliente usada para criptografar o certificado de cliente Por exemplo, myKey.pem.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--source-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do cliente de origem quando source-tls-mode é mútuo. Por exemplo, myCA.pem.

--source-cert-file FILE

O certificado do servidor para apresentar ao cliente de origem. Por exemplo, myCert.pem.

--source-key-file FILE

A chave privada do servidor usada para criptografar o certificado do servidor Por exemplo, myKey.pem.

Exemplos

Substituir os certificados de autenticação existentes por novos.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do servidor de destino. Por exemplo, myCA.pem.

--dest-cert-file FILE

O certificado do cliente utilizado para autenticação no servidor de destino. Por exemplo, myCert.pem.

--dest-key-file FILE

A chave privada do cliente usada para criptografar o certificado de cliente Por exemplo, myKey.pem.

--dest-tls-mode MODE

O destino TLS mode. Valores aceitos:simple,mutual,none

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--source-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do cliente de origem quando source-tls-mode é mútuo. Por exemplo, myCA.pem.

--source-cert-file FILE

O certificado do servidor para apresentar ao cliente de origem. Por exemplo, myCert.pem.

--source-key-file FILE

A chave privada do servidor usada para criptografar o certificado do servidor Por exemplo, myKey.pem.

--source-tls-mode MODE

A fonte: TLS. Valores aceitos: simple, mutual

Exemplos

Definir configurações de autenticação para um ponto de extremidade.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-hostname HOSTNAME

Indique o nome completo do domínio (FQDN) ou o endereço IP acessível externamente do destino ao qual deseja se conectar. Para pontos de extremidad cloud, esse valor deve corresponder a um endereço IP público ou a um endereço IP privado acessível dentro de IBM Cloud, como um ponto de extremidade de serviço em nuvem privada. Para endpoints do location, esse valor deve ser resolvido a partir dos hosts do plano de controle e estar acessível a partir deles para locais do Satellite ou onde o agente é executado para o Satellite Connector.

--dest-port PORT

Forneça a porta na qual o recurso de destino atende às solicitações recebidas. Certifique-se de que a porta corresponda ao protocolo de destino.

--dest-protocol PROTOCOL

Especifique o protocolo do destino. Se você não especificar esta opção, o protocolo de destino será herdado do protocolo de origem. Valores aceitos: TCP, TLS

--dest-type TYPE

Especifique onde o recurso de destino é executado: no IBM Cloud (cloud) ou no seu endereço Satellite (location). Opções disponíveis: location, cloud

--idle-timeout-seconds SECONDS

Especifique o intervalo de tempo limite em segundos para conexões ativas com o destino. Certifique-se de que seu tempo limite seja compatível com o serviço de destino e as configurações do protocolo keep-alive.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

Forneça um nome para o terminal.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--sni SNI

Especifique o indicador de nome do servidor, caso você defina um protocolo de origem tls ou https e deseje que um nome de host separado seja adicionado ao handshake TLS.

--source-protocol PROTOCOL

Forneça o protocolo que a origem usa para conectar o recurso de destino. Veja http://ibm.biz/endpoint-protocols. Opções disponíveis: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Exemplos

Criar um terminal.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.

-f

Force o comando a ser executado sem prompts do usuário.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Desativar um ponto de extremidade.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.

-f

Force o comando a ser executado sem prompts do usuário.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Habilite um ponto de extremidade.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os detalhes de um terminal.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todos os terminais em um local do Satellite.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Excluir um terminal.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-hostname HOSTNAME

Indique o nome completo do domínio (FQDN) ou o endereço IP acessível externamente do destino ao qual deseja se conectar. Para pontos de extremidad cloud, esse valor deve corresponder a um endereço IP público ou a um endereço IP privado acessível dentro de IBM Cloud, como um ponto de extremidade de serviço em nuvem privada. Para endpoints do location, esse valor deve ser resolvido a partir dos hosts do plano de controle e estar acessível a partir deles para locais do Satellite ou onde o agente é executado para o Satellite Connector.

--dest-port PORT

Forneça a porta na qual o recurso de destino atende às solicitações recebidas. Certifique-se de que a porta corresponda ao protocolo de destino.

--dest-protocol PROTOCOL

Especifique o protocolo do destino. Se você não especificar esta opção, o protocolo de destino será herdado do protocolo de origem. Valores aceitos: TCP, TLS

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls (--connector-id ID | --location LOCATION)``.

--idle-timeout-seconds SECONDS

Especifique o intervalo de tempo limite em segundos para conexões ativas com o destino. Certifique-se de que seu tempo limite seja compatível com o serviço de destino e as configurações do protocolo keep-alive.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

Forneça um novo nome para o terminal.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--sni SNI

Especifique o indicador de nome do servidor, caso você defina um protocolo de origem tls ou https e deseje que um nome de host separado seja adicionado ao handshake TLS.

--source-protocol PROTOCOL

Forneça o protocolo que a origem usa para conectar o recurso de destino. Veja http://ibm.biz/endpoint-protocols. Valores aceitos: TCP, TLS, HTTP, HTTPS, HTTP-tunnel

Exemplos

Atualize um terminal.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser ativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

O nome da ACL.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Crie uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser ativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Adicione um ou mais pontos de extremidade habilitados a uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Lista todos os pontos de extremidade habilitados para uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Um nome ou ID de um ponto de extremidade a ser desativado para essa ACL.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover um ou mais pontos de extremidade habilitados de uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualizar os detalhes de uma ACL.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todas as ACLs de um conector ou local do Satellite.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Excluir uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Adicione uma ou mais sub-redes a uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subnet SUBNET

Um bloco IP ou CIDR permitido por essa ACL. O valor deve estar totalmente contido nos seguintes CIDRs: 10.0.0.0/8, 161.26.0.0/16, 166.8.0.0/14, 172.16.0.0/12.

Exemplos

Remover uma ou mais sub-redes de uma ACL.

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

Opções de comando

--acl-id ID

Especifique o ID da ACL. Para listar todas as ACLs, execute ibmcloud sat acl ls.

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--name NAME

O novo nome da ACL.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Atualizar o nome de uma ACL.

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

Opções de comando

--platform PLATFORM

A plataforma para o Satellite Connector Agent. Para obter mais informações sobre o Docker, consulte a documentação em https://ibm.biz/satconagent Opções disponíveis: windows, docker

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obtenha um Agente de Conector do Satellite para uma plataforma específica.

ibmcloud sat experimental agent attach --platform PLATFORM -q

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todos os agentes de um conector do Satellite.

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

Opções de comando

--name NAME

O nome para o conector do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--region REGION

A região da IBM Cloud para gerenciar seu conector do Satellite.

Exemplos

Crie um conector do Satellite.

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

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os detalhes de um conector do Satellite.

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

Opções de comando

--after AFTER

Mostrar Satellite após o cursor fornecido.

--first FIRST

Visualize os próximos Satellite, até o primeiro número de conectores.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os conectores do Satellite na sua conta do IBM Cloud.

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

Opções de comando

--connector-id ID

O ID de um conector do Satellite.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Exclua um conector do Satellite.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obter as configurações de autenticação de um ponto de extremidade.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do servidor de destino. Por exemplo, myCA.pem.

--dest-cert-file FILE

O certificado do cliente utilizado para autenticação no servidor de destino. Por exemplo, myCert.pem.

--dest-key-file FILE

A chave privada do cliente usada para criptografar o certificado de cliente Por exemplo, myKey.pem.

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--source-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do cliente de origem quando source-tls-mode é mútuo. Por exemplo, myCA.pem.

--source-cert-file FILE

O certificado do servidor para apresentar ao cliente de origem. Por exemplo, myCert.pem.

--source-key-file FILE

A chave privada do servidor usada para criptografar o certificado do servidor Por exemplo, myKey.pem.

Exemplos

Substituir os certificados de autenticação existentes por novos.

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

Opções de comando

--connector-id ID

O ID do conector Satellite. Para localizar o ID do conector executar ibmcloud sat connector ls.

--dest-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do servidor de destino. Por exemplo, myCA.pem.

--dest-cert-file FILE

O certificado do cliente utilizado para autenticação no servidor de destino. Por exemplo, myCert.pem.

--dest-key-file FILE

A chave privada do cliente usada para criptografar o certificado de cliente Por exemplo, myKey.pem.

--dest-tls-mode MODE

O destino TLS mode. Valores aceitos:simple,mutual,none

--endpoint ENDPOINT

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute o comando ibmcloud sat endpoint ls``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--source-ca-cert-file FILE

Certificado ou cadeia de CA confiável usado para validar o certificado do cliente de origem quando source-tls-mode é mútuo. Por exemplo, myCA.pem.

--source-cert-file FILE

O certificado do servidor para apresentar ao cliente de origem. Por exemplo, myCert.pem.

--source-key-file FILE

A chave privada do servidor usada para criptografar o certificado do servidor Por exemplo, myKey.pem.

--source-tls-mode MODE

A fonte: TLS. Valores aceitos: simple, mutual

Exemplos

Definir configurações de autenticação para um ponto de extremidade.

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

Opções de comando

--description DESCRIPTION

Insira uma nova descrição para o local “ Satellite ”. O tamanho da descrição é limitado a 400 bytes.

--location-id ID

O ID do local “ Satellite ”. Para encontrar o ID do local, acesse ibmcloud sat location ls.

--name NAME

Especifique um novo nome para o local “ Satellite ”. Os nomes de locais devem começar com uma letra, podem conter letras, números, pontos (.) e hífens (-), e devem ter menos de 36 caracteres. Não reutilize nomes, inclusive nomes de locais excluídos.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Atualizar o nome ou a descrição de um local Satellite.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especificar o nome ou o ID do cluster. Para listar os clusters registrados, execute ibmcloud sat cluster ls.

--group GROUP, -g GROUP

Especifique o nome ou ID de um grupo de clusters do Satellite. Para listar grupos de clusters disponíveis, execute ibmcloud sat group ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Inclua um cluster em seu grupo de clusters.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o nome ou ID do cluster para incluir no grupo de clusters. Para listar os clusters registrados, execute ibmcloud sat cluster ls.

--name NAME

Forneça um nome do grupo de clusters do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Crie um grupo de clusters.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especificar o nome ou o ID do cluster. Para listar os clusters do seu grupo de clusters, execute o comando ibmcloud sat group get --group <cluster_group_name_or_ID>``.

-f

Force o comando a ser executado sem prompts do usuário.

--group GROUP, -g GROUP

Especifique o nome ou ID de um grupo de clusters do Satellite. Para listar grupos de clusters disponíveis, execute ibmcloud sat group ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remove um ou mais clusters do seu grupo de clusters Satellite e exclui os recursos Kubernetes que eram gerenciados por ele.

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

Opções de comando

--group GROUP, -g GROUP

Especifique o nome ou ID de um grupo de clusters do Satellite. Para listar os clusters registrados, execute ibmcloud sat cluster ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obter informações detalhadas para um grupo de clusters do Satellite.

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

Opções de comando

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todos os grupos de clusters do Satellite em sua conta da IBM Cloud.

ibmcloud sat group ls --output json -q

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

--group GROUP, -g GROUP

Especifique o nome ou ID de um grupo de clusters do Satellite. Para listar grupos de clusters disponíveis, execute ibmcloud sat group ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover um grupo de clusters do Satellite, o que cancela a inscrição dos clusters e exclui os recursos Kubernetes que eram gerenciados por ele.

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

Opções de comando

--cluster CLUSTER

O nome ou ID do cluster ao qual designar o host. Para listar os clusters disponíveis, execute o comando ibmcloud sat cluster ls``. Se nenhum cluster for fornecido, o host será designado automaticamente para o plano de controle do Satellite.

--host HOST

O nome ou o ID do host a ser designado. Para designar hosts automaticamente com base nos rótulos, não inclua essa opção. Para recuperar o ID do host, execute ibmcloud sat host ls --location <location_ID_or_name>.

--host-label LABEL, --hl LABEL

Insira quaisquer rótulos como pares chave-valor para identificar o host a ser atribuído ao seu plano de controle do Satellite ou ao seu cluster do Red Hat OpenShift. O primeiro host que tem esse rótulo e é não designado é automaticamente designado ao cluster ou plano de controle. Para encontrar rótulos de host disponíveis, execute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--worker-pool POOL, -p POOL

O nome ou ID do conjunto de trabalhadores dentro do cluster para o qual designar o host. Se nenhum conjunto de trabalhadores for especificado, o host será designado ao conjunto de trabalhadores padrão.

--zone ZONE

O nome ou ID da zona para a qual designar o host. Para encontrar as zonas disponíveis, acesse ibmcloud sat location get --location <location_name_or_ID> e procure o campo “ Host Zones ”.

Exemplos

Designe um host a um cluster ou plano de controle do local do Satellite.

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

Opções de comando

--host-label LABEL, --hl LABEL

Insira quaisquer rótulos como pares chave-valor para identificar o host a ser atribuído ao seu plano de controle do Satellite ou ao seu cluster do Red Hat OpenShift. O primeiro host que tem esse rótulo e é não designado é automaticamente designado ao cluster ou plano de controle. Para encontrar rótulos de host disponíveis, execute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.

--host-link-agent-endpoint ENDPOINT

O terminal usado pelo agente de link para se conectar ao servidor de túnel de link.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--operating-system SYSTEM

O sistema operacional dos hosts que você deseja anexar ao seu local. Para conectar hosts RHCOS, seu local deve ser ativado por RHCOS. Valores aceitos: RHEL, RHCOS

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--reset-key

Redefina a chave que o plano de controle usa para conectar e atribuir hosts no local. Consulte https://ibm.biz/reset-key.

Exemplos

Crie e faça o download de um script que possa ser executado em seus hosts para anexá-los ao seu local.

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

Opções de comando

--host HOST

O ID do host do Satellite. Para descobrir o ID do host, execute o comando ibmcloud sat host ls <location_ID_or_name>``.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os detalhes de um host do Satellite.

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

Opções de comando

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar todos os hosts vinculados a um local do Satellite, incluindo os hosts atribuídos a clusters ou ao painel de controle.

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

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

--host HOST

O nome ou ID do host a ser removido.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover um host de um local do Satellite.

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

Opções de comando

--host HOST

O nome ou o ID do host a ser designado. Para designar hosts automaticamente com base nos rótulos, não inclua essa opção.

--host-label LABEL, --hl LABEL

Insira quaisquer rótulos como pares chave-valor para identificar o host a ser atribuído ao seu plano de controle do Satellite ou ao seu cluster do Red Hat OpenShift. O primeiro host que tem esse rótulo e é não designado é automaticamente designado ao cluster ou plano de controle. Para encontrar rótulos de host disponíveis, execute ibmcloud sat host get --host <host_name_or_ID> --location <location_name_or_ID>.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--zone ZONE

O nome ou ID da zona para associar ao host. Não é possível mudar a zona dos hosts designados a um recurso, como um cluster. Deve-se remover sua designação primeiro. Para listar as zonas disponíveis, execute o comando ibmcloud sat location get --location ``.

Exemplos

Atualize as informações do host, como zonas e rótulos.

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

Opções de comando

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todas as chaves da configuração Satellite em sua conta IBM Cloud.

ibmcloud sat key ls --output json -q

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

--key KEY

O nome ou ID de uma chave do Satellite Config.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover uma chave de configuração Satellite.

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

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

--name NAME

O nome da nova chave de configuração Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Gere uma nova chave para uso dos clusters gerenciados para conectar a configuração Satellite.

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

Opções de comando

--capability CAPABILITY

Um recurso disponível na unidade de negócios “ Satellite ”.

--coreos-enabled

Ative os recursos do Red Hat CoreOS para o local do Satellite. Essa ação não pode ser desfeita Consulte https://ibm.biz/infra-os.

--cos-bucket BUCKET

Especifique o nome do bucket do IBM Cloud Object Storage para armazenar os dados do plano de controle do local do Satellite. Caso contrário, um novo depósito será criado para você.

--description DESCRIPTION

Insira uma descrição para o local do Satellite.

--ha-zone ZONE

Especifique a zona para o seu local. Para garantir alta disponibilidade, especifique três zonas para a sua localização, como --ha-zone ZONE1_NAME --ha-zone ZONE2_NAME --ha-zone ZONE3_NAME. Os nomes das zonas devem corresponder exatamente aos nomes das zonas correspondentes em seu provedor de infraestrutura no qual você planeja criar hosts.

--managed-from REGION

Selecione a região da IBM Cloud da qual gerenciar seu local do Satellite. Escolha uma região próxima ao seu data center no local para obter o melhor desempenho. Consulte https://ibm.biz/sat-region..

--name NAME

Especifique um nome para o local do Satellite. Os nomes de locais devem começar com uma letra, podem conter letras, números, pontos (.) e hífens (-), e devem ter menos de 36 caracteres. Não reutilize os nomes, mesmo que o outro local seja excluído.

--physical-address ADDRESS

O endereço físico da localização do Satellite.

--pod-network-interface-selection SELECTION

O método para seleção da interface de rede de nó para a rede de pod interno. Essa opção só pode ser usada se você também ativar Red Hat CoreOS com a opção --coreos-enabled. Para fornecer um endereço IP ou URL direto, especifique can-reach=<url> ou can-reach=<ip_address>. Para escolher uma interface, especifique interface=<network_interface>.

--pod-subnet SUBNET

Especifique um CIDR de sub-rede customizado para fornecer endereços IP privados para pods. Essa opção é usada apenas se você ativar Red Hat CoreOS com a opção --coreos-enabled. A sub-rede deve ter o tamanho de /23 ou mais. Consulte https://ibm.biz/sat-location-create Valor padrão: '172.16.0.0/16

--provider PROVIDER

Indique o provedor de infraestrutura para usar para o local do Satellite. Se você incluir essa opção, também deverá incluir a opção --provider-credential. Valores aceitos: aws, azure, gcp, vmware

--provider-credential CREDENTIAL

Especifique o caminho para um arquivo JSON em sua máquina local que tenha as credenciais do provedor de infraestrutura para o local do Satellite. O formato da credencial é específico para o provedor. Consulte http://ibm.biz/sat-infra-creds..

--provider-region REGION

Especifique a região no provedor de infraestrutura no qual você planeja criar os hosts para o local do Satellite. Se você incluir essa opção, também deverá incluir a opção --provider.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--service-subnet SUBNET

Especifique um CIDR de sub-rede customizado para fornecer endereços IP privados para serviços. Essa opção é usada apenas se você ativar Red Hat CoreOS com a opção --coreos-enabled. A sub-rede deve ter o tamanho de /24 ou mais. Consulte https://ibm.biz/sat-location-create Valor-padrão: 172.20.0.0/16

Exemplos

Crie um local do Satellite.

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

Opções de comando

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subdomain SUBDOMAIN

Especifique o nome do subdomínio. Para listar os subdomínios existentes, execute ibmcloud sat location dns ls --location <ID>.

Exemplos

Visualize os detalhes de um subdomínio registrado em um local Satellite.

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

Opções de comando

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste os subdomínios registrados em um local do Satellite.

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

Opções de comando

--ip IP

Especifique o endereço IP de cada host do plano de controle, no formato --ip x.x.x.1 --ip x.x.x.2 --ip x.x.x.3. Para clusters de várias zonas, use um endereço IP de cada zona. Para encontrar o endereço IP, acesse ibmcloud sat host ls --location <location_ID_or_name> e procure por Worker IP para os hosts identificados como infrastructure.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Configure um subdomínio para os hosts designados ao plano de controle em um local do Satellite.

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

Opções de comando

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize os detalhes de um local do Satellite.

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

Opções de comando

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todos os locais do Satellite em sua conta do IBM Cloud.

ibmcloud sat location ls --output json -q

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Exclua um local.

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

Opções de comando

--description DESCRIPTION

Insira uma nova descrição para o local “ Satellite ”. O tamanho da descrição é limitado a 400 bytes.

--location-id ID

O ID do local “ Satellite ”. Para encontrar o ID do local, acesse ibmcloud sat location ls.

--name NAME

Especifique um novo nome para o local “ Satellite ”. Os nomes de locais devem começar com uma letra, podem conter letras, números, pontos (.) e hífens (-), e devem ter menos de 36 caracteres. Não reutilize nomes, inclusive nomes de locais excluídos.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Atualizar o nome ou a descrição de um local Satellite.

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

Opções de comando

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Visualize as mensagens atuais do usuário.

ibmcloud sat messages -q

Opções de comando

--history HISTORY

O ID do histórico para o recurso.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--resource RESOURCE

Especifique o ID de recurso do Kubernetes. Para encontrar recursos d Kubernetes, acesse ibmcloud sat resource ls.

--save-data

Faça download e salve uma definição de recurso do Kubernetes em um arquivo temporário.

Exemplos

Visualize os detalhes de um recurso do Kubernetes gerenciado por uma configuração do Satellite.

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

Opções de comando

--limit LIMIT

Especifique o número máximo de entradas de histórico a serem retornadas.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--resource RESOURCE

O ID do recurso do Kubernetes.

Exemplos

Obter histórico para um recurso do Kubernetes.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o nome ou ID do cluster registrado no qual o recurso Kubernetes é executado. Para localizar clusters registrados, acesse ibmcloud sat cluster ls.

--limit LIMIT

Especifique o número máximo de entradas de recurso para a procura retornar.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--search SEARCH

Indique a sequência para filtrar resultados da procura de recursos do Kubernetes, como um nome de pod ou namespace.

--subscription SUBSCRIPTION

Especifique o ID ou nome da assinatura do Satellite. Para localizar assinaturas, execute o comando ibmcloud sat cluster ls``.

Exemplos

Procure os recursos do Kubernetes que são gerenciados pelo Satellite.

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

Opções de comando

--location LOCATION

O nome ou ID do local do Satellite. Para descobrir o ID ou o nome do local, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todos os clusters de serviço do Satellite em seu local para revisar detalhes, como recursos do host solicitado.

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

Opções de comando

--all

Desativar correções automáticas para todas as designações de armazenamento do Satellite de uma configuração de armazenamento.

--assignment ASSIGNMENT

O ID de uma designação de armazenamento do Satellite. Para listar as atribuições de armazenamento disponíveis da configuração, execute o comando ibmcloud sat storage assignment ls --config CONFIG``.

--config CONFIG

O nome ou ID de uma configuração de armazenamento do Satellite. Para listar configurações de armazenamento disponíveis, execute ibmcloud sat storage config ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Desativar as correções automáticas para uma atribuição de armazenamento do tipo “ Satellite ”.

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

Opções de comando

--all

Ative as correções automáticas para todas as designações de armazenamento do Satellite de uma configuração de armazenamento

--assignment ASSIGNMENT

O ID de uma designação de armazenamento do Satellite. Para listar as atribuições de armazenamento disponíveis da configuração, execute o comando ibmcloud sat storage assignment ls --config CONFIG``.

--config CONFIG

O nome ou ID de uma configuração de armazenamento do Satellite. Para listar configurações de armazenamento disponíveis, execute ibmcloud sat storage config ls.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Ativar patches automáticos para uma atribuição de armazenamento do tipo “ Satellite ”.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o ID do cluster do Satellite para a designação. Para encontrar o ID do cluster, execute ibmcloud oc cluster ls --provider satellite.

--config CONFIG

Especifique a configuração de armazenamento Satellite para a designação. para localizar configurações, execute ibmcloud sat storage config ls..

--group GROUP, -g GROUP

Especifique os grupos de cluster para a designação. Para localizar grupos de clusters, execute o comando ibmcloud sat group ls``.

--name NAME

Forneça um nome para a designação de armazenamento do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--service-cluster-id CLUSTER

Especifique o ID do cluster de serviço para a designação. Para descobrir o ID do cluster de serviços, execute o comando ibmcloud sat service ls --location ``.

Exemplos

Crie uma designação para implementar suas configurações de armazenamento nos clusters na localização do Satellite.

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

Opções de comando

--assignment ASSIGNMENT

Especifique o ID de uma designação de armazenamento do Satellite.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obtenha os detalhes de uma designação de armazenamento do Satellite.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o ID do cluster do Satellite para as designações. Para obter o ID do cluster, execute o comando ibmcloud oc cluster ls --provider satellite``.

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar configurações de armazenamento disponíveis, execute ibmcloud sat storage config ls.

--location LOCATION

Especifique o nome de um local do Satellite. Para listar os locais disponíveis, execute o comando ibmcloud sat location ls``. Esta opção não pode ser usada pelo administrador de serviço.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--service-cluster-id CLUSTER

Especifique o ID do cluster de serviço para as designações. Para descobrir o ID do cluster de serviços, execute o comando ibmcloud sat service ls --location ``.

Exemplos

Liste as designações de armazenamento do Satellite em sua conta da IBM Cloud.

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

Opções de comando

--assignment ASSIGNMENT

Especifique o ID de uma designação de armazenamento do Satellite. Para listar as atribuições disponíveis, execute o comando ibmcloud sat storage assignment ls``.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Aplique as alterações de configuração de armazenamento para as designações associadas

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

Opções de comando

--assignment ASSIGNMENT

Especifique o ID de uma designação de armazenamento do Satellite. Para encontrar tarefas, acesse ibmcloud sat storage assignment ls.

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remova uma designação de armazenamento do Satellite.

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

Opções de comando

--assignment ASSIGNMENT

Especifique o ID de uma designação de armazenamento do Satellite.

-f

Force o comando a ser executado sem prompts do usuário.

--group GROUP, -g GROUP

Especifique os novos grupos de clusters para a designação. Para listar os grupos disponíveis, execute o comando ibmcloud sat group ls``.

--name NAME

Forneça um novo nome para a designação de armazenamento do Satellite.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Atualize uma designação de armazenamento do Satellite.

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

Opções de comando

--config-name NAME

Especifique o nome da configuração de armazenamento para a classe de armazenamento customizada. Para listar as configurações de armazenamen Satellite, execute o comando ibmcloud sat storage config ls``.

--name NAME

Forneça um nome para a classe de armazenamento customizada.

--param PARAM, -p PARAM

Especifique um par “ key=value ” para os parâmetros da classe de armazenamento. Para visualizar os parâmetros da classe de armazenamento em um modelo de armazenamento, execute ibmcloud sat storage template get``.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Crie uma classe de armazenamento customizada do Satellite.

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

Opções de comando

--class CLASS

Especifique o nome de uma classe de armazenamento do Satellite.

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar as configurações de armazenamen Satellite, execute o comando ibmcloud sat storage config ls``.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obter os detalhes de uma classe de armazenamento do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar as configurações de armazenamen Satellite, execute o comando ibmcloud sat storage config ls``.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--show-params

Inclua esta opção para listar todos os detalhes do parâmetro de classe de armazenamento.

Exemplos

Liste as classes de armazenamento em uma configuração de armazenamento do tipo “ Satellite ”.

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

Opções de comando

--location LOCATION

Insira o ID ou nome do local para a configuração de armazenamento. Para encontrar locais disponíveis, acesse ibmcloud sat location ls.

--name NAME

Especifique o nome da configuração de armazenamento.

--param PARAM, -p PARAM

Especifique um par de valores “ key=value ” para os parâmetros de configuração. Para visualizar os parâmetros de configuração de um modelo de armazenamento, execute o comando ibmcloud sat storage template get``.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--template-name NAME

Especifique o nome do modelo de configuração de armazenamento do Satellite. Para listar os modelos de configuração de armazenamento disponíveis, execute o comando ibmcloud sat storage template ls``.

--template-version VERSION

Especifique a versão do modelo de configuração de armazenamento do Satellite. Se você não incluir essa opção, a versão padrão será usada. Para listar os modelos de configuração de armazenamento disponíveis, execute o comando ibmcloud sat storage template ls``.

Exemplos

Criar uma configuração de armazenamento do Satellite para instalar drivers de armazenamento em seus clusters.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat storage config ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Obter os detalhes de uma configuração de armazenamento do Satellite.

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

Opções de comando

--location LOCATION

Especifique o ID ou nome do local que contém as configurações que deseja listar. Para encontrar locais disponíveis, acesse ibmcloud sat location ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Listar as configurações de armazenamento do Satellite em sua conta da IBM Cloud.

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

Opções de comando

--apply

Aplique a versão de configuração de armazenamento Satellite mais recente em todas as designações de uma configuração. Para listar as atribuições de uma configuração, execute o comando ibmcloud sat storage assignment ls --config CONFIG``.

--config CONFIG

Especifique o nome ou ID da configuração de armazenamento. Para listar as configurações de armazenamen Satellite, execute o comando ibmcloud sat storage config ls``.

-f

Force o comando a ser executado sem prompts do usuário.

--param PARAM, -p PARAM

Especifique um par de valores “ key=value ” para os parâmetros de configuração. Para visualizar os parâmetros de configuração de um modelo de armazenamento, execute o comando ibmcloud sat storage template get``.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Defina os parâmetros de configuração e segredo de uma configuração de armazenamento do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat storage config ls.

-f

Force o comando a ser executado sem prompts do usuário.

--include-assignments

Inclua esta opção para atualizar as atribuições da configuração de armazenamento para a versão mais recente da configuração.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Aplique as atualizações de patch mais recentes a uma configuração de armazenamento do Satellite.

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

Opções de comando

--config CONFIG

Especifique o nome ou ID de uma configuração de armazenamento do Satellite. Para listar as configurações disponíveis, execute ibmcloud sat storage config ls.

-f

Force o comando a ser executado sem prompts do usuário.

--include-assignments

Inclua essa opção para remover a configuração de armazenamento e quaisquer designações associadas.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Remover uma configuração de armazenamento do Satellite.

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

Opções de comando

--name NAME

Especifique o nome do modelo de armazenamento. Para listar os modelos de armazenamento disponíveis, execute o comando ibmcloud sat storage template ls``.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--version VERSION

Especifique a versão do modelo de armazenamento. Para listar os modelos de armazenamento disponíveis, execute o comando ibmcloud sat storage template ls``.

Exemplos

Veja os detalhes de um modelo de armazenamento do Satellite.

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

Opções de comando

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste os modelos de armazenamento disponíveis do Satellite.

ibmcloud sat storage template ls -q

Opções de comando

--auth-required

Forneça o segredo de autenticação necessário para conectar ao repositório remoto. Consulte https://ibm.biz/sat-config-private-repo para obter detalhes. Estratégia: GitOps.

--config CONFIG

Especifique o nome da configuração para usar para a assinatura. Para verificar as configurações disponíveis, acesse ibmcloud sat config ls.

--gitref GITREF

Especifique o GitRef para usar para a assinatura do Satellite. Estratégia: GitOps.

--gitref-type TYPE

Indique o tipo de GitRef a ser usado para a assinatura do Satellite. Estratégia: GitOps. Valores permitidos: branch, commit, tag, release

--group GROUP, -g GROUP

Especifique o nome ou ID dos grupos de clusters para assinar sua configuração. Para encontrar os grupos de clusters disponíveis, execute o comando ibmcloud sat group ls``.

--name NAME

Insira um nome para a assinatura.

--path PATH

Forneça o caminho para os arquivos de repositório ou ativos de liberação no repositório remoto a serem usados para a assinatura do Satellite. Estratégia: GitOps.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--repository REPOSITORY

Especifique a URL do repositório remoto a ser usado para a assinatura. Estratégia: GitOps.

--version VERSION

Indique o nome ou ID da versão de configuração existente para usar para a assinatura. Para encontrar as versões, acesse ibmcloud sat config get --config <configuration_name_or_ID>. Estratégia: upload direto.

Exemplos

Crie uma assinatura do Satellite para clusters.

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

Opções de comando

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subscription SUBSCRIPTION

Digite o nome ou o ID de uma assinatura do Satellite. Para localizar assinaturas, execute o comando ibmcloud sat subscription ls``.

Exemplos

Obtenha informações detalhadas para uma assinatura do Satellite.

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

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subscription SUBSCRIPTION

Especifique o nome ou ID de uma assinatura do Satellite. Para listar as assinaturas, execute o comando ibmcloud sat subscription ls``.

Exemplos

Atualize a assinatura do Satellite para usar sua identidade na gestão de recursos.

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

Opções de comando

--cluster CLUSTER, -c CLUSTER

Especifique o nome do cluster ou ID do Satellite. Para localizar clusters registrados, acesse ibmcloud sat cluster ls.

--output OUTPUT

Imprime a saída de comando no formato fornecido. Valores aceitos: json

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

Exemplos

Liste todas as assinaturas do Satellite em sua conta do IBM Cloud.

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

Opções de comando

-f

Force o comando a ser executado sem prompts do usuário.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--subscription SUBSCRIPTION

Forneça o nome ou ID de uma assinatura do Satellite. Para listar as assinaturas, execute o comando ibmcloud sat subscription ls``.

Exemplos

Remova uma assinatura do Satellite.

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

Opções de comando

--auth-required

Forneça o segredo de autenticação necessário para conectar ao repositório remoto. Estratégia: GitOps.

-f

Force o comando a ser executado sem prompts do usuário.

--gitref GITREF

Especifique o GitRef para usar para a assinatura do Satellite. Estratégia: GitOps.

--gitref-type TYPE

Indique o tipo de GitRef a ser usado para esta assinatura do Satellite. Estratégia: GitOps. Valores permitidos: branch, commit, tag, release

--group GROUP, -g GROUP

Especifique os novos grupos de clusters para assinar sua configuração.

--name NAME

Forneça um novo nome da assinatura do Satellite.

--path PATH

Indique o caminho para os arquivos de repositório ou ativos de liberação no repositório remoto a ser usado para a assinatura do Satellite. Estratégia: GitOps.

-q

Não mostrar a mensagem do dia ou os lembretes de atualização.

--repository REPOSITORY

Forneça a URL do repositório remoto para usar para a assinatura do Satellite. Estratégia: GitOps.

--subscription SUBSCRIPTION

Especifique o nome ou ID de uma assinatura do Satellite. Para listar as assinaturas, execute o comando ibmcloud sat subscription ls``.

--version VERSION

Indique a versão de configuração existente a ser usada para a assinatura do Satellite. Estratégia: upload direto.

Exemplos

Atualize uma assinatura do Satellite.

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