Guida rapida: deployment di un servizio shell in Cloud Run

Esegui il deployment di un servizio shell in Cloud Run

Scopri come creare una semplice applicazione Hello World, pacchettizzarla in un'immagine container, caricare l'immagine container su Artifact Registry, quindi eseguire il deployment dell'immagine container in Cloud Run. Puoi usare altre lingue oltre a quelle mostrate.

Prima di iniziare

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

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.

  5. To initialize the gcloud CLI, run the following command: 

    gcloud init

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

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init

  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 con limitazioni di dominio 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.

scrivi l'applicazione di esempio

Per scrivere un'applicazione Shell:

  1. Crea una nuova directory denominata helloworld-shell e modificala al suo interno:

    mkdir helloworld-shell
cd helloworld-shell

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

    helloworld-shell/go.mod 
    module github.com/GoogleCloudPlatform/cloud-run-samples/helloworld-shell

go 1.19

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

    go mod init

  3. Crea un file script.sh con il seguente contenuto:

    helloworld-shell/script.sh 
    
set -e
echo "Hello ${NAME:-World}!"

    Per eseguire questo script shell su ogni richiesta in entrata, questo esempio utilizza un piccolo programma Go che avvia un server web di base e rimane in ascolto sulla porta definita dalla variabile di ambiente PORT.

  4. Crea un file invoke.go con il seguente contenuto:

    helloworld-shell/invoke.go 
    
// Sample helloworld-shell is a Cloud Run shell-script-as-a-service.
package main

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

func main() {
	http.HandleFunc("/", scriptHandler)

	// 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 scriptHandler(w http.ResponseWriter, r *http.Request) {
	cmd := exec.CommandContext(r.Context(), "/bin/bash", "script.sh")
	cmd.Stderr = os.Stderr
	out, err := cmd.Output()
	if err != nil {
		w.WriteHeader(500)
	}
	w.Write(out)
}

  5. Crea un nuovo file denominato Dockerfile nella stessa directory dei file di origine:

    helloworld-shell/Dockerfile 
    
# Use the offical golang image to create a binary.
# This is based on Debian and sets the GOPATH to /go.
# https://hub.docker.com/_/golang
FROM golang:1.20-buster as builder

# Create and change to the app directory.
WORKDIR /app

# Retrieve application dependencies.
# This allows the container build to reuse cached dependencies.
# Expecting to copy go.mod and if present go.sum.
COPY go.* ./
RUN go mod download

# Copy local code to the container image.
COPY invoke.go ./

# Build the binary.
RUN go build -mod=readonly -v -o server

# Use the official Debian slim image for a lean production container.
# https://hub.docker.com/_/debian
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM debian:buster-slim
RUN set -x && apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    --no-install-recommends \
    ca-certificates && \
    rm -rf /var/lib/apt/lists/*

# Create and change to the app directory.
WORKDIR /

# Copy the binary to the production image from the builder stage.
COPY --from=builder /app/server /app/server
COPY script.sh ./

# Run the web service on container startup.
CMD ["/app/server"]

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

Esegui il deployment su 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 Autorizzazioni per il deployment di Cloud Run, Autorizzazioni Cloud Build e Autorizzazioni di Artifact Registry per conoscere le autorizzazioni necessarie.

Il deployment dal codice sorgente 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 dal codice sorgente utilizzando questo comando:

    gcloud run deploy

    Se ti viene richiesto di abilitare l'API, rispondi y per abilitarla.

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

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

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

    4. Quando ti viene chiesto di specificare la regione: seleziona l'area geografica di tua scelta, ad esempio us-central1.

    5. Ti verrà chiesto di consentire le chiamate non autenticate: rispondi y .

    Quindi, attendi qualche istante fino al completamento del deployment. In caso di esito positivo, la riga di comando visualizza l'URL del servizio.

  2. Per visitare il servizio di cui hai eseguito il deployment, apri l'URL del servizio in un browser web.

Località di Cloud Run

Cloud Run è a livello di regione, 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.

Soddisfare i requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare la regione in cui vengono eseguiti i servizi Cloud Run. In genere, puoi selezionare la regione più vicina ai tuoi utenti, ma ti consigliamo di prendere in considerazione la località degli altri prodotti Google Cloud utilizzati dal servizio Cloud Run. L'utilizzo dei prodotti Google Cloud insieme in più località può influire sulla latenza e sui costi del tuo servizio.

Cloud Run è disponibile nelle seguenti regioni:

Soggetto ai prezzi di Livello 1

Soggetto ai prezzi di Livello 2

  • 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)
  • europe-west12 (Torino)
  • europe-west2 (Londra, Regno Unito) icona foglia A basse emissioni di CO2
  • europe-west3 (Francoforte, Germania) icona foglia A basse emissioni di CO2
  • europe-west6 (Zurigo, Svizzera) icona foglia A basse emissioni di CO2
  • me-central1 (Doha)
  • me-central2 (Dammam)
  • northamerica-northeast1 (Montreal) icona foglia A basse emissioni di CO2
  • northamerica-northeast2 (Toronto) icona foglia A basse emissioni di CO2
  • southamerica-east1 (San Paolo, Brasile) icona foglia A basse emissioni di CO2
  • southamerica-west1 (Santiago, Cile) icona foglia A basse emissioni di CO2
  • 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 console Google Cloud.

Complimenti! Hai appena eseguito il deployment di un'immagine container dal codice sorgente a Cloud Run. Cloud Run esegue lo scale out automatico e orizzontale dell'immagine container per gestire le richieste ricevute, per poi fare 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 addebiti i costi quando il servizio non è in uso, è possibile che ti vengano comunque addebitati l'archiviazione dell'immagine container in Artifact Registry. Puoi eliminare l'immagine container o 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. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. 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 da un codice sorgente di codice e sul push a un repository, consulta: