Docker Compose で構築する
1 台の Linux ホストに Docker Compose で Agent Fleet を構築し、最初の管理者がサインインできるところまでのコマンドをまとめます。 各手順で何を決めるかは インストールする にあります。このページは、その手順を実際に打つときに開きます。
| あなたがやること | 起きること |
|---|---|
.env を作り、シークレット・DOCKER_GID・公開 URL・IdP を書く |
Control Plane がこの値で起動する |
| ワークスペースのイメージを用意する(ビルドか取得) | Control Plane がメンバーごとに docker run でワークスペースを起動できる |
docker compose up -d で起動する |
Control Plane(cp)と Caddy が動き、Caddy が TLS の証明書を取る |
SUPER_ADMIN_EMAILS のアカウントでサインインする |
そのアカウントが配備管理者になり、ワークスペースを起動できる |
作業するディレクトリは deploy/compose/ です(リリースのバンドルなら、展開したディレクトリ)。
このディレクトリにあるもの
Section titled “このディレクトリにあるもの”| ファイル | 役目 |
|---|---|
docker-compose.yml |
cp(Control Plane)と caddy(TLS の自動取得)のサービス |
Caddyfile |
リバースプロキシと Let’s Encrypt(ACME)。自己署名に切り替える tls internal もここにあります |
.env.example |
すべての設定。.env にコピーして使います |
backup.sh・restore.sh |
バックアップと復元(バックアップして復元する) |
load-images.sh |
ローカルの tar からイメージを読み込む。レジストリに届かないホスト専用です(閉じたネットワークに入れる) |
release.sh |
バージョンの付いたリリースのバンドルを作る。メンテナー向けです |
docker-compose.macos.yml |
Mac で動かすためのオーバーレイ(macOS(Apple Silicon)で動かす) |
リリースのイメージは GHCR に公開されています。
ghcr.io/k-k1/agent-fleet/control-plane:<版>とghcr.io/k-k1/agent-fleet/workspace:<版>です.envのREGISTRYとVERSIONで決まります。公開のパッケージなので、レジストリへのログインはいりません- 社内のミラーから取るときは、
REGISTRYをそこに向けます
| 用意するもの | 補足 |
|---|---|
Docker(Engine と docker compose)が動く Linux ホスト |
Apple Silicon の Mac なら 1 人で使えます(macOS(Apple Silicon)で動かす) |
| 公開ドメインと、このホストを指す DNS の A / AAAA レコード | TLS に使います。社内だけなら Caddyfile の tls internal を使います |
| サインイン用の IdP のクライアント | Google の OAuth 2.0 ウェブクライアント、または Entra ID・Okta・Keycloak・Auth0・Cognito・GitLab の OIDC アプリ。登録するリダイレクト URI は、いくつ使っても 1 つです |
| エージェントのシート | 各メンバーが最初の起動のあとに Console から自分のシートでログインします。個人の Pro / Max より、会社の Team / Enterprise のシートをおすすめします |
(agy を使うなら)RDRAND を出す CPU |
下の「Antigravity CLI と RDRAND」 |
SAML しかない IdP(HENNGE One・TrustLogin・CloudGate など)は、oauth2-proxy か Keycloak を前に置いて AUTH=proxy で使います。
Antigravity CLI と RDRAND
Section titled “Antigravity CLI と RDRAND”agy(Antigravity CLI)は FIPS のビルドで、CPU の RDRAND 命令がないと起動の時点で止まります。grep -w rdrand /proc/cpuinfo で確かめます。
- カーネルが命令を取り下げているホスト(RDRAND が定数を返す AMD Ryzen Embedded など)では、Agent が OpenSSL の CPU 検出から RDRAND を外して agy を動かします。このとき乱数は CPU ではなくカーネルから取り、Console の agy のカードにそう出ます
- FIPS モジュール自身のエントロピー源を必須とする配備では、
AF_AGY_RDRAND_MASK=0を設定します。そのときは、エージェントの選択肢からagyが消えます
公開リリースから始めるとき
Section titled “公開リリースから始めるとき”配布リポジトリ の install-compose.sh が、バンドルの取得・検証・展開と、GHCR からのイメージの取得までを行います。
終わると、下の手順 1 の cp .env.example .env から続けられます。このページの手順は、手作業で(またはソースから)構築する場合のものです。
1. 設定を書いてソースから起動する
Section titled “1. 設定を書いてソースから起動する”DATA_DIR は、Control Plane が動くユーザー(uid 1000、docker-compose.yml の user: "1000:1000")が書けるようにして作ります。既定の /srv/agent-fleet/data はふつうのユーザーには作れないので、下の 4) のとおり sudo で作って所有者を 1000:1000 にします。
cd deploy/composecp .env.example .env# 1) シークレットを作って .env に書く:head -c 32 /dev/urandom | base64 # -> AF_MASTER_KEY (控えをパスワードマネージャーに残す)head -c 32 /dev/urandom | base64 # -> AF_COOKIE_SECRET# 2) DOCKER_GID にホストの docker グループを入れる:getent group docker | cut -d: -f3 # -> DOCKER_GID# 3) .env に PUBLIC_DOMAIN / PUBLIC_BASE_URL / IdP(GOOGLE_OAUTH_* と# AF_OIDC_* のどちらか、または両方)/ AF_OAUTH_ALLOWED_DOMAINS / SUPER_ADMIN_EMAILS / DATA_DIR を書く# 4) DATA_DIR を作り、CP を動かすユーザー uid 1000 の持ち物にする(既定の# /srv/agent-fleet/data には sudo が要る):DATA_DIR="$(grep -E '^DATA_DIR=' .env | cut -d= -f2)"sudo mkdir -p "$DATA_DIR" && sudo chown 1000:1000 "$DATA_DIR"
# 5) ユーザーごとのワークスペースのイメージをビルドする(compose がビルドするのは CP だけ。# CP は WS_IMAGE からワークスペースを起動する。既定は agent-fleet/workspace:dev):docker build -t agent-fleet/workspace:dev ../../workspace
docker compose up -d --build # ソースからdocker compose logs -f cpAF_MASTER_KEYは、作ったその場でパスワードマネージャーに控えます。DATA_DIRにもバックアップにも入りません(配備のキーを扱う)DOCKER_GIDを間違えると、docker のソケットで permission denied になります- 各変数の意味は
.env.example自体に書いてあります。何を選ぶかは インストールする の手順 1〜4 です
2. 公開リリースのイメージで起動する
Section titled “2. 公開リリースのイメージで起動する”ビルドせずに公開リリースを動かすときは、REGISTRY・VERSION・WS_IMAGE をバンドルに入っている値のままにし、手順 1 の 5)(イメージのビルド)を飛ばしてイメージを取得します。
docker compose pull # cp + caddydocker pull "$(grep -E '^WS_IMAGE=' .env | cut -d= -f2)" # ワークスペース(下を参照)docker compose up -dワークスペースのイメージは compose のサービスではありません。Control Plane がメンバーごとに docker run で起動するので、docker compose pull では取れません。
- 先に取っておかなくても、最初のワークスペースの起動で取得されます
- 先に取っておくと、最初に「起動」を押した人が数分待たずに済みます
3. サインインの IdP を書く
Section titled “3. サインインの IdP を書く”.env に書くキーと、IdP の側で作るものは IdP ごとのページにあります。
| IdP | ページ |
|---|---|
| Google でサインインする | |
| Microsoft Entra ID | Microsoft Entra ID でサインインする |
| GitHub | GitHub でサインインする |
| Okta・Keycloak・Auth0・Cognito・GitLab | そのほかの OIDC でサインインする |
どの IdP でも、登録するリダイレクト URI は次の 1 つです。
https://<PUBLIC_DOMAIN>/oauth2/callbackリポジトリをクローンするための GitHub・Bitbucket の「OAuth で接続」は、.env ではなく、テナント管理者が Console で登録します(連携に使う OAuth アプリを選ぶ)。
4. 最初の管理者としてサインインする
Section titled “4. 最初の管理者としてサインインする”https://<PUBLIC_DOMAIN>を開きますSUPER_ADMIN_EMAILSに書いたアカウントでサインインします- ワークスペースを起動します
SUPER_ADMIN_EMAILSは起動のときに 1 回だけ読まれ、配備管理者を決めるのはこの値だけです。リストから外して再起動すると、その人の配備管理者のロールも外れます.env.exampleはAF_PROVISION=inviteで始まります。管理者が追加するまで、ほかの人にはワークスペースができません。追加された人は、AF_OAUTH_ALLOWED_*に入っていなくてもサインインできます- テナント・メンバー・テナント専用のサインインページ(
<PUBLIC_BASE_URL>/login/<slug>)の決め方は テナントとプロビジョニングの方式を決める にあります - 人を外す方法は アクセスを取り消す・super_admin を引き継ぐ にあります
うまくいかないとき
Section titled “うまくいかないとき”| 症状 | 見るところ |
|---|---|
| Control Plane が起動しない | docker compose logs cp。curl -s http://127.0.0.1:8099/healthz が ok を返すか |
| docker のソケットで permission denied | DOCKER_GID が getent group docker と同じか |
| サインインがいつも拒否される | 許可リストがすべて空で、まだ誰も招待していない(ログインできない) |
| ワークスペースから公開 URL に届かない | ワークスペースから CP に届かないとき |
ほかの症状は 症状から原因を探す にあります。
エージェント向け
この指示をエージェントに送ると、このページを読ませられます。
https://agent-fleet.org/docs/ja/operate/compose/install/index.md を読んで