Configurar o ambiente

Antes de programar e executar um job cron, você precisa configurar o projeto e o ambiente Google Cloudpara o Cloud Scheduler.

Ative a API do Cloud Scheduler

Use as instruções a seguir para criar ou selecionar um Google Cloud projeto e ativar a API Cloud Scheduler.

Console

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Scheduler API.

   Enable the API

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Cloud Scheduler API.

   Enable the API

gcloud

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Scheduler API:

   gcloud services enable scheduler.googleapis.com

7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

10. Make sure that billing is enabled for your Google Cloud project.

11. Enable the Cloud Scheduler API:

    gcloud services enable scheduler.googleapis.com

Configurar a autenticação

A forma como você se autentica no Cloud Scheduler depende da interface usada para acessar a API e do ambiente em que seu código está sendo executado.

Para mais informações, consulte Autenticar no Cloud Scheduler e Usar autenticação com destinos HTTP.

Adicionar um aplicativo do App Engine

Se você for usar um destino HTTP do App Engine, adicione um aplicativo do App Engine ao seu projeto. Esse app serve como o local do serviço do Cloud Scheduler e do próprio gerenciador de jobs, que executa o trabalho associado a um job do Cloud Scheduler e retorna um aviso em resposta.

Se você quiser que um job handler do App Engine não esteja no seu projeto, selecione um destino HTTP. Nesse caso, não é necessário ter um app do App Engine no seu projeto.

Console

1. No console do Google Cloud, acesse a página do App Engine.

   Acessar o App Engine

2. Na caixa de diálogo Bem-vindo ao App Engine, siga um destes procedimentos:

   • Se você já criou um aplicativo do App Engine e a mensagem Your App Engine application has been created aparece, pule as etapas restantes desta seção.

     ou

   • Se você ainda não criou um aplicativo do App Engine, clique em Criar aplicativo e continue com as etapas restantes desta seção.

3. Selecione uma região para o aplicativo.

   europe-west e us-central são chamados, respectivamente, europe-west1 e us-central1 nos comandos do Cloud Scheduler.

   Depois de definir uma região para o app do App Engine, não é possível alterá-la.

4. Não selecione uma conta de serviço. A conta de serviço padrão do App Engine será usada.

5. Clique em Próxima.

   O aplicativo é configurado e criado. Isso pode levar alguns minutos.

6. Não faça o download do SDK Cloud. Em vez disso, clique em Farei isso mais tarde.

   Você vai receber a mensagem Seu aplicativo do App Engine foi criado.

gcloud

1. Para criar um app do App Engine, execute o comando gcloud app create:

   gcloud app create --region=REGION
   

   Substitua REGION pelo local em que o app é executado. Observe que europe-west e us-central são chamados, respectivamente, europe-west1 e us-central1 nos comandos do Cloud Scheduler.

   Depois de definir uma região para o app do App Engine, não é possível alterá-la.

2. Para verificar a região de um app existente, use este comando:

   gcloud app describe
   

   O locationId indica a região. Por exemplo, locationId: us-central.