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

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 com o console Google Cloud . Depois, confira a carga de trabalho no console Google Cloud 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 console do Google Cloud , clique em Orientação:

Orientações


Antes de começar

Siga estas etapas para ativar a API do Kubernetes Engine:
  1. Acesse a página do Kubernetes Engine no console do 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 o projeto do Google Cloud .

Funções exigidas

Verifique se você tem os seguintes papéis no projeto: Administrador do Compute, Administrador do Kubernetes Engine, Usuário da conta de serviço

Verificar os papéis

  1. No console do Google Cloud , 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 o 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 console do Google Cloud , 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. No console do Google Cloud , acesse a página Criar um cluster do Autopilot do GKE.

    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 amostra 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. No console do Google Cloud , acesse a página Detalhes da implantação de hello-world-app:

    1. No console Google Cloud , 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ê quiser 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