Envoyer des SMS avec les actions GitHub

Il existe des patrons de toutes formes et de toutes tailles. Certains ne s'occupent de rien et vous laissent travailler au mieux de vos capacités. D'autres adoptent une approche plus directe et mesurent vos réalisations uniquement à travers le code que vous produisez. Après tout, si vous n'écrivez pas de code, pourquoi vous payer ?

Vous voulez montrer à votre patron à quel point vous travaillez dur ? Absolument ! Grâce à la puissance de Nexmo et des Actions GitHub, vous pouvez vous assurer qu'une excellente évaluation annuelle et une augmentation de salaire conséquente sont de mise.

Conditions préalables

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

This tutorial also uses a virtual phone number. To purchase one, go to Numbers > Buy Numbers and search for one that meets your needs.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Au moment où nous écrivons ces lignes, GitHub Actions est actuellement en version bêta publique. Si vous n'êtes pas membre de la version bêta, vous devez demander à participer à la version bêta.

Qu'est-ce que GitHub Actions ?

GitHub Actions est un nouvel outil de GitHub dans lequel des actions individuelles sont combinées pour former un flux de travail qui s'exécute sur différents types d'événements déclencheurs.

Chaque action est un conteneur Docker contenant un seul point d'entrée. L'action se trouve à l'intérieur d'un conteneur Dockerfile avec des LABEL qui fournit des informations sur l'action.

Par exemple, supposons que vous souhaitiez imprimer le nom de l'utilisateur (appelé Acteur GitHub) sur la console. Vous devez créer un dépôt qui contient un fichier Dockerfile avec le contenu suivant :

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"]

Cette action exécute la commande echo $GITHUB_ACTOR où $GITHUB_ACTOR est une variable d'environnement que GitHub fournit au conteneur contenant l'utilisateur qui a déclenché l'action.

Pour plus d'informations sur Docker, voir Vue d'ensemble de Docker.

L'avantage des actions GitHub réside dans la création d'actions réutilisables que d'autres peuvent utiliser dans leurs flux de travail.

Création de votre premier flux de travail

Pour ce guide, vous allez créer un nouveau référentiel avec un flux de travail qui envoie à votre patron un message texte à chaque fois qu'un push est reçu.

Créer un référentiel

Commencez par créer un nouveau dépôt :

Creating a new repository on GitHub

Créer un nouveau flux de travail

Après avoir créé votre référentiel, vous devrez naviguer vers l'onglet actions où vous verrez un bouton pour créer un nouveau flux de travail :

Create your first workflow on GitHub

Les flux de travail peuvent être créés soit dans l'interface utilisateur graphique (GUI), soit en créant un fichier workflow fichier.

Lier le déclencheur d'action à une action

Faites glisser le connecteur bleu vers le bas pour créer votre première action.

Drag the connector to create a new action

L'action que vous allez introduire est l'action Action Nexmo SMS. Cette action utilise la CLI Nexmo pour envoyer des messages texte.

Dans la case "Rechercher ou saisir une action...", mettez nexmo-community/nexmo-sms-action@master et cliquez sur le bouton utiliser.

Enter the Nexmo Send SMS Action

Cette action nécessite la définition de trois variables secrètes :

• NEXMO_API_KEY contenant votre clé API Nexmo.

• NEXMO_API_SECRET contenant votre secret API Nexmo.

• NEXMO_NUMBER contenant le numéro à partir duquel le message doit être envoyé.

Je recommande de stocker le numéro de votre patron dans une autre variable secrète.

Faites défiler vers le bas et entrez vos variables secrètes. Je vais utiliser la variable d'environnement BOSS_NUMBER pour enregistrer le numéro qui recevra le SMS.

À des fins de test, et probablement à des fins de production, je ne recommanderais pas d'utiliser le nom de votre patron. réel de votre patron. Essayez d'abord avec votre numéro de téléphone. Le numéro de téléphone doit être au format international, sans espace ni caractère spécial séparant les chiffres. Par exemple, 15551239876.

Define your secrets

La commande fonctionne en prenant un argument sous la forme de RECIPIENT_NUMBER The contents of the message. Vous pouvez utiliser des variables comme $BOSS_NUMBER et $GITHUB_ACTOR dans les arguments, qui se résolvent lors de l'exécution de l'action.

Saisissez maintenant ce qui suit dans la case args ce qui suit :

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

Vous pouvez maintenant appuyer sur le bouton "Terminé" et enregistrer votre action en cliquant sur le bouton "Commencer à valider" dans le coin supérieur droit :

Save your action

Sauvegarder l'action est une push en soi. Si vous regardez dans l'onglet des actions, vous pouvez voir le statut de votre action.

See the status of the action in progress

Vous devriez recevoir un message texte lors de l'enregistrement de votre action et lors de toute poussée supplémentaire vers le référentiel.

Text message which states that you are working.

Conclusion

Bientôt, votre patron commencera à réaliser la véritable valeur que vous apportez à l'entreprise. Votre travail remplira sa boîte de réception de SMS et le plongera dans un état d'euphorie "mes subordonnés directs sont extraordinaires".

You being praised by all of your bosses.

Consultez le site hey-boss-im-working pour un exemple complet de ce flux de travail. Vous pouvez également le trouver dans notre Catalogue Nexmo Extend.