osm-edgeをセットアップする

前提条件

この osm-edge v1.1.2 のデモには以下が必要だ:

注意: このドキュメントでは、~/.kube/config に Kubernetes クラスターの資格情報が既にインストールされており、kubectl cluster-info が正常に実行されることを前提としている。

osm-edge コマンドライン ツールをダウンロードしてインストールする

「osm」コマンドラインツールには、Open Service Mesh のインストールと設定に必要なものがすべて含まれている。バイナリは osm-edge GitHub releases pageで入手できる。

GNU/Linux

osm-edge v1.1.2の64ビットGNU/LinuxまたはmacOSバイナリをダウンロードする。

system=$(uname -s)
release=v1.1.2
curl -L https://github.com/flomesh-io/osm-edge/releases/download/${release}/osm-${release}-${system}-amd64.tar.gz | tar -vxzf -
./${system}-amd64/osm version

macOS

osm-edge v1.1.2用の64ビットmacOSバイナリをダウンロードする。

system=$(uname -s | tr [:upper:] [:lower:])
arch=$(uname -m)
release=v1.1.2
curl -L https://github.com/flomesh-io/osm-edge/releases/download/${release}/osm-edge-${release}-${system}-${arch}.tar.gz | tar -vxzf -
. /${system}-${arch}/osm version

osm CLI は、 this guideに従ってソースからコンパイルできる。

Kubernetes に osm-edge をインストールする

「osm」バイナリをダウンロードして解凍したら、Open Service Mesh を Kubernetes クラスターにインストールする準備が整った。

以下のコマンドは、Kubernetes クラスターに osm-edge をインストールする方法を示す。このコマンドは、Prometheus、Grafana、および Jaeger の統合を有効にする。value.yaml ファイルにある osm.enablePermissiveTrafficPolicy チャートパラメータは、osm-edge に対して、ポリシーを無視し、トラフィックがポッド間を自由に流れるように指示する。Permissive Traffic Policy モードを有効にすると、新しいポッドはEnvoyで注入されるが、トラフィックはプロキシを経由して流れ、アクセス制御ポリシーによってブロックされることはない。

注意: Permissive Traffic Policy モードは、SMI ポリシーの作成に時間がかかるブラウンフィールド展開にとって重要な機能だ。オペレーターが SMI ポリシーを設計している間、既存のサービスは osm-edge がインストールされる前と同様に動作し続ける。

export osm_namespace=osm-system # Replace osm-system with the namespace where osm-edge will be installed
export osm_mesh_name=osm # Replace osm with the desired osm-edge mesh name

osm install \
    --mesh-name "$osm_mesh_name" \
    --osm-namespace "$osm_namespace" \
    --set=osm.enablePermissiveTrafficPolicy=true \
    --set=osm.deployPrometheus=true \
    --set=osm.deployGrafana=true \
    --set=osm.deployJaeger=true

osm-edge の Prometheus、Grafana、および Jaeger との統合の詳細については、observability documentationを参照してください。

次のステップ

osm-edge コントロールプレーンが起動して実行されるようになったので、 add applicationsをメッシュに追加する。