Os comandos em anthos-gke aws management
deploy e delete do 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 autenticar seu serviço de gerenciamento e o comando delete
para desinstalar seu ambiente do GKE na AWS. Você pode usar o comando diagnose
para coletar informações adicionais para depuração.
Inicialização
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 possui permissões suficientes e se os recursos referenciados, como chaves do AWS KMS, existem. - Cria ou anexa informações de status a
anthos-gke-status.yaml
. Este arquivo inclui um ID de cluster gerado, uma chave pública SSH, criptografadaGoogle Cloud chaves de conta de serviço e um certificado de CA do 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
. O padrão é o 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
. O padrão é o 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 seu anthos-gke.yaml
.
Obter credenciais
O comando get-credentials
atualiza seu arquivo kubeconfig
com credenciais e informações de endpoint para o seu serviço de gerenciamento. Por padrão, as credenciais são anexadas a ~/.kube/config
. Você pode definir um caminho diferente para o seu kubeconfig definindo a variável de ambiente KUBECONFIG
.
anthos-gke aws management get-credentials [--workspace DIRECTORY]
Bandeiras
-
--workspace DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. O padrão é o diretório atual.
Exemplos
Para obter credenciais para um serviço de gerenciamento definido no diretório de trabalho atual, execute o seguinte comando:
anthos-gke aws management get-credentials
Para obter credenciais para 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 seu anthos-gke.yaml
.
Diagnosticar
O comando diagnose snapshot
gera um pacote de suporte para ajudar o Google a depurar problemas com seu serviço de gerenciamento. O pacote de suporte é um arquivo tar que inclui configuração, eventos de cluster e logs. Para obter 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]
Bandeiras
-
--ssh-key-path PATH
- Um argumento obrigatório que fornece o caminho para um arquivo de chave SSH. Para a maioria dos usuários, este valor deve ser
~/.ssh/anthos-gke
.
Bandeiras opcionais
-
[--bastion-ip IP ]
- Especifica um endereço IP de host bastião .
-
[--bastion-ssh-key-path PATH ]
- O caminho para um arquivo de chave SSH para o host bastion. 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 instantâneo 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 de pool de nós. O padrão é
--ssh-key-path
. -
[--snapshot-config PATH ]
- O caminho para um arquivo de configuração de instantâneo YAML (opcional).
-
[--output PATH ]
- O caminho onde
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
. O padrão é o diretório atual. -
[--quiet]
- Elimine 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 visualizar a configuração de instantâneo 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 instantâneo 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
Bandeiras opcionais
-
[--force]
- Força a exclusão do serviço de gerenciamento mesmo que o usuário não consiga se conectar a ele.
Argumentos posicionais
-
DIRECTORY
- Um argumento opcional para o diretório que contém o arquivo
anthos-gke.yaml
. O padrão é o diretório atual.
Exemplos
Para excluir o serviço de gerenciamento definido no diretório de trabalho atual, execute o seguinte comando:
anthos-gke aws management delete
Para excluir o serviço de gerenciamento definido em um diretório específico, execute o seguinte comando:
anthos-gke aws management delete ~/example/workspace