Configura l'ambiente

Prima di pianificare ed eseguire un cron job, devi configurare il tuo Google Cloud progetto e il tuo ambiente per Cloud Scheduler.

Abilita l'API Cloud Scheduler

Segui le istruzioni riportate di seguito per creare o selezionare un progetto Google Cloud e per abilitare l'API Cloud Scheduler.

Console

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Scheduler API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

gcloud

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Installa Google Cloud CLI.

  3. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  4. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  5. 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 per il quale ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    • Crea un progetto Google Cloud :

      gcloud projects create PROJECT_ID

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

    • Seleziona il progetto Google Cloud che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

  7. Abilita l'API Cloud Scheduler, se non è già abilitata:

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di 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 cloudscheduler.googleapis.com

  8. Installa Google Cloud CLI.

  9. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  10. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  11. 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 per il quale ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    • Crea un progetto Google Cloud :

      gcloud projects create PROJECT_ID

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

    • Seleziona il progetto Google Cloud che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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

  13. Abilita l'API Cloud Scheduler, se non è già abilitata:

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di 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 cloudscheduler.googleapis.com
    14.

Configura l'autenticazione

La modalità di autenticazione a Cloud Scheduler dipende dall'interfaccia che utilizzi per accedere all'API e dall'ambiente in cui viene eseguito il codice.

Per saperne di più, consulta Autenticazione a Cloud Scheduler e Utilizzare l'autenticazione con target HTTP.

Aggiungere un'applicazione App Engine

Se utilizzerai una destinazione HTTP App Engine, devi aggiungere un'applicazione App Engine al tuo progetto. Questa app funge sia da posizione del servizio Cloud Scheduler sia da gestore dei job stesso, che esegue il lavoro associato a un job Cloud Scheduler e restituisce una conferma in risposta.

Se vuoi un gestore di job App Engine che non si trovi nel tuo progetto, devi selezionare una destinazione HTTP. In questo caso, non hai bisogno di un'app App Engine nel tuo progetto.

Console

  1. Nella console Google Cloud , vai alla pagina App Engine.

    Vai ad App Engine

  2. Nella finestra di dialogo Ti diamo il benvenuto in App Engine, esegui una delle seguenti operazioni:

    • Se hai già creato un'applicazione App Engine e viene visualizzato il messaggio L'applicazione App Engine è stata creata, puoi saltare i passaggi rimanenti di questa sezione.

      o

    • Se non hai ancora creato un'applicazione App Engine, fai clic su Crea applicazione e continua con i passaggi rimanenti di questa sezione.

  3. Seleziona una regione per la tua applicazione.

    Tieni presente che europe-west e us-central sono chiamati rispettivamente europe-west1 e us-central1 nei comandi Cloud Scheduler.

    Dopo aver impostato una regione per l'app App Engine, non puoi modificarla.

  4. Non selezionare un account di servizio; viene utilizzato il service account predefinito di App Engine.

  5. Fai clic su Avanti.

    L'applicazione è configurata e creata. Questa operazione potrebbe richiedere alcuni minuti.

  6. Non scaricare Cloud SDK, ma fai clic su Lo farò in seguito.

    Dovresti visualizzare il messaggio L'applicazione App Engine è stata creata.

gcloud

  1. Per creare un'app App Engine, esegui il comando gcloud app create:

    gcloud app create --region=REGION

    Sostituisci REGION con la posizione in cui viene eseguita l'app. Tieni presente che europe-west e us-central sono chiamati rispettivamente europe-west1 e us-central1 nei comandi Cloud Scheduler.

    Dopo aver impostato una regione per l'app App Engine, non puoi modificarla.

  2. Puoi controllare la regione di un'app esistente con il seguente comando:

    gcloud app describe

    locationId indica la regione. Ad esempio: locationId: us-central.