Connessione da Cloud Run

Questa pagina descrive la procedura per eseguire il 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

  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.

    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.

    Go to project selector

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

  6. 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, fai clic su Avanti per confermare il nome del progetto a cui apporterai modifiche.

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

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

Creazione di un cluster e della 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. In Informazioni di base, inserisci my-cluster nel campo ID cluster.

  5. Nel campo Password, inserisci una password qualsiasi. 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 Networking, seleziona default.

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

    Nella finestra di dialogo È richiesta una connessione di accesso privato ai servizi, per creare una connessione di accesso privato ai servizi, completa quanto segue:

    1. Fai clic su Configura connessione.

      Viene visualizzato un nuovo riquadro denominato 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. In Informazioni di base, inserisci my-primary nel campo ID istanza.

  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 sei 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. Nell'elenco a discesa Utente, seleziona postgres.

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

  7. Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra 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 venga visualizzato il messaggio Statement executed successfully 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. Ne avrai bisogno per il passaggio successivo di questa guida rapida.

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

  1. Nella console Google Cloud, apri Cloud Shell.

    Apri Cloud Shell

  2. Nell'editor 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 messaggio non viene visualizzato se hai già eseguito questo passaggio in precedenza.

  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 della risorsa è my-primary.

  3. Prendi nota dell'indirizzo IP privato della riga. Ne avrai bisogno per il passaggio successivo di questa guida rapida.

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

Creare un servizio per Cloud Run

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

    Vai a Cloud Run

  2. Nella scheda Services (Servizi), fai clic su Create Service (Crea servizio).

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

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

    1. Seleziona la scheda Registry degli elementi.
    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.
  5. Nel campo Nome servizio, inserisci quickstart-service.

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

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

  8. Assicurati che l'opzione La CPU viene allocata solo durante l'elaborazione delle richieste sia selezionata nella sezione Prezzi e allocazione della CPU.

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

  10. 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:

  11. Passa dalla scheda Contenitori 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.

  12. 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 data store.

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 raccolta dei voti di esempio visualizzata è simile alla seguente:

    Applicazione di esempio di tabulazioni e spazi

Esegui la pulizia

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

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

Eliminare 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