메뉴
deploy broker または ArgoCD経由でfov-quicklookアプリケーションを操作する。 デプロイ、状態確認、ログ取得、再起動、ロールアウト、ArgoCD操作、Phalanxブランチ切替に関するタスクで使用する。 対象はusdf-rsp-devのfov-quicklookアプリケーションのみ。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | argocd-deployment |
| description | deploy broker または ArgoCD経由でfov-quicklookアプリケーションを操作する。 デプロイ、状態確認、ログ取得、再起動、ロールアウト、ArgoCD操作、Phalanxブランチ切替に関するタスクで使用する。 対象はusdf-rsp-devのfov-quicklookアプリケーションのみ。 |
標準の 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 で公開する。
cd dev/deploy-brokerhttp://127.0.0.1:8010 に届くこと（通常は SSH tunnel）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
cd dev/deploy-broker
# ArgoCD sync
uv run deploy-broker-client argocd-sync
# 主要コンポーネント(coordinator, generator, frontend, debug)を再起動
uv run deploy-broker-client argocd-restart
# 特定のDeploymentだけ再起動
uv run deploy-broker-client argocd-restart coordinator
uv run deploy-broker-client argocd-restart generator frontend
argocd.sh を使う手動運用dev/.argocd-token に保存されていることcd dev
./argocd.sh extract-token "<コピーしたcurlコマンド>"
cd dev
# 主要コンポーネント(coordinator, generator, frontend, debug)を再起動
./argocd.sh restart
# 特定のDeploymentだけ再起動
./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
| 短縮名 | フル名 | 役割 |
|---|---|---|
coordinator | fov-quicklook-coordinator | RPCハブ、ジョブ管理 |
generator | fov-quicklook-generator | FITS→タイル変換 |
frontend | fov-quicklook-frontend | UI提供 |
db | fov-quicklook-db | PostgreSQL（通常再起動しない） |
debug | fov-quicklook-debug | デバッグ用 |
cd dev
# coordinatorのログを表示（デフォルト）
./argocd.sh logs
# 特定コンポーネントのログ
./argocd.sh logs generator
./argocd.sh logs frontend
Podが起動に失敗している場合、ログの末尾にエラーメッセージが表示される。
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
# ブランチを変更して即座にsync
./argocd.sh set-branch u/michitaro/fov-quicklook-diffimage-20260311-0512 --sync
# ローカルの Phalanx branch を確認して合わせる場合
git -C ../k8s/phalanx branch --show-current
./argocd.sh set-branch "$(git -C ../k8s/phalanx branch --show-current)" --sync
マニフェストをクラスタに適用する。ブランチ変更後やHelm valuesの更新後に使用。
cd dev
./argocd.sh sync
argocd app actions run) を使用。--auth-token にブラウザのcookie JWTを渡すGET /api/v1/applications/fov-quicklook/resource) を使用。Cookie認証argocd app get はproject get権限の問題でこの環境では使用不可fov-quicklook アプリケーションのみに制限--server usdf-rsp-dev.slac.stanford.edu --grpc-web --grpc-web-root-path /argo-cdhttps://usdf-rsp-dev.slac.stanford.edu/argo-cd/api/v1/applications/fov-quicklook/phalanx-check / phalanx-push は applications/fov-quicklook/ など許可済み path 以外を含む push を停止するu/michitaro/fov-quicklook-* branch のみに制限されるこのタスクでは、fov-quicklook アプリ repo と Phalanx repo でルールが異なる。
lsst-sqre/fov-quicklook)GitHub Actions のビルドではブランチ名が Docker イメージタグに使われるため、
ブランチ名に / を含めないこと。
feature/alpha-channel — ビルドがトリガーされないfeature-alpha-channel — 正常にビルドされるcopilot- プレフィックスは不要。通常の説明的なブランチ名を使えばよい。
lsst-sqre/phalanx)Phalanx 側の fov-quicklook 用ブランチは、u/michitaro/fov-quicklook-
で始まる名前を使うこと。
u/michitaro/fov-quicklook-diffimage-20260311-0512copilot-by-uuid-main-20260310-2347u/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
uv run deploy-broker-client request-deploy ...uv run deploy-broker-client argocd-get-branchuv run deploy-broker-client argocd-statusuv run deploy-broker-client argocd-syncuv run deploy-broker-client argocd-restartuv run deploy-broker-client argocd-logs coordinator./dev/verify-deploy.sh all または broker から app token を取って直接確認