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

​
Nodeとして実行

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

1

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

mkdir ale-run
cd ale-run

npm i @ale-run/runtime@latest
2

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

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

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

pm2 log ale-agent

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

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

rm -r ~/.ale
4

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

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

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

​
Kubernetes Podでの実行

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

1

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

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

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

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

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

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

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