Guida rapida: deployment di un servizio in Cloud Run
Scopri come creare una semplice applicazione Hello World e pacchettizzarla in un'immagine container, caricare l'immagine container in Artifact Registry eseguire il deployment dell'immagine container in Cloud Run.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Per impostare il progetto predefinito per il servizio Cloud Run:
Sostituisci PROJECT_ID con il nome del progetto che hai creato per questa guida rapida.gcloud config set project PROJECT_ID
Se ti trovi in un criterio dell'organizzazione che limita le chiamate non autenticate per il tuo progetto, dovrai accedere al servizio di cui hai eseguito il deployment come descritto in Test dei servizi privati.
Abilita l'API Cloud Run Admin:
gcloud services enable run.googleapis.com
Dopo aver abilitato l'API Cloud Run Admin, l'account di servizio predefinito di Compute Engine viene creato automaticamente.
- Affinché Cloud Build sia in grado di creare le tue origini, concedi il parametro
Account di servizio Cloud Build
all'account di servizio predefinito di Compute Engine eseguendo questo comando:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \ --role=roles/cloudbuild.builds.builder
Sostituisci
PROJECT_NUMBER
con il tuo Google Cloud il numero del progetto ePROJECT_ID
con il tuo Google Cloud dell'ID progetto.Puoi trovare sia il numero di progetto sia l'ID progetto nella Ti diamo il benvenuto della console Google Cloud.
scrivi l'applicazione di esempio
Cloud Run supporta la maggior parte dei linguaggi. Vengono forniti esempi per seguenti lingue:
Tuttavia, in tutti questi esempi, ignora ed ometti il materiale su
service.yaml
e Docker Hub, perché Cloud Run non li utilizza.
Crea un nuovo file denominato Dockerfile
nella stessa directory dell'origine
. Cloud Run supporta la maggior parte dei linguaggi. Per i Dockerfile di esempio in
lingue elencate sopra, consulta le seguenti risorse:
Tuttavia, in questi campioni, ignora e ometti il materiale su service.yaml
e
Docker Hub, perché Cloud Run non li utilizza.
Esegui il deployment in Cloud Run dall'origine
Importante: questa guida rapida presuppone che tu disponga dei ruoli di proprietario o editor nel progetto che stai utilizzando per la guida rapida. In caso contrario, consulta il ruolo Sviluppatore origine Cloud Run per le autorizzazioni richieste per il deployment di una risorsa Cloud Run dall'origine.
Il deployment dall'origine crea automaticamente un'immagine container dal codice sorgente e ne esegue il deployment.
Per eseguire il deployment dall'origine:
Nella directory del codice sorgente, esegui il deployment dall'origine utilizzando il seguente comando:
gcloud run deploy
Se ti viene richiesto di abilitare l'API, rispondi y per abilitarla.
Quando ti viene richiesta la posizione del codice sorgente, premi Invio per eseguire il deployment della cartella attuale.
Quando ti viene richiesto il nome del servizio, premi Invio per accettare nome predefinito, ad esempio
helloworld
.Se ti viene richiesto di abilitare le API nel progetto, ad esempio l'API Artifact Registry, rispondi premendo
y
.Quando ti viene richiesta la regione, seleziona la regione di tua scelta, ad esempio
us-central1
.Se ti viene chiesto di creare un repository nella regione specificata, rispondi premendo
y
.Se ti viene chiesto di consentire le chiamate non autenticate: rispondi
y
. Potresti non visualizzare questo prompt se è presente un dominio un criterio dell'organizzazione che impedisce l'accesso; per ulteriori dettagli, consulta Sezione Prima di iniziare.
Quindi, attendi qualche istante fino al completamento del deployment. Una volta raggiunto il successo, nella riga di comando visualizza l'URL del servizio.
Visita il servizio di cui hai eseguito il deployment aprendo l'URL del servizio in un browser web.
Località Cloud Run
Cloud Run è regionale, il che significa che l'infrastruttura
dei tuoi servizi Cloud Run si trova in una regione specifica
gestiti da Google in modo che siano disponibili in modo ridondante
tutte le zone all'interno di quella regione.
Soddisfare i requisiti di latenza, disponibilità o durabilità è fondamentale
i fattori necessari per selezionare la regione in cui vengono eseguiti i servizi Cloud Run.
Generalmente puoi selezionare la regione più vicina ai tuoi utenti, ma devi considerare
la località dell'altro account Google Cloud
prodotti utilizzati dal tuo servizio Cloud Run.
L'utilizzo combinato dei prodotti Google Cloud in più località può influire
nonché la latenza del tuo servizio.
Cloud Run è disponibile nelle regioni seguenti:
Soggetto ai prezzi di Livello 1
asia-east1
(Taiwan)asia-northeast1
(Tokyo)asia-northeast2
(Osaka)europe-north1
(Finlandia) A basse emissioni di CO2europe-southwest1
(Madrid) A basse emissioni di CO2europe-west1
(Belgio) A basse emissioni di CO2europe-west4
(Paesi Bassi) A basse emissioni di CO2europe-west8
(Milano)europe-west9
(Parigi) A basse emissioni di CO2me-west1
(Tel Aviv)us-central1
(Iowa) A basse emissioni di CO2us-east1
(Carolina del Sud)us-east4
(Virginia del Nord)us-east5
(Colombo)us-south1
(Dallas) A basse emissioni di CO2us-west1
(Oregon) A basse emissioni di CO2
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-south1
(Mumbai, India)asia-south2
(Delhi, India)australia-southeast1
(Sydney)australia-southeast2
(Melbourne)europe-central2
(Varsavia, Polonia)europe-west10
(Berlino) A basse emissioni di CO2europe-west12
(Torino)europe-west2
(Londra, Regno Unito) A basse emissioni di CO2europe-west3
(Francoforte, Germania) A basse emissioni di CO2europe-west6
(Zurigo, Svizzera) A basse emissioni di CO2me-central1
(Doha)me-central2
(Dammam)northamerica-northeast1
(Montreal) A basse emissioni di CO2northamerica-northeast2
(Toronto) A basse emissioni di CO2southamerica-east1
(San Paolo, Brasile) A basse emissioni di CO2southamerica-west1
(Santiago, Cile) A basse emissioni di CO2us-west2
(Los Angeles)us-west3
(Salt Lake City)us-west4
(Las Vegas)
Se hai già creato un servizio Cloud Run, puoi visualizzare nella dashboard di Cloud Run all'interno Console Google Cloud.
Complimenti! Hai appena eseguito il deployment di un'immagine container dal codice sorgente a Cloud Run. Cloud Run automaticamente e orizzontalmente fa lo scale out dell'immagine container per gestire le richieste ricevute, poi esegue lo scale in quando la domanda diminuisce. Paghi solo per la CPU, la memoria e il networking utilizzati durante la gestione delle richieste.
Esegui la pulizia
Rimuovi il progetto di test
Sebbene Cloud Run non effettui addebiti quando il servizio non è in uso, potrebbe essere ancora addebitato per l'archiviazione dell'immagine container in Artifact Registry. Puoi eliminare l'immagine container o eliminare il tuo progetto Google Cloud per evitare addebiti. L'eliminazione del progetto Google Cloud interrompe la fatturazione per tutte le risorse utilizzate all'interno del progetto.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Passaggi successivi
Per saperne di più sulla creazione di un container dall'origine di codice e sul push a un repository, consulta: