Guia de início rápido: implantar no Cloud Run for Anthos

Saiba como criar um cluster ativado para o Cloud Run for Anthos e a implantar um contêiner de amostra pré-criado nesse cluster.

Se você tiver uma conta de demonstração, siga este guia de início rápido no Google Cloud Skills Boost.

Antes de começar

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  2. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  3. Para garantir que você tenha a versão mais recente da Google Cloud CLI, instale ou atualize a Google Cloud CLI:

Como configurar o ambiente de linha de comando e ativar as APIs necessárias

Conclua as etapas a seguir para configurar o ambiente de linha de comando para o Cloud Run for Anthos e ativar as APIs necessárias:

  1. Configure a Google Cloud CLI para usar o ID do projeto do Google Cloud por padrão:

    gcloud config set project PROJECT-ID

    Substitua PROJECT-ID pelo ID do projeto.

  2. Defina a zona em que você quer que o novo cluster seja implantado. É possível usar qualquer zona compatível com o GKE. Por exemplo:

    gcloud config set compute/zone ZONE

    Substitua ZONE pela zona desejada.

  3. Execute o comando gcloud services para ativar as APIs a seguir no projeto do Google Cloud:

    • API Google Kubernetes Engine: criar clusters do GKE
    • API Cloud Build: criar contêineres
    • API Container Registry: publicar contêineres no Container Registry
    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

    O processo pode levar vários segundos para ser concluído. Quando as APIs forem ativadas, a linha de comando exibirá uma mensagem semelhante a esta:

    Operation "operations/..." finished successfully.

Como criar um cluster do GKE com o Cloud Run for Anthos ativado

Conclua as etapas a seguir para criar um cluster e ativá-lo no Cloud Run for Anthos:

  1. Crie um cluster novo usando o comando:

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=e2-standard-4 \
      --num-nodes=4 \
      --enable-stackdriver-kubernetes

    Substitua CLUSTER_NAME pelo nome do cluster.

  2. Aguarde a conclusão da criação do cluster. Durante o processo de criação, você verá mensagens semelhantes a estas:

    Creating cluster my-cluster...done.
    Created [https://container.googleapis.com/v1beta1/ \
    projects/my-project/zones/us-central1-b/clusters/my-cluster].
    

    em que my-project é o ID do projeto do Google Cloud e my-cluster é o cluster que você acabou de criar.

  3. Defina os padrões da gcloud dos recursos do Cloud Run for Anthos para o nome do novo cluster e o local dele. Você define esses padrões para evitar especificar esses valores sempre que usar a Google Cloud CLI.

    gcloud config set run/platform gke
    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location ZONE

    Substitua CLUSTER_NAME e ZONE pelos mesmos valores usados para criar o novo cluster.

Como implantar um contêiner de amostra

Use o console do Google Cloud para implantar um contêiner de amostra e criar um serviço no cluster:

  1. No console do Google Cloud, acesse a página do Cloud Run for Anthos.

    Acessar o Cloud Run for Anthos

  2. Abra o formulário Criar serviço clicando em Criar serviço:

  3. No menu suspenso de clusters disponíveis, selecione o cluster que você acabou de criar.

  4. Deixe default inserido como o nome do namespace.

  5. Insira um nome do serviço, como hello.

  6. Clique em Next.

  7. Selecione Implantar uma revisão de uma imagem de contêiner existente e, em seguida, selecione hello na lista suspensa de contêineres de demonstração.

  8. Clique em Next.

  9. Selecione Externo em Conectividade para invocar o serviço.

  10. Clique em Criar para implantar a imagem no Cloud Run for Anthos e aguarde a conclusão da implantação.

Parabéns! Você acabou de implantar um serviço em um cluster ativado do Cloud Run for Anthos.

Como acessar o serviço implantado

Agora que o serviço está em execução, é possível enviar solicitações para ele. Nesta seção, o cURL é usado para demonstrar como acessar o serviço e verificar se ele está funcionando:

  1. No console do Google Cloud, acesse a página do Cloud Run for Anthos.

    Acessar o Cloud Run for Anthos

  2. Clique no nome do novo serviço do Cloud Run for Anthos para acessar a página Detalhes do serviço.

  3. Clique em info , à direita do URL do serviço.

  4. Clique em Invocar no Cloud Shell para executar o comando cURL gerado para o serviço no Cloud Shell.

A solicitação cURL retorna o código-fonte do contêiner de amostra em que o serviço está em execução. Agora você já sabe que seu serviço está processando solicitações.

Limpeza

É possível desativar o Cloud Run for Anthos ou excluir o cluster e o serviço do Cloud Run for Anthos para evitar cobranças relacionadas à execução desses recursos.

Como desativar o Cloud Run for Anthos

Para desativar o Cloud Run for Anthos e manter o cluster:

  1. No console do Google Cloud, acesse a página do Google Kubernetes Engine.

    Acessar o Google Kubernetes Engine

  2. Clique no cluster em que você quer desativar o Cloud Run for Anthos.

  3. Clique em Editar.

  4. Role para baixo até Recursos do Anthos e, na lista suspensa Cloud Run para Anthos, selecione Desativar.

  5. Clique em Salvar.

Como excluir o Cloud Run for Anthos

Para excluir permanentemente o cluster do GKE, incluindo o serviço do Cloud Run for Anthos e todos os recursos dele:

  1. No console do Google Cloud, acesse a página do Google Kubernetes Engine.

    Acessar o Google Kubernetes Engine

  2. Selecione o cluster que você quer excluir.

  3. Clique em Excluir e selecione Excluir novamente no pop-up.

A seguir

Para saber como criar um contêiner a partir do código-fonte, enviar para o Container Registry e, em seguida, implantar, consulte:

Para uma visão geral da arquitetura do Cloud Run for Anthos que abrange as alterações na instalação do Cloud Run for Anthos como um complemento no cluster do Google Kubernetes Engine, consulte: