Conectar o aplicativo aos dados do Cloud SQL e fazer a implantação no Cloud Run

1. Visão geral

Neste codelab, vamos demonstrar um método simples e fácil de configurar o Cloud SQL e conectar nosso aplicativo a ele. É um aprendizado rápido de nível L100 para melhorar a experiência do desenvolvedor na integração de aplicativos avançados de IA a recursos de dados sofisticados que o Cloud SQL oferece.

O que você vai criar

Um aplicativo da Web simples.

Como parte disso, você vai:

  1. Criar uma instância do Cloud SQL para PostgreSQL com instalação em um clique
  2. Criar um aplicativo de amostra para se conectar a essa instância e configurar dados

Requisitos

  • Use um navegador, como o Chrome ou o Firefox.
  • Ter um projeto do Google Cloud com o faturamento ativado.

2. Antes de começar

Criar um projeto

  1. No console do Google Cloud, na página de seletor de projetos, selecione ou crie um projeto do Google Cloud.
  2. Confira se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto.
  3. Você vai usar o Cloud Shell, um ambiente de linha de comando em execução no Google Cloud. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

Imagem do botão "Ativar o Cloud Shell"

  1. Depois de se conectar ao Cloud Shell, verifique se você já está autenticado e se o projeto está definido como o ID do seu projeto usando o comando a seguir:
gcloud auth list
  1. Execute o comando a seguir no Cloud Shell para confirmar se o comando gcloud sabe sobre seu projeto.
gcloud config list project
  1. Se o projeto não estiver definido, use este comando:
gcloud config set project <YOUR_PROJECT_ID>
  1. Ative as APIs necessárias: siga o link e ative as APIs.

Como alternativa, você pode usar o comando gcloud para isso. Consulte a documentação para ver o uso e os comandos gcloud.

3. Configuração do banco de dados

Neste laboratório, vamos usar o Cloud SQL para PostgreSQL como o banco de dados dos dados de teste.

Vamos criar uma instância do Cloud SQL em que o conjunto de dados de teste será carregado.

  1. Clique no botão ou copie o link abaixo para o navegador em que o usuário do console do Google Cloud está conectado.

  1. Depois que essa etapa for concluída, o repositório será clonado para o editor do Cloud Shell local, e você poderá executar o comando abaixo na pasta do projeto. É importante verificar se você está no diretório do projeto:
sh run.sh
  1. Agora use a interface (clicando no link no terminal ou no link "Visualizar na Web" no terminal).
  2. Insira os detalhes do ID do projeto e do nome da instância para começar.
  3. Pegue um café enquanto os registros são rolados. Você pode ler sobre como isso é feito nos bastidores aqui.

4. Criar o aplicativo de amostra para testar a conexão

No terminal do Cloud Shell, execute os comandos a seguir um por um:

git clone https://github.com/flazer99/verify-easy-cloud-sql-connection

cd verify-easy-cloud-sql-connection

Faça alterações no arquivo verify_connection.py para a configuração do Cloud SQL que você acabou de configurar na seção anterior:

# Replace this with the Private IP of your Cloud SQL Instance
DB_HOST = <<>> 
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual Cloud SQL password    
DB_PASS = <<>>

5. Implantar no Cloud Run

No terminal do Cloud Shell, verifique se você está na pasta do projeto.

Depois de confirmar que você está na pasta do projeto, execute o comando a seguir:

gcloud run deploy verify-cloudsql \
    --source . \
    --region=us-central1 \
    --network=easy-cloudsql-vpc \
    --subnet=easy-cloudsql-subnet \
    --vpc-egress=all-traffic \
    --allow-unauthenticated

Após a implantação, você vai receber um endpoint do Cloud Run implantado semelhante a este:

https://verify-cloudsql-**********-uc.a.run.app/

6. Demonstração

Para confirmar se ele funcionou, confira o resultado no navegador ou no Explorador de registros.

Navegue até Cloud SQL no console do Google Cloud e abra a instância recém-criada. Clique em Cloud SQL Studio no painel de navegação à esquerda e conecte-se com suas credenciais.

No estúdio, no painel à esquerda, atualize os objetos do banco de dados. A tabela recém-criada será exibida:

658d9261e6098139.png

Você pode consultar rapidamente para verificar se a inserção foi feita:

658d9261e6098139.png

7. Revisão dos dados

Depois que este laboratório de teste for concluído, não se esqueça de excluir a instância do Cloud SQL.

Isso vai limpar o cluster e as instâncias dele.

8. Conclusão

Comece a configurar seus dados com o Cloud SQL de forma rápida e fácil.