Guida rapida: crea un'istanza Cloud Run

Questa pagina mostra come utilizzare Cloud Run per creare un'istanza Cloud Run in un container di esempio, visualizzarne i log e gestirne il ciclo di vita utilizzando gcloud CLI.

Prima di iniziare

  1. Installa Google Cloud CLI.

  2. Configura gcloud CLI per utilizzare la tua identità federata.

    Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.

  3. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  4. Crea o seleziona un Google Cloud progetto.

    Ruoli richiesti per selezionare o creare un progetto

    • Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

    • Crea un Google Cloud progetto:

      gcloud projects create PROJECT_ID

      Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

    • Seleziona il Google Cloud progetto che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

  5. Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

  6. Verifica che la fatturazione sia attivata per il tuo Google Cloud progetto.

  7. Abilita l'API Cloud Run Admin e le API Cloud Logging:

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli. 

    gcloud services enable run.googleapis.com logging.googleapis.com
  8. Per impostare il progetto predefinito per l'istanza Cloud Run: 
    gcloud config set project PROJECT_ID
     Sostituisci PROJECT_ID con il nome del progetto che hai creato per questa guida rapida.
  9. Assicurati di aver installato il componente gcloud beta: 
    gcloud components install beta
  10. Esamina i prezzi di Cloud Run o stima i costi con il Calcolatore prezzi.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un'istanza

Per creare un'istanza Cloud Run in un container di esempio utilizzando gcloud CLI:

  1. Esegui questo comando:

    gcloud beta run instances create my-instance \
--image us-docker.pkg.dev/cloudrun/container/hello \
--region REGION \
--port 8080 \
--no-invoker-iam-check

    Sostituisci REGION con unaregione supportata Google Cloud .

    Il flag --no-invoker-iam-check disabilita l'autenticazione dell'invoker IAM, rendendo l'URL dell'istanza accessibile senza autenticazione IAM.

  2. Attendi il completamento della creazione dell'istanza. Al termine, il comando mostra un output simile al seguente:

    Creating instance...
Importing container..............done
Provisioning resources.......done
Starting instance.....done
Done.
Instance [my-instance] has successfully been created.

URL: https://my-instance-PROJECT-NUMBER.REGION.run.app

  3. Apri l'URL restituito nel browser per interagire con il container in esecuzione.

Visualizzazione dei log delle istanze

Per visualizzare i log generati dall'istanza Cloud Run:

  1. Nella Google Cloud console, vai a Esplora log:

    Vai a Esplora log

  2. Filtra i log per l'istanza specifica:

    resource.type="cloud_run_instance"
resource.labels.location="<var>REGION</var>"
resource.labels.instance_name="my-instance"

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Elimina l'istanza

Per arrestare ed eliminare l'istanza Cloud Run:

gcloud beta run instances delete my-instance --region REGION

Elimina il progetto di test

L'eliminazione del Google Cloud progetto interrompe la fatturazione per tutte le risorse del progetto. Per rilasciare tutte le Google Cloud risorse del progetto:

    Elimina un Google Cloud progetto:

    gcloud projects delete PROJECT_ID

Passaggi successivi

Per ulteriori informazioni sulle istanze Cloud Run, consulta: