Configurar o ambiente

Antes de programar e executar um cron job, configure seu projeto e ambiente do Google Cloud para o Cloud Scheduler.

Ative a API Cloud Scheduler

Siga estas instruções para criar ou selecionar um projeto Google Cloud e ativar a API Cloud Scheduler.

Console

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

  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. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

  2. Instale a CLI do Google Cloud.

  3. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  4. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  5. Crie ou selecione um Google Cloud projeto.

    Funções necessárias para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

  6. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  7. Ative a API Cloud Scheduler, se ela ainda não estiver ativada:

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão pelo papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis. 

    gcloud services enable cloudscheduler.googleapis.com

  8. Instale a CLI do Google Cloud.

  9. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  10. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  11. Crie ou selecione um Google Cloud projeto.

    Funções necessárias para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    • Crie um projeto do Google Cloud :

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

  12. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  13. Ative a API Cloud Scheduler, se ela ainda não estiver ativada:

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão pelo papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis. 

    gcloud services enable cloudscheduler.googleapis.com
    14.

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 o código está sendo executado.

Para mais informações, consulte Autenticar no Cloud Scheduler e Usar a 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 local do serviço do Cloud Scheduler e do próprio gerenciador de jobs, que realiza o trabalho associado a um job do Cloud Scheduler e retorna um reconhecimento em resposta.

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

Console

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

    Acessar o App Engine

  2. Na caixa de diálogo Bem-vindo ao App Engine, faça o seguinte:

    • Se você já criou um aplicativo do App Engine e a mensagem Seu aplicativo do App Engine foi criado 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 siga as etapas restantes nesta seção.

  3. Selecione uma região para seu aplicativo.

    Observação: 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 mudar essa escolha.

  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 ver 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. Observação: 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 mudar essa escolha.

  2. É possível verificar a região de um app com o seguinte comando:

    gcloud app describe

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