Criar um cluster e implantar uma carga de trabalho no Google Cloud console

Um cluster do Kubernetes fornece serviços de computação, armazenamento, rede e outros serviços para aplicativos, semelhante a um data center virtual. Os apps e os serviços associados que são executados no Kubernetes são chamados de cargas de trabalho.

Neste tutorial, você vai conferir rapidamente um cluster do Google Kubernetes Engine em execução e uma carga de trabalho de exemplo configurados usando o Google Cloud console. Depois, vai conferir a carga de trabalho no Google Cloud console antes de seguir para nosso programa de aprendizado mais aprofundado ou começar a planejar e criar seu próprio cluster pronto para produção.

Se você preferir configurar o cluster e a carga de trabalho de exemplo usando o Terraform, consulte Criar um cluster com o Terraform.

Para seguir as instruções detalhadas desta tarefa diretamente no Google Cloud console, clique em Orientação:

Orientações

Antes de começar

Siga estas etapas para ativar a API Kubernetes Engine:
  1. Acesse a página do Kubernetes Engine noconsole. Google Cloud
  2. Crie ou selecione um projeto.
  3. Aguarde a ativação da API e dos serviços relacionados. Isso pode levar alguns minutos.

  4. Verifique se o faturamento está ativado para seu Google Cloud projeto.

Funções exigidas

Verifique se você tem as seguintes funções no projeto: Administrador de computação, Administrador do Kubernetes Engine, Usuário da conta de serviço

Verificar os papéis

  1. No Google Cloud console, acesse a página IAM.

    Acessar IAM
  2. Selecione o projeto.

  3. Na coluna Principal, encontre todas as linhas que identificam você ou um grupo no qual você está incluído. Para saber em quais grupos você está incluído, entre em contato com seu administrador.

  4. Em todas as linhas que especificam ou incluem você, verifique a coluna Papel para ver se a lista de papéis inclui os papéis necessários.

Conceder os papéis

  1. No Google Cloud console, acesse a página IAM.

    Acessar IAM
  2. Selecione o projeto.
  3. Clique em Conceder acesso.

  4. No campo Novos principais, digite seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

  5. Clique em Selecionar um papel e pesquise o papel.
  6. Para conceder outros papéis, adicione-os clicando em Adicionar outro papel.
  7. Clique em Salvar.

Criar um cluster no modo Autopilot do GKE

No modo Autopilot, o Google gerencia a configuração do cluster, incluindo escalonamento, segurança e outras configurações pré-configuradas. Os clusters no modo Autopilot são otimizados para executar a maioria das cargas de trabalho de produção e provisionar recursos de computação com base nos seus manifestos do Kubernetes.

  1. Noconsole, acesse a página Criar um cluster do Autopilot do GKE. Google Cloud

    Acessar "Criar um cluster do Autopilot"

  2. Em Princípios básicos do cluster, faça o seguinte:

    1. No campo Nome, digite este nome:

      hello-world-cluster

    2. Mantenha os valores padrão para o restante das configurações e clique em Criar para começar a criar o cluster.

  3. Quando você for redirecionado para a página Clusters do Kubernetes, poderá acompanhar o progresso do cluster enquanto ele está sendo configurado, implantado e verificado.

  4. Aguarde até ver uma marca de seleção ao lado do título da página hello-world-cluster.

Implantar um app de exemplo no cluster

Implante um app da Web "hello world" de amostra fornecido pelo Google e armazenado como um contêiner no Artifact Registry.

  1. No console Google Cloud , acesse a página Cargas de trabalho do GKE.

    Acesse "Cargas de trabalho"

  2. Clique em Implantar.

  3. Em Nome da implantação, insira o nome a seguir: 

    hello-world-app

  4. No Cluster do Kubernetes, selecione hello-world-cluster.

  5. Clique em Próxima: Detalhes do contêiner.

  6. Deixe Imagem de contêiner atual selecionada e, em Caminho da imagem, insira o seguinte caminho:

    us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

    Este aplicativo "hello world" simples é empacotado em um único contêiner, mas os aplicativos maiores normalmente consistem em vários contêineres relacionados que podem ser implantados juntos e executados como uma única carga de trabalho.

  7. Clique em Próxima: Expor (opcional).

  8. Na seção Expor, crie um serviço do Kubernetes de balanceamento de carga para direcionar solicitações externas ao aplicativo:

    1. Selecione Expor a implantação como um novo serviço.

    2. Deixe a Porta 1 definida como 80.

    3. Em Porta de destino 1, digite 8080.

    4. Clique em Implantar.

    O GKE atribui automaticamente um endereço IP externo disponível ao serviço.

    Esse serviço é considerado parte da carga de trabalho hello-world-app.

  9. Para clusters do Autopilot, é possível que você veja uma mensagem de erro, como Does not have minimum availability. Isso ocorre porque o Autopilot exclui e recria os nós. Aguarde alguns minutos e clique em Atualizar para atualizar a página.

  10. Aguarde a conclusão da implantação e a página Detalhes da implantação.

Ver uma demonstração ao vivo no navegador

  1. Noconsole, acesse a página Detalhes da implantação de hello-world-app: Google Cloud

    1. No Google Cloud console, acesse a página Cargas de trabalho do GKE.

      Acesse "Cargas de trabalho"

    2. Na coluna Nome, clique no nome da carga de trabalho implantada, hello-world-app.

  2. Na coluna Endpoints, clique no endereço IP, que está disponível publicamente.

    O GKE abre uma nova guia do navegador e envia uma solicitação ao aplicativo. Dispense os avisos de site seguro. Você vai encontrar a mensagem Hello, world! na nova guia do navegador.

    Se o Endpoints estiver vazio, sua organização pode ter uma política que impede o acesso externo.

Você criou um cluster do GKE no modo Autopilot e implantou uma carga de trabalho de amostra.

Fazer uma limpeza para evitar cobranças

Se você planeja fazer outros tutoriais ou explorar mais o exemplo, aguarde até concluir tudo para realizar a etapa de limpeza. É possível continuar usando o cluster de amostra do Kubernetes na maioria dos tutoriais do GKE.

Se você criou um projeto para saber mais sobre o GKE e não precisa mais dele, exclua o projeto.

Se você usou um projeto que já existe, do GKE exclua os recursos criados para evitar cobranças na sua conta:

  1. Acessar a página de Clusters do GKE.

    Acessar Clusters

  2. Selecione a linha que contém hello-world-cluster e clique em Excluir.

  3. Na janela Excluir hello-world-cluster, faça o seguinte:

    1. No campo hello-world-cluster, insira hello-world-cluster.

    2. Clique em Excluir.

    Se você receber uma mensagem de erro sobre o cluster que está sendo reparado, poderá aguardar a conclusão do processo e, em seguida, excluí-lo. Essa operação pode levar algum tempo para ser concluída.

  4. Se você criou um coletor e um bucket de registros ao seguir as instruções em outros tutoriais:

    1. Acesse a página Armazenamento de registros do Cloud Logging.

      Acessar o armazenamento de registros

    2. Selecione hello-world-cluster-bucket e clique em Excluir.

    3. Acesse a página Roteador de registros do Logging.

      Acessar o roteador de registros

    4. Selecione hello-world-cluster-sink e clique em Excluir.

A seguir