![](\"//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=B081YD3VL5&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=oshimayuki0d-22\")
![\"\"](\"https://ir-jp.amazon-adsystem.com/e/ir?t=oshimayuki0d-22&l=li2&o=9&a=B081YD3VL5\")
最近 Raspberry Pi で遊び始め、Raspberry Pi 上で動いているプログラムを無停止で更新できたら面白いなと思い、k3s を使った無停止リリースに挑戦してみました。
\n最終的には、プログラムの更新によって、以下のように途中で L チカのスピードが速くなります。
\nさて、まずはどうやって無停止でプログラムを更新するかを考えてみます。
\nGPIO を複数のプログラムが同時にさわるとよくないことになりそうなので、GPIO を扱うプログラムを無停止で更新するのは少しハードルが高そうです。
\nそこで、「GPIO を扱うプログラム」と「GPIO に与える値を計算するプログラム」を別プロセスにする方針を考えてみました。
\n下図のようなイメージです。
\n![\"raspberrypi-k3s-non-stop-release-architecture.jpg\"](\"/media/raspberrypi-k3s-non-stop-release-architecture.jpg\")
この「GPIO を扱うプロセス」から「計算を担当するプロセス」に向けて定期的に HTTP リクエストを送り、その結果を GPIO に出力する流れです。
\nその上で、サーバ側のプログラムの更新は k3s を使えば簡単に無停止でできそうなので、k3s を使ってみようと思います。
\nもし k3s が動かないと方針から考え直しなので、最初に k3s をセットアップして動作確認します。
\nといってもめちゃくちゃ簡単で、Raspberry Pi 上で以下のコマンドを実行するだけです。
\ncurl -sfL https://get.k3s.io | sh -この際、私の環境では cgroup の設定の関係でエラーになりましたが、エラーメッセージの通り対処して reboot すれば解決しました。
\n参考: k3s on pi error - cgroupmemory=1 cgroupenable=memory #2067
\nちなみに、もともとは MicroK8s を使おうと思っていたのですが、手こずりそうな雰囲気を感じたため k3s に変更しました。
\n参考: Microk8s on armhf architecture #719
\nインストールしたら kubectl run や kubectl get pod などでコンテナを動かせることを確認しておきましょう。
実装に入る前に、クライアント側・サーバ側が HTTP で通信するときのインタフェースを決める必要があります。
\n今回は L チカで済ませるつもりなので何でも良いのですが、今後複数の PIN を扱えるよう、以下のようにしました。
\n{\n \"gpios\": [\n {\n \"pin\": 21,\n \"value\": 1\n }\n ]\n}value が 1 なら ON、0 なら OFF となります。
\nでは、GPIO を扱う、クライアント側に相当するプログラムを用意します。
\nPython ならライブラリを入れたりせずに GPIO が扱えたので、Python で書いてみました。
\nimport RPi.GPIO as GPIO\nimport time\nimport datetime\nimport requests\n\nURL = 'http://localhost:30000'\n\ndef request_gpios():\n response = requests.get(URL, timeout=(1, 1))\n body = response.json()\n now = datetime.datetime.now()\n print(str(now) + ' | body: ' + str(body))\n return body['gpios']\n\ndef setup_gpios(gpios):\n for gpio in gpios:\n pin = gpio['pin']\n GPIO.setup(pin, GPIO.OUT)\n\ndef output_gpios(gpios):\n for gpio in gpios:\n pin = gpio['pin']\n value = gpio['value']\n GPIO.output(pin, value)\n\nGPIO.setmode(GPIO.BCM)\n\ntry:\n gpios = request_gpios()\n setup_gpios(gpios)\n\n while True:\n gpios = request_gpios()\n output_gpios(gpios)\n time.sleep(0.5)\n\nexcept KeyboardInterrupt:\n GPIO.cleanup()0.5 秒ごとにリクエストを送り、その結果を GPIO に出力しているだけです。
\nサーバ側もできたら、以下のように実行することになります。
\n$ python main.py\n2021-05-08 19:57:36.481347 | body: {u'gpios': [{u'value': 1, u'pin': 21}]}\n2021-05-08 19:57:36.491097 | body: {u'gpios': [{u'value': 1, u'pin': 21}]}\n2021-05-08 19:57:36.998604 | body: {u'gpios': [{u'value': 0, u'pin': 21}]}\n :次に、サーバ側のプログラムを作成します。
\nconst http = require(\"http\");\nconst process = require(\"process\");\n\nconst PORT = 3000;\nconst INTERVAL_MILLIS = process.env.INTERVAL_MILLIS || 1000;\n\nconst ON_RESPONSE = {\n gpios: [\n {\n pin: 21,\n value: 1,\n },\n ],\n};\n\nconst OFF_RESPONSE = {\n gpios: [\n {\n pin: 21,\n value: 0,\n },\n ],\n};\n\nvar response = ON_RESPONSE;\n\nintervalObj = setInterval(() => {\n response = response === ON_RESPONSE ? OFF_RESPONSE : ON_RESPONSE;\n}, INTERVAL_MILLIS);\n\nconst server = http\n .createServer((req, res) => {\n res.writeHead(200, { \"Content-Type\": \"text/plain\" });\n const body = JSON.stringify(response);\n\n res.end(body);\n const now = Date.now();\n console.log(now + \" | body: \" + body);\n })\n .listen(PORT, () => console.log(\"Server http://localhost:\" + PORT));\n\nprocess.on(\"SIGTERM\", () => {\n // リクエストの処理中かもしれないので 5 秒待つ\n setTimeout(() => {\n console.log(\"Received SIGTERM at \" + new Date());\n server.close(() => {\n console.log(\"Server closed\");\n });\n\n clearInterval(intervalObj);\n console.log(\"intervalObj cleared\");\n }, 5000);\n});クライアント側と比べると少し長いですが、ざっくり言えば、環境変数 INTERVAL_MILLIS で指定した時間ごとにレスポンスの ON/OFF の値が切り替わるだけです。
\nコードの最後の部分については、k3s でコンテナを更新する際に古いほうのコンテナに飛ぶ SIGTERM をうまくハンドリング (Graceful Shutdown) するための記述です。
\n試しに実行して curl localhost:3000 のようなリクエストを送ると、以下のようになります。
$ node server.js\nServer http://localhost:3000\n1620471867537 | body: {"gpios":[{"pin":21,"value":1}]}\n1620471868278 | body: {"gpios":[{"pin":21,"value":1}]}\n1620471868861 | body: {"gpios":[{"pin":21,"value":0}]}\n :クライアント側、サーバ側のプログラムができたので、サーバ側をコンテナにしようと思います。
\nコンテナ化したいので、Dockerfile を書きます
\nFROM node:14.16.1-alpine\n\nCOPY server.js /opt/app/\n\nENTRYPOINT [\"node\", \"/opt/app/server.js\"]docker build して、Docker Hub に push します。
\n$ docker build -t <イメージ名> .\n$ docker login\n$ docker push <イメージ名>k3s にデプロイするため、マニフェストファイルを作成します。
\napiVersion: v1\nkind: Service\nmetadata:\n labels:\n app: app\n name: app\nspec:\n type: NodePort\n selector:\n app: app\n ports:\n - port: 3000\n targetPort: 3000\n nodePort: 30000\n---\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n labels:\n app: app\n name: app\nspec:\n replicas: 1\n selector:\n matchLabels:\n app: app\n strategy:\n rollingUpdate:\n maxSurge: 50%\n maxUnavailable: 50%\n template:\n metadata:\n labels:\n app: app\n spec:\n containers:\n - name: app\n image: <イメージ名>\n ports:\n - containerPort: 3000\n livenessProbe:\n failureThreshold: 3\n httpGet:\n path: /\n port: 3000\n periodSeconds: 60\n timeoutSeconds: 3\n readinessProbe:\n failureThreshold: 3\n httpGet:\n path: /\n port: 3000\n periodSeconds: 5\n timeoutSeconds: 3\n resources:\n limits:\n cpu: 500m\n memory: 250Mi\n requests:\n cpu: 500m\n memory: 250Mi\n env:\n - name: INTERVAL_MILLIS\n value: \"2000\"\n restartPolicy: Always\n terminationGracePeriodSeconds: 60これを適用してしばらく待てば、コンテナが起動しています。
\n$ kubectl apply -f app.yaml\nservice/app created\ndeployment.apps/app created\n$ kubectl get po\nNAME READY STATUS RESTARTS AGE\napp-7878c59946-4wfkk 1/1 Running 0 95m※ 実際にはプライベートなレジストリを使ったので、その設定もしています。
\n参考: Pull an Image from a Private Registry
\nクライアント側を Raspberry Pi 上で実行すると、無事疎通します！このとき、LED もチカチカします！
\n$ python main.py\n2021-05-08 20:19:55.393659 | body: {u'gpios': [{u'value': 1, u'pin': 21}]}\n2021-05-08 20:19:55.400793 | body: {u'gpios': [{u'value': 1, u'pin': 21}]}\n2021-05-08 20:19:55.908066 | body: {u'gpios': [{u'value': 0, u'pin': 21}]}\n :では最後に、無停止で更新できるか試します。
\n本当ならプログラムを書き換えて反映したいのですが、少し手間がかかります。
\nDeployment の環境変数を変えるだけでも同じ挙動になるので、環境変数の変更で試してみます。
\n簡易的に kubectl edit deploy app で INTERVAL_MILLIS を 500 に変更すると…
無事、無停止で挙動が切り替わりました！
\n一応やりたかったことは達成しましたが、この方針でよかったのか少し考えてみようと思います。
\n今回は「GPIO を扱うプログラム」と「GPIO に与える値を計算するプログラム」を別プロセスにする方針にすることと、k3s を使ったローリングアップデートで、無停止での動作の切り替えを実現しました。
\nKubernetes の使い方さえ知っていれば簡単だったので、基本的には悪くない方針だったと思います。
\nただ、大きな欠点として、「GPIO を扱うプログラム」側は無停止で更新できないことが挙げられます。
\n「GPIO を扱うプログラム」の更新がある際は無停止リリースしている場合じゃない気もするので、これでもいいかもしれませんが、改善する方法も考えておきたいです。
\n例えば、「GPIO を扱うプロセス」を「リクエストに応じて GPIO を処理するプロセス」と「定期的にリクエストを送るプロセス」に分離し、無停止で更新できないのは「定期的にリクエストを送る」という薄いプログラムだけにするといった方針が考えられます。
\n他には、「GPIO を扱うプログラム」の新版・旧版を並列稼働させ、特定時刻になったら切り替わるようにする処理を入れる、といった方法でも実現できるかもしれません。
\n後者の方法はうまく動作するのか検証するのがかなり大変な気がするので、本当にそこまでするのか要検討だと思います。
\nということで、「Raspberry Pi で L チカしてるプログラムを、k3s を使って無停止で更新する」という記事については以上になります。
\n説明はスラスラ進んだように書きましたが、実際にはサーバ側のプログラムを Graceful Shutdown させる箇所などで少し手間取ったりしました。
\nとはいえ、想像していたくらいの時間で一通りできたので、個人的には満足しています。
\n今後の改良としては、まずは「GPIO を扱うプログラム」の方もコンテナ化してみることが考えられます。
\nk3s 上のコンテナから GPIO を操作する例はいくつかあったので、たぶんできると思います。
\n参考
\n\nあとは、せっかく k3s を導入していろんなコンテナを連携させたりしやすくなったので、Tensorflow Serving や TorchServe のコンテナと連携させて、機械学習の結果を Raspberry Pi の挙動に反映したりしたら面白いかもしれません。
","fields":{"slug":"/posts/raspberrypi-k3s-non-stop-release","tagSlugs":["/tag/raspberrypi/","/tag/k-8-s/","/tag/iot/"],"autoRecommendPosts":["getting-started-with-aws-app-runner","raspberrypi-motordriver","raspberrypi-clean-architecture","aws-app-runner-with-cloud-native-buildpacks"]},"frontmatter":{"date":"2021-05-08T12:04:52.347Z","description":"最近 Raspberry Pi で遊び始め、Raspberry Pi 上で動いているプログラムを無停止で更新できたら面白いなと思い、k3s を使った無停止リリースに挑戦してみました。","tags":["raspberrypi","k8s","iot"],"title":"Raspberry Pi で L チカしてるプログラムを、k3s を使って無停止で更新する","socialImage":null,"recommendPosts":["https://www.kanzennirikaisita.com/posts/software-developer-books-index"]}}},"pageContext":{"slug":"/posts/raspberrypi-k3s-non-stop-release"}},"staticQueryHashes":["251939775","3942705351","401334301"]}