Enviar SMS com o GitHub Actions

Os chefes são de todos os tipos. Alguns são mais distantes, deixando você trabalhar da melhor maneira possível. Outros adotam uma abordagem mais direta e avaliam suas realizações exclusivamente pelo código que você produz. Afinal, se você não está escrevendo código, por que estamos pagando você?

Quer mostrar ao seu chefe o quanto você está se esforçando? Claro que sim! Com o poder do Nexmo e do GitHub Actions, você pode garantir que uma excelente avaliação anual e um aumento salarial considerável estejam garantidos.

Pré-requisitos

No momento da redação deste artigo, o GitHub Actions está em fase de beta pública. Se você não faz parte do beta, precisará se inscrever no beta.

O que é o GitHub Actions?

GitHub Actions é uma nova ferramenta do GitHub na qual ações individuais são combinadas para formar um fluxo de trabalho que é executado em diferentes tipos de eventos de acionamento.

Cada ação é um contêiner Docker que contém um único ponto de entrada. A ação está contida em um Dockerfile com LABEL instruções que fornecem informações sobre a ação.

Por exemplo, digamos que você queira imprimir o nome do usuário (conhecido como “GitHub Actor”) no console. Você criaria um repositório que contivesse um Dockerfile com o seguinte conteúdo:

FROM alpine:3.8

LABEL "com.github.actions.name"="Print GitHub Actor"
LABEL "com.github.actions.description"="Print the GITHUB_ACTOR environment variable to the console."
LABEL "com.github.actions.icon"="user"
LABEL "com.github.actions.color"="blue"

LABEL "repository"="https://github.com/cr0wst/display-github-actor-action"
LABEL "homepage"="https://smcrow.net"
LABEL "maintainer"="Steve Crow <steve.crow@nexmo.com>"

ENTRYPOINT ["sh", "-c", "echo $GITHUB_ACTOR"]

Essa ação inteira executa o comando echo $GITHUB_ACTOR onde $GITHUB_ACTOR é uma variável de ambiente que o GitHub fornece ao contêiner que contém o usuário que acionou a ação.

Para obter mais informações sobre o Docker, consulte isto Visão geral do Docker.

A vantagem do GitHub Actions está na criação de ações reutilizáveis que outras pessoas podem usar em seus fluxos de trabalho.

Criando seu primeiro fluxo de trabalho

Neste guia, você criará um novo repositório com um fluxo de trabalho que envia uma mensagem de texto ao seu chefe sempre que for recebido um push.

Criar um repositório

Primeiro, comece criando um novo repositório:

Creating a new repository on GitHub

Criar um novo fluxo de trabalho

Depois de criar seu repositório, você precisará acessar a aba “Ações”, onde encontrará um botão para criar um novo fluxo de trabalho:

Create your first workflow on GitHub

Os fluxos de trabalho podem ser criados tanto na interface gráfica do usuário (GUI) quanto por meio da criação de um workflow arquivo.

Vincule o gatilho de ação a uma ação

Arraste o conector azul para baixo para criar sua primeira ação.

Drag the connector to create a new action

A ação que você irá implementar é a Ação SMS da Nexmo. Essa ação utiliza o Nexmo CLI para enviar mensagens de texto.

Na caixa “Encontre ou insira uma ação...”, digite nexmo-community/nexmo-sms-action@master e clique no botão “Usar”.

Enter the Nexmo Send SMS Action

Essa ação requer a definição de três variáveis secretas:

• NEXMO_API_KEY que contém sua chave de API da Nexmo.

• NEXMO_API_SECRET que contém sua chave secreta da API da Nexmo.

• NEXMO_NUMBER que contém o número do qual a mensagem deve ser enviada.

Recomendo salvar o número do seu chefe em outra variável secreta.

Role a página para baixo e insira suas variáveis secretas. Vou usar a BOSS_NUMBER variável de ambiente para armazenar o número que receberá o SMS.

Para fins de teste — e provavelmente também para fins de produção —, eu não recomendaria usar o número . Tente primeiro com o seu próprio número de telefone. O número de telefone deve estar no formato internacional, sem espaços ou caracteres especiais separando os dígitos. Por exemplo, 15551239876.

Define your secrets

O comando funciona recebendo um argumento no formato RECIPIENT_NUMBER The contents of the message. Você pode usar variáveis como $BOSS_NUMBER e $GITHUB_ACTOR nos argumentos, que são resolvidos na execução da ação.

Agora, digite o seguinte na args caixa:

$BOSS_NUMBER Hey boss! Just letting you know that I, $GITHUB_ACTOR, just pushed some code.

Agora você pode clicar no botão “Concluído” e salvar sua ação com o botão “Iniciar commit”, no canto superior direito:

Save your action

Salvar a ação é uma push ato em si. Se você acessar a aba “Ações”, poderá ver o status da sua ação.

See the status of the action in progress

Você deve receber uma mensagem de texto ao salvar sua ação e sempre que houver novas atualizações no repositório.

Text message which states that you are working.

Conclusão

Em breve, seu chefe começará a perceber o verdadeiro valor que você agrega à empresa. Seu trabalho vai encher a caixa de entrada de mensagens de texto dele e deixá-lo em um estado de euforia do tipo “meus subordinados diretos são incríveis”.

You being praised by all of your bosses.

Dá uma olhada no repositório hey-boss-im-working para ver um exemplo completo desse fluxo de trabalho. Você também pode encontrá-lo no nosso Catálogo do Nexmo Extend.