Seleziona un ambiente di esecuzione per i servizi

Tutte le istanze Cloud Run sono in modalità sandbox. La tecnologia di sandboxing e le funzionalità disponibili variano a seconda dell'ambiente di esecuzione selezionato.

L'ambiente di esecuzione di prima generazione si basa su gVisor e offre tempi di avvio a freddo rapidi ed emulazione della maggior parte delle chiamate del sistema operativo, ma non di tutte.

L'ambiente di esecuzione di seconda generazione è una microVM e fornisce la compatibilità Linux completa anziché l'emulazione delle chiamate di sistema. Questo ambiente di esecuzione fornisce:

  • Prestazioni della CPU più rapide
  • Prestazioni di rete più rapide, soprattutto in presenza di perdita di pacchetti
  • Compatibilità Linux completa, incluso il supporto per tutte le chiamate di sistema, gli spazi dei nomi e i cgroup
  • Supporto del file system di rete

Sebbene l'ambiente di esecuzione di seconda generazione sia generalmente più veloce in condizioni di carico sostenuto, per alcuni servizi i tempi di avvio a freddo sono più lunghi rispetto alla prima generazione.

Entrambi gli ambienti di esecuzione hanno lo stesso prezzo. Per i dettagli, consulta la pagina dei prezzi di Cloud Run.

Selezione di un ambiente di esecuzione per un servizio Cloud Run

Per impostazione predefinita, i servizi Cloud Run non hanno un ambiente di esecuzione specificato, il che significa che Cloud Run seleziona l'ambiente di esecuzione in base alle funzionalità utilizzate. Se non specifichi un ambiente di esecuzione per il tuo servizio, Cloud Run può selezionare l'ambiente di prima o di seconda generazione.

I job e i pool di worker Cloud Run utilizzano solo l'ambiente di esecuzione di seconda generazione, che non può essere modificato.

Come scegliere un ambiente di esecuzione

Dovresti utilizzare la prima generazione se si applica una delle seguenti condizioni:

  • Il tuo servizio Cloud Run ha un traffico con picchi improvvisi e deve fare lo scale out rapidamente su molte istanze oppure il tuo servizio è sensibile ai tempi di avvio a freddo.
  • Il tuo servizio Cloud Run ha un traffico poco frequente che causa frequenti scale out da zero.
  • Vuoi utilizzare meno di 512 MiB di memoria. L'ambiente di esecuzione di seconda generazione richiede almeno 512 MiB di memoria.

Devi utilizzare la seconda generazione se una delle seguenti condizioni si applica al tuo servizio Cloud Run:

  • Il tuo servizio deve utilizzare NFS, che è supportato solo dalla seconda generazione.
  • Il tuo servizio ha un traffico abbastanza costante e tollera avvii completi un po' più lenti.
  • Il tuo servizio ha workload ad alta intensità di CPU.
  • Il tuo servizio potrebbe trarre vantaggio da prestazioni di rete più rapide.
  • Il tuo servizio utilizza il traffico VPC diretto in uscita per inviare traffico a una rete VPC e richiede le migliori prestazioni di rete possibili.
  • Il tuo servizio deve utilizzare un software che presenta problemi di esecuzione nella prima generazione a causa di chiamate di sistema non implementate.
  • Il tuo servizio richiede la funzionalità cgroup di Linux.
  • Il tuo servizio utilizza un'infrastruttura di terze parti per proteggere i container.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment di servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Se esegui il deployment di un servizio o di una funzione dal codice sorgente, devi disporre anche di ruoli aggiuntivi concessi al tuo progetto e al account di servizio Cloud Build.

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APICloud de Confiance , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Imposta e aggiorna l'ambiente di esecuzione

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che non vengano apportati aggiornamenti espliciti per modificarla.

L'impostazione predefinita per i servizi Cloud Run è non specificato, il che significa che Cloud Run seleziona un ambiente di esecuzione adatto. In alternativa, puoi specificare un ambiente di esecuzione. Per utilizzare la seconda generazione, devi specificare almeno 512 MiB di memoria.

Puoi impostare l'ambiente di esecuzione utilizzando la console Cloud de Confiance , la riga di comando gcloud o un file YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:

Console

  1. Nella console Cloud de Confiance , vai alla pagina Cloud Run:

    Vai a Cloud Run

  2. Seleziona Servizi dal menu di navigazione di Cloud Run:

    1. Se stai configurando un nuovo servizio, fai clic su Esegui il deployment del container e compila la pagina delle impostazioni iniziali del servizio. Quindi fai clic su Container, networking, sicurezza per espandere la pagina di configurazione del servizio.

    2. Se stai configurando un servizio esistente, fai clic sul servizio.

  3. Fai clic sulla scheda Container.

  4. Seleziona l'ambiente di esecuzione utilizzando i pulsanti di opzione. Mantieni Predefinito per consentire a Cloud Run di selezionare un ambiente di esecuzione adatto.

  5. Fai clic su Crea per un nuovo servizio. Fai clic su Visualizza differenze e fai di nuovo il deployment, quindi su Esegui il deployment delle modifiche per un servizio esistente.

gcloud

Puoi aggiornare l'ambiente di esecuzione per un determinato servizio utilizzando il seguente comando:

gcloud run services update SERVICE --execution-environment ENVIRONMENT

Sostituisci SERVICE con il nome del tuo servizio e ENVIRONMENT con l'ambiente di esecuzione desiderato. Specifica il valore gen1 per la prima generazione o gen2 per la seconda generazione.

Puoi anche impostare l'ambiente di esecuzione durante il deployment utilizzando il comando:

gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT

Sostituisci quanto segue:

  • IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
  • ENVIRONMENT: l'ambiente di esecuzione desiderato. Specifica il valore gen1 per la prima generazione o gen2 per la seconda generazione.

YAML

  1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Imposta l'annotazione run.googleapis.com/execution-environment:

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          annotations:
            run.googleapis.com/execution-environment: ENVIRONMENT

    Sostituisci quanto segue:

    • SERVICE: il nome del servizio Cloud Run.
    • ENVIRONMENT: l'ambiente di esecuzione selezionato. Specifica il valore gen1 per la prima generazione o gen2 per la seconda generazione.

    Rimuovi l'annotazione run.googleapis.com/execution-environment per il comportamento predefinito.

  3. Crea o aggiorna il servizio utilizzando il seguente comando:

    gcloud run services replace service.yaml

    Per impostazione predefinita, il comando gcloud run services replace utilizza il file service.yaml, se presente.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi quanto segue a una risorsa google_cloud_run_v2_service nella configurazione Terraform:
resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-execution-environment"
  location = "REGION"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    execution_environment = "ENVIRONMENT"
  }
}

Sostituisci quanto segue:

  • REGION: la regione Cloud de Confiance . Ad esempio europe-west1.
  • ENVIRONMENT: EXECUTION_ENVIRONMENT_GEN1 per la prima generazione o EXECUTION_ENVIRONMENT_GEN2 per la seconda generazione.

Visualizza le impostazioni dell'ambiente di esecuzione

Per visualizzare le impostazioni attuali dell'ambiente di esecuzione per il tuo servizio Cloud Run:

Console

  1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

    Vai a Cloud Run

  2. Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.

  3. Fai clic sulla scheda Container per visualizzare le impostazioni.

gcloud

  1. Utilizza il seguente comando:

    gcloud run services describe SERVICE
  2. Individua l'impostazione dell'ambiente di esecuzione nella configurazione restituita.

Arresti normali

Quando un'istanza Cloud Run viene arrestata, riceve un segnale SIGTERM per abilitare un arresto normale di 10 secondi.

Gestione del segnale SIGTERM

Ti consigliamo di installare un gestore SIGTERM nel container, soprattutto se utilizzi la fatturazione basata sulle richieste.

La gestione di SIGTERM offre al container la possibilità di eseguire le attività di pulizia necessarie, ad esempio lo svuotamento dei log, prima di uscire. Se il container non intercetta SIGTERM, avrà comunque 10 secondi per eseguire queste attività; questi 10 secondi vengono fatturati.

Come verificare se il container gestisce SIGTERM

Per determinare se nel container è installato un gestore SIGTERM:

  1. Avvia Cloud Shell. Puoi trovare Pulsante Attiva Cloud Run Attiva Cloud Shell nell'intestazione della pagina della documentazione in cui ti trovi. Potresti doverlo autorizzare e attendere il provisioning. In alternativa, avvia una sessione autonoma.

  2. Esegui il container localmente in Cloud Shell:

    docker run IMAGE_URL

    Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .

  3. Apri un'altra scheda in Cloud Shell e visualizza un elenco dei container in esecuzione nella sessione Cloud Shell corrente:

    docker container ls

    Devi individuare l'ID container restituito dal comando.

  4. Utilizzando l'ID container, invia un segnale SIGTERM al container

    docker kill -s SIGTERM CONTAINER_ID
  5. Torna alla scheda in cui hai richiamato docker run per verificare se il container è stato chiuso (interrotto). Se il segnale SIGTERM ha causato l'uscita del container, significa che il container sta gestendo SIGTERM.

Come gestire SIGTERM

Se il tuo container non gestisce SIGTERM, il modo più semplice per aggiungere un gestore SIGTERM è eseguire il wrapping del servizio con tini. In questo modo, il servizio viene eseguito come sottoprocesso di tini, che assume il ruolo del processo di inizializzazione del container. Consulta le istruzioni di Docker per le istruzioni.

In alternativa, puoi modificare l'applicazione in modo che gestisca direttamente SIGTERM.

Passaggi successivi