Esegui il deployment di un'app Cloud Run utilizzando Cloud Shell

Esegui il deployment di un'app Cloud Run utilizzando Cloud Shell

Per iniziare a utilizzare Cloud Run, puoi eseguire il deployment di un'applicazione Hello World di esempio e ispezionare le risorse del servizio in tempo reale. In questa guida rapida, utilizzerai Cloud Shell per configurare un servizio Cloud Run e visualizzarne i log.

Prima di iniziare

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

2. Verify that billing is enabled for your Google Cloud project.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire il deployment di un'app Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Cloud Run Admin (roles/run.admin)
• Cloud Run Source Developer (roles/run.sourceDeveloper)
• Utente Service Account (roles/iam.serviceAccountUser)
• Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin)
• Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Visualizzatore log (roles/logging.viewer)

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 non esegui l'override di questo comportamento.

Per consentire a Cloud Build di creare le tue origini, concedi al service account Cloud Build 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 l'ID progetto Google Cloude SERVICE_ACCOUNT_EMAIL_ADDRESS con l'indirizzo email del account di servizio Cloud Build. Se utilizzi il account di servizio predefinito di Compute Engine come account di servizio Cloud Build, utilizza il seguente formato per l'indirizzo email del account di servizio:

PROJECT_NUMBER-compute@

Sostituisci PROJECT_NUMBER con il tuo numero di progetto Google Cloud.

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

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

Crea un'applicazione

1. Avvia l'editor di Cloud Shell.
2. Nella barra di stato di Cloud Code, seleziona Nuova applicazione.
3. Scegli Applicazione Cloud Run come tipo di applicazione preferito.

4. Dall'elenco delle applicazioni di esempio (Node.js, Python con framework Flask e Django, Java, Go), scegli un'app Hello World.

   Ad esempio, se scegli Python (Flask): Hello World, viene creata un'app Hello World Python (Flask) di base.

5. Seleziona una cartella per il percorso della tua applicazione e fai clic su Crea nuova applicazione.

   L'editor di Cloud Shell carica l'applicazione in un nuovo workspace. Una volta caricato il workspace, l'app è accessibile nella visualizzazione Explorer.

Esegui il deployment in Cloud Run

Per eseguire il deployment dell'applicazione in Cloud Run, segui questi passaggi:

1. Apri la tavolozza dei comandi (premi Ctrl/Cmd+Shift+P o fai clic su Visualizza > Tavolozza comandi) e poi esegui il comando Esegui il deployment in Cloud Run. Viene visualizzata la UI di deployment di Cloud Run.
2. Se richiesto, autorizza Cloud Code a effettuare chiamate API Google Cloud .
3. Configura il progetto Google Cloud .
4. Se richiesto, abilita l'API Cloud Run facendo clic su Abilita API.
5. Nella finestra di dialogo Esegui il deployment in Cloud Run, seleziona un servizio preesistente o creane uno nuovo.
6. Se stai creando un nuovo servizio, scegli Cloud Run (completamente gestito) in Piattaforma di deployment.
7. Scegli una regione in cui eseguire il deployment.
8. Per Autenticazione, seleziona Consenti chiamate non autenticate per rendere pubblico il servizio.

9. Dopo aver definito le impostazioni che preferisci, puoi fare clic su Esegui il deployment.

   Cloud Code crea l'immagine, la invia al registry ed esegue il deployment dell'app su Cloud Run. Il tuo servizio è ora disponibile.

10. Visualizza il servizio in esecuzione seguendo l'URL visualizzato nella finestra di dialogo Cloud Run: Deploy.

Modifica il tuo servizio

Per modificare la tua richiesta, segui questi passaggi:

1. Nella visualizzazione Explorer, trova il file app.py che implementa il comportamento del servizio.
2. Sostituisci il messaggio "It's running!" con un messaggio a tua scelta.
3. Dopo aver apportato questa modifica, scegli il comando Esegui il deployment in Cloud Run utilizzando il riquadro dei comandi.
4. Verifica che il servizio appena creato sia selezionato in Impostazioni servizio.
5. Fai clic su Esegui il deployment.
6. Al termine della creazione e del deployment dell'applicazione, puoi aggiornare il servizio per visualizzare il messaggio aggiornato.

Visualizza i log

Puoi anche visualizzare i log dell'applicazione di cui hai eseguito il deployment con il visualizzatore log incluso in Cloud Code.

Per visualizzare i log, segui questi passaggi:

1. Fai clic su Cloud Code ed espandi la sezione Cloud Run.

2. Fai clic con il tasto destro del mouse sul servizio Cloud Run e poi su Visualizza log.

3. Aggiorna l'app nel browser e visualizza i nuovi log generati facendo clic sul pulsante di aggiornamento dei log.

Esegui la pulizia

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

Per eliminare il progetto:

1. Vai alla pagina Progetti nella console Google Cloud :

   Vai alla pagina Progetti

2. Seleziona il progetto che hai creato per questa guida rapida, quindi fai clic su Elimina.

   In questo modo il progetto viene chiuso e ne viene pianificata l'eliminazione.

Se utilizzi un progetto esistente e vuoi eliminare le risorse che hai creato per questa guida rapida:

• Immagine container: sebbene non siano previsti addebiti per Cloud Run quando un servizio non è in uso, ti potrebbero comunque essere addebitati i costi di archiviazione dell'immagine container in Artifact Registry. Per eliminare l'immagine, apri la pagina Artifact Registry, seleziona il repository che contiene l'immagine, seleziona l'immagine, fai clic su Elimina, quindi su Elimina.

  Apri la pagina Artifact Registry

• Servizio Cloud Run: per eliminare un servizio Cloud Run, nella pagina Cloud Run della consoleGoogle Cloud , seleziona il servizio che vuoi eliminare, fai clic su Elimina e poi su Elimina.

  Apri la pagina Cloud Run

Passaggi successivi

• Scopri la varietà di funzionalità offerte dall'interfaccia dell'editor di Cloud Shell.
• Scopri come configurare Cloud Shell per personalizzare la tua esperienza.