Broken CircleCI構(gòu)建和粒子網(wǎng)格

描述

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

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

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

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

我對這個項目的方法的另一個看法是我想使用Particle Mesh Networking 。本質(zhì)上，粒子網(wǎng)狀網(wǎng)絡(luò)由具有網(wǎng)絡(luò)訪問權(quán)限的網(wǎng)關(guān)設(shè)備和一個/多個端點設(shè)備組成。在Particle 博客上可以找到更好的解釋。

我的示例將使用Argon WiFi 網(wǎng)關(guān)設(shè)備和 2 個Xenon端點設(shè)備。

網(wǎng)關(guān)和端點設(shè)備可以通過發(fā)布或訂閱事件來相互通信。只有此網(wǎng)絡(luò)上的設(shè)備才能訪問這些事件。

知道這一點，我們可以在我們的網(wǎng)關(guān)設(shè)備 (Argon) display_broken_build上定義一個函數(shù)，當(dāng) API 調(diào)用它時，它可以在我們的網(wǎng)絡(luò)matrix_display_message上發(fā)出一個自定義事件。我們的端點將訂閱事件matrix_display_message ，然后可以執(zhí)行特定操作。

我的計劃是讓 1 個 Xenon 端點運(yùn)行滾動選框，而另一個 Xenon 端點顯示損壞構(gòu)建的數(shù)量。這表明在工作環(huán)境中，我們可以在我們的網(wǎng)絡(luò)上使用多個設(shè)備來顯示構(gòu)建失敗的通知以及可能更詳細(xì)的統(tǒng)計信息。

圈子CI

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

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

將此推送到 github 并導(dǎo)致 CircleCI 構(gòu)建您的項目。

首先它會安裝 npm 依賴項，然后是npm foo，它不應(yīng)該存在于你的package.json文件中，導(dǎo)致構(gòu)建失敗。

應(yīng)用程序接口

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

在/api/display上，API 將登錄到我的設(shè)備并調(diào)用它的display_broken_build函數(shù)，將分支和用戶值傳遞給它。

API 引用存儲在 local.env 文件中的環(huán)境變量。

PDEVICE=particle_device_id
PUSER=particle_user
PPASS=particle_password

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

您可以像這樣向現(xiàn)在的部署提供您的秘密：

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

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

氬氣（網(wǎng)關(guān)）

我正在使用 Argon 作為我的網(wǎng)關(guān)設(shè)備。

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

您會注意到在設(shè)置時我定義了接受命令（字符串）的函數(shù)display_broken_build ，并且在通過 API 調(diào)用該函數(shù)的事件中，我調(diào)用了displayMessage函數(shù)，該函數(shù)隨后會將 matrix_display_message發(fā)送到網(wǎng)絡(luò)上。

Xenon - 滾動字幕（端點）

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

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

Mesh.subscribe("matrix_display_message", displayMessage);

Xenon - 計數(shù)器（端點）

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

我將計數(shù)初始化為0，每次發(fā)布matrix_display_message時它都會調(diào)用logToDisplay ，將計數(shù)遞增 1 并將其發(fā)送到 LCD 顯示器。

結(jié)論

一旦部署了 API，設(shè)備閃爍，并發(fā)布了失敗的 CircleCI 存儲庫，我就有了自己的可愛的物聯(lián)網(wǎng)顯示網(wǎng)絡(luò)，在構(gòu)建失敗時通知我。

?

?