SMS mit GitHub-Aktionen senden

Chefs gibt es in allen Formen und Größen. Einige lassen die Hände von Ihnen und lassen Sie nach besten Kräften arbeiten. Andere verfolgen einen direkteren Ansatz und messen Ihre Leistungen ausschließlich an dem Code, den Sie produzieren. Denn wenn Sie keinen Code schreiben, warum bezahlen wir Sie dann?

Sie wollen Ihrem Chef zeigen, wie hart Sie arbeiten? Unbedingt! Mit der Leistung von Nexmo und GitHub Actions können Sie sicherstellen, dass eine exzellente Jahresbewertung und eine beträchtliche Gehaltserhöhung in Ordnung sind.

Voraussetzungen

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

In diesem Lernprogramm wird auch eine virtuelle Telefonnummer verwendet. Um eine zu erwerben, gehen Sie zu Rufnummern > Rufnummern kaufen und suchen Sie nach einer Nummer, die Ihren Anforderungen entspricht.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

Zum Zeitpunkt der Erstellung dieses Artikels befindet sich GitHub Actions in der öffentlichen Betaphase. Wenn Sie noch nicht an der Beta teilnehmen, müssen Sie für die Beta beantragen.

Was ist GitHub Actions?

GitHub-Aktionen ist ein neues Tool von GitHub, bei dem einzelne Aktionen zu einem Workflow kombiniert werden, der auf verschiedene Ereignistypen auslöst.

Jede Aktion ist ein Docker-Container mit einem einzigen Einstiegspunkt. Die Aktion befindet sich innerhalb eines Dockerfile mit LABEL Anweisungen, die Informationen über die Aktion enthalten.

Nehmen wir an, Sie möchten den Namen des Benutzers (als GitHub-Akteur bezeichnet) auf der Konsole ausgeben. Sie würden ein Repository erstellen, das eine Dockerfile mit dem folgenden Inhalt enthält:

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

Diese gesamte Aktion führt den Befehl echo $GITHUB_ACTOR wobei $GITHUB_ACTOR eine Umgebungsvariable ist, die GitHub dem Container zur Verfügung stellt, in dem sich der Benutzer befindet, der die Aktion ausgelöst hat.

Weitere Informationen über Docker finden Sie hier Docker-Übersicht.

Der Vorteil von GitHub Actions liegt in der Erstellung wiederverwendbarer Aktionen, die andere in ihren Arbeitsabläufen nutzen können.

Erstellen Ihres ersten Workflows

In dieser Anleitung werden Sie ein neues Repository mit einem Workflow erstellen, der Ihrem Chef jedes Mal eine Textnachricht sendet, wenn ein Push empfangen wird.

Ein Repository erstellen

Beginnen Sie mit der Erstellung eines neuen Repositorys:

Creating a new repository on GitHub

Einen neuen Workflow erstellen

Nachdem Sie Ihr Repository erstellt haben, müssen Sie zur Registerkarte Aktionen navigieren, wo Sie eine Schaltfläche zum Erstellen eines neuen Workflows finden:

Create your first workflow on GitHub

Workflows können entweder über die grafische Benutzeroberfläche (GUI) oder durch Erstellen einer workflow Datei.

Verknüpfen Sie den Aktionsauslöser mit einer Aktion

Ziehen Sie das blaue Verbindungsstück nach unten, um Ihre erste Aktion zu erstellen.

Drag the connector to create a new action

Die Aktion, die Sie einbringen werden, ist die Nexmo SMS-Aktion. Diese Aktion verwendet die Nexmo CLI um Textnachrichten zu versenden.

Geben Sie in das Feld "Aktion suchen oder eingeben..." ein nexmo-community/nexmo-sms-action@master ein und klicken Sie auf die Schaltfläche Verwenden.

Enter the Nexmo Send SMS Action

Für diese Aktion müssen drei geheime Variablen definiert werden:

• NEXMO_API_KEY mit Ihrem Nexmo API-Schlüssel.

• NEXMO_API_SECRET mit Ihrem Nexmo API Secret.

• NEXMO_NUMBER die die Nummer enthält, von der aus die Nachricht gesendet werden soll.

Ich empfehle, die Nummer Ihres Chefs in einer anderen geheimen Variablen zu speichern.

Blättern Sie nach unten und geben Sie Ihre geheimen Variablen ein. Ich werde die BOSS_NUMBER Umgebungsvariable verwenden, um die Nummer zu speichern, an die die SMS gesendet werden soll.

Für Testzwecke, und wahrscheinlich auch für die Produktion, würde ich nicht empfehlen, den Namen Ihres Chefs zu verwenden. tatsächlichen Nummer zu verwenden. Versuchen Sie es zuerst mit Ihrer Telefonnummer. Die Telefonnummer muss im internationalen Format sein, ohne Leerzeichen oder Sonderzeichen zwischen den Zahlen. Zum Beispiel: 15551239876.

Define your secrets

Der Befehl funktioniert, indem er ein Argument in Form von RECIPIENT_NUMBER The contents of the message. Sie können Variablen verwenden wie $BOSS_NUMBER und $GITHUB_ACTOR in den Argumenten verwenden, die bei der Ausführung der Aktion aufgelöst werden.

Geben Sie nun Folgendes in das Feld args Feld ein:

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

Jetzt können Sie auf die Schaltfläche "Fertig" klicken und Ihre Aktion mit der Schaltfläche "Übertragen starten" in der oberen rechten Ecke speichern:

Save your action

Das Speichern der Aktion ist ein push an und für sich. Auf der Registerkarte "Aktionen" können Sie den Status Ihrer Aktion sehen.

See the status of the action in progress

Sie sollten eine Textnachricht erhalten, wenn Sie Ihre Aktion speichern und bei jedem weiteren Push in das Repository.

Text message which states that you are working.

Schlussfolgerung

Schon bald wird Ihr Chef den wahren Wert erkennen, den Sie für das Unternehmen darstellen. Ihre Arbeit wird sein SMS-Postfach füllen und ihn in einen Zustand der "Meine direkten Mitarbeiter sind fantastisch"-Euphorie versetzen.

You being praised by all of your bosses.

Sehen Sie sich die hey-boss-im-working Repository für ein vollständiges Beispiel dieses Arbeitsablaufs. Sie können es auch als Teil unseres Nexmo-Erweiterungs-Katalogs.