Docker ホストの元のデプロイ先で実行し、AP_CONTAINER を実際の名前に変更します。Compose の例は agenticpentest-workbench-1 です。イメージのリポジトリは既存コンテナから取得します。先にダウンロードし、停止後にデータをコピーします。バックアップは認証情報を含むため非公開で保管し、ツール分の容量も確保してください。独自のコンテナ内パスは docker inspect に合わせます。

AP_CONTAINER=agenticpentest
AP_BACKUP="$HOME/AgenticPenTest-backups/v1.0.4-$(date +%Y%m%d-%H%M%S)"
umask 077
mkdir -p "$AP_BACKUP"
docker inspect "$AP_CONTAINER" > "$AP_BACKUP/container.json"
AP_OLD_IMAGE="$(docker inspect --format '{{.Image}}' "$AP_CONTAINER")"
AP_IMAGE="$(docker exec "$AP_CONTAINER" node -p "require('./config/distribution.json').image")"
docker tag "$AP_OLD_IMAGE" "$AP_IMAGE:rollback-before-v1.0.4"
docker pull "$AP_IMAGE:v1.0.4"
AP_TOOLKIT="$(docker exec "$AP_CONTAINER" node -p "process.env.TOOLKIT_ROOT || '/opt/agenticpentest-tools'")"
docker stop "$AP_CONTAINER"
docker cp "$AP_CONTAINER:/var/lib/agenticpentest/." "$AP_BACKUP/data"
docker cp "$AP_CONTAINER:$AP_TOOLKIT/." "$AP_BACKUP/tools"

Compose： 元の Compose ファイル、env の絶対パス、プロジェクト名を設定します。すべての -f オーバーライドを両コマンドに残します。env をバックアップし、AP_IMAGE だけを変更してボリューム名は維持します。今後の更新のためホスト上のファイルを保持してください。

AP_COMPOSE="$PWD/compose.yaml"
AP_ENV="$PWD/.env"
AP_PROJECT=agenticpentest
touch "$AP_ENV"
cp -p "$AP_ENV" "$AP_BACKUP/runtime.env"
python3 - "$AP_ENV" "$AP_IMAGE:v1.0.4" <<'PY'
from pathlib import Path
import re, sys
p = Path(sys.argv[1])
text = p.read_text()
line = 'AP_IMAGE=' + sys.argv[2]
text = re.sub(r'^AP_IMAGE=.*$', line, text, flags=re.M) if re.search(r'^AP_IMAGE=', text, re.M) else text.rstrip() + '\n' + line + '\n'
p.write_text(text)
PY
docker compose -f "$AP_COMPOSE" --env-file "$AP_ENV" -p "$AP_PROJECT" pull workbench
docker compose -f "$AP_COMPOSE" --env-file "$AP_ENV" -p "$AP_PROJECT" up -d --no-build workbench

単独 Docker： 以下の再作成例は、下記クイックスタートを変更せず使った場合専用です。独自構成は保存した container.json から元のポート、環境、ボリューム/バインド、ネットワーク、安全設定を再現し、既定ボリュームに置き換えないでください。管理更新には --cap-drop ALL --security-opt no-new-privileges:true を維持します。確認中は停止した旧コンテナを残します。

docker rename "$AP_CONTAINER" "$AP_CONTAINER-before-v1.0.4"
docker run -d --name "$AP_CONTAINER" --restart unless-stopped \
  --cap-drop ALL --security-opt no-new-privileges:true \
  -p 127.0.0.1:8765:8765 \
  -e PUBLIC_ORIGIN=http://127.0.0.1:8765 \
  -v agenticpentest-data:/var/lib/agenticpentest \
  -v agenticpentest-tools:/opt/agenticpentest-tools \
  "$AP_IMAGE:v1.0.4"

healthy と 1.0.4 を確認し、元の URL・既存アカウントで資産、モデル、タスク、レポートを確認します。単独 Docker は確認後にのみ docker rm "$AP_CONTAINER-before-v1.0.4" で旧コンテナを削除します。-v は付けず、バックアップと復元用イメージは保持します。起動失敗時はデータ/鍵と元のイメージ・設定を戻してから再試行してください。

docker inspect --format '{{.State.Health.Status}}' "$AP_CONTAINER"
docker exec "$AP_CONTAINER" node -p "require('./package.json').version"

この管理手順は Linux 用です。元のソースディレクトリで、root ではない既存サービス所有者として実行します。AP_DATA、AP_UNIT、AP_ORIGIN を実際の絶対データパス、サービス名、ブラウザ URL に変更してください。前景プロセスはコピー前に Ctrl+C で停止します。外部ツールの場所は保持し別途バックアップします。新規インストーラや npm run init を既存環境で再実行しないでください。

AP_SOURCE="$PWD"
AP_DATA="$AP_SOURCE/data"
AP_UNIT=agenticpentest.service
AP_ORIGIN=http://127.0.0.1:8765
AP_REPOSITORY="$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["repository"])' "$AP_SOURCE/config/distribution.json")"
AP_BACKUP="$HOME/AgenticPenTest-backups/source-v1.0.4-$(date +%Y%m%d-%H%M%S)"
umask 077
mkdir -p "$AP_BACKUP"
if systemctl is-active --quiet "$AP_UNIT"; then sudo systemctl stop "$AP_UNIT"; fi
tar -czf "$AP_BACKUP/data.tar.gz" -C "$AP_DATA" .
if [ -f "$AP_SOURCE/.env" ]; then cp -p "$AP_SOURCE/.env" "$AP_BACKUP/app.env"; fi

変更のない公式 Git チェックアウト： git status --short が空の場合だけ実行します。独自変更は先に保存し、変更や履歴分岐がある状態で強制リセットしないでください。将来の main ではなく、公開済み v1.0.4 タグを選びます。

cd "$AP_SOURCE"
git status --short
git rev-parse HEAD > "$AP_BACKUP/source-commit.txt"
git fetch origin main refs/tags/v1.0.4:refs/tags/v1.0.4
git merge --ff-only v1.0.4

ZIP、Git メタデータなし、履歴分岐： 直前の Git ブロックは実行せず、隣の新規ディレクトリを作ります。元のディレクトリを復元用に残し、env をコピーして、絶対 AP_DATA と対応する鍵を引き続き使います。新ディレクトリは未作成である必要があります。外部ツールの場所を保持し、サービスの WorkingDirectory/ExecStart/env のパスを調整してください。空の data で既存データを上書きしないでください。

AP_PREVIOUS_SOURCE="$AP_SOURCE"
AP_SOURCE="${AP_PREVIOUS_SOURCE}-v1.0.4"
git clone --branch v1.0.4 "$AP_REPOSITORY" "$AP_SOURCE"
if [ -f "$AP_PREVIOUS_SOURCE/.env" ]; then cp -p "$AP_PREVIOUS_SOURCE/.env" "$AP_SOURCE/.env"; fi
if [ -d "$AP_PREVIOUS_SOURCE/.runtime/node" ]; then
  mkdir -p "$AP_SOURCE/.runtime"
  cp -a "$AP_PREVIOUS_SOURCE/.runtime/node" "$AP_SOURCE/.runtime/node"
fi
cd "$AP_SOURCE"

両方のソース経路で実行： 選択したディレクトリで元の環境を維持してビルドします。独立 Node があれば再利用し、固定されたクラウド SDK を導入します。必要なら事前にプロキシ環境変数を設定してください。続いて下のサービス設定とチャネル登録を行います。ネイティブ Windows/macOS ソースは Git/npm で手動更新できますが、この Linux/systemd チャネルには対応しません。

cd "$AP_SOURCE"
export PATH="$AP_SOURCE/.runtime/node/bin:$PATH"
npm ci
npm run build
python3 scripts/setup-cloud-sdk.py --install

Docker 管理者またはソースサービスの所有者として、デプロイ先ホスト上で実行します。Web コンテナ内や root として登録しないでください。 Docker 権限または承認済みの非対話 sudo、もしくは対象サービスだけの権限が必要です。SSH と Git/Python 3 を用意します。下は Ubuntu/Debian 用です。macOS はリモートログインを有効にして Git/Python 3 を確認します。ローカル SSH 鍵認証を確認し、~/.ssh/authorized_keys がなければ作成します。既存鍵は置き換えないでください。

sudo apt-get update
sudo apt-get install -y openssh-server git python3
sudo systemctl enable --now ssh
mkdir -p ~/.ssh
touch ~/.ssh/authorized_keys
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

他の Linux では対応する SSH パッケージとサービス名を使います。登録はホスト公開鍵を固定し、更新コマンド専用の鍵を作成します。Docker socket のマウントは不要です。

Docker： デプロイしたイメージに対応する v1.0.4 ソースを使います。既存ディレクトリへ cd するか、イメージに記録されたリポジトリを取得してください。AP_HOST_SOURCE が存在する場合は別の空ディレクトリを選びます。同じシェルで更新変数を保持し、AP_ENV はホストの絶対パスにします。

AP_REPOSITORY="$(docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.source" }}' "$AP_CONTAINER")"
AP_HOST_SOURCE="$HOME/AgenticPenTest-host"
git clone --branch v1.0.4 "$AP_REPOSITORY" "$AP_HOST_SOURCE"
cd "$AP_HOST_SOURCE"

Compose：プレビューを確認してから適用します：

python3 scripts/setup-platform-updater.py docker --container "$AP_CONTAINER" --env-file "$AP_ENV"
python3 scripts/setup-platform-updater.py docker --container "$AP_CONTAINER" --env-file "$AP_ENV" --apply

単独 Docker：env ファイル引数を省略します：

python3 scripts/setup-platform-updater.py docker --container "$AP_CONTAINER"
python3 scripts/setup-platform-updater.py docker --container "$AP_CONTAINER" --apply

ホストユーザーには対応イメージの取得権限が必要です。必要に応じホストで docker login を行います。イメージ取得は Docker daemon のプロキシ、システム設定のプロキシはアプリと更新メタデータ用です。macOS の SSH は host.docker.internal、Linux はループバックか Docker ゲートウェイが既定です。必要なら両方の登録コマンドに --host、--ssh-port、--host-key /absolute/path/to/ssh_host_ed25519_key.pub を追加します。公開メタデータにトークンは不要です。既存 network guard の統合と再登録権限は維持してください。

ソース： 既存 systemd ユニットと実行設定を維持します。systemctl show "$AP_UNIT" -p User -p WorkingDirectory -p ExecStart -p EnvironmentFiles で、このソースが登録ユーザーとして、元のデータ・URL で実行されることを確認します。パス変更は sudo systemctl edit --full "$AP_UNIT" で行ってください。ユニットがない場合に限り、前景プロセスを停止して下のテンプレートを使用します。AP_TOOLKIT を既存ツールの絶対パスに変更します。隣接ソース方式では旧ディレクトリのままでも構いません。既存ユニットをテンプレートで上書きしないでください。

AP_USER="$(id -un)"
AP_NODE="$(command -v node)"
AP_TOOLKIT="$AP_SOURCE/tools/toolkit"
if [ -x "$AP_SOURCE/.runtime/node/bin/node" ]; then AP_NODE="$AP_SOURCE/.runtime/node/bin/node"; fi
if ! systemctl cat "$AP_UNIT" >/dev/null 2>&1; then
sudo tee "/etc/systemd/system/$AP_UNIT" >/dev/null <<EOF
[Unit]
Description=AgenticPenTest
After=network.target
[Service]
Type=simple
User=$AP_USER
WorkingDirectory=$AP_SOURCE
EnvironmentFile=-"$AP_SOURCE/.env"
Environment="WORKBENCH_DATA=$AP_DATA" "PUBLIC_ORIGIN=$AP_ORIGIN" "TOOLKIT_ROOT=$AP_TOOLKIT"
ExecStart="$AP_NODE" "--env-file-if-exists=$AP_SOURCE/.env" "$AP_SOURCE/server.mjs"
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now "$AP_UNIT"
fi

既存の Linux ホスト network guard がある場合、初回の手動再起動後に新しい Node ホスト PID へ再登録し、元の制限値を保持してください。ソースチャネル登録前に行うと、更新器が guard を認識できます。既存の隔離手順に従い、socket マウントの削除やポリシー緩和で回避しないでください。

このサービスの start/stop だけを許可し、sudo 規則を検証して起動後、登録をプレビュー・適用します。規則ファイルが既にある場合は管理者が統合し、上書きしないでください。ホスト network guard には別途審査済みの再登録権限が必要で、下のサービス権限だけでは付与されません。

AP_USER="$(id -un)"
AP_SYSTEMCTL="$(command -v systemctl)"
AP_RULE="$(mktemp)"
printf '%s ALL=(root) NOPASSWD: %s start %s, %s stop %s\n' \
  "$AP_USER" "$AP_SYSTEMCTL" "$AP_UNIT" "$AP_SYSTEMCTL" "$AP_UNIT" > "$AP_RULE"
sudo visudo -cf "$AP_RULE"
if sudo test -e /etc/sudoers.d/agenticpentest-updater; then
  cat "$AP_RULE"
  sudo visudo -f /etc/sudoers.d/agenticpentest-updater
else
  sudo install -m 0440 "$AP_RULE" /etc/sudoers.d/agenticpentest-updater
fi
rm -- "$AP_RULE"
sudo systemctl start "$AP_UNIT"
systemctl is-active "$AP_UNIT"
curl -fsS "$AP_ORIGIN/api/auth"
cd "$AP_SOURCE"
python3 scripts/setup-platform-updater.py source --source-root "$AP_SOURCE" --unit "$AP_UNIT" --data-dir "$AP_DATA" --origin "$AP_ORIGIN"
python3 scripts/setup-platform-updater.py source --source-root "$AP_SOURCE" --unit "$AP_UNIT" --data-dir "$AP_DATA" --origin "$AP_ORIGIN" --apply

{
  "mcpServers": {
    "agenticpentest": {
      "command": "node",
      "args": [
        "<project-directory>/scripts/mcp-stdio.mjs"
      ],
      "env": {
        "AP_MCP_URL": "https://workbench.example/mcp",
        "AP_MCP_TOKEN": "<developer-credential>",
        "AP_MCP_WORKSPACE": "personal"
      }
    }
  }
}

例のパス、必要に応じて Node.js のコマンド、トークンを自分の環境に合わせて置き換えます。AP_MCP_URL は利用するインスタンス、AP_MCP_WORKSPACE はその認証情報で許可された personal または team を指定します。設定形式はクライアントによって異なります。