Os comandos em anthos-gke aws management
implantam e excluem o GKE nos serviços de gerenciamento da AWS. Use os comandos init
e apply
para provisionar um serviço de gerenciamento.
Use o comando get-credentials
para se autenticar no serviço de gerenciamento e use o comando delete
para desinstalar o GKE no ambiente da AWS. Use o comando diagnose
para coletar informações adicionais para depuração.
Init
O comando anthos-aws init
faz o seguinte:
- Prepara um diretório de trabalho que contém um arquivo
anthos-gke.yaml
. - Valida a configuração. Durante a validação,
init
verifica se o arquivoanthos-gke.yaml
contém todos os campos obrigatórios, se o usuário tem permissões suficientes e recursos referenciados, como AWS KMS{. 101}há chaves. - Cria ou anexa informações de status a
anthos-gke-status.yaml
.Esse arquivo inclui um ID de cluster gerado, uma chave pública SSH, chaves de conta de serviço do Google Cloud criptografadas e um certificado CA de Kubernetes criptografado.
Execute anthos-gke init
antes de anthos-gke apply
.
anthos-gke aws management init DIRECTORY
Argumentos posicionais
DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. Assume o padrão do diretório atual.
Exemplos
Para inicializar o diretório de trabalho atual, execute o seguinte comando:
anthos-gke aws management init
Para inicializar um diretório específico, execute o seguinte comando:
anthos-gke aws management init DIRECTORY
Substitua DIRECTORY pelo diretório que contém seu arquivo anthos-gke.yaml
.
Aplicar
O comando apply
provisiona um serviço de gerenciamento na AWS. O comando também cria um bucket do Cloud Storage que o GKE na AWS usa para o estado do Terraform.
anthos-gke aws management apply DIRECTORY
Argumentos posicionais
DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. Assume o padrão do diretório atual.
Exemplos
Para criar um serviço de gerenciamento a partir da configuração no diretório de trabalho atual, execute o seguinte comando:
$ anthos-gke aws management apply
Para criar um serviço de gerenciamento a partir da configuração em um diretório específico (~/example/workspace
, por exemplo), execute o seguinte comando:
$ anthos-gke aws management apply DIRECTORY
Substitua DIRECTORY pelo diretório que contém o anthos-gke.yaml
.
Receba as credenciais .
O comando get-credentials
atualiza o arquivo kubeconfig
com credenciais e informações de endpoint para seu serviço de gerenciamento. Por padrão, as credenciais são anexadas a ~/.kube/config
. É possível definir um caminho diferente para o kubeconfig definindo a variável de ambiente KUBECONFIG
.
anthos-gke aws management get-credentials [--workspace DIRECTORY]
Sinalizações
--workspace DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. Assume o padrão do diretório atual.
Exemplos
Para receber credenciais de um serviço de gerenciamento definido no diretório de trabalho atual, execute o comando a seguir:
anthos-gke aws management get-credentials
Para receber as credenciais de um serviço de gerenciamento definido em um diretório específico, execute o seguinte comando:
anthos-gke aws management get-credentials --workspace DIRECTORY
Substitua DIRECTORY pelo diretório que contém o anthos-gke.yaml
.
Diagnóstico
O comando diagnose snapshot
gera um pacote de suporte para ajudar o Google a solucionar problemas de depuração no serviço de gerenciamento. O pacote de suporte é um arquivo .tar que inclui configuração, eventos do cluster e registros. Para mais informações, consulte
Solução de problemas.
anthos-gke aws management diagnose snapshot
--ssh-key-path PATH \
[--bastion-ip IP] \
[--bastion-ssh-key-path PATH] \
[--cluster-ssh-key-path PATH] \
[--dry-run] \
[--mgmt-service-ssh-key-path PATH] \
[--nodepool-ssh-key-path PATH] \
[--output PATH] \
[--snapshot-config PATH] \
[--workspace DIRECTORY] \
[--quiet]
Sinalizações
--ssh-key-path PATH
- Um argumento obrigatório que fornece o caminho para um arquivo de chave SSH. Para a maioria dos usuários, esse valor precisa ser
~/.ssh/anthos-gke
.
Sinalizações opcionais
[--bastion-ip IP]
- Especifica um endereço IP do Bastion Host.
[--bastion-ssh-key-path PATH]
- O caminho para um arquivo de chave SSH para o Bastion Host. O padrão é
--ssh-key-path
. [--cluster-ssh-key-path PATH]
- O caminho para um arquivo de chave SSH para as máquinas do plano de controle do cluster de carga de trabalho.
O padrão é
--ssh-key-path
. [--dry-run]
- Uma opção para exibir o arquivo de configuração do snapshot sem gerar um pacote de suporte.
[--mgmt-service-ssh-key-path PATH]
- O caminho para um arquivo de chave SSH para o serviço de gerenciamento. O padrão é
--ssh-key-path
. [--nodepool-ssh-key-path PATH]
- O caminho para um arquivo de chave SSH para máquinas com pool de nós. O padrão é
--ssh-key-path
. [--snapshot-config PATH]
- O caminho para um arquivo de configuração de snapshot YAML (opcional).
[--output PATH]
- O caminho em que
anthos-gke
cria o arquivo do pacote de suporte. --workspace DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. Assume o padrão do diretório atual. [--quiet]
- Elimine as mensagens impressas no console.
Exemplos
Para gerar um pacote de suporte para um serviço de gerenciamento definido no diretório ~/example/workspace
, execute o seguinte comando:
anthos-gke aws management diagnose snapshot \
--ssh-key-path ~/.ssh/anthos-gke \
--workspace ~/example/workspace
Para ver a configuração de snapshot padrão, execute o seguinte comando:
anthos-gke aws management diagnose snapshot \
--ssh-key-path ~/.ssh/anthos-gke \
--dry-run
Para especificar um arquivo de configuração de snapshot personalizado (incluindo seus próprios comandos bash e kubectl), execute o seguinte comando:
anthos-gke aws management diagnose snapshot \
--ssh-key-path ~/.ssh/anthos-gke
--snapshot-config ~/my-snapshot-config.yaml
Excluir
O comando anthos-gke aws management delete
exclui um cluster de gerenciamento.
anthos-gke aws management delete DIRECTORY
Sinalizações opcionais
[--force]
- Força a exclusão do serviço de gerenciamento, mesmo que o usuário não possa se conectar a ele. .
Argumentos posicionais
DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. Assume o padrão do diretório atual.
Exemplos
Para excluir o serviço de gerenciamento definido no diretório de trabalho atual, execute o comando abaixo:
anthos-gke aws management delete
Para excluir o eerviço de gerenciamento definido em um diretório específico, execute o seguinte comando:
anthos-gke aws management delete ~/example/workspace