Gerenciar cron jobs

Destino Pub/Sub

Se você escolher o tipo de destino Pub/Sub:

1. especifique o nome do tópico em que o job será publicado. Deve ser um tópico do Pub/Sub já configurado no seu projeto.

2. Especifique a mensagem para enviar ao tópico. É enviado como data na mensagem do Pub/Sub. Para um exemplo que isso, consulte o Guia de início rápido.

3. Adicione todos os atributos de mensagem necessários.

4. Defina qualquer outra configuração usando a seção Configure optional settings.

O Cloud Scheduler publicará mensagens neste tópico como uma API do Google conta de serviço.

OK

Destino HTTP do App Engine

Se você escolher o tipo de segmentação App Engine HTTP, deverá usar o App Engine e região associada ao projeto atual. Se quiser usar outro aplicativo do App Engine fora da sua projeto, escolha HTTP como destino, não HTTP do App Engine. O regras de firewall de destino precisam permitir solicitações do intervalo de IP 0.1.0.2/32.

Defina o formulário da seguinte maneira:

1. Na lista Tipo de destino, selecione App Engine HTTP.

2. Especifique o nome do serviço do App Engine que está executando o gerenciador do job do Cloud Scheduler. Se omitido, o default padrão será usado. Se quiser defini-la, você pode encontrar os nomes dos serviços no Console do Google Cloud:

3. Você também pode especificar a versão. Se ela não for definida, será usada a versão disponibilizada no momento. Confira as versões disponíveis no Console do Google Cloud:

4. Também é possível especificar a instância. Se não for definida, qualquer instância disponível poderá ser usados. Confira as versões disponíveis no Console do Google Cloud:

5. Especifique o URL relativo do endpoint do App Engine em que o job vai entrar em contato. Se você usar o valor padrão /, o job usará PROJECT-ID.appspot.com, em que PROJECT-ID é o ID do projeto atual.

   Observação: se você não estiver usando o serviço padrão, o URL de destino será exibido na interface do console do Google Cloud tem o formato SERVICE.PROJECT-ID.r.appspot.com/*. O mesmo URL exibido no seu terminal usando a CLI tem o formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/: As duas formas são equivalentes.

6. Defina o método HTTP que você quer usar ao executar o job. O padrão é POST.

7. Adicione os cabeçalhos necessários à solicitação.

8. Se quiser, especifique os dados do corpo que serão enviados ao alvo. Esses dados é enviado no corpo da solicitação como bytes quando o O método HTTP POST ou PUT está selecionado.

Os endpoints do App Engine de destino devem estar no mesmo projeto e podem ser protegido com login: admin no elemento handlers da app.yaml.

OK

Destino HTTP

Se você escolher o tipo de destino HTTP:

1. especifique o URL completo do ponto de extremidade com que o job entrará em contato.

2. Especifique o método HTTP. O padrão é POST.

3. Se você quiser, pode especificar também os dados que serão enviados ao destino. Esses dados são enviados o corpo da solicitação como bytes quando o método HTTP POST ou PUT for selecionados.

4. Adicione os cabeçalhos necessários.

5. Para criar um job de destino HTTP que exija autenticação, consulte Use a autenticação com destinos HTTP.

Os pontos de extremidade HTTP de destino precisam estar publicamente acessíveis.

Observação: ao usar um destino HTTP, o Cloud Scheduler pode relatar uma solicitação de falha, embora o destino tenha sido retornado com sucesso. Isso pode ocorrer quando houver uma incompatibilidade entre as configurações de tempo limite do destino e o do Cloud Scheduler. Consulte a Vaga descrição para definir o campo attempt_deadline.

OK

É possível usar o Cloud Scheduler para configurar unidades de trabalho programadas, como cron jobs, que são enviados a destinos em alguns programação recorrente, também chamado de intervalo ou frequência do job.

Apenas uma única instância de um job deve ser executada por vez. Em casos raros circunstâncias, é possível que várias instâncias do mesmo trabalho sejam solicitado. Como resultado, o gerenciador de solicitações deve ser idempotente, e seu código precisa garantir que não haja efeitos colaterais prejudiciais caso isso ocorra.

Observação: o Cloud Scheduler fornece cabeçalhos que pode ajudar na eliminação de duplicação das solicitações de trabalho, tornando o manipulador de idempotente. Em particular, a solicitação de trabalho pode ser identificada de forma exclusiva usando o nome do job e o horário em que ele está agendado.

O Cloud Scheduler destina-se a jobs repetidos. Se você precisar executar uma job apenas uma vez, use o Cloud Tasks, que pode programar uma tarefa com até 30 dias de antecedência.

Antes de começar

Verifique se você configurou o ambiente para Cloud Scheduler.

Escolha um tipo de segmentação

O Cloud Scheduler pode invocar os seguintes tipos de destinos:

• Endpoints HTTP

• Tópicos do Pub/Sub

• Serviços do App Engine

Invocar serviços de destino restritos à entrada interna

O Cloud Scheduler pode invocar os seguintes serviços internamente:

• Cloud Functions
• Cloud Run (no URL run.app, não em domínios personalizados)

Para invocar esses destinos internamente, eles precisam estar no mesmo projeto do Google Cloud ou perímetro do VPC Service Controls como Job do Cloud Scheduler.

Para saber mais sobre como proteger destinos restringindo a entrada, consulte Restringir a entrada (por Cloud Run) e Como definir configurações de rede (por Cloud Functions).

Criar um job

É possível criar um job usando o console ou a Google Cloud CLI.

Console

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

   Acessar o Cloud Scheduler

2. Clique em Criar job.

3. No campo Nome, insira um nome exclusivo para o job projeto.

   Depois de excluir o job associado, reutilize o nome de um job em um projeto.

4. Na lista Região, selecione uma região.

   Se estiver usando um destino HTTP do App Engine, escolha o mesmo como o aplicativo do App Engine. Para mais informações, consulte Regiões compatíveis por destino.

5. Se quiser, você também pode inserir uma breve descrição do job, como um lembrete da função dele.

   Essa descrição aparece no console ao lado do nome do job.

6. Especifique a frequência em que o job será executado, usando uma string de configuração.

   Por exemplo, a string 0 1 * * 0 executa o job uma vez por semana à 1h todo domingo de manhã. A string fornecida aqui pode ser qualquer Compatível com unix-cron fio. Para mais informações, consulte Configure cron job jobs.

7. Na lista Fuso horário, escolha o fuso que será usado no job. cronograma.

8. Clique em Continuar.

9. Especifique o Tipo de destino:

   • HTTP

   • Pub/Sub: é preciso especifique o nome do tópico do Pub/Sub que você tem configurado no projeto e no qual o job será publicado.

   • HTTP do App Engine: use o aplicativo do App Engine e a região associada o projeto atual.

10. Clique em Continuar.

11. Como alternativa, para configurar um comportamento de repetição, clique em Defina configurações opcionais. Para especificar a duração, use uma sequência de números inteiros não negativos decimais com os seguintes sufixos de unidade:

    • h: hora
    • m: minuto
    • s: segundo
    • ms: (milissegundos)
    • µ: microssegundo
    • ns: nanossegundo

    Não é permitido usar valores negativos e fracionários. O campo Max retry duration aceita apenas valores h, m e s. Tanto Min backoff duration quanto Max backoff duration aceitam o conjunto completo.

12. Opcionalmente, para destinos HTTP e App Engine HTTP, configure um prazo para tentativas de trabalho. Se o gerenciador de solicitações não responder com isso prazo, a solicitação é cancelada e a tentativa é marcada como falhou. O Cloud Scheduler tenta executar o job novamente de acordo com a configuração de nova tentativa.

13. Para criar e salvar o job, clique em Criar.

    O job será executado com a frequência especificada.

gcloud

Ao criar um job com a CLI gcloud, você usa diferentes para cada tipo de target:

HTTP

Você pode enviar uma solicitação para qualquer ponto de extremidade HTTP ou HTTPS. HTTP segmentado endpoints devem ser acessíveis publicamente.

gcloud scheduler jobs create http JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --uri=URI

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job será executado.

• SCHEDULE: frequência ou job. intervalo em que o job será executado, por exemplo, every 3 hours. O string fornecida aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

• URI: o URI totalmente qualificado do endpoint com quem o job vai entrar em contato.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud:

• Se preferir, especifique o método HTTP. O padrão é POST.

• Se você quiser, pode especificar também os dados que serão enviados ao destino. Esses dados são enviados no corpo da solicitação como bytes quando POST ou PUT O método HTTP está selecionado.

• Como opção, defina os valores de repetição, que especificam como o App Engine o job deve ser repetida em caso de falha. Na maioria dos casos, os padrões serão ser suficientes.

• Para criar um job de HTTP Target que exija autenticação, consulte Como usar a autenticação com destinos HTTP.

Exemplo

gcloud scheduler jobs create http my-http-job \
    --schedule "0 1 * * 0" \
    --uri "http://myproject/my-url.com" \
    --http-method GET

Observação: ao usar um destino HTTP, o Cloud Scheduler pode relatar uma solicitação de falha, embora o destino tenha sido retornado com sucesso. Isso poderá acontecer quando houver incompatibilidade entre as configurações de tempo limite do serviço de destino e o do Cloud Scheduler. Consulte a Vaga descrição para definir o campo attempt_deadline.

Pub/Sub

Use um tópico do Pub/Sub já configurado em seu projeto. O Cloud Scheduler publicará mensagens no neste tópico como uma conta de serviço da API do Google.

gcloud scheduler jobs create pubsub JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --topic=TOPIC

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job será executado.

• SCHEDULE: frequência ou job. intervalo em que o job será executado, por exemplo, every 3 hours. O string fornecida aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

• TOPIC: o nome do tópico para o qual o job serão publicadas. Use a sinalização --message-body ou --message-body-from-file, para especificar uma mensagem a ser enviada ao tópico. É enviado como data na mensagem do Pub/Sub. Para um exemplo que consulte o guia de início rápido.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud.

Exemplo

gcloud scheduler jobs create pubsub myjob \
    --schedule "0 1 * * 0" \
    --topic cron-topic \
    --message-body "Hello"

HTTP do App Engine

O destino App Engine HTTP está disponível apenas para o App Engine aplicativo associado ao projeto atual. Se você quiser usar algum outro App Engine fora do seu projeto atual, escolha HTTP como o destino, e não App Engine HTTP. As regras de firewall de destino precisam solicitações de permissão do intervalo de IP 0.1.0.2/32.

É possível proteger os endpoints do App Engine com login: admin no handlers no arquivo app.yaml.

gcloud scheduler jobs create app-engine \
    --JOB=JOB \
    --location=LOCATION \
    --schedule=SCHEDULE

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job será executado. Precisa ser o mesmo local do seu aplicativo do App Engine.

• SCHEDULE: frequência ou intervalo do job, em que a tarefa é executar, por exemplo, every 3 hours. A string que você fornecer aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud:

• Especifique o URL relativo do endpoint do App Engine que o o job vai entrar em contato. Se você usar o valor padrão /, o job usará PROJECT-ID.appspot.com, em que PROJECT-ID é o ID do projeto atual.

• Especifique o nome do serviço do App Engine em execução o gerenciador do job do Cloud Scheduler. Se omitido, o default padrão será usado. Se quiser defini-lo, você pode encontrar os nomes dos serviços no console do Google Cloud.

• Se preferir, defina o método HTTP que você quer usar ao executar o job. O padrão é POST.

• Você também pode especificar a versão. Se não for definida, a veiculação atual mais recente é usada. Confira as versões disponíveis no Console do Google Cloud:

• Também é possível especificar a instância. Se não for definida, as instâncias disponíveis podem ser usadas. Confira as versões disponíveis no Console do Google Cloud:

• Se você quiser, pode especificar também os dados que serão enviados ao destino. Esses dados são enviados no corpo da solicitação como bytes quando o HTTP POST ou PUT é selecionado.

• Como opção, defina os valores de repetição, que especificam como o App Engine o job deve ser repetida em caso de falha. Na maioria dos casos, os padrões são suficientes.

Exemplo

gcloud scheduler jobs create app-engine my-appengine-job \
    --schedule "0 1 * * 0" \
    --relative-url "/cron-handler"

Observação: se você não estiver usando o serviço padrão para o qual o URL de destino retornou a janela do terminal está no formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/. O mesmo URL exibido na UI do console do Google Cloud tem o formato SERVICE.PROJECT-ID.r.appspot.com/*: Os dois formulários são equivalentes.

Editar um job

É possível editar a configuração de um job.

Console

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

   Acessar o Cloud Scheduler

2. Selecione o job a ser editado.

3. Clique em Editar.

4. Siga as etapas para definir o cronograma, configurar a execução e defina as configurações opcionais ao criar um job.

gcloud

Ao editar um job com a CLI gcloud, você usa diferentes para cada tipo de target:

HTTP

Você pode enviar uma solicitação para qualquer ponto de extremidade HTTP ou HTTPS. HTTP segmentado endpoints devem ser acessíveis publicamente.

gcloud scheduler jobs update http JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --uri=URI

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job é executado. Se você não especificar o local, a CLI gcloud usará seu local padrão. Se o job que você quer editar estiver em um local, você deve especificar o local, além do NAME para que seu job seja identificado. Não é possível e atualizar o local da tarefa.

• SCHEDULE: frequência ou job. intervalo em que o job será executado, por exemplo, every 3 hours. O string fornecida aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

• URI: o URI totalmente qualificado do endpoint com quem o job vai entrar em contato.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud.

Exemplo

gcloud scheduler jobs update http my-http-job \
    --schedule "0 1 * * 0" \
    --uri "http://myproject/my-url.com" \
    --http-method GET

Observação: ao usar um destino HTTP, o Cloud Scheduler pode relatar uma solicitação de falha, embora o destino tenha sido retornado com sucesso. Isso poderá acontecer quando houver incompatibilidade entre as configurações de tempo limite do serviço de destino e o do Cloud Scheduler. Consulte a Vaga descrição para definir o campo attempt_deadline.

Pub/Sub

Use um tópico do Pub/Sub já configurado em seu projeto. O Cloud Scheduler publicará mensagens no neste tópico como uma conta de serviço da API do Google.

gcloud scheduler jobs update pubsub JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --topic=TOPIC

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job é executado. Se você não especificar o local, a CLI gcloud usará seu local padrão. Se o job que você quer editar estiver em um local, você deve especificar o local, além do NAME para que seu job seja identificado. Não é possível e atualizar o local da tarefa.

• SCHEDULE: frequência ou intervalo do job, em que a tarefa é executar, por exemplo, every 3 hours. A string que você fornecer aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

• TOPIC: o nome do tópico para o qual o job serão publicadas. Use a sinalização --message-body ou --message-body-from-file para especificar uma mensagem a ser enviada ao tópico. É enviado como data na mensagem do Pub/Sub. Para um exemplo que consulte o guia de início rápido.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud.

Exemplo

gcloud scheduler jobs update pubsub myjob \
    --schedule "0 1 * * 0" \
    --topic cron-topic --message-body "Hello"

HTTP do App Engine

O destino App Engine HTTP está disponível apenas para o App Engine aplicativo associado ao projeto atual. Se você quiser usar algum outro App Engine fora do seu projeto atual, escolha HTTP como o destino, e não App Engine HTTP.

É possível proteger os endpoints do App Engine com login: admin no handlers no arquivo app.yaml.

gcloud scheduler jobs update app-engine JOB \
    --location=LOCATION \
    --schedule=SCHEDULE

Substitua:

• JOB: um nome de job que precisa ser exclusivo no projeto. Não é possível reutilizar o nome de um job em um projeto, excluir o job associado.

• LOCATION: o local em que o job é executado. É o mesmo local do aplicativo do App Engine de destino. Se você não especificar o local, a CLI gcloud usará seu local padrão. Se o job que você quer editar estiver em um local, você deve especificar o local, além do NAME para que seu job seja identificado. Não é possível e atualizar o local da tarefa.

• SCHEDULE: frequência ou intervalo do job, em que a tarefa é executar, por exemplo, every 3 hours. A string que você fornecer aqui pode ser qualquer unix-cron uma string compatível. Embora não seja mais recomendado usá-lo, a versão Sintaxe do cron do App Engine ainda é compatível com os jobs atuais.

  Para mais informações, consulte Configure cron job jobs.

Outros parâmetros estão descritos na Referência da linha de comando do gcloud.

Exemplo

gcloud scheduler jobs update app-engine my-appengine-job \
    --schedule "0 1 * * 0" \
    --relative-url "/cron-handler"

Observação: se você não estiver usando o serviço padrão para o qual o URL de destino retornou a janela do terminal está no formato https://SERVICE-dot-PROJECT-ID.r.appspot.com/. O mesmo URL exibido na UI do console do Google Cloud tem o formato SERVICE.PROJECT-ID.r.appspot.com/*: Os dois formulários são equivalentes.

Pausar um job

É possível pausar a execução de um job.

Console

1. No Console do Google Cloud, acesse o Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Selecione o job a ser pausado.

3. Clique em Pausar.

gcloud

1. Abra uma janela do terminal na máquina em que você instalou o CLI gcloud.

2. Execute o comando:

    gcloud scheduler jobs pause MY_JOB
   

   Substitua MY_JOB pelo nome do job a ser pausado.

Enquanto um job é pausado, você também pode editá-lo. Depois de editar o job, permanece pausada até você retomá-la.

Retomar um job

É possível retomar a execução de um job pausado.

Console

1. No Console do Google Cloud, acesse o Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Selecione o job para retomar.

   É preciso que o job já esteja pausado.

3. Clique em Retomar.

gcloud

1. Abra uma janela do terminal na máquina em que você instalou o CLI gcloud.

2. Execute o comando:

    gcloud scheduler jobs resume MY_JOB
   

   Substitua MY_JOB pelo nome do job a ser retomado.

Excluir um job

É possível excluir um job.

Console

1. No Console do Google Cloud, acesse o Cloud Scheduler.

   Acessar o Cloud Scheduler

2. Selecione o job a ser excluído.

3. Clique em Excluir.

gcloud

1. Abra uma janela do terminal na máquina em que você instalou o CLI gcloud.

2. Execute o comando:

    gcloud scheduler jobs delete MY_JOB
   

   Substitua MY_JOB pelo nome do job a ser excluída.