Guida rapida: esegui il deployment su Cloud Run da un repository Git

Guida rapida: esegui il deployment su Cloud Run da un repository Git

Questa pagina mostra come eseguire il deployment continuo da un repository Git a Cloud Run utilizzando Cloud Build.

Puoi eseguire il deployment continuo da un repository utilizzando Cloud Build o Developer Connect.

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

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

4. Abilita l'API Cloud Build, se non è già abilitata.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

   Abilitare l'API

5. Se il tuo progetto è soggetto a una policy dell'organizzazione con limitazione del dominio che limita le chiamate non autenticate, dovrai accedere al servizio di cui hai eseguito il deployment come descritto in Test dei servizi privati.

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

• Cloud Run Source Developer (roles/run.sourceDeveloper) sul servizio
• Cloud Run Admin (roles/run.admin) sul progetto
• Utente dell'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.

Crea un repository da un modello

Per creare un repository:

1. Vai al repository dei modelli:

   Node.js

   Vai a github.com/GoogleCloudPlatform/cloud-run-microservice-template-nodejs

   Python

   Vai alla pagina github.com/GoogleCloudPlatform/cloud-run-microservice-template-python

   Vai

   Vai a github.com/GoogleCloudPlatform/cloud-run-microservice-template-go

   Java

   Vai alla pagina github.com/GoogleCloudPlatform/cloud-run-microservice-template-java

2. Fai clic su Utilizza questo modello.

3. Seleziona Crea un nuovo repository.

4. Nel modulo inserisci un nome repository.

5. Fai clic su Crea repository.

Esegui il deployment dal repository

Per eseguire il deployment dal repository:

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

   Vai a Cloud Run

2. Seleziona Servizi dal menu e fai clic su Connetti repository.

3. Nel modulo, seleziona Cloud Build e fai clic su Configura con Cloud Build.

4. Nel riquadro a destra:

   1. In Repository, seleziona il repository appena creato. Se non hai ancora eseguito l'autenticazione, potrebbe essere necessario farlo. Utilizza il link authenticate nel campo Repository Provider.

   2. Seleziona la casella di conferma relativa a GitHub e all'interattività di Google Cloud .

   3. Fai clic su Avanti.

   4. In Tipo di build, seleziona BuildpackGoogle Cloud .

   5. Fai clic su Salva.

5. Nel modulo Crea servizio:

   1. Conferma il nome del servizio. Verrà compilato automaticamente con il nome del repository.

   2. Nel menu a discesa Regione, seleziona la regione in cui vuoi che si trovi il servizio.

   3. In Autenticazione, seleziona Consenti accesso pubblico. Se non disponi delle autorizzazioni (ruolo Amministratore Cloud Run) per selezionare questa opzione, il servizio verrà sottoposto a deployment e richiederà l'autenticazione.

   4. Fai clic su Crea per eseguire il deployment del repository di esempio in Cloud Run e attendi il completamento del deployment.

6. Fai clic sul link dell'URL visualizzato per eseguire il container di cui è stato eseguito il deployment.

Località di Cloud Run

Cloud Run è regionale, il che significa che l'infrastruttura che esegue i tuoi 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.

La soddisfazione dei requisiti di latenza, disponibilità o durabilità è un fattore principale 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 prodotti Google Cloud utilizzati dal tuo servizio Cloud Run. L'utilizzo di prodotti Google Cloud in sinergia in più località può influire sulla latenza del servizio e sui costi.

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) Bassi livelli di CO₂
• 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) Bassi livelli di CO₂
• europe-west10 (Berlino)
• europe-west12 (Torino) Bassi livelli di CO₂
• europe-west2 (Londra, Regno Unito) Bassi livelli di CO₂
• europe-west3 (Francoforte, Germania)
• europe-west6 (Zurigo, Svizzera) A basse emissioni 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 consoleGoogle Cloud .

Ok

Aggiorna il servizio

Per apportare modifiche al servizio:

1. Esegui il push di un commit nel branch principale del repository.

2. Aggiorna il servizio Cloud Run per visualizzare lo stato dell'aggiornamento.

Operazione riuscita: hai eseguito il deployment di un'immagine container da un repository Git a Cloud Run.

Cloud Run scala automaticamente le istanze container in base alla domanda e paghi solo per la CPU, la memoria e le risorse di rete utilizzate durante l'elaborazione delle richieste.

Esegui la pulizia

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

Elimina il repository

Cloud Run non ti addebita alcun costo quando il servizio di cui hai eseguito il deployment non è in uso. Tuttavia, ti potrebbero comunque essere addebitati i costi di archiviazione dell'immagine container in Artifact Registry. Per eliminare i repository Artifact Registry, segui i passaggi descritti in Elimina 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 uno di questi passaggi:

Console

Per eliminare un servizio:

1. Nella console Google Cloud , 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: il nome del servizio.
• REGION:la regione Google Cloud del servizio.

Elimina il progetto di test

L'eliminazione del progetto Google Cloud interrompe la fatturazione per tutte le risorse al suo interno. Per rilasciare tutte le risorse Google Cloud del progetto, segui questi passaggi:

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 URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.
1. Nella console Google Cloud , 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, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Guida rapida: crea ed esegui il deployment
• Deployment continuo con Cloud Build
• Creazione di container utilizzando i buildpack