Acionador do Cloud Scheduler

O acionador do Cloud Scheduler permite-lhe agendar as execuções da integração para períodos definidos ou intervalos regulares em várias regiões.

Os acionadores do Cloud Scheduler tiram partido dos serviços do Cloud Scheduler para oferecer um agendador de tarefas cronológicas de nível empresarial totalmente gerido na integração de aplicações. Com este acionador, pode agora gerir todas as tarefas cron criadas na sua integração, tanto a partir da IU do Application Integration como do painel de controlo do Cloud Scheduler. Além disso, o acionador do Cloud Scheduler também lhe permite implementar tarefas cronológicas entre regiões para agendar as execuções da integração.

Por exemplo, se tiver aprovisionado a sua integração em us-central1, pode usar o acionador do Cloud Scheduler para implementar uma tarefa cron em asia-east1 (ou qualquer uma das regiões suportadas do Google Cloud para o Cloud Scheduler) para chamar o ponto final da sua integração em us-central1.

Antes de começar

Certifique-se de que realiza as seguintes tarefas no seu projeto do Google Cloud antes de configurar o acionador do Cloud Scheduler:

Ative a API Cloud Scheduler (cloudscheduler.googleapis.com).
Ative a API Cloud Scheduler
Confirme que tem uma conta de serviço Google com a função Invocador da integração de aplicações atribuída. Se não tiver uma conta de serviço, tem de criar uma nova e atribuir-lhe a função Application Integration Invoker.
Para ver informações sobre como criar e gerir contas de serviço, consulte o artigo Criar e gerir contas de serviço

Para obter informações sobre as funções de integração de aplicações predefinidas, consulte o artigo Funções de IAM predefinidas.

Adicione o acionador do Cloud Scheduler

Para adicionar um acionador do Cloud Scheduler à sua integração, siga estes passos:

Na Google Cloud consola, aceda à página Application Integration.
Aceda à solução Application Integration
No menu de navegação, clique em Integrações
A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
  Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
4. Clique em Criar.
A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
Clique e coloque o elemento Acionador do Cloud Scheduler no editor de integração.

Configure o acionador do Cloud Scheduler

Para configurar um acionador do Cloud Scheduler, siga estes passos:

Clique no elemento Acionador do Cloud Scheduler no editor de integração para abrir o painel de configuração do acionador.
Especifique a programação do acionador do Cloud Scheduler através de uma das seguintes opções:
- Básico: use a interface do utilizador para configurar a programação da tarefa cron.
- Avançado: use uma expressão unix-cron para configurar a programação da tarefa cron.
(Para a opção Básico) Selecione o separador Básico e faça o seguinte nos campos indicados:
1. Horários: selecione os intervalos de tempo em que a integração tem de ser executada.
  - Executar a uma hora específica: selecione esta opção para executar a integração a uma hora específica.
  - Repetir de hora em hora: selecione esta opção para executar repetidamente a integração de hora em hora.
  - Repetir por minuto: selecione esta opção para executar repetidamente a integração de acordo com o número de minutos especificado
2. Dias: selecione os dias em que a integração tem de ser executada. Pode optar por executar a integração todos os dias, em dias específicos da semana ou num dia específico do mês.
3. Meses: selecione os meses em que a integração tem de ser executada. Pode optar por executar a integração todos os meses ou durante meses específicos.
(Para a opção avançada) Selecione o separador Avançadas e especifique a programação da tarefa cron com uma expressão cron.
A expressão cron tem cinco valores que têm de ser especificados pela seguinte ordem:
1. Minuto (0-59)
2. Hora (0-23)
3. Dia do mês (1-31)
4. Mês, qualquer um dos seguintes valores:
  - Um número entre 1 e 12
  - Uma abreviatura de três letras do mês (por exemplo, jan, fev, mar)
5. Dia da semana, qualquer um dos seguintes valores:
  - Um número de 0 a 6, começando com domingo como 0
  - Uma abreviatura de três letras do dia (por exemplo, seg, ter, qua)
Por exemplo, para executar a integração no primeiro dia de cada mês, use a * * 1 * * expressão cron.

Para mais informações, consulte o artigo Configure programações de tarefas cron.
Região: selecione a região onde a sua tarefa do Cloud Scheduler vai ser implementada.
Email da conta de serviço: introduza o endereço de email da conta de serviço Google criada.

Saída do acionador

Para cada acionador do Cloud Scheduler configurado e publicado na versão de integração, o Application Integration cria uma nova tarefa do Cloud Scheduler no seu projeto do Google Cloud.

É criada uma tarefa do Cloud Scheduler com a seguinte convenção de nomenclatura para evitar erros de duplicação de tarefas:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER

Exemplo: DemoIntegration__V1__1

Registos de acionadores

Um acionador do Cloud Scheduler gera registos no início e no fim de cada execução da integração. Pode ver os registos do acionador do Cloud Scheduler na página do Explorador de registos do Cloud Logging:

Na Google Cloud consola, aceda à página Cloud Scheduler.
Aceda ao Cloud Scheduler
Localize o trabalho do Cloud Scheduler e clique em Ver na coluna Registos.
É apresentada a página Explorador de registos do Cloud Logging, que mostra os registos gerados pelo acionador do Cloud Scheduler.

Edite um acionador do Cloud Scheduler

Application Integration

Para editar o acionador do Cloud Scheduler a partir da integração de aplicações, siga estes passos:

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
Selecione a integração que quer editar.
No editor de integração, clique no menu pendente Versão e selecione a versão de integração que contém o acionador do Cloud Scheduler que quer editar.
Anular publicação e ativar a edição se a versão de integração selecionada estiver publicada (no estado ativo).
Clique no elemento Acionador do Cloud Scheduler no editor de integração para abrir o painel de configuração do acionador.
Modifique as configurações de tarefas do Cloud Scheduler conforme desejado.

Cloud Scheduler

Pode editar o acionador do Cloud Scheduler modificando a configuração da tarefa do Cloud Scheduler a partir do Cloud Scheduler:

Na Google Cloud consola, aceda ao Cloud Scheduler.
Aceda ao Cloud Scheduler
Selecione a tarefa do Cloud Scheduler que quer editar.
Clique em Edit.
Modifique as configurações de tarefas do Cloud Scheduler conforme desejado.

Pause, retome e copie uma tarefa do Cloud Scheduler

A integração de aplicações não suporta operações de pausa, retoma e cópia para uma tarefa do Cloud Scheduler criada através do acionador do Cloud Scheduler.

O acionador do Cloud Scheduler gera um erro no painel de configuração do acionador se pausar manualmente a execução de uma tarefa do Cloud Scheduler a partir do Cloud Scheduler.

Para mais informações sobre as mensagens de erro do acionador do Cloud Scheduler, consulte o artigo Resolva problemas do acionador do Cloud Scheduler. Para obter informações sobre como pausar e retomar uma tarefa cron com o Cloud Scheduler, consulte o artigo Pause ou retome uma tarefa

Elimine uma tarefa do Cloud Scheduler

Pode eliminar uma tarefa do Cloud Scheduler a partir da sua integração no Application Integration ou do Cloud Scheduler.

Application Integration

Para eliminar uma tarefa do Cloud Scheduler a partir da integração de aplicações, siga estes passos:

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
Selecione a integração que quer editar.
No editor de integração, clique no menu pendente Versão e selecione a versão de integração que contém o acionador do Cloud Scheduler que quer eliminar.
Anule a publicação da versão de integração selecionada.
A tarefa do Cloud Scheduler para a versão de integração correspondente é eliminada.

Cloud Scheduler

Para eliminar uma tarefa do Cloud Scheduler a partir do Cloud Scheduler, siga estes passos:

Na Google Cloud consola, aceda ao Cloud Scheduler.
Aceda ao Cloud Scheduler
Selecione a tarefa do Cloud Scheduler que quer eliminar.
Clique em Eliminar.
A tarefa do Cloud Scheduler para a versão de integração correspondente é eliminada.

Práticas recomendadas

Como prática recomendada, anule a publicação de todos os acionadores do Cloud Scheduler quando já não forem necessários. Se deixar um acionador do Cloud Scheduler redundante publicado, o acionador continua a invocar a integração automaticamente, o que pode causar cobranças de faturação adicionais.

Resolva problemas do acionador do Cloud Scheduler

A tabela seguinte descreve os erros que pode encontrar no acionador do Cloud Scheduler e as causas correspondentes dos erros.

Localização do erro	Ocorrência do erro	Mensagem de erro	Causas possíveis	Resolução
Painel de configuração do acionador > Mensagem de erro	Quando a tarefa do Cloud Scheduler interrompe a execução da sua integração	`The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB does not exist. It might be deleted from your Google Cloud project.`	A tarefa do Cloud Scheduler é eliminada através do Cloud Scheduler.	Crie uma nova versão de integração para substituir a tarefa existente do Cloud Scheduler.
		`The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.`	A tarefa do Cloud Scheduler está pausada através do Cloud Scheduler.	Retome a tarefa do Cloud Scheduler a partir do Cloud Scheduler.
		`The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.`	Consulte os registos de acionadores para identificar o problema.	Crie uma nova versão de integração para substituir a tarefa existente do Cloud Scheduler.
		`The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.`	A conta de serviço fornecida não tem as autorizações do IAM necessárias.	Para recuperar uma tarefa deste estado, tente novamente a operação CloudScheduler.UpdateJob até receber uma resposta bem-sucedida.
		`The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.`	`CLOUD_SCHEDULER_JOB_ISSUE`	NA

Exclusões do SLA

O acionador do Cloud Scheduler depende do produto Cloud Scheduler. Como esta dependência é externa à Application Integration, os termos e as condições do Application Integration Service Level Agreement (SLA) aplicam-se apenas quando a execução é agendada com êxito para uma integração active.