fix(tools): 接続できないときの案内を実態に合わせる

measure.sh は 000(接続不可)にも「egg-info を再生成して再起動」と案内して
いたが、これはコードの新旧の問題ではなく測定条件が実機と違う場合で、
従っても直らない。000 は専用の案内に分け、動いているコンテナと公開ポートを
出して measure_profile.json を直すよう促す。

preflight.sh はコンテナ名と URL を実機から探して export 行の形で出す。
compose のプロジェクト名はチェックアウト先のディレクトリ名になるため、
weko-web-1 / :8443 という既定は環境によって当たらない。
あわせて curl 失敗時に code が "000000" になる連結も直した。

OPERATIONS.md §2-4 に実際の値の調べ方と、既に作られた
measure_profile.json は環境変数では変わらないことを書いた。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: Masaharu Hayashi

docs/OPERATIONS.md

@@ -110,11 +110,42 @@ export WEKO_HOST_HEADER=weko3.example.org
 export INV=tools/api-inventory/scripts
 ```
 
-**実機の場所（コンテナ名・URL・Host）を既定から変えているなら、この 3 つを必ず設定する。**
-台帳ツールは初回に `$WEKO_API_INVENTORY_DIR/measure_profile.json` を作るとき、この 3 つを既定値として書き込む。
+#### 自分の環境の値を調べる
+
+**上の既定値をそのまま使えるとは限らない。** compose のプロジェクト名は
+**チェックアウトしたディレクトリ名**になるので、`~/wekov2` に clone していればコンテナは
+`weko-web-1` ではなく `wekov2-web-1` になる。公開ポートも compose ファイル次第で変わる。
+
+```bash
+docker ps --format '{{.Names}}  {{.Ports}}' | grep -E 'web|nginx'
+```
+
+```text
+wekov2-nginx-1  0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp     ← 443 なので https://localhost
+wekov2-web-1    0.0.0.0:5001->5000/tcp                        ← これが WEKO_WEB_CONTAINER
+```
+
+この例なら次のようになる。**`preflight.sh` は正しい値を見つけて `export` 行の形で出すので、
+分からなければ先に流してよい**（§2-6）。
+
+```bash
+export WEKO_WEB_CONTAINER=wekov2-web-1
+export WEKO_BASE_URL=https://localhost
+```
+
+#### `measure_profile.json` との関係
+
+台帳ツールは初回に `$WEKO_API_INVENTORY_DIR/measure_profile.json` を作るとき、上の 3 つを既定値として書き込む。
 **作られたあとは JSON が正**で、環境変数を変えても既存のファイルは書き換わらない
 （測定条件を変えたいときは JSON を直す。`tools/api-inventory/scripts/README.md`）。
 
+**すでに間違った値で作られている場合は JSON を直す。** 環境変数だけ直しても `measure.sh` は
+古い値を使い続け、「トップページが 000」で止まる。
+
+```bash
+grep -E 'web_container|base_url' "$WEKO_API_INVENTORY_DIR/measure_profile.json"
+```
+
 毎回打つのが面倒なら前の 2 つを `~/.bashrc` に書いてよい。
 **`INV` は相対パスなので、`~/weko` の中で作業しているときしか使えない。**
 
@@ -501,6 +532,7 @@ git push origin v2.1.0
 |---|---|---|
 | `no python application found` / `AttributeError: module ... has no attribute` | egg-info の再生成漏れ | 手順 2 をやり直す。再生成前後で件数が変わらないことを確認するまで確定させない |
 | 切り替えたのに旧バージョンの経路が生きている | uwsgi が古いコードのまま | 手順 2 の再起動と確認コマンド |
+| `measure.sh` が「トップページが 000」で止まる | 接続できていない。プロファイルの `base_url` / `web_container` が実機と違う | §2-4 で実際の値を調べ、`measure_profile.json` を直す。コードの新旧とは無関係なので egg-info を作り直しても直らない |
 | `reconcile.py` の件数が減らない | 台帳の行の追加漏れ、または `impl_file` の記載誤り | `reconcile.py`（`--gate` なし）で A/B/C/D/E の内訳を読む。詳細は `tools/api-inventory/ci/README.md` §4 |
 | 測定結果が「ほぼ全部遮断」 | 書き込み系を叩いて自分のセッションを消した | 手順 6 の 2 つの確認。`--refresh-fixtures` で張り直して測り直す |
 | ゲートが落ちて先へ進めない | G1〜G9 / reconcile A〜E | `docs/RULE.md` §3-3 の原則に従う。**G3/G4/G8/G9 の例外は RCOS 公開基盤チームリーダの承認が要る** |

tools/api-inventory/scripts/measure.sh

@@ -53,6 +53,18 @@ if [ -z "$SKIP_VERIFY" ]; then
   # snapshot.py は毎回新プロセスなので即反映されるが、probe は uwsgi を叩くため
   # egg-info の再生成と restart をしないと別バージョンを測ることになる。
   code="$(curl -sk --max-time 20 -o /dev/null -w '%{http_code}' -H "Host: $HOSTHDR" "$BASE/" || true)"
+  if [ "$code" = "000" ]; then
+    # 接続そのものができていない。コードの新旧ではなく、測定条件が実機と違う。
+    say "  ★$BASE/ に接続できません(code=000)。プロファイルの値が実機と合っていません。"
+    say "     いま動いているコンテナと公開ポート:"
+    if command -v docker >/dev/null 2>&1; then
+      docker ps --format '       {{.Names}}  {{.Ports}}' 2>/dev/null | grep -E 'web|nginx' || say "       (該当なし。実機が起動していない)"
+    fi
+    say "     合う値を $PROFILE の base_url / web_container に書くこと。"
+    say "     compose のプロジェクト名はチェックアウト先のディレクトリ名になるので、"
+    say "     コンテナ名は weko-web-1 とは限らない(例 wekov2-web-1)。"
+    exit 1
+  fi
   if [ "$code" != "200" ]; then
     say "  ★トップページが $code。egg-info を再生成して web を再起動してください。"
     say "     docker exec $WEB_CONTAINER bash -lc 'cd /code && for d in modules/*/; do (cd \"\$d\" && python setup.py -q egg_info); done'"

tools/release/preflight.sh

@@ -110,14 +110,37 @@ HOSTHDR="${WEKO_HOST_HEADER:-weko3.example.org}"
 if command -v docker >/dev/null 2>&1; then
   if docker ps --format '{{.Names}}' 2>/dev/null | grep -qx "$WEB"; then
     ok "実機コンテナが動いている（$WEB）"
-    code=$(curl -sk -o /dev/null -w '%{http_code}' -H "Host: $HOSTHDR" "$BASEURL/" 2>/dev/null || echo 000)
-    if [ "$code" = "200" ]; then
-      ok "トップページが 200（$BASEURL / Host: $HOSTHDR）"
+  else
+    # compose のプロジェクト名はチェックアウト先のディレクトリ名になるため、
+    # コンテナ名は weko-web-1 とは限らない。動いているものから候補を出す。
+    cand=$(docker ps --format '{{.Names}}' 2>/dev/null | grep -E -- '-web-1$|^web$|web' | head -1 || true)
+    if [ -n "$cand" ]; then
+      ng "実機コンテナ $WEB が動いていない（動いているのは $cand）" "export WEKO_WEB_CONTAINER=$cand"
+    else
+      ng "実機コンテナ $WEB が動いていない" "./install.sh で起動する（別名なら export WEKO_WEB_CONTAINER=...）"
+    fi
+  fi
+
+  # curl は接続失敗でも '000' を出力して非ゼロで終わる。|| echo で足すと二重になる。
+  code=$(curl -sk --max-time 10 -o /dev/null -w '%{http_code}' -H "Host: $HOSTHDR" "$BASEURL/" 2>/dev/null || true)
+  [ -n "$code" ] || code=000
+  if [ "$code" = "200" ]; then
+    ok "トップページが 200（$BASEURL / Host: $HOSTHDR）"
+  elif [ "$code" = "000" ]; then
+    # 接続できていない。URL が実機と違う可能性が高いので、候補を当たって出す。
+    found=""
+    for u in https://localhost https://localhost:8443 http://localhost http://localhost:8080; do
+      [ "$u" = "$BASEURL" ] && continue
+      c=$(curl -sk --max-time 5 -o /dev/null -w '%{http_code}' -H "Host: $HOSTHDR" "$u/" 2>/dev/null || true)
+      [ "$c" = "200" ] && { found="$u"; break; }
+    done
+    if [ -n "$found" ]; then
+      ng "$BASEURL/ に接続できない（$found なら 200）" "export WEKO_BASE_URL=$found"
     else
-      caut "トップページが $code（200 でない）" "起動直後なら待つ。続くなら docker logs $WEB を見る"
+      ng "$BASEURL/ に接続できない（code=000）" "実機が起動しているか、公開ポートを確認する: docker ps --format '{{.Names}}  {{.Ports}}'"
     fi
   else
-    ng "実機コンテナ $WEB が動いていない" "./install.sh で起動する（別名なら export WEKO_WEB_CONTAINER=...）"
+    caut "トップページが $code（200 でない）" "起動直後なら待つ。続くなら docker logs $WEB を見る"
   fi
 fi