Conectar a partir do Cloud Run

Conectar a partir do Cloud Run

Esta página orienta você no processo de implantação de um aplicativo de exemplo em um serviço do Cloud Run usando o console do Google Cloud e um aplicativo cliente. Este aplicativo de exemplo conecta o Cloud Run ao AlloyDB para PostgreSQL.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Ative as APIs do Cloud necessárias para executar um aplicativo de exemplo do AlloyDB para PostgreSQL no Cloud Run.

   Ativar as APIs

   1. Na etapa Confirmar projeto, para confirmar o nome do projeto em que você vai fazer mudanças, clique em Próxima.

   2. Na etapa Ativar APIs, clique em Ativar para ativar o seguinte:

      • API AlloyDB
      • API Cloud Run Admin
      • API Compute Engine
      • API Cloud Build
      • API Container Registry
      • API Service Networking
      • API Cloud Resource Manager

Criar um cluster e a instância principal

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

   Acessar Clusters

2. Clique em Criar cluster.

   O console do Google Cloud oferece vários tipos de clusters. Selecione Alta disponibilidade.

3. Clique em Continuar.

   A seção Configurar o cluster é aberta.

4. Em Informações básicas, no campo ID do cluster, insira my-cluster.

5. No campo Senha, digite qualquer senha. Anote essa senha. Você vai usá-lo novamente mais tarde neste guia.

6. No campo Região, selecione us-central1 (Iowa).

7. Em Rede, selecione default.

   Se você ainda não tiver configurado o acesso a serviços particulares, uma caixa de diálogo com a mensagem Conexão de acesso a serviços particulares exigida vai aparecer.

   Na caixa de diálogo Conexão de acesso a serviços particulares necessária, para criar uma conexão de acesso a serviços particulares, faça o seguinte:

   1. Clique em Configurar conexão.

      Um novo painel chamado Ativar a API Service Networking vai aparecer.

   2. No painel, selecione Usar um intervalo de IP alocado automaticamente.

   3. Clique em Continuar.

   4. Clique em Criar conexão e aguarde a conclusão da configuração.

      O painel é removido.

8. Clique em Continuar.

   A seção Configurar a instância principal é aberta.

9. Em Informações básicas, no campo ID da instância, insira my-primary.

10. Para um valor Máquina, selecione 2 vCPU, 16 GB.

11. Clique em Criar cluster.

    Aguarde a criação do cluster.

Conectar-se à instância e criar um banco de dados

1. Se você não estiver na página Visão geral do cluster recém-criado, acesse a página Clusters no console do Google Cloud.

   Acessar Clusters

2. Para mostrar a página Visão geral do cluster, clique no nome do cluster my-cluster.

3. No menu de navegação, clique em AlloyDB Studio.

4. Na lista Banco de dados da página Fazer login no AlloyDB Studio, selecione postgres.

5. Na lista suspensa Usuário, selecione postgres.

6. No campo Senha, insira a senha criada em Criar um cluster e a instância principal.

7. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.

8. Na guia Editor 1, crie um banco de dados:

   CREATE DATABASE quickstart_db;
   

9. Clique em Executar. Aguarde a mensagem Statement executed successfully aparecer no painel Results.

Encontrar seu código de projeto

1. Acesse a página Painel de controle no console do Google Cloud.

   Ir para o painel

2. Encontre o ID do projeto no card Informações do projeto.

3. Anote o ID do projeto. Você vai precisar dele na próxima etapa deste guia de início rápido.

Preencher o Artifact Registry com uma imagem do aplicativo de exemplo

1. No console do Google Cloud, abra o Cloud Shell.

   Abra o Cloud Shell

2. No editor do Cloud Shell, use o comando a seguir para clonar o repositório com o código de aplicativo de exemplo do GitHub:

   cloudshell_open --repo_url \
   "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
   --dir \
   "examples/go" \
   --force_new_clone

3. Crie um repositório no Artifact Registry para imagens do Docker:

   gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

   Substitua PROJECT_ID pelo ID do seu projeto.

4. Na caixa de diálogo Autorizar o Cloud Shell, clique em Autorizar. Essa solicitação não aparece se você já tiver feito essa etapa anteriormente.

5. Para criar um contêiner do Docker e publicá-lo no Artifact Registry, use o seguinte comando:

    gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

   Substitua PROJECT_ID pelo ID do seu projeto.

Encontrar o endereço IP da nova instância

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

   Acessar Clusters

2. Encontre a linha na tabela em que o nome do recurso é my-primary.

3. Anote o endereço IP particular da linha. Você vai precisar dele na próxima etapa deste guia de início rápido.

   O exemplo de formato do endereço IP é 172.19.209.2:5432.

Criar um serviço para o Cloud Run

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

   Acessar o Cloud Run

2. Na guia Serviços, clique em Criar serviço.

3. No campo URL da imagem do contêiner, clique em Selecionar.

4. No painel Selecionar imagem do contêiner, execute estas etapas:

   1. Selecione a guia Registro de artefatos.
   2. Abra us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
   3. Abra run-sql.
   4. Selecione a imagem mais recente.
   5. Clique em Selecionar.

5. No campo Nome da conta de serviço, insira quickstart-service.

6. Verifique se us-central1 (Iowa) está selecionado na lista Região por padrão.

7. Na seção Autenticação, selecione Permitir invocações não autenticadas.

8. Verifique se a opção A CPU é alocada somente durante o processamento da solicitação está selecionada na seção Alocação e preços da CPU.

9. Expanda a seção Contêineres, volumes, rede, segurança.

10. Na guia Contêineres, selecione Variáveis e secrets e siga estas etapas:

    1. Na seção Variáveis de ambiente, clique em Adicionar variável.

    2. Insira o seguinte nos campos Name e Value:

       • DB_NAME: quickstart_db
       • DB_USER: postgres
       • DB_PASS: a senha que você inseriu ao criar o cluster em Criar um cluster e a instância principal.
       • DB_PORT: 5432
       • INSTANCE_HOST: o endereço IP da instância principal do cluster, que você encontrou em Encontrar o endereço IP da nova instância. Não inclua o número da porta. Por exemplo, defina como 172.19.209.2, e não 172.19.209.2:5432.

11. Mude da guia Contêineres para a guia Rede e siga estas etapas:

    1. Marque a caixa de seleção Conectar a uma VPC para tráfego de saída.

    2. Selecione a opção Enviar tráfego diretamente para uma VPC.

    3. Na lista suspensa Rede, escolha o valor default.

    4. Na lista suspensa Sub-rede, verifique se o valor default está selecionado.

12. Clique em Criar para criar o serviço do Cloud Run.

    Depois que o serviço do Cloud Run é implantado, a página quickstart-service mostra o URL do aplicativo de exemplo no campo URL.

    O aplicativo usa o AlloyDB como armazenamento de dados.

Conferir o aplicativo de exemplo

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

   Acessar o Cloud Run

2. Na página quickstart-service, clique em Copiar para a área de transferência para copiar o URL do aplicativo.

3. Em uma nova guia do navegador, cole o URL do aplicativo copiado e clique em Enter.

   O aplicativo da Web de coleta de votos que aparece é semelhante a este:

   

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

Limpar o cluster

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

   Acessar Clusters

2. Ao lado do cluster my-cluster que você quer excluir, clique em Ações e depois em Excluir.

3. Na caixa de diálogo Delete cluster que aparece, digite my-cluster no campo my-cluster para confirmar que você quer excluir o cluster.

4. Clique em Excluir.

Limpar o serviço

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

   Acesse o Cloud Run

2. Marque a caixa de seleção ao lado do nome do serviço do quickstart-service.

3. Clique em Excluir na parte de cima da página Cloud Run.

4. Na caixa de diálogo Excluir quickstart-service que aparece, clique em Excluir para confirmar.

A seguir

• Ativar o acesso do projeto ao AlloyDB

• Conceder a outros usuários o acesso ao AlloyDB

• Ativar o acesso a serviços privados

• Criar um cluster e a instância principal