Guida rapida: esegui il deployment di una funzione Cloud Run utilizzando la Google Cloud console

Guida rapida: esegui il deployment di una funzione Cloud Run utilizzando la Google Cloud console

Questa pagina mostra come eseguire il deployment di una funzione Cloud Run HTTP utilizzando la Google Cloud console.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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 role (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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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 role (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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. Se sei soggetto a un criterio dell'organizzazione di limitazione del dominio che limita le chiamate non autenticate per il tuo progetto, dovrai accedere al servizio di cui hai eseguito il deployment come descritto in Testare i servizi privati.

2. Esamina i prezzi di Cloud Run o stima i costi con il Calcolatore prezzi.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Amministratore di Cloud Run (roles/run.admin) sul progetto
• Cloud Run Source Developer (roles/run.sourceDeveloper) sul progetto
• Utente account di servizio (roles/iam.serviceAccountUser) sull'identità di servizio
• Visualizzatore log (roles/logging.viewer) sul progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Concedi al account di servizio Cloud Build l'accesso al tuo progetto

Cloud Build utilizza automaticamente il service account predefinito di Compute Engine come account di servizio Cloud Build predefinito per creare il codice sorgente e la risorsa Cloud Run, a meno che tu non sostituisca questo comportamento.

Affinché Cloud Build possa creare le tue origini, concedi al service account il ruolo Cloud Run Builder (roles/run.builder) nel tuo progetto:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \
    --role=roles/run.builder

Sostituisci PROJECT_ID con il tuo Google Cloud ID progetto e SERVICE_ACCOUNT_EMAIL_ADDRESS con l' indirizzo email del account di servizio Cloud Build. Se utilizzi il service account predefinito di Compute Engine come service account Cloud Build, utilizza il seguente formato per l'indirizzo email dell'account di servizio:

[e-mail]

Sostituisci PROJECT_NUMBER con il tuo Google Cloud numero del progetto.

Per istruzioni dettagliate su come trovare l'ID progetto e il numero del progetto, consulta Creazione e gestione dei progetti.

La propagazione della concessione del ruolo Cloud Run Builder richiede un paio di minuti per propagarsi.

esegui il deployment della funzione

Per eseguire il deployment di una funzione:

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

   Vai a Cloud Run

2. Fai clic su Scrivi una funzione.

3. Nel campo Nome servizio, inserisci un nome del servizio per descrivere la funzione, ad esempio my-nodejs-http-function. I nomi dei servizi devono iniziare solo con una lettera e contenere un massimo di 49 caratteri, tra cui lettere, numeri o trattini. I nomi dei servizi non possono terminare con trattini e devono essere univoci per regione e progetto. Il nome del servizio non può essere modificato in seguito ed è visibile pubblicamente.

4. Nell'elenco Regione, utilizza il valore predefinito europe-west1, o seleziona la regione in cui vuoi eseguire il deployment della funzione.

5. Nell'elenco Runtime , utilizza il valore predefinito o seleziona una versione del runtime.

6. Nella sezione Autenticazione, seleziona Consenti accesso pubblico. Se non hai le autorizzazioni (ruolo Amministratore di Cloud Run) per selezionare questa opzione, il servizio verrà sottoposto a deployment e richiederà l'autenticazione.

7. Fai clic su Crea e attendi che Cloud Run crei il servizio utilizzando una revisione segnaposto. La console ti reindirizzerà alla scheda Origine , dove potrai visualizzare il codice sorgente della funzione.

8. Nella scheda Origine, fai clic su Salva ed esegui di nuovo il deployment. (Facoltativo) Fai clic su Mostra payload per visualizzare l'oggetto della richiesta in entrata.

9. Dopo il deployment, l'URL del container viene visualizzato accanto al testo URL:. Per visualizzare l'output della funzione, fai clic su Copia negli appunti per copiare il relativo URL e incollalo nella barra degli indirizzi del browser.

   **Operazione riuscita:** hai eseguito il deployment di una funzione Cloud Run HTTP utilizzando la Google Cloud console.

Località Cloud Run

Cloud Run è regionale, il che significa che l'infrastruttura che esegue i servizi Cloud Run si trova in una regione specifica ed è gestita da Google per essere disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Il rispetto dei requisiti di latenza, disponibilità o durabilità è un fattore fondamentale per la selezione della regione in cui vengono eseguiti i servizi Cloud Run. In genere puoi selezionare la regione più vicina ai tuoi utenti, ma devi considerare la posizione degli altri Google Cloud prodotti utilizzati dal tuo servizio Cloud Run. L'utilizzo di Google Cloud prodotti insieme in più località può influire sulla latenza e sul costo del servizio.

Cloud Run è disponibile nelle seguenti regioni:

Soggetto ai prezzi di Livello 1

• asia-east1 (Taiwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• asia-south1 (Mumbai, India)
• asia-southeast3 (Bangkok)
• europe-north1 (Finlandia) Bassi livelli di CO₂
• europe-north2 (Stoccolma) Bassi livelli di CO₂
• europe-southwest1 (Madrid) Bassi livelli di CO₂
• europe-west1 (Belgio) Bassi livelli di CO₂
• europe-west4 (Paesi Bassi) Bassi livelli di CO₂
• europe-west8 (Milano)
• europe-west9 (Parigi) Bassi livelli di CO₂
• me-west1 (Tel Aviv)
• northamerica-south1 (Messico)
• us-central1 (Iowa) Bassi livelli di CO₂
• us-east1 (Carolina del Sud)
• us-east4 (Virginia del Nord)
• us-east5 (Columbus)
• us-south1 (Dallas) Bassi livelli di CO₂
• us-west1 (Oregon) Bassi livelli di CO₂

Soggetto ai prezzi di Livello 2

• africa-south1 (Johannesburg)
• asia-east2 (Hong Kong)
• asia-northeast3 (Seul, Corea del Sud)
• asia-southeast1 (Singapore)
• asia-southeast2 (Giacarta)
• asia-south2 (Delhi, India)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Varsavia, Polonia)
• europe-west10 (Berlino)
• europe-west12 (Torino)
• europe-west2 (Londra, Regno Unito) Bassi livelli di CO₂
• europe-west3 (Francoforte, Germania)
• europe-west6 (Zurigo, Svizzera) Bassi livelli di CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) Bassi livelli di CO₂
• northamerica-northeast2 (Toronto) Bassi livelli di CO₂
• southamerica-east1 (San Paolo, Brasile) Bassi livelli di CO₂
• southamerica-west1 (Santiago, Cile) Bassi livelli di CO₂
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Se hai già creato un servizio Cloud Run, puoi visualizzare la regione nella dashboard di Cloud Run nella Google Cloud console.

Ok

Libera spazio

Per evitare addebiti aggiuntivi al tuo Google Cloud account, elimina tutte le risorse di cui hai eseguito il deployment con questa guida rapida.

Elimina il repository

Cloud Run non addebita costi quando il servizio di cui hai eseguito il deployment non è in uso. Tuttavia, potresti comunque ricevere addebiti per l'archiviazione dell'immagine container in Artifact Registry. Per eliminare i repository Artifact Registry, segui i passaggi descritti in Eliminare i repository nella documentazione di Artifact Registry.

Elimina il servizio

I servizi Cloud Run non comportano costi finché non ricevono richieste. Per eliminare il servizio Cloud Run, segui una di queste procedure:

Console

Per eliminare un servizio:

1. Nella Google Cloud console, vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Individua il servizio che vuoi eliminare nell'elenco dei servizi e fai clic sulla relativa casella di controllo per selezionarlo.

3. Fai clic su Elimina. Verranno eliminate tutte le revisioni del servizio.

gcloud

Per eliminare un servizio, esegui questo comando:

gcloud run services delete SERVICE --region REGION

Sostituisci quanto segue:

• SERVICE: nome del servizio.
• REGION: Google Cloud regione del servizio.

Elimina il progetto di test

L'eliminazione del progetto interrompe la fatturazione per tutte le risorse del progetto. Google Cloud Per rilasciare tutte le Google Cloud risorse del progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:
• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un appspot.com URL, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.
1. Nella Google Cloud console, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Per eseguire il deployment di una funzione di esempio in Cloud Run utilizzando Google Cloud CLI, consulta Guida rapida: esegui il deployment di una funzione in Cloud Run utilizzando gcloud CLI.

• Per eseguire il deployment delle funzioni utilizzando la Google Cloud console e Google Cloud CLI, consulta Esegui il deployment delle funzioni.

• Per visualizzare ed eliminare le funzioni esistenti, consulta Gestisci le revisioni dei servizi.

• Per creare container di funzioni nella tua toolchain ed eseguirne il deployment in Cloud Run, consulta Crea funzioni.

• Per creare trigger con Eventarc, consulta Crea trigger con Eventarc.