マルチクラスター

エールは主要なCSPのKubernetesクラスターだけでなく、Generic形式のクラスター接続もサポートしています。エージェントを実行する方法に応じて、以下の手順でクラスターを追加登録し管理すできます。

Nodeとして実行

AWS EC2でエールを実行する場合は、以下の手順に従い、ale-runパッケージのインストール手順まで進めてください。

AWS EC2にエールをインストール

以下のコマンドを入力してale-runパッケージをインストールしてください。

mkdir ale-run
cd ale-run

npm i @ale-run/runtime@latest

以下のコマンドを入力してエールエージェントをエージェントモードで実行します。

pm2 start "npx aled agent -c [Kubernetes クラスター名]" --name "ale-agent" --watch

pm2で出力されるログが以下のように表示されれば、実行が完了しています。クラスター登録に必要なエージェントトークンは、`agent token is...`で始まるログで確認できます。

pm2 log ale-agent

...
ale-agent  | [INFO] [runtime:init] using embedded mongodb "mongodb://127.0.0.1:27017/ale" at "/home/ubuntu/.ale/mongodb"
ale-agent  | [INFO] [runtime:init] using cluster: default
ale-agent  | [INFO] [k8s] KubernetesClusterDriver initialized with agent {"connection":{"context":"default","namespace":"ale"},"stat":{"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"}}}
ale-agent  | [INFO] [k8s] ConfigContext initialized with {"connection":{"context":"default","namespace":"ale"},"stat":{"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"}}}
ale-agent  | [INFO] [k8s] connect k8s to "default"
ale-agent  | [INFO] [k8s] [agent] cluster agent initialized
ale-agent  | [INFO] [runtime:agent] Ale Agent is initialized with config
ale-agent  | [INFO] [agent-server] token loaded from secret "ale/agent-secrets"
ale-agent  | [INFO] [runtime:init] agent httpsd is listening at 0.0.0.0:9801
ale-agent  | [INFO] [runtime:init] agent token is cat-c5a7cea7b25709a0863ac64a80155d46.930d450e5893040b54820c83 
ale-agent  | [INFO] [k8s] config loaded from cluster from "ale/agent-config"
ale-agent  | [INFO] [stat] stat controller init {"collector":{"prefix":"ale"},"db":{"url":"mongodb://127.0.0.1:27017/","dbName":"ale"},"connection":{"context":"default","namespace":"ale"}}
ale-agent  | [INFO] [stat] connect k8s to "default"
ale-agent  | [INFO] [stat] stat watcher started

実行中にデータベースの競合が発生した場合や設定を初期化したい場合は、以下のコマンドを入力して既存のエールデータを削除してから再実行してください。

rm -r ~/.ale

運用システムの設定ページ下部にある「クラスターを接続」をクリックし、以下の値を入力してください。

クラスタープラットフォーム : Generic Kubernetes
名前、表示名 : ダッシュボードに表示される名前
エージェント接続アドレス
アクセストークン : 前の手順で取得したトークン値

接続されたクラスターは、ダッシュボードでサービスをデプロイするためのプロジェクトまたは環境を作成する際に、デプロイ先のクラスターとして選択できます。

Kubernetes Podでの実行

Kubernetesクラスターにエールをインストールする場合は、以下のページを参考に進めてください。

エージェントの外部IPを確認

kubectl get svc \
    -n ale \
    ale-agent-lb \
    -o jsonpath='{.status.loadBalancer.ingress[0].hostname}' \
| xargs -I{} echo "https://{}"

kubectl get svc \
    -n ale \
    ale-agent-lb \
    -o jsonpath='{.status.loadBalancer.ingress[0].ip}' \
| xargs -I{} echo "https://{}"

エージェントトークンを確認

kubectl get secrets agent-secrets -n ale -o jsonpath='{.data.AGENT_TOKEN}' | base64 --decode

運用システムの設定ページ下部にある「クラスターを接続」をクリックし、以下の値を入力してください。

クラスタープラットフォーム : 接続するクラスターのプロバイダーを選択
名前、表示名 : ダッシュボードに表示される名前
エージェント接続アドレス
アクセストークン : 前の手順で取得したトークン値

スタートガイド

インストール

OAuth

コンテナレジストリ

運用システム

Advanced

マルチクラスター

Nodeとして実行

Kubernetes Podでの実行

​Nodeとして実行

​Kubernetes Podでの実行

Nodeとして実行

Kubernetes Podでの実行