| name | argocd-deployment |
| description | deploy broker または ArgoCD経由でfov-quicklookアプリケーションを操作する。 デプロイ、状態確認、ログ取得、再起動、ロールアウト、ArgoCD操作、Phalanxブランチ切替に関するタスクで使用する。 対象はusdf-rsp-devのfov-quicklookアプリケーションのみ。
|
ArgoCD Deployment 操作スキル
概要
標準の agent-safe 経路では dev/deploy-broker/ を使い、必要な場合だけ
dev/argocd.sh を使って ArgoCD 上の fov-quicklook アプリケーションを操作する。
デフォルト前提: 特に指定がない限り、agent は deploy daemon が
http://127.0.0.1:8010 で動いている前提で deploy-broker-client を使ってよい。
必要なら SSH tunnel でこの localhost endpoint に届くようにする。
agent-safe 運用: agent に GitHub / ArgoCD への直接権限を渡さない場合は、
dev/deploy-broker/ の broker daemon を優先する。broker は ArgoCD token を
daemon 側に保持し、status / branch / logs / sync / restart などの制限された操作だけを
認証付き HTTP API で公開する。
broker 経由の標準運用
前提条件
cd dev/deploy-broker- broker daemon が起動していること
- ArgoCD token は broker daemon に登録済みであること
- 標準運用では client から
http://127.0.0.1:8010 に届くこと（通常は SSH tunnel）
トークンの取得と設定
- ブラウザで https://usdf-rsp-dev.slac.stanford.edu/argo-cd/applications/fov-quicklook にアクセス
- 開発者ツールを開く
- 任意のAPIリクエストを選択し「Copy as cURL」を実行
- daemon ノードの state dir に
bootstrap/argocd.curl として保存してから daemon を起動:
cd /srv/fov-quicklook-broker-state
mkdir -p bootstrap
cat > bootstrap/argocd.curl <<'EOF'
curl 'https://usdf-rsp-dev.slac.stanford.edu/argo-cd/api/v1/applications/fov-quicklook' \
-H 'Cookie: argocd.token=...'
EOF
uv run --project /srv/fov-quicklook/dev/deploy-broker deploy-broker-daemon
daemon は起動時に bootstrap/argocd.curl を読んで token を保存し、元 file を削除する。
デプロイ要求
cd dev/deploy-broker
uv run deploy-broker-client request-deploy \
u/michitaro/fov-quicklook-my-topic \
--app-repo ../.. \
--verify-mode auto
状態確認
cd dev/deploy-broker
uv run deploy-broker-client argocd-status
uv run deploy-broker-client argocd-get-branch
uv run deploy-broker-client argocd-logs coordinator
sync / restart
cd dev/deploy-broker
uv run deploy-broker-client argocd-sync
uv run deploy-broker-client argocd-restart
uv run deploy-broker-client argocd-restart coordinator
uv run deploy-broker-client argocd-restart generator frontend
argocd.sh を使う手動運用
前提条件
トークンの取得と設定
- ブラウザで https://usdf-rsp-dev.slac.stanford.edu/argo-cd/applications/fov-quicklook にアクセス
- 開発者ツールを開く
- 任意のAPIリクエストを選択し「Copy as cURL」を実行
- 以下のコマンドでトークンを抽出・保存:
cd dev
./argocd.sh extract-token "<コピーしたcurlコマンド>"
Deploymentの再起動
cd dev
./argocd.sh restart
./argocd.sh restart coordinator
./argocd.sh restart generator frontend
状態確認
cd dev
./argocd.sh status
出力例:
=== fov-quicklook Deployment 状態 ===
fov-quicklook-coordinator: 1/1 ready image=ghcr.io/lsst-sqre/fov-quicklook:main
fov-quicklook-generator: 8/8 ready image=ghcr.io/lsst-sqre/fov-quicklook:main
fov-quicklook-frontend: 2/2 ready image=ghcr.io/lsst-sqre/fov-quicklook:main
fov-quicklook-db: 1/1 ready image=postgres:16
fov-quicklook-debug: 1/1 ready image=jupyter/base-notebook:latest
Deployment一覧
| 短縮名 | フル名 | 役割 |
|---|
coordinator | fov-quicklook-coordinator | RPCハブ、ジョブ管理 |
generator | fov-quicklook-generator | FITS→タイル変換 |
frontend | fov-quicklook-frontend | UI提供 |
db | fov-quicklook-db | PostgreSQL（通常再起動しない） |
debug | fov-quicklook-debug | デバッグ用 |
Podログの確認
cd dev
./argocd.sh logs
./argocd.sh logs generator
./argocd.sh logs frontend
Podが起動に失敗している場合、ログの末尾にエラーメッセージが表示される。
Phalanxリポジトリの参照ブランチ管理
ArgoCDのfov-quicklookアプリケーションは lsst-sqre/phalanx リポジトリの特定ブランチを参照している。
注意: k8s/phalanx/ はプロジェクトルートとは別の独立した git リポジトリ（https://github.com/lsst-sqre/phalanx.git）です。
.gitignore で除外されており、サブモジュールではありません。
ローカルの k8s/phalanx のブランチとArgoCDの参照ブランチが一致していない場合、設定のミスマッチが発生する。
cd dev
./argocd.sh get-branch
./argocd.sh set-branch u/michitaro/fov-quicklook-diffimage-20260311-0512
./argocd.sh set-branch u/michitaro/fov-quicklook-diffimage-20260311-0512 --sync
git -C ../k8s/phalanx branch --show-current
./argocd.sh set-branch "$(git -C ../k8s/phalanx branch --show-current)" --sync
ArgoCD sync
マニフェストをクラスタに適用する。ブランチ変更後やHelm valuesの更新後に使用。
cd dev
./argocd.sh sync
技術的な仕組み
- 再起動: ArgoCD CLI (
argocd app actions run) を使用。--auth-token にブラウザのcookie JWTを渡す
- 状態確認: ArgoCD REST API (
GET /api/v1/applications/fov-quicklook/resource) を使用。Cookie認証
- CLIの
argocd app get はproject get権限の問題でこの環境では使用不可
安全性
- 操作対象は
fov-quicklook アプリケーションのみに制限
- ArgoCD CLIのサーバ指定:
--server usdf-rsp-dev.slac.stanford.edu --grpc-web --grpc-web-root-path /argo-cd
- REST APIのベースURL:
https://usdf-rsp-dev.slac.stanford.edu/argo-cd/api/v1/applications/fov-quicklook/
phalanx-check / phalanx-push は applications/fov-quicklook/ など許可済み path 以外を含む push を停止する- Phalanx の安全 push は
u/michitaro/fov-quicklook-* branch のみに制限される
ブランチ名のルール
このタスクでは、fov-quicklook アプリ repo と Phalanx repo でルールが異なる。
fov-quicklook アプリ repo (lsst-sqre/fov-quicklook)
GitHub Actions のビルドではブランチ名が Docker イメージタグに使われるため、
ブランチ名に / を含めないこと。
- ✗
feature/alpha-channel — ビルドがトリガーされない
- ✓
feature-alpha-channel — 正常にビルドされる
copilot- プレフィックスは不要。通常の説明的なブランチ名を使えばよい。
Phalanx repo (lsst-sqre/phalanx)
Phalanx 側の fov-quicklook 用ブランチは、u/michitaro/fov-quicklook-
で始まる名前を使うこと。
- ✓
u/michitaro/fov-quicklook-diffimage-20260311-0512
- ✗
copilot-by-uuid-main-20260310-2347
u/michitaro/fov-quicklook/... のような / 区切り branch は、
remote に既存の u/michitaro/fov-quicklook ref があるため
Git の file/directory conflict で push できない。現状では
u/michitaro/fov-quicklook-... 形式を使う。
既存ブランチをリネームする場合:
git branch -m old-name new-name
git push origin -u new-name
git push origin --delete old-name
典型的なフロー
- 標準の deploy request:
uv run deploy-broker-client request-deploy ...
- 参照ブランチ確認:
uv run deploy-broker-client argocd-get-branch
- 状態確認:
uv run deploy-broker-client argocd-status
- 必要なら追加 sync:
uv run deploy-broker-client argocd-sync
- 必要なら再起動:
uv run deploy-broker-client argocd-restart
- 必要ならログ確認:
uv run deploy-broker-client argocd-logs coordinator
- deploy 後の HTTP 検証:
./dev/verify-deploy.sh all または broker から app token を取って直接確認
