Implantar um aplicativo JavaScript no Cloud Run com o AlloyDB

1. Visão geral

O Cloud Run é uma plataforma sem servidor totalmente gerenciada que permite executar contêineres sem estado que podem ser invocados por solicitações HTTP. Neste codelab, você vai aprender a conectar um aplicativo Node.js no Cloud Run ao AlloyDB com segurança usando uma conta de serviço e a autenticação do IAM.

O que você vai aprender

Neste laboratório, você vai aprender a:

• Crie uma instância do AlloyDB (configurada para usar o Private Service Connect).
• Implantar um aplicativo no Cloud Run que se conecta à sua instância do AlloyDB

2. Pré-requisitos

1. Se você ainda não tiver uma Conta do Google, crie uma.
   • Use uma conta pessoal em vez de uma conta escolar ou de trabalho. As contas escolares e de trabalho podem ter restrições que impedem a ativação das APIs necessárias para este laboratório.

3. Configurar o projeto

1. Faça login no Console do Google Cloud.
2. Ative o faturamento no console do Cloud.
   • A conclusão deste laboratório custa menos de US $1 em recursos do Cloud.
   • Siga as etapas no final deste laboratório para excluir recursos e evitar mais cobranças.
   • Novos usuários podem aproveitar o teste sem custos financeiros de US$300.
3. Crie um projeto ou reutilize um projeto existente.

4. Abrir editor do Cloud Shell

1. Acesse o editor do Cloud Shell.
2. Se o terminal não aparecer na parte de baixo da tela, abra-o:
   • Clique no menu de navegação .
   • Clique em Terminal.
   • Clique em Novo Terminal.
3. No terminal, defina o projeto com este comando:
   • Formato:

     gcloud config set project [PROJECT_ID]
     

   • Exemplo:

     gcloud config set project lab-project-id-example
     

   • Se você não se lembrar do ID do projeto, faça o seguinte:
     • Para listar todos os IDs de projeto, use:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
4. Se for necessário autorizar, clique em Autorizar para continuar.
5. Você vai receber esta mensagem:

   Updated property [core/project].
   

   Se você vir um WARNING e for perguntado Do you want to continue (Y/N)?, provavelmente inseriu o ID do projeto incorretamente. Pressione N, Enter e tente executar o comando gcloud config set project novamente.

5. Ativar APIs

No terminal, ative as APIs:

gcloud services enable \
  compute.googleapis.com \
  alloydb.googleapis.com \
  run.googleapis.com \
  artifactregistry.googleapis.com \
  cloudbuild.googleapis.com \
  cloudaicompanion.googleapis.com

Se for necessário autorizar, clique em Autorizar para continuar.

Esse comando pode levar alguns minutos para ser concluído, mas vai gerar uma mensagem de sucesso semelhante a esta:

Operation "operations/acf.p2-73d90d00-47ee-447a-b600" finished successfully.

6. Configurar uma conta de serviço

Crie e configure uma conta de serviço do Google Cloud para ser usada pelo Cloud Run, de modo que ela tenha as permissões corretas para se conectar ao AlloyDB.

1. Execute o comando gcloud iam service-accounts create da seguinte maneira para criar uma conta de serviço:

   gcloud iam service-accounts create quickstart-service-account \
     --display-name="Quickstart Service Account"
   

2. Execute o comando gcloud projects add-iam-policy-binding da seguinte maneira para adicionar o papel Usuário do banco de dados do AlloyDB à conta de serviço do Google Cloud que você acabou de criar.

   gcloud projects add-iam-policy-binding ${GOOGLE_CLOUD_PROJECT} \
     --member="serviceAccount:quickstart-service-account@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
     --role="roles/alloydb.databaseUser"
   

3. Execute o comando gcloud projects add-iam-policy-binding da seguinte maneira para adicionar o papel Consumidor do Service Usage à conta de serviço do Google Cloud que você acabou de criar.

   gcloud projects add-iam-policy-binding ${GOOGLE_CLOUD_PROJECT} \
     --member="serviceAccount:quickstart-service-account@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

4. Execute o comando gcloud projects add-iam-policy-binding da seguinte maneira para adicionar o papel Gravador de registros à conta de serviço do Google Cloud que você acabou de criar.

   gcloud projects add-iam-policy-binding ${GOOGLE_CLOUD_PROJECT} \
     --member="serviceAccount:quickstart-service-account@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
     --role="roles/logging.logWriter"
   

7. Criar banco de dados do AlloyDB

1. Execute o comando gcloud alloydb clusters create para criar uma instância do Cloud SQL.

   gcloud alloydb clusters create quickstart-cluster \
     --password=$(openssl rand -base64 20) \
     --region=us-central1 \
     --project=${GOOGLE_CLOUD_PROJECT} \
     --enable-private-service-connect \
     --database-version=POSTGRES_16
   

Esse comando pode levar alguns minutos para ser concluído.

1. Execute o comando gcloud alloydb instances create para criar uma instância do Cloud SQL.

   gcloud alloydb instances create quickstart-instance \
     --project=${GOOGLE_CLOUD_PROJECT} \
     --instance-type=PRIMARY \
     --cpu-count=2 \
     --region=us-central1 \
     --cluster=quickstart-cluster \
     --allowed-psc-projects=${GOOGLE_CLOUD_PROJECT} \
     --database-flags=alloydb.iam_authentication=on
   

2. Execute o comando gcloud alloydb instances describe para receber o link do anexo de serviço do PSC e exportá-lo para uma variável.

   export SERVICE_ATTACHMENT=$(gcloud alloydb instances describe quickstart-instance \
       --cluster=quickstart-cluster --region=us-central1 \
       --format="value(pscInstanceConfig.serviceAttachmentLink)")
   

3. gcloud compute addresses create quickstart-address \
     --region=us-central1 \
     --subnet=default
   

4. gcloud compute forwarding-rules create quickstart-endpoint \
     --region=us-central1 \
     --network=default \
     --address=quickstart-address \
     --target-service-attachment=${SERVICE_ATTACHMENT}
   

Crie um usuário do banco de dados PostgreSQL para a conta de serviço criada anteriormente acessar o banco de dados.

gcloud alloydb users create quickstart-service-account@${GOOGLE_CLOUD_PROJECT}.iam \
  --cluster=quickstart-cluster \
  --region=us-central1 \
  --type=IAM_BASED \
  --superuser=true

8. Preparar inscrição

Prepare um aplicativo Node.js que responda a solicitações HTTP.

1. No Cloud Shell, crie um novo diretório chamado helloworld e mude para ele:

   mkdir helloworld
   cd helloworld
   

2. Inicialize um arquivo package.json como um módulo.

   npm init -y
   npm pkg set type="module"
   npm pkg set main="index.mjs"
   npm pkg set scripts.start="node index.mjs"
   

3. Instale a biblioteca de autenticação do Google Cloud.

   npm install google-auth-library
   

4. Instale o pg para interagir com o banco de dados PostgreSQL.

   npm install pg
   

5. Instale o Express para aceitar solicitações HTTP de entrada.

   npm install express
   

6. Crie um arquivo index.mjs com o código do aplicativo. Esse código pode:
   • Aceitar solicitações HTTP
   • Conecte-se ao banco de dados
   • Armazenar o horário da solicitação HTTP no banco de dados
   • Retornar os horários dos últimos cinco pedidos
   Execute o comando a seguir no Cloud Shell:

   cat > index.mjs << "EOF"
   import express from 'express';
   import pg from 'pg';
   const { Pool } = pg;
   import {GoogleAuth} from 'google-auth-library';
   
   const auth = new GoogleAuth({
     scopes: ['https://www.googleapis.com/auth/alloydb.login'],
   });
   
   const pool = new Pool({
     host: process.env.DB_HOST,
     user: process.env.DB_USER,
     password: async () => {
       return await auth.getAccessToken();
     },
     database: process.env.DB_NAME,
     ssl: {
       require: true,
       rejectUnauthorized: false, // required for self-signed certs
       // https://node-postgres.com/features/ssl#self-signed-cert
     }
   });
   
   const app = express();
   
   app.get('/', async (req, res) => {
     await pool.query('INSERT INTO visits(created_at) VALUES(NOW())');
     const {rows} = await pool.query('SELECT created_at FROM visits ORDER BY created_at DESC LIMIT 5');
     console.table(rows); // prints the last 5 visits
     res.send(rows);
   });
   
   const port = parseInt(process.env.PORT) || 8080;
   app.listen(port, async () => {
     console.log('process.env: ', process.env);
     await pool.query(`CREATE TABLE IF NOT EXISTS visits (
       id SERIAL NOT NULL,
       created_at timestamp NOT NULL,
       PRIMARY KEY (id)
     );`);
     console.log(`helloworld: listening on port ${port}`);
   });
   
   EOF
   

Esse código cria um servidor da Web básico que detecta na porta definida pela variável de ambiente PORT. O aplicativo está pronto para ser implantado.

9. Implantar aplicativo do Cloud Run

1. Execute o comando abaixo para implantar o aplicativo no Cloud Run:

   gcloud run deploy helloworld \
     --region=us-central1 \
     --source=. \
     --set-env-vars DB_NAME="quickstart_db" \
     --set-env-vars DB_USER="postgres" \
     --set-env-vars DB_PASSWORD=${DB_PASSWORD} \
     --set-env-vars DB_HOST="$(gcloud sql instances describe quickstart-instance --project=${GOOGLE_CLOUD_PROJECT} --format='value(settings.ipConfiguration.pscConfig.pscAutoConnections.ipAddress)')" \
     --service-account="quickstart-service-account@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
     --network=default \
     --subnet=default \
     --allow-unauthenticated
   

2. Se solicitado, pressione Y e Enter para confirmar que você quer continuar:

   Do you want to continue (Y/n)? Y
   

Depois de alguns minutos, o aplicativo vai fornecer um URL para você acessar.

Navegue até o URL para ver o aplicativo em ação. Sempre que você acessar a URL ou atualizar a página, as cinco visitas mais recentes vão aparecer em JSON.

Depois de alguns minutos, o aplicativo vai fornecer um URL para você acessar.

Navegue até o URL para ver o aplicativo em ação. Sempre que você acessar a URL ou atualizar a página, as cinco visitas mais recentes vão aparecer em JSON.

10. Parabéns

Neste laboratório, você aprendeu a:

• Crie uma instância do AlloyDB (configurada para usar o Private Service Connect).
• Implantar um aplicativo no Cloud Run que se conecta à sua instância do AlloyDB

Limpar

O Cloud SQL não tem um nível sem custo financeiro e vai cobrar se você continuar usando o serviço. Você pode excluir seu projeto na nuvem para evitar cobranças adicionais.

O Cloud Run não gera custos quando o serviço não está em uso, mas você ainda pode receber cobranças pelo armazenamento da imagem do contêiner no Artifact Registry. A exclusão do projeto na nuvem interrompe o faturamento de todos os recursos usados nele.

Se quiser, exclua o projeto:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

Você também pode excluir recursos desnecessários do disco do Cloud Shell. Você pode:

1. Exclua o diretório do projeto do codelab:

   rm -rf ~/task-app
   

2. Aviso: Não é possível desfazer a próxima ação. Se você quiser excluir tudo no Cloud Shell para liberar espaço, exclua todo o diretório principal. Tenha cuidado para que tudo o que você quer manter seja salvo em outro lugar.

   sudo rm -rf $HOME
   

Continue aprendendo

• Implantar um aplicativo Next.js full stack no Cloud Run com o Cloud SQL para PostgreSQL usando o conector Node.js do Cloud SQL
• Implantar um aplicativo Angular full stack no Cloud Run com o Cloud SQL para PostgreSQL usando o conector Node.js do Cloud SQL
• Implante um aplicativo Angular full stack no Cloud Run com o Firestore usando o SDK Admin do Node.js
• Implantar um aplicativo Next.js full stack no Cloud Run com o Firestore usando o SDK Admin do Node.js