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

1. Visão geral

Com este 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 ao integrar 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 os 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.

Para testar este codelab, use o link de crédito de faturamento de teste do GCP: https://bit.ly/ez-cloudsql1

Como resgatar créditos usando este link? Indique.

3. Você vai usar o Cloud Shell, um ambiente de linha de comando executado no Google Cloud. Clique em "Ativar o Cloud Shell" na parte de cima do console do Google Cloud.

4. Depois de se conectar ao Cloud Shell, verifique se sua conta já está autenticada e se o projeto está configurado com seu ID do projeto usando o seguinte comando:

gcloud auth list

5. Execute o comando a seguir no Cloud Shell para confirmar se o comando gcloud sabe sobre seu projeto.

gcloud config list project

6. Se o projeto não estiver definido, use este comando:

gcloud config set project <YOUR_PROJECT_ID>

7. Ative as APIs necessárias: siga o link e ative as APIs.

Como alternativa, use o comando gcloud. 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.

Um clique e pronto

2. Depois que essa etapa for concluída, o repositório será clonado no editor local do Cloud Shell, e você poderá executar o comando abaixo na pasta do projeto. É importante verificar se você está no diretório do projeto:

sh run.sh

3. Agora use a interface (clique no link no terminal ou no link "visualizar na Web" no terminal).
4. Insira os detalhes do ID do projeto e do nome da instância para começar.
5. Tome um café enquanto os registros rolam e leia aqui como isso é feito nos bastidores.

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 mudanças 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 = <<>>

Se você quiser testar localmente ou de qualquer lugar, acesse a instância do Cloud SQL, clique em "EDITAR" e em "Ativar IP público" ou "Conectividade de IP público" (não a de saída) e insira "0.0.0.0/0" em "Redes externas autorizadas" para fins de desenvolvimento. Depois, remova e desative a conectividade de IP público.

5. Implantar no Cloud Run

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

Quando tiver certeza de que está na pasta do projeto, execute o seguinte comando:

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

Depois da 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 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 faça login com suas credenciais.

No estúdio, no painel à esquerda, atualize os objetos do banco de dados para ver a tabela recém-criada:

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

7. Limpeza

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

Acesse https://console.cloud.google.com/sql/instances. Selecione a instância que você quer excluir clicando nas reticências verticais ao lado dela e clique em EXCLUIR.

Ele 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.