O produto descrito nesta documentação, os clusters do Anthos na AWS (geração anterior), agora está no modo de manutenção. Todas as novas instalações precisam usar o produto de geração atual Clusters do Anthos na AWS.
Para se conectar ao GKE nos recursos da AWS, execute as etapas a
seguir. Selecione se você tem uma VPC atual da AWS (ou conexão direta com a VPC) ou criou uma VPC dedicada ao criar seu serviço de gerenciamento.
VPC atual
Se você tiver uma conexão direta ou VPN com uma VPC atual, omita a linha env HTTP_PROXY=http://localhost:8118 dos comandos neste tópico.
VPC dedicada
Quando você cria um serviço de gerenciamento em uma VPC dedicada, o GKE na AWS inclui um bastion host em uma sub-rede pública.
Para se conectar ao serviço de gerenciamento, siga estas etapas:
Para abrir o túnel, execute o script bastion-tunnel.sh. O túnel encaminha
para localhost:8118.
Para abrir um túnel para o Bastion Host, execute o seguinte comando:
./bastion-tunnel.sh-N
As mensagens do túnel SSH aparecem nessa janela. Quando estiver pronto para fechar a conexão, interrompa o processo usando Control+C ou fechando a janela.
Abra um novo terminal e mude para o diretório anthos-aws.
cd anthos-aws
Verifique se você consegue se conectar ao cluster com kubectl.
A saída inclui o URL do servidor da API de serviço de gerenciamento.
Os comandos nas seções a seguir presumem que você está usando esse Bastion Host.
Se você não estiver usando o Bastion Host, remova as linhas que contêm HTTP_PROXY.
Como se conectar ao serviço de gerenciamento com o kubectl
Para se conectar ao seu serviço de gerenciamento com a ferramenta kubectl,
execute as seguintes etapas:
No diretório anthos-aws, use
anthos-gke para alternar o contexto para o serviço de gerenciamento.
cd anthos-aws
anthos-gke aws management get-credentials
Como se conectar aos clusters com o kubectl
Para se conectar aos clusters de usuários com a ferramenta kubectl,
execute as seguintes etapas:
No diretório anthos-aws, use
anthos-gke para alternar o contexto para o cluster de usuário.
cd anthos-aws
env HTTPS_PROXY=http://localhost:8118 \
anthos-gke aws clusters get-credentials CLUSTER_NAME
Substitua CLUSTER_NAME pelo nome do cluster de usuários.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-14 UTC."],[],[],null,["# Connecting to your cluster with kubectl\n\nBefore you begin\n----------------\n\n\nBefore you start using GKE on AWS, make sure you have performed the following tasks:\n\n- Complete the [Prerequisites](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/prerequisites).\n\n\u003c!-- --\u003e\n\n- Install a [management service](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/installing-management).\n- Create a [user cluster](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/creating-user-cluster).\n\nThe bastion host\n----------------\n\nTo connect to your GKE on AWS resources, perform the following\nsteps. Select if you have an existing AWS VPC (or direct connection to\nyour VPC) or created a dedicated VPC when creating your management service. \n\n### Existing VPC\n\nIf you have a direct or VPN connection to an existing VPC, omit the line\n`env HTTP_PROXY=http://localhost:8118` from commands in this topic.\n\n### Dedicated VPC\n\nWhen you create a management service in a dedicated VPC,\nGKE on AWS includes a\n[bastion](https://en.wikipedia.org/wiki/Bastion_host) host in a\npublic subnet.\n| **Important:** If you restart your terminal session or the SSH connection is lost, you need to re-launch the `bastion-tunnel.sh` script.\n\nTo connect to your management service, perform the following steps:\n\n1. Change to the directory with your GKE on AWS configuration.\n You created this directory when\n [Installing the management service](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/installing-management).\n\n ```sh\n cd anthos-aws\n ```\n\n \u003cbr /\u003e\n\n2. To open the tunnel, run the `bastion-tunnel.sh` script. The tunnel forwards\n to `localhost:8118`.\n\n To open a tunnel to the bastion host, run the following command: \n\n ./bastion-tunnel.sh -N\n\n Messages from the SSH tunnel appear in this window. When you are ready to\n close the connection, stop the process by using \u003ckbd\u003eControl+C\u003c/kbd\u003e or\n closing the window.\n3. Open a new terminal and change into your `anthos-aws` directory.\n\n ```sh\n cd anthos-aws\n ```\n4. Check that you're able to connect to the cluster with `kubectl`.\n\n env HTTPS_PROXY=http://localhost:8118 \\\n kubectl cluster-info\n\n The output includes the URL for the management service API server.\n\nThe commands in the following sections assume you are using this bastion host.\nIf you are not using the bastion host, remove the lines containing `HTTP_PROXY`.\n\nConnecting to your management service with kubectl\n--------------------------------------------------\n\nTo connect to your management service with the `kubectl` tool, perform the\nfollowing steps:\n\nFrom your `anthos-aws` directory, use\n`anthos-gke` to switch context to your management service.\n\n```sh\ncd anthos-aws\nanthos-gke aws management get-credentials\n```\n| **Note:** `anthos-gke` uses the credentials you specified when you ran `aws configure`.\n\n\u003cbr /\u003e\n\nConnecting to your user clusters with kubectl\n---------------------------------------------\n\nTo connect to your user clusters with the `kubectl` tool, perform the\nfollowing steps:\n\nFrom your `anthos-aws` directory, use\n`anthos-gke` to switch context to your user cluster.\n\n```sh\ncd anthos-aws\nenv HTTPS_PROXY=http://localhost:8118 \\\n anthos-gke aws clusters get-credentials CLUSTER_NAME\n```\nReplace \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e with your user cluster name.\n\n\u003cbr /\u003e"]]
