Opções de comando

--connector-id

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

--endpoint

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

--location

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

--name

O nome da ACL.

-q

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

--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

Criar uma ACL

ibmcloud sat acl create --name NAME --subnet SUBNET --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--endpoint

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

--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

Adicionar um ou mais terminais habilitados a uma ACL

ibmcloud sat acl endpoint add --acl-id ID --endpoint ENDPOINT --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat acl endpoint help

Opções de comando

--acl-id

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

--connector-id

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

--location

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

--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 pontos de extremidade ativados para uma ACL

ibmcloud sat acl endpoint ls --acl-id ID --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--endpoint

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

--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 terminais habilitados de uma ACL

ibmcloud sat acl endpoint rm --acl-id ID --endpoint ENDPOINT --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--location

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

--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 --acl-id ID --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat acl help

Opções de comando

--connector-id

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

--location

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

--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 --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--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 --acl-id ID --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--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

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

Adicionar uma ou mais sub-redes a uma ACL

ibmcloud sat acl subnet add --acl-id ID --subnet SUBNET --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat acl subnet help

Opções de comando

--acl-id

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

--connector-id

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

--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

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 --acl-id ID --subnet SUBNET --connector-id ID

Opções de comando

--acl-id

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

--connector-id

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

--location

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

--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 --acl-id ID --name NAME --connector-id ID

Opções de comando

--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

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

ibmcloud sat agent attach --platform PLATFORM

Exemplos

Mostrar ajuda

ibmcloud sat agent help

Opções de comando

--connector-id

O ID de um conector do Satellite.

--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 ID

Opções de comando

-c, --cluster

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

--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 um cluster registrado

ibmcloud sat cluster get --cluster CLUSTER

Exemplos

Mostrar ajuda

ibmcloud sat cluster help

Opções de comando

--filter

Filtrar clusters registrados por ID do cluster.

--limit

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

--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 clusters registrados na sua conta do IBM Cloud

ibmcloud sat cluster ls

Opções de comando

--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 --name NAME

Opções de comando

-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 o registro de um cluster

ibmcloud sat cluster unregister --cluster CLUSTER

Opções de comando

--data-location

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

--name

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

--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 nas cargas de trabalho do Satellite

ibmcloud sat config create --name NAME --data-location LOCATION

Opções de comando

--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

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 detalhes de uma configuração do Satellite, como as versões ou assinaturas associadas à configuração

ibmcloud sat config get --config CONFIG

Exemplos

Mostrar ajuda

ibmcloud sat config help

Opções de comando

--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 ” na sua conta do IBM Cloud

ibmcloud sat config ls

Opções de comando

--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

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

Opções de comando

--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

Opções de comando

--config

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

--description

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

--file-format

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

--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

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

Exemplos

Crie 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 \
  --config CONFIG \
  --file-format FORMAT \
  --name NAME \
  --read-config CONFIG

Opções de comando

--config

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

--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

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 sobre uma versão de configuração do Satellite

ibmcloud sat config version get --config CONFIG --version VERSION

Exemplos

Mostrar ajuda

ibmcloud sat config version help

Opções de comando

--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

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

Opções de comando

--name

O nome para o conector do Satellite.

-q

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

--region

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

Exemplos

Criar um conector do Satellite

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

Opções de comando

--connector-id

O ID de um conector do Satellite.

--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 um conector do Satellite

ibmcloud sat connector get --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat connector help

Opções de comando

--after

Mostrar Satellite após o cursor fornecido.

--first

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

--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 em sua conta do IBM Cloud

ibmcloud sat connector ls

Opções de comando

--connector-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

Excluir um conector do Satellite

ibmcloud sat connector rm --connector-id ID

Opções de comando

--connector-id

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

--endpoint

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

--location

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

--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 endpoint

ibmcloud sat endpoint authn get --endpoint ENDPOINT --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat endpoint authn help

Opções de comando

--connector-id

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

--dest-ca-cert-file

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

--dest-cert-file

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

--dest-key-file

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

--endpoint

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

--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

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

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

--source-key-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 --endpoint ENDPOINT --connector-id ID

Opções de comando

--connector-id

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

--dest-ca-cert-file

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

--dest-cert-file

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

--dest-key-file

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

--dest-tls-mode

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

--endpoint

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

--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

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

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

--source-key-file

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

--source-tls-mode

A fonte: TLS. Valores aceitos: simple, mutual

Exemplos

Definir configurações de autenticação para um endpoint

ibmcloud sat endpoint authn set --endpoint ENDPOINT --connector-id ID

Opções de comando

--connector-id

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

--dest-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 em 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 os locais do Satellite ou onde o agente é executado para o Satellite Connector.

--dest-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

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

Especifique onde o recurso de destino é executado: na nuvem “ IBM Cloud ” (cloud) ou em seu próprio ambiente “ Satellite ” (location). Opções disponíveis: localização, nuvem

--idle-timeout-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

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

--name

Forneça um nome para o terminal.

--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

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

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 \
  --dest-hostname HOSTNAME \
  --dest-port PORT \
  --dest-type TYPE \
  --name NAME \
  --source-protocol PROTOCOL \
  --connector-id ID

Opções de comando

--connector-id

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

--endpoint

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

-f

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

--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 terminal

ibmcloud sat endpoint disable --endpoint ENDPOINT --connector-id ID

Opções de comando

--connector-id

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

--endpoint

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

-f

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

--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

Ativar um endpoint

ibmcloud sat endpoint enable --endpoint ENDPOINT --connector-id ID

Opções de comando

--connector-id

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

--endpoint

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute ibmcloud sat endpoint ls (--connector-id ID | --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

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 um endpoint

ibmcloud sat endpoint get --endpoint ENDPOINT --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat endpoint help

Opções de comando

--connector-id

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

--location

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

--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 endpoints em um local do Satellite

ibmcloud sat endpoint ls --connector-id ID

Opções de comando

--connector-id

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

--endpoint

Especifique o nome ou ID do terminal. Para listar todos os endpoints, execute ibmcloud sat endpoint ls (--connector-id ID | --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 endpoint

ibmcloud sat endpoint rm --endpoint ENDPOINT --connector-id ID

Opções de comando

--connector-id

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

--dest-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 em 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 os locais do Satellite ou onde o agente é executado para o Satellite Connector.

--dest-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

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

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

--idle-timeout-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

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

--name

Forneça um novo nome para o terminal.

-q

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

--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

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

Atualizar um endpoint

ibmcloud sat endpoint update --endpoint ENDPOINT --connector-id ID

Exemplos

Mostrar ajuda

ibmcloud sat experimental endpoint help

Exemplos

Mostrar ajuda

ibmcloud sat experimental help

Opções de comando

-c, --cluster

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

-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

Adicione um cluster ao seu grupo de clusters

ibmcloud sat group attach --cluster CLUSTER --group GROUP

Opções de comando

-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

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

Criar um grupo de clusters

ibmcloud sat group create --name NAME

Opções de comando

-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.

-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 do Satellite e exclui os recursos Kubernetes que eram gerenciados pelas assinaturas do grupo

ibmcloud sat group detach --cluster CLUSTER --group GROUP

Opções de comando

-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

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 sobre um grupo de clusters do Satellite

ibmcloud sat group get --group GROUP

Exemplos

Mostrar ajuda

ibmcloud sat group help

Opções de comando

--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 cluster do Satellite na sua conta do IBM Cloud

ibmcloud sat group ls

Opções de comando

-f

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

-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 as assinaturas dos clusters e exclui os recursos do Kubernetes que eram gerenciados pelas assinaturas do grupo

ibmcloud sat group rm --group GROUP

Opções de comando

--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

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, --hl

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

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

-p, --worker-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.

-q

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

--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

Atribuir um host a um plano de controle de localização ou cluster do Satellite

ibmcloud sat host assign --location LOCATION

Opções de comando

--host-label, --hl

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

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

--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

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 baixe um script que você possa executar em seus hosts para associá-los ao seu local

ibmcloud sat host attach --location LOCATION

Opções de comando

--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

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

--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 um host do Satellite

ibmcloud sat host get --host HOST --location LOCATION

Exemplos

Mostrar ajuda

ibmcloud sat host help

Opções de comando

--location

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

--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 plano de controle

ibmcloud sat host ls --location LOCATION

Opções de comando

-f

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

--host

O nome ou ID do host a ser removido.

--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 --host HOST --location LOCATION

Opções de comando

--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, --hl

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

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

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

Atualizar informações do host, como zonas e rótulos

ibmcloud sat host update --host HOST --location LOCATION

Exemplos

Mostrar ajuda

ibmcloud sat key help

Opções de comando

--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 de configuração do Satellite em sua conta IBM Cloud

ibmcloud sat key ls

Opções de comando

-f

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

--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 do tipo “ Satellite ”

ibmcloud sat key rm --key KEY

Opções de comando

-f

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

--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

Gerar uma nova chave para que os clusters gerenciados se conectem à configuração d Satellite

ibmcloud sat key rotate --name NAME

Opções de comando

--capability

Um recurso da 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

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

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

--ha-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

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. Veja https://ibm.biz/sat-region.

--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

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

--pod-network-interface-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

Especifique um CIDR de sub-rede customizado para fornecer endereços IP privados para pods. Essa opção é usada apenas se você ativar o recurso “ 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

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

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

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

Especifique um CIDR de sub-rede customizado para fornecer endereços IP privados para serviços. Essa opção é usada apenas se você ativar o recurso “ 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

Criar uma localização do Satellite

ibmcloud sat location create --managed-from REGION --name NAME

Opções de comando

--location

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

--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

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

Exemplos

Visualizar os detalhes de um subdomínio registrado em um endereço Satellite

ibmcloud sat location dns get --location LOCATION --subdomain SUBDOMAIN

Exemplos

Mostrar ajuda

ibmcloud sat location dns help

Opções de comando

--location

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

--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 os subdomínios registrados em um endereço Satellite

ibmcloud sat location dns ls --location LOCATION

Opções de comando

--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

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

--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

Defina um subdomínio para os hosts atribuídos ao plano de controle em um local Satellite

ibmcloud sat location dns register --ip IP --location LOCATION

Opções de comando

--location

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

--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

Veja os detalhes de uma unidade da Satellite

ibmcloud sat location get --location LOCATION

Exemplos

Mostrar ajuda

ibmcloud sat location help

Opções de comando

--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 lojas da Satellite na sua conta do IBM Cloud

ibmcloud sat location ls

Opções de comando

-f

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

--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 local

ibmcloud sat location rm --location LOCATION

Opções de comando

--description

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

--location-id

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

--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 do Satellite

ibmcloud sat location update --location-id ID

Opções de comando

-q

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

Exemplos

Visualizar as mensagens do usuário atual

ibmcloud sat messages

Opções de comando

--history

O ID do histórico para o recurso.

--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

Especifique o ID de recurso do Kubernetes. Para encontrar recursos sobre o “ 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

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

ibmcloud sat resource get --resource RESOURCE

Exemplos

Mostrar ajuda

ibmcloud sat resource help

Opções de comando

--limit

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

--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

O ID do recurso do Kubernetes.

Exemplos

Obter o histórico de um recurso do Kubernetes

ibmcloud sat resource history get --resource RESOURCE

Exemplos

Mostrar ajuda

ibmcloud sat resource history help

Opções de comando

-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

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

--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

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

--subscription

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

Exemplos

Pesquise recursos do Kubernetes gerenciados por Satellite

ibmcloud sat resource ls --cluster CLUSTER

Exemplos

Mostrar ajuda

ibmcloud sat service help

Opções de comando

--location

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

--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 sua localidade para analisar detalhes, como os recursos de host solicitados

ibmcloud sat service ls --location LOCATION

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

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

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 correções automáticas para uma atribuição de armazenamento do Satellite

ibmcloud sat storage assignment autopatch disable --config CONFIG --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

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

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 Satellite

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

Exemplos

Mostrar ajuda

ibmcloud sat storage assignment autopatch help

Opções de comando

-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

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

-g, --group

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

--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

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

Exemplos

Crie uma tarefa para implantar suas configurações de armazenamento nos clusters do seu local do Satellite

ibmcloud sat storage assignment create --config CONFIG --cluster CLUSTER

Opções de comando

--assignment

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

--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

Veja os detalhes de uma atribuição de armazenamento do Satellite

ibmcloud sat storage assignment get --assignment ASSIGNMENT

Exemplos

Mostrar ajuda

ibmcloud sat storage assignment help

Opções de comando

-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

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

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

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

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

Exemplos

Liste as alocações de armazenamento do Satellite na sua conta do IBM Cloud

ibmcloud sat storage assignment ls --cluster CLUSTER

Opções de comando

--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

Aplicar as alterações na configuração de armazenamento às atribuições associadas

ibmcloud sat storage assignment patch --assignment ASSIGNMENT

Opções de comando

--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

Remover uma atribuição de armazenamento do Satellite

ibmcloud sat storage assignment rm --assignment ASSIGNMENT

Opções de comando

--assignment

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

-f

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

-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

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

Atualizar uma atribuição de armazenamento do Satellite

ibmcloud sat storage assignment update --assignment ASSIGNMENT

Opções de comando

--config-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

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

-p, --param

Especifique um par de valores “ 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 o comando ibmcloud sat storage template get``.

-q

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

Exemplos

Criar uma classe de armazenamento personalizada do tipo “ Satellite ”

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

Opções de comando

--class

Especifique o nome de uma classe de armazenamento do Satellite.

--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

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 tipo “ Satellite ”

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

Exemplos

Mostrar ajuda

ibmcloud sat storage config class help

Opções de comando

--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

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

Listar as classes de armazenamento em uma configuração de armazenamento do Satellite

ibmcloud sat storage config class ls --config CONFIG

Opções de comando

--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

Especifique o nome da configuração de armazenamento.

-p, --param

Especifique um par “ 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

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

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

Crie uma configuração de armazenamento do tipo “ Satellite ” para instalar drivers de armazenamento em seus clusters

ibmcloud sat storage config create --location LOCATION --name NAME --template-name NAME

Opções de comando

--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

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

Exemplos

Mostrar ajuda

ibmcloud sat storage config help

Opções de comando

--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

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 as configurações de armazenamento do Satellite na sua conta IBM Cloud

ibmcloud sat storage config ls

Exemplos

Mostrar ajuda

ibmcloud sat storage config param help

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

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.

-p, --param

Especifique um par “ 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

Definir os parâmetros de configuração e os parâmetros secretos de uma configuração de armazenamento do Satellite

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

Opções de comando

--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

Opções de comando

--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

Exemplos

Mostrar ajuda

ibmcloud sat storage help

Opções de comando

--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

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

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

Obtenha os detalhes de um modelo de armazenamento do Satellite

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

Exemplos

Mostrar ajuda

ibmcloud sat storage template help

Opções de comando

-q

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

Exemplos

Listar os modelos de armazenamento disponíveis no Satellite

ibmcloud sat storage template ls

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

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

-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``.

--gitref

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

--gitref-type

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

--name

Insira um nome para a assinatura.

--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

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

--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

Criar uma assinatura do Satellite para clusters

ibmcloud sat subscription create \
  --config CONFIG \
  --group GROUP \
  --name NAME \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY

Opções de comando

--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

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 sobre a assinatura do Satellite

ibmcloud sat subscription get --subscription SUBSCRIPTION

Exemplos

Mostrar ajuda

ibmcloud sat subscription help

Exemplos

Mostrar ajuda

ibmcloud sat subscription identity help

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

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 no gerenciamento de recursos

ibmcloud sat subscription identity set --subscription SUBSCRIPTION

Opções de comando

-c, --cluster

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

--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 assinaturas do Satellite na sua conta do IBM Cloud

ibmcloud sat subscription ls

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

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

Exemplos

Cancelar uma assinatura do “ Satellite ”

ibmcloud sat subscription rm --subscription SUBSCRIPTION

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.

-g, --group

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

--gitref

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

--gitref-type

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

--name

Forneça um novo nome da assinatura do Satellite.

--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

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

--subscription

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

--version

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

Exemplos

Atualizar uma assinatura do “ Satellite ”

ibmcloud sat subscription update \
  --subscription SUBSCRIPTION \
  --auth-required \
  --gitref GITREF \
  --gitref-type TYPE \
  --path PATH \
  --repository REPOSITORY