Connessione da Cloud Run

Connessione da Cloud Run

Questa pagina ti guida nel processo di deployment di un'applicazione di esempio su un servizio Cloud Run utilizzando la console Google Cloud e un'applicazione client. Questa applicazione di esempio connette Cloud Run ad AlloyDB per PostgreSQL.

Prima di iniziare

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Abilita le API Cloud necessarie per eseguire un'applicazione di esempio AlloyDB per PostgreSQL su Cloud Run.

   Abilita le API

   1. Nel passaggio Conferma progetto, per confermare il nome del progetto a cui apporterai le modifiche, fai clic su Avanti.

   2. Nel passaggio Abilita API, fai clic su Abilita per abilitare quanto segue:

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

Creare un cluster e la relativa istanza principale

1. Nella console Google Cloud , vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su Crea cluster.

   La console Google Cloud ti offre una scelta di tipi di cluster. Seleziona Disponibilità elevata.

3. Fai clic su Continua.

   La sezione Configura il cluster si espande.

4. Nella sezione Informazioni di base, nel campo ID cluster, inserisci my-cluster.

5. Nel campo Password, inserisci la password che preferisci. Prendi nota di questa password. Lo utilizzerai di nuovo più avanti in questa guida rapida.

6. Nel campo Regione, seleziona us-central1 (Iowa).

7. In Connettività, nel menu a discesa Rete, seleziona default.

   Se non hai ancora configurato l'accesso privato ai servizi, viene visualizzata una finestra di dialogo con l'etichetta È richiesta una connessione di accesso privato ai servizi.

   Nella finestra di dialogo È richiesta una connessione di accesso privato ai servizi, per creare la connessione di accesso privato ai servizi, completa i seguenti passaggi:

   1. Fai clic su Configura connessione.

      Viene visualizzato un nuovo riquadro etichettato Abilita API Service Networking.

   2. Nel riquadro, seleziona Utilizza un intervallo IP allocato automaticamente.

   3. Fai clic su Continua.

   4. Fai clic su Crea connessione e attendi il completamento della configurazione della connessione.

      Il riquadro viene rimosso.

8. Fai clic su Continua.

   La sezione Configura l'istanza principale si espande.

9. Nella sezione Informazioni di base, nel campo ID istanza, inserisci my-primary.

10. Per un valore Macchina, seleziona 2 vCPU, 16 GB.

11. Fai clic su Crea cluster.

    Attendi la creazione del cluster.

Connettiti all'istanza e crea un database

1. Se non ti trovi nella pagina Panoramica del cluster appena creato, nella console Google Cloud vai alla pagina Cluster.

   Vai a Cluster

2. Per visualizzare la pagina Panoramica del cluster, fai clic sul nome del cluster my-cluster.

3. Nel menu di navigazione, fai clic su AlloyDB Studio.

4. Nell'elenco Database della pagina Accedi ad AlloyDB Studio, seleziona postgres.

5. Nel menu a discesa Utente, seleziona postgres.

6. Nel campo Password, inserisci la password che hai creato in Creazione di un cluster e della relativa istanza principale.

7. Fai clic su Authenticate (Autentica). Nel riquadro Explorer viene visualizzato un elenco degli oggetti nel database.

8. Nella scheda Editor 1, crea un database:

   CREATE DATABASE quickstart_db;
   

9. Fai clic su Esegui. Attendi che il messaggio Statement executed successfully venga visualizzato nel riquadro Risultati.

Trovare l'ID progetto

1. Vai alla pagina Dashboard nella console Google Cloud .

   Vai alla dashboard

2. Trova l'ID progetto nella scheda Informazioni sul progetto.

3. Prendi nota dell'ID progetto. Ti servirà per il passaggio successivo di questa guida rapida.

Popola Artifact Registry con un'immagine dell'applicazione di esempio

1. Nella console Google Cloud , apri Cloud Shell.

   Apri Cloud Shell

2. Nell'editor di Cloud Shell, utilizza il seguente comando per clonare il repository con il codice dell'applicazione di esempio da GitHub:

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

3. Crea un repository in Artifact Registry per le immagini Docker:

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

   Sostituisci PROJECT_ID con l'ID del tuo progetto.

4. Nella finestra di dialogo Autorizza Cloud Shell, fai clic su Autorizza. Questo prompt non viene visualizzato se hai già eseguito questo passaggio.

5. Per creare un container Docker e pubblicarlo in Artifact Registry, utilizza il seguente comando:

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

   Sostituisci PROJECT_ID con l'ID del tuo progetto.

Trovare l'indirizzo IP della nuova istanza

1. Nella console Google Cloud , vai alla pagina Cluster.

   Vai a Cluster

2. Trova la riga nella tabella il cui Nome risorsa è my-primary.

3. Prendi nota dell'indirizzo IP privato di questa riga. Ti servirà per il passaggio successivo di questa guida rapida.

   Il formato di esempio dell'indirizzo IP è 172.19.209.2:5432.

Crea un servizio per Cloud Run

1. Nella console Google Cloud , vai alla pagina Cloud Run.

   Vai a Cloud Run

2. Nella scheda Servizi, fai clic su Esegui il deployment del container.

3. Nella pagina Crea servizio, seleziona l'opzione Esegui il deployment di una revisione da un'immagine container esistente.

4. Nel campo URL immagine container, fai clic su Seleziona.

5. Nel riquadro Seleziona immagine container, completa i seguenti passaggi:

   1. Seleziona la scheda Artifact Registry.
   2. Espandi us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
   3. Espandi run-sql.
   4. Seleziona l'immagine più recente.
   5. Fai clic su Seleziona.

6. Nel campo Nome servizio, inserisci quickstart-service.

7. Assicurati che us-central1 (Iowa) sia selezionata per impostazione predefinita nell'elenco Regione.

8. Nella sezione Autenticazione, seleziona Consenti chiamate non autenticate.

9. Assicurati che l'opzione La CPU viene allocata solo durante l'elaborazione delle richieste sia selezionata nella sezione Allocazione e prezzi della CPU.

10. Espandi la sezione Container, volumi, networking, sicurezza.

11. Nella scheda Container, seleziona la scheda Variabili e secret e completa i seguenti passaggi:

    1. Nella sezione Variabili di ambiente, fai clic su Aggiungi variabile.

    2. Inserisci quanto segue nei campi Name e Value:

       • DB_NAME: quickstart_db
       • DB_USER: postgres
       • DB_PASS: la password che hai inserito quando hai creato il cluster in Creare un cluster e la relativa istanza principale.
       • DB_PORT: 5432
       • INSTANCE_HOST: l'indirizzo IP dell'istanza principale del cluster, che hai trovato in Trovare l'indirizzo IP della nuova istanza. Non includere il numero di porta, ad esempio imposta 172.19.209.2 e non 172.19.209.2:5432.

12. Passa dalla scheda Container alla scheda Networking e completa i seguenti passaggi:

    1. Seleziona la casella di controllo Connettiti a un VPC per il traffico in uscita.

    2. Seleziona l'opzione Invia il traffico direttamente a un VPC.

    3. Nell'elenco a discesa Rete, scegli il valore default.

    4. Nell'elenco a discesa Subnet, assicurati che sia selezionato il valore default.

13. Fai clic su Crea per creare il servizio Cloud Run.

    Dopo il deployment del servizio Cloud Run, la pagina quickstart-service mostra l'URL dell'applicazione di esempio nel campo URL.

    L'applicazione utilizza AlloyDB come datastore.

Visualizza l'applicazione di esempio

1. Nella console Google Cloud , vai alla pagina Cloud Run.

   Vai a Cloud Run

2. Nella pagina quickstart-service, fai clic su Copia negli appunti per copiare l'URL dell'applicazione.

3. In una nuova scheda del browser, incolla l'URL dell'applicazione copiato e fai clic su Invio.

   L'applicazione web di esempio per la raccolta dei voti visualizzata è simile alla seguente:

   

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Pulire il cluster

1. Nella console Google Cloud , vai alla pagina Cluster.

   Vai a Cluster

2. Accanto al cluster my-cluster che vuoi eliminare, fai clic su Azioni e poi su Elimina.

3. Nella finestra di dialogo Elimina cluster visualizzata, digita my-cluster nel campo my-cluster per confermare che vuoi eliminarlo.

4. Fai clic su Elimina.

Pulire il servizio

1. Nella console Google Cloud , vai alla pagina Cloud Run.

   Vai a Cloud Run

2. Seleziona la casella di controllo accanto al nome del servizio quickstart-service.

3. Fai clic su Elimina nella parte superiore della pagina Cloud Run.

4. Nella finestra di dialogo Elimina quickstart-service visualizzata, fai clic su Elimina per confermare.

Passaggi successivi

• Abilitare l'accesso al progetto in AlloyDB

• Concedere ad AlloyDB l'accesso ad altri utenti

• Attivare l'accesso privato ai servizi

• Crea un cluster e la relativa istanza principale