描述

這個項目搭載了我上一篇文章使用 Slack 和 Particle 創建 IoT 滾動選框。

我不想使用滾動字幕顯示獨特的消息，而是希望僅在持續集成平臺構建失敗時接收通知。在此通知中有用的是，哪個分支失敗了，誰是用戶。

CircleCI是一個很棒的持續集成平臺，我在個人項目中經常使用它，但我相信這種方法（或類似方法）適用于大多數人。

CircleCI config.yml允許您在“構建失敗”時調用命令。這很棒，因為我們可以將 POST 請求卷曲到 API ，將我們的CIRCLE_BRANCH和CIRCLE_USERNAME傳遞給它。簡單！

我對這個項目的方法的另一個看法是我想使用Particle Mesh Networking 。本質上，粒子網狀網絡由具有網絡訪問權限的網關設備和一個/多個端點設備組成。在Particle 博客上可以找到更好的解釋。

我的示例將使用Argon WiFi 網關設備和 2 個Xenon端點設備。

網關和端點設備可以通過發布或訂閱事件來相互通信。只有此網絡上的設備才能訪問這些事件。

知道這一點，我們可以在我們的網關設備 (Argon) display_broken_build上定義一個函數，當 API 調用它時，它可以在我們的網絡matrix_display_message上發出一個自定義事件。我們的端點將訂閱事件matrix_display_message ，然后可以執行特定操作。

我的計劃是讓 1 個 Xenon 端點運行滾動選框，而另一個 Xenon 端點顯示損壞構建的數量。這表明在工作環境中，我們可以在我們的網絡上使用多個設備來顯示構建失敗的通知以及可能更詳細的統計信息。

圈子CI

首先，我們需要一個會失敗的構建。創建一個 git repo 并創建一個.circleci/config.yml文件。（參見示例）確保您隨后在 CircleCI 應用程序中選擇了您的 git 存儲庫。同時在您的新存儲庫中創建一個package.json文件。
此清單將沒有依賴項或腳本。（見例子）

my-failing-repo
 | - .circleci/config.yml 
 | - package.json

將此推送到 github 并導致 CircleCI 構建您的項目。

首先它會安裝 npm 依賴項，然后是npm foo，它不應該存在于你的package.json文件中，導致構建失敗。

應用程序接口

我創建了一個 expressJS API (index.js) 和一個路由 /display。

在/api/display上，API 將登錄到我的設備并調用它的display_broken_build函數，將分支和用戶值傳遞給它。

API 引用存儲在 local.env 文件中的環境變量。

PDEVICE=particle_device_id
PUSER=particle_user
PPASS=particle_password

API 然后托管在now上，我的now.json清單向 API 公開了我的路由和秘密。

您可以像這樣向現在的部署提供您的秘密：

now secret add mesh-pub-user foo@bar.com

部署 API 后，更新對.circleci/config.yml文件中端點的引用。

氬氣（網關）

我正在使用 Argon 作為我的網關設備。

使用 Particles 的 Workbench，我在我的設備上刷新了argon-publish.ino 。

您會注意到在設置時我定義了接受命令（字符串）的函數display_broken_build ，并且在通過 API 調用該函數的事件中，我調用了displayMessage函數，該函數隨后會將 matrix_display_message發送到網絡上。

Xenon - 滾動字幕（端點）

此設備的代碼 ( xenon-subscribe-scrolling-marquee.ino ) 與我原來的滾動字幕示例非常相似。

不同之處在于，此設備在設置時訂閱了matrix_display_message事件。收到后，調用displayMessage，從而寫入 LCD。

Mesh.subscribe("matrix_display_message", displayMessage);

Xenon - 計數器（端點）

該設備的代碼 ( xenon-subscribe-counter.ino ) 非常簡單。

我將計數初始化為0，每次發布matrix_display_message時它都會調用logToDisplay ，將計數遞增 1 并將其發送到 LCD 顯示器。

結論

一旦部署了 API，設備閃爍，并發布了失敗的 CircleCI 存儲庫，我就有了自己的可愛的物聯網顯示網絡，在構建失敗時通知我。

?

?