Impostare descrizioni (servizi)

Questa pagina mostra come impostare una descrizione personalizzata per i servizi Cloud Run. Una descrizione è un testo facoltativo leggibile allegato al servizio. Una descrizione può contenere un massimo di 512 caratteri. Se presente, la descrizione viene mostrata quando vengono visualizzati 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 dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Impostare o modificare una descrizione

Puoi impostare una descrizione per i servizi Cloud Run.

Riga di comando

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 comando seguente:

    gcloud run services replace service.yaml

Terraform

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

La seguente risorsa google_cloud_run_v2_service specifica una descrizione. Sostituisci la descrizione con il valore che preferisci.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-description"
  location = "us-central1"

  description = "This service has a custom description"

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

}