Guida rapida: deployment di un servizio Go in Cloud Run

Scopri come creare una semplice applicazione Hello World e pacchettizzarla in un'immagine container, caricare l'immagine container in Artifact Registry e poi eseguire il deployment dell'immagine container in Cloud Run.

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

  1. Accedi al tuo account Google Cloud. 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Installa Google Cloud CLI.

  5. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    6.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  8. Installa Google Cloud CLI.

  9. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    10.

  10. Per impostare il progetto predefinito per il servizio Cloud Run: 
     gcloud config set project PROJECT_ID
    Sostituisci PROJECT_ID con il nome del progetto che hai creato per questa guida rapida.

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

  12. Individua l'account di servizio predefinito di Compute Engine. Per impostazione predefinita, l'account di servizio predefinito di Compute Engine viene creato automaticamente con il seguente formato email:

    PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Sostituisci PROJECT_NUMBER con il tuo Google Cloud del progetto. Puoi trovare il numero del tuo progetto nella Ti diamo il benvenuto della console Google Cloud o eseguendo questo comando:

    gcloud projects describe PROJECT_ID --format='value(projectNumber)'

    Per gli ambienti di produzione, consigliamo vivamente creazione di un nuovo account di servizio e la concessione di uno o più ruoli IAM contenenti autorizzazioni minime richieste e seguire il principio del privilegio minimo.

  13. Affinché Cloud Build sia in grado di creare le tue origini, concedi il 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

scrivi l'applicazione di esempio

Per scrivere un'applicazione in Go:

  1. Crea una nuova directory denominata helloworld e cambiala in Questo:

    mkdir helloworld
cd helloworld

  2. Inizializza un file go.mod per dichiarare il modulo go:

    module github.com/GoogleCloudPlatform/golang-samples/run/helloworld

go 1.19

    Puoi creare il file go.mod direttamente nel formato mostrato sopra oppure puoi inizializzarlo dalla directory del progetto con:

    go mod init github.com/GoogleCloudPlatform/golang-samples/run/helloworld

  3. Crea un nuovo file denominato main.go e incolla il seguente codice Questo:

    
// Sample run-helloworld is a minimal Cloud Run service.
package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	log.Print("starting server...")
	http.HandleFunc("/", handler)

	// Determine port for HTTP service.
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
		log.Printf("defaulting to port %s", port)
	}

	// Start HTTP server.
	log.Printf("listening on port %s", port)
	if err := http.ListenAndServe(":"+port, nil); err != nil {
		log.Fatal(err)
	}
}

func handler(w http.ResponseWriter, r *http.Request) {
	name := os.Getenv("NAME")
	if name == "" {
		name = "World"
	}
	fmt.Fprintf(w, "Hello %s!\n", name)
}

    Questo codice crea un server web di base in ascolto sulla porta definita la variabile di ambiente PORT.

L'app è stata completata ed è pronta per il deployment.

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, fai riferimento al 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:

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

    1. Quando ti viene richiesta la posizione del codice sorgente, premi Invio per eseguire il deployment della cartella attuale.

    2. Quando ti viene richiesto il nome del servizio, premi Invio per accettare nome predefinito, ad esempio helloworld.

    3. Se ti viene richiesto di abilitare l'API Artifact Registry o di consentire la creazione di un repository Artifact Registry, rispondi premendo y.

    4. Quando ti viene richiesta la regione, seleziona la regione di tua scelta, ad esempio us-central1.

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

  2. 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 affinché 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

Soggetto ai prezzi di Livello 2

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

  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 del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Per saperne di più sulla creazione di un container dall'origine di codice e sul push a un repository, consulta: