Descrizioni degli insiemi (servizi)

Questa pagina mostra come impostare una descrizione personalizzata sui servizi Cloud Run. Una descrizione è un testo facoltativo leggibile che viene associato al servizio. Una descrizione è limitata a 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 dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il servizio Cloud Run interagisce con le API Google Cloud, come le librerie client di Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci 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 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 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.

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"

  deletion_protection = false # set to "true" in production

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

}