Dapr CLI を Ubuntu にインストールする

こんにちは、@studio_meowtoon です。今回は、WSL Ubuntu 22.04 に　Dapr CLI とランタイムをインストールする方法を紹介します。

目的

分散アプリケーションの為のランタイム Dapr の理解を深めます。

実現すること

ローカル環境 (Ubuntu) に Dapr を操作する為のコマンドラインツール Dapr CLI をインストールして Dapr ランタイムの動作を確認します。

技術トピック

Dapr とは？

こちらを展開してご覧いただけます。

Dapr (ダーパー)

Dapr（Distributed Application Runtime）は、マイクロサービスアプリケーションをより簡単に構築するためのオープンソースのランタイムです。

キーワード	内容
ポータビリティ	Dapr はプログラム言語やクラウドプロバイダに依存しない、ユニバーサルなランタイムです。
プラグ＆プレイ	既存のアプリケーションに Dapr を追加する際、既存のコードを変更することなくシームレスに統合できます。
サービス間通信	Dapr はメッセージングとイベント駆動のパターンをサポートし、サービス間の連携を簡単に実現します。
シークレット管理	アプリケーションの構成情報や認証情報などのシークレットを安全に管理できます。
開発の迅速化	Dapr のプラグ＆プレイ機能により、コードの再利用が容易になり、アプリケーションの開発時間が短縮されます。
フレキシブルなアーキテクチャ	Dapr はアプリケーションのコンポーネント間の緩やかな結合を促進し、アーキテクチャの柔軟性を高めます。
拡張性	Dapr は多くの言語とクラウドプロバイダに対応しており、拡張機能を追加することでカスタマイズが可能です。
可用性と信頼性	Dapr は分散システムにおける共通の問題に対処し、アプリケーションの可用性と信頼性を向上させます。

開発環境

Windows 11 Home 22H2 を使用しています。
WSL の Ubuntu を操作していきますので macOS の方も参考にして頂けます。

WSL (Microsoft Store アプリ版) ※ こちらの関連記事からインストール方法をご確認いただけます

> wsl --version
WSL バージョン: 1.0.3.0
カーネル バージョン: 5.15.79.1
WSLg バージョン: 1.0.47

Ubuntu ※ こちらの関連記事からインストール方法をご確認いただけます

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 22.04.1 LTS
Release:        22.04

Docker ※ こちらの関連記事からインストール方法をご確認いただけます

$ docker --version
Docker version 23.0.1, build a5ee5b1

Dapr CLI インストール

インストールします。

$ wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | /bin/bash

バーションを確認します。

$ dapr --version
CLI version: 1.11.0
Runtime version: n/a

ここまでの手順では、Dapr ランタイムはまだ初期化されていません。

Dapr ランタイムの初期化

Dapr ランタイムを初期化する方法が2種類あります。

No	方法	概要
1	ローカル環境に初期化	Dapr の起動には Redis が必要なので Redis の環境を個別に用意する必要があります。
2	Docker 環境に初期化	Dapr の起動に必要である Redis コンテナもセットで環境が初期化されます。 ※ 公式での推奨

ローカル環境に初期化

この記事ではこちらの方法は試みません。

初期化

$ dapr init --slim

※ Dapr ランタイムをアンインストールする場合

$ dapr uninstall

Docker 環境に初期化

この記事ではこちらの方法を実施します。

Docker 環境の起動を確認します。

$ docker --version
Docker version 24.0.4, build 3713ee1

初期化します。

$ dapr init

出力

⌛  Making the jump to hyperspace...
ℹ️  Container images will be pulled from Docker Hub
ℹ️  Installing runtime version 1.11.2
→  Downloading binaries and setting up components...
Dapr runtime installed to /home/hiroxpepe/.dapr/bin, you may run the following to add it to your path if you want to run daprd directly:
    export PATH=$PATH:/home/$USER/.dapr/bin
✅  Downloading binaries and setting up components...
✅  Downloaded binaries and completed components set up.
ℹ️  daprd binary has been installed to /home/$USER/.dapr/bin.
ℹ️  dapr_placement container is running.
ℹ️  dapr_redis container is running.
ℹ️  dapr_zipkin container is running.
ℹ️  Use `docker ps` to check running containers.
✅  Success! Dapr is up and running. To get started, go here: https://aka.ms/dapr-getting-started

Dapr ランタイムをアンインストールする場合には以下のコマンドを実行します。

$ dapr uninstall --all

コンテナの起動状況を確認します。

$ docker ps | grep dapr
35cd134c3331   openzipkin/zipkin    "start-zipkin"            4 minutes ago   Up 4 minutes (healthy)   9410/tcp, 0.0.0.0:9411->9411/tcp, :::9411->9411/tcp   dapr_zipkin
95b45d0675e7   daprio/dapr:1.11.2   "./placement"             4 minutes ago   Up 4 minutes             0.0.0.0:50005->50005/tcp, :::50005->50005/tcp         dapr_placement
0bd11951aa9d   redis:6              "docker-entrypoint.s…"   5 minutes ago   Up 5 minutes             0.0.0.0:6379->6379/tcp, :::6379->6379/tcp             dapr_redis

初期化後

以下のディレクトリに Dapr ランタイムがインストールされています。

 /home/$USER/.dapr/bin

再度バーションを確認します。

$ dapr --version
CLI version: 1.11.0
Runtime version: 1.11.2

ここまでの手順で、Ubuntu に Dapr ランタイムをインストールすることができました。

Dapr API を使用してみる

Dapr ランタイムの起動

Dapr サイドカーを実行します。

この例では、空のアプリケーションをポート 3500 でリッスンする Dapr サイドカーが起動されます。

$ dapr run --app-id hello-dapr --dapr-http-port 3500

出力の一部

ℹ️  Checking if Dapr sidecar is listening on GRPC port 45501
ℹ️  Dapr sidecar is up and running.
✅  You're up and running! Dapr logs will appear here.

停止したい場合、別ターミナルで以下のコマンドを実行します。なお、エラーで起動出来ていない場合は停止できないようです。

$ dapr stop --app-id hello-dapr

別ターミナルから、Dapr Dashboard で確認します。

$ dapr dashboard -p 9999
Dapr Dashboard running on http://localhost:9999

API で操作してみる

別ターミナルから Dapr API で値を登録します。

$ curl -X POST -H "Content-Type: application/json" -d '[{ "key": "name", "value": "Michael Jackson"}]' http://localhost:3500/v1.0/state/statestore

続けて Dapr API で値を取得してみます。

$ curl http://localhost:3500/v1.0/state/statestore/name

出力

"Michael Jackson"

Dapr の Redis コンテナを調べて状態を確認します。

Redis CLI を使用します。

$ docker exec -it dapr_redis redis-cli

Redis CLI
※ exit で操作を抜けます。

> keys *
1) "hello-dapr||name"

> hgetall "hello-dapr||name"
1) "data"
2) "\"Michael Jackson\""
3) "version"
4) "1"

このように、Dapr API で操作した値が、Redis コンテナに保存されています。

Dapr API で値を削除します。

$ curl -v -X DELETE -H "Content-Type: application/json" http://localhost:3500/v1.0/state/statestore/name

Redis コンテナを確認すると値が削除されています。

> keys *
(empty array)

まとめ

Dapr CLI をインストールして Dapr ランタイムを構築し、 Ubuntu の Docker 環境にて Dapr API の動作を確認することが出来ました。

どうでしたか？ WSL Ubuntu に Dapr CLI をインストールして Dapr ランタイムを構築できます。ぜひお試しください。今後も Ubuntu の開発環境などを紹介していきますので、ぜひお楽しみにしてください。

推奨コンテンツ

参考資料

Dapar Getting started