12 Dias de DigitalOcean (Dia 5) – Automatizando Lembretes de Aniversário com Gatilhos Diários

Bem-vindo ao Dia 5 dos 12 Dias de DigitalOcean! Ontem, você configurou seu Serviço de Lembrete de Aniversário para rodar no DigitalOcean Functions, o que significa que agora está sem servidor e pronto para a nuvem. 🎉 Hoje, você dará um passo a mais automatizando-o para funcionar em sua própria programação—sem necessidade de entrada manual.

No final deste guia, seu serviço (ou qualquer outra função em que você esteja trabalhando) será executado automaticamente em um horário definido todos os dias. Isso significa que não será mais necessário lembrar de acioná-lo você mesmo—ele simplesmente funciona.

Por que Automatizar?

Implantar sua função na nuvem foi uma grande conquista ontem, mas ter que executá-la manualmente anula o propósito da automação. O foco de hoje é agendar o serviço para funcionar automaticamente—como um relógio—para que você possa configurá-lo e esquecê-lo. O DigitalOcean Functions possui agendamento integrado usando Gatilhos para esse propósito exato, e você tem duas maneiras de configurá-lo.

🚀 O que Você Vai Aprender

No final de hoje, você saberá como:

1. Configurar um gatilho diário para executar sua função automaticamente.
2. Aprender duas maneiras de fazer isso—por meio do Painel de Controle da DigitalOcean ou com o doctl CLI e project.yml.
3. Testar a configuração para garantir que funcione.

🛠 O que Você Vai Precisar

Antes de começar, certifique-se de ter o seguinte:

1. Uma função já implantada na DigitalOcean (por exemplo, o Serviço de Lembrete de Aniversário do Dia 4: Construindo um Serviço de Lembrete de Aniversário) para automatizar com gatilhos.
2. Se você estiver usando o doctl CLI, precisará do arquivo project.yml para sua função. Você pode conferir Dia 4 para instruções sobre como instalar e configurar o doctl CLI e criar o arquivo project.yml.

🧑‍🍳 Receita para o Dia 5: Automatizando Funções com Gatilhos

Passo 1: Configure um Gatilho para sua Função

A DigitalOcean oferece duas opções para configurar gatilhos:

1. Opção 1: Use o Painel de Controle para uma configuração rápida e fácil.
2. Opção 2: Use o doctl CLI para um controle mais robusto e programático.

Opção 1: Usando o Painel de Controle para Criar um Acionador

A maneira mais fácil de configurar um acionador é através do Painel de Controle da DigitalOcean. É rápido, não requer configuração e é ideal para configurações simples únicas.

• Navegue até a página principal de Funções no painel da DigitalOcean.
• Encontre sua função (por exemplo, lembretes/aniversários) e clique na guia Acionadores.

• Clique em Criar Acionador, adicione um Nome para o seu acionador. Isso pode ser qualquer coisa descritiva, como acionador-diario-de-aniversario. O nome deve conter apenas caracteres alfanuméricos, traços e pontos.
• Adicione uma expressão cron para definir o agendamento. Por exemplo, 0 9 * * * significa que a função será executada todos os dias às 9:00.

• Salve o acionador.

Depois de criar o acionador, é uma boa ideia testá-lo para garantir que tudo funcione como esperado. Pule para a seção Testar a Automação abaixo para aprender como.

Opção 2: Usando o doctl CLI com project.yml

Você também pode criar gatilhos adicionando-os diretamente ao seu project.yml arquivo. Este método é mais confiável para reimplantações frequentes porque garante que seus gatilhos estejam sempre incluídos na configuração da função. Ao contrário da opção do Painel de Controle descrita anteriormente, essa abordagem evita que os gatilhos sejam sobrescritos ou perdidos durante as reimplantações.

Aqui está como você pode configurá-lo:

• Abra o seu arquivo project.yml de Dia 4: Implantando Notificações de Aniversário com Funções do DigitalOcean. Ele pode parecer algo assim:

  packages:
    - name: reminders
      shared: false
      environment:
        DO_DB_NAME: "${DB_NAME}"
        DO_DB_USER: "${DB_USER}"
        DO_DB_PASSWORD: "${DB_PASSWORD}"
        DO_DB_HOST: "${DB_HOST}"
        DO_DB_PORT: "${DB_PORT}"
        TWILIO_ACCOUNT_SID: "${TWILIO_ACCOUNT_SID}"
        TWILIO_AUTH_TOKEN: "${TWILIO_AUTH_TOKEN}"
        TWILIO_PHONE_FROM: "${TWILIO_PHONE_FROM}"
        TWILIO_PHONE_TO: "${TWILIO_PHONE_TO}"
      functions:
        - name: birthdays
          runtime: python:default
  

• Adicione uma seção triggers à configuração da sua função para definir o agendamento:

  triggers:
    - name: diário-aniversário-gatilho
      sourceType: agendador
      sourceDetails:
      cron: "0 9 * * *"
  

• Arquivo project.yml final atualizado:

  packages:
    - name: reminders
      shared: false
      environment:
        DO_DB_NAME: "${DB_NAME}"
        DO_DB_USER: "${DB_USER}"
        DO_DB_PASSWORD: "${DB_PASSWORD}"
        DO_DB_HOST: "${DB_HOST}"
        DO_DB_PORT: "${DB_PORT}"
        TWILIO_ACCOUNT_SID: "${TWILIO_ACCOUNT_SID}"
        TWILIO_AUTH_TOKEN: "${TWILIO_AUTH_TOKEN}"
        TWILIO_PHONE_FROM: "${TWILIO_PHONE_FROM}"
        TWILIO_PHONE_TO: "${TWILIO_PHONE_TO}"
      functions:
        - name: birthdays
          runtime: python:default
          triggers:
            - name: daily-birthday-trigger
              sourceType: scheduler
              sourceDetails:
                cron: "0 9 * * *"
  

  Isso diz à DigitalOcean para executar a função birthdays todos os dias às 9:00 AM.

  1. triggers seção: Define o nome, tipo e cronograma para o gatilho. Você pode nomear seu gatilho de maneira descritiva, como daily-birthday-trigger.

  2. cron: Especifica o horário em que a função será executada diariamente em UTC. A expressão cron 0 9 * * *, por exemplo, agenda a função para ser executada todos os dias às 9:00 AM.

• Salve o arquivo e implante-o executando o seguinte comando a partir do diretório que contém a pasta my-birthday-reminder-service:

  doctl serverless deploy my-birthday-reminder-service
  

  Importante: Certifique-se de executar o comando a partir do diretório pai, não dentro da pasta my-birthday-reminder-service. Executá-lo no local errado pode resultar em um erro como este:

  ❯ doctl serverless deploy my-birthday-reminder-service
  Erro: ENOENT: nenhum arquivo ou diretório encontrado, lstat
  

• Uma vez que a implantação for bem-sucedida, você verá uma mensagem de confirmação semelhante a esta:

  Funções implantadas
    - lembretes/aniversários
  Triggers implantados:
    - desencadeador-diário-aniversário
  

  

• Vá para o seu painel para verificar se o gatilho foi criado na seção Funções.

Passo 2: Teste a Automação

Vamos testar seus gatilhos para garantir que estão funcionando. Em vez de esperar que sejam acionados no cronograma habitual, você pode defini-los temporariamente para serem executados em alguns minutos. Veja como fazer:

• Defina a expressão cron para o seu gatilho para alguns minutos a partir do horário atual (em UTC). Por exemplo, se for 9h25 UTC, defina a expressão cron para 28 9 * * * para que a função seja executada às 9h28 UTC.

  Nota: Não tem certeza de como converter seu horário local para UTC? Ferramentas como Conversor de Fuso Horário podem ajudar.

• Salve o gatilho atualizado (se estiver usando o Painel de Controle) ou reimplante seu arquivo project.yml atualizado (se estiver usando a CLI):

  doctl serverless deploy my-birthday-reminder-service
  

• Espere o gatilho executar, depois verifique os logs de ativação para confirmar que a função foi executada com sucesso:

  doctl serverless activations logs --function reminders/birthdays --last
  

Este comando retornará os detalhes da ativação mais recente da sua função. Por exemplo, você pode ver algo assim:

=== 59e8e4f482874d79a8e4f48287dd79ef success 12/23 07:46:33 reminders/birthdays:0.0.6
2024-12-23T07:46:33.323205805Z stdout: Message sent for Charlie Brown. Message SID: SM85f5caeb3ec09239e0d8bdaaba2b158b

Isso confirma que o gatilho foi acionado e a função foi ativada com sucesso! 🎉

Uma Nota Rápida sobre Logs

Embora o comando logs de ativação seja uma ótima maneira de verificar execuções recentes, às vezes você precisará de logs mais detalhados para depurar ou investigar problemas com sua função. A DigitalOcean também oferece opções para encaminhar esses logs para serviços de logging externos, facilitando o monitoramento e a resolução de problemas da sua aplicação ao longo do tempo.

No Dia 6, você aprenderá a visualizar logs diretamente, interpretá-los de forma eficaz e configurar o encaminhamento de logs para serviços externos como Logtail ou Papertrail. Essas ferramentas ajudarão você a acompanhar facilmente o desempenho da sua função.

🎁 Resumo

Aqui está o que você conquistou hoje:

1. Você automatizou seu Serviço de Lembrete de Aniversário (ou qualquer outra função) para ser executado diariamente.
2. Você aprendeu duas maneiras de configurar gatilhos—através do Painel de Controle e com o doctl CLI.
3. Você testou sua configuração para garantir que funcione como esperado.

Aqui estão os tutoriais anteriores desta série:

• Dia 1: Configurando um Banco de Dados PostgreSQL para Lembretes de Aniversário
• Dia 2: Conectando-se ao Seu Banco de Dados PostgreSQL com Python
• Dia 3: Verificando Aniversários e Enviando Notificações por SMS
• Dia 4: Implantando Notificações de Aniversário em Funções

Próximo: Agora que seu serviço está funcionando de forma independente, o próximo passo é monitorá-lo efetivamente. No próximo tutorial, você aprenderá como visualizar os logs da sua função e encaminhá-los para serviços externos para simplificar o rastreamento e a resolução de problemas. Até lá!