Connetti a un database Firestore

Anteprima - Using the Cloud Run integrations

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Utilizza Firestore per configurare un database cloud NoSQL scalabile per il tuo servizio Cloud Run. Firestore è un database NoSQL flessibile e scalabile per lo sviluppo mobile, web e server.

Utilizzando l'integrazione Cloud Run descritta in questa pagina, puoi connettere rapidamente il tuo servizio Cloud Run a un nuovo database Firestore.

Prima di iniziare

• Assicurati che sia già stato eseguito il deployment del servizio Cloud Run con cui esegui l'integrazione.
• Consulta la pagina dei prezzi di Firestore. Ti viene addebitato il costo per le singole risorse utilizzate nell'integrazione.

Ruoli obbligatori

Per utilizzare le integrazioni di Cloud Run, tu o il tuo amministratore dovete concedere i ruoli IAM su due entità diverse.

Fai clic per visualizzare i ruoli richiesti per il tuo Account Google

Per ottenere le autorizzazioni necessarie per utilizzare le integrazioni di Cloud Run, chiedi all'amministratore di concedere al tuo Account Google i seguenti ruoli IAM sul tuo progetto:

• Sviluppatore Cloud Run (roles/run.developer)
• Visualizzatore Compute (roles/compute.viewer)
• Sviluppatore integrazioni serverless (roles/runapps.developer)
• Operatore di integrazioni serverless (roles/runapps.operator)
• Utente account di servizio (roles/iam.serviceAccountUser)

Fai clic per visualizzare i ruoli richiesti per l'account di servizio

Per eseguire il deployment del servizio Cloud Run, puoi utilizzare l'account di servizio predefinito di Compute Engine creato automaticamente o specificare un account di servizio gestito dall'utente. L'account di servizio deve avere i seguenti ruoli:

• Sviluppatore Cloud Run (roles/run.developer)
• Writer bucket di log (roles/logging.bucketWriter)
• Utente account di servizio (roles/iam.serviceAccountUser)
• Amministratore Storage (roles/storage.admin)
• Amministratore Firestore (roles/firestore.admin)
• Amministratore IAM progetto (roles/projectIAM.admin)

Connetti un servizio a un nuovo database Firestore

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche per le revisioni successive verrà applicata automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

Puoi connettere un servizio Cloud Run a un database Firestore utilizzando la console o la riga di comando.

Console

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

   Vai a Cloud Run

2. Fai clic sul servizio che vuoi utilizzare nell'elenco dei servizi che vuoi utilizzare in questa integrazione.

3. Fai clic sulla scheda Integrations (Integrazioni).

4. Fai clic su Add integration (Aggiungi integrazione).

5. Fai clic su Database Firestore.

6. Utilizza il nome predefinito o cambia il nome specificando il valore che vuoi utilizzare.

   

7. Se ti viene richiesto di abilitare un elenco di API, fai clic su Abilita e attendi che le API siano abilitate.

8. In Risorse, nota le nuove risorse che verranno create come risultato di questa integrazione.

9. Fai clic su Invia e attendi la creazione dell'integrazione e delle risorse. L'operazione potrebbe richiedere fino a 15 minuti.

Riga di comando

1. Aggiorna l'interfaccia a Google Cloud CLI più recente:

   gcloud components update
   

2. Crea l'integrazione:

   gcloud beta run integrations create \
   --type=firestore \
   --service=SERVICE \
   

   Sostituisci:

   • SERVICE con il nome del tuo servizio Cloud Run.

   Se vuoi, includi il flag --service-account=SERVICE_ACCOUNT_EMAIL.

   • SERVICE_ACCOUNT_EMAIL con l'indirizzo email dell'account di servizio gestito dall'utente ([e-mail]) utilizzato per eseguire il deployment del servizio. Ometti questo flag se vuoi utilizzare l'account di servizio Compute predefinito (SERVICE_ACCOUNT_ID@PROJECT_ID.iam.gserviceaccount.com).

     Per continuare a utilizzare l'account di servizio specificato durante il deployment delle integrazioni di Cloud Run, esegui questo comando:

     gcloud config set runapps/deployment-service-account
     

3. Attendi fino a 15 minuti, durante il quale viene creato e connesso un database Firestore completamente configurato. Viene inoltre creata una nuova revisione di Cloud Run, incluse le variabili di ambiente che identificano il database. Al termine del processo, viene visualizzato il seguente messaggio:

   [firestore] integration [firestore-xxx] has been updated successfully.
   
   To connect to the Firestore database, utilize the environment variable
   `FIRESTORE_DB_NAME`. This variable is added to the Cloud Run
   service for you.

   Puoi controllare lo stato eseguendo gcloud beta run integrations describe.

Visualizza le integrazioni dei database Firestore

Per visualizzare lo stato attuale delle integrazioni dei database Firestore per il servizio Cloud Run:

Console

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

   Vai a Cloud Run

2. Fai clic sul servizio che vuoi utilizzare nell'elenco dei servizi che vuoi utilizzare in questa integrazione.

3. Fai clic sulla scheda Integrations (Integrazioni).

4. Individua l'integrazione del database Firestore che ti interessa e fai clic su Visualizza dettagli.

Riga di comando

1. Utilizza il comando seguente per visualizzare un elenco delle integrazioni disponibili:

   gcloud beta run integrations list

2. Utilizzando un nome dall'elenco restituito, visualizza i relativi dettagli:

   gcloud beta run integrations describe INTEGRATION_NAME

   Sostituisci INTEGRATION_NAME con il nome dell'integrazione del tuo database Firestore.

Elimina le integrazioni dei database Firestore

L'eliminazione di un'integrazione comporta anche l'eliminazione di tutte le risorse Google Cloud associate all'integrazione, ma non elimina il servizio Cloud Run.

Per eliminare l'integrazione di un database Firestore dal servizio Cloud Run:

Console

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

   Vai a Cloud Run

2. Fai clic sul servizio da cui vuoi eliminare un'integrazione.

3. Fai clic sulla scheda Integrations (Integrazioni).

4. Individua l'integrazione del database Firestore che ti interessa, fai clic sull'icona con i puntini di sospensione a destra dell'integrazione e poi fai clic su Elimina.

Riga di comando

1. Utilizza il comando seguente per visualizzare un elenco delle integrazioni disponibili:

   gcloud beta run integrations list

2. Utilizzando un nome dall'elenco restituito, elimina l'integrazione:

   gcloud beta run integrations delete INTEGRATION_NAME
   

   Sostituisci:

   • INTEGRATION_NAME con il nome dell'integrazione del tuo database Firestore.

   Facoltativamente, puoi utilizzare le seguenti opzioni di segnalazione:

   Opzione	Descrizione
   --service-account	L'indirizzo email dell'account di servizio gestito dall'utente per eseguire l'operazione di eliminazione.

Accedi al database Firestore nel tuo codice

Dopo aver completato l'integrazione, Cloud Run aggiunge automaticamente la variabile di ambiente FIRESTORE_DB_NAME da utilizzare nel codice di servizio Cloud Run.

Codice di esempio per i servizi che utilizzano Firestore

Consulta la documentazione di Firestore per gli esempi di codice di Cloud Run e Firestore.

Limitazioni

• Le integrazioni di Cloud Run sono supportate solo in determinate regioni. Se devi utilizzare una regione non supportata dalle integrazioni di Cloud Run, consulta Utilizzare una libreria client lato server.
• Il database predefinito Firestore non è supportato. Questa integrazione supporta solo la creazione di database Firestore denominati.