Impostare descrizioni (servizi)

Questa pagina mostra come impostare una descrizione personalizzata in Cloud Run i servizi di machine learning. Una descrizione è un testo facoltativo leggibile allegato al servizio. Una descrizione può contenere un massimo di 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 tuo servizio Cloud Run si interfaccia con Le API Google Cloud, come le librerie client di Cloud, consultano guida alla configurazione dell'identità dei servizi. Per saperne di più sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.

Impostare o modificare una descrizione

Puoi impostare una descrizione per i 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 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, 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"
    }
  }

}