Impostare le descrizioni dei servizi

Questa pagina mostra come impostare una descrizione personalizzata per i tuoi servizi Cloud Run. Una descrizione è un testo facoltativo leggibile allegato al servizio. Una descrizione può contenere al massimo 512 caratteri. Se presente, la descrizione viene visualizzata quando visualizzi i dettagli di un servizio utilizzando gcloud run services describe.

Ruoli obbligatori

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

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM Cloud Run e Autorizzazioni IAM Cloud Run. Se il tuo servizio Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Impostare o modificare una descrizione

Puoi impostare una descrizione sui servizi Cloud Run.

gcloud

Puoi impostare o aggiornare la descrizione durante il deployment:

gcloud run deploy SERVICE --description DESCRIPTION

Sostituisci

  • SERVICE con il nome del tuo servizio Cloud Run
  • DESCRIPTION con la descrizione del servizio

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. Aggiorna l'annotazione run.googleapis.com/description:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
    run.googleapis.com/description: "DESCRIPTION"
spec:
  template:
    ...

    Sostituisci

    • SERVICE con il nome del tuo servizio Cloud Run
    • DESCRIPTION con la descrizione del servizio

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

    gcloud run services replace service.yaml

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-description"
  location = "us-central1"

  description = "This service has a custom description"

  deletion_protection = false # set to "true" in production

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

}

Sostituisci la descrizione con il valore che preferisci.