macOS(Apple Silicon)で動かす
Apple Silicon の Mac で、Agent Fleet を 1 人で使えるように動かします。 Docker のエンジン(colima・OrbStack・Docker Desktop)で動かすか、Linux の VM の中でネイティブパッケージを動かすかを選べます。
| あなたがやること | 起きること |
|---|---|
.env に Mac 用の値を書く |
Control Plane が 1 人用(AUTH=dev)で起動する |
オーバーレイのファイル docker-compose.macos.yml を足して起動する |
Control Plane がブリッジネットワークで動き、host.docker.internal でワークスペースに届く |
Mac のブラウザで http://127.0.0.1:8099 を開く |
Console が開き、ワークスペースを起動できる |
対象と対象外は次のとおりです。
| 対象 | 対象外 |
|---|---|
| Apple Silicon の Mac で、1 人で使う | Intel の Mac(動かしたことがありません) |
| colima・OrbStack・Docker Desktop | チームや公開の配備(この構成には Caddy も IdP もありません) |
| Lima・OrbStack のマシンの中のネイティブパッケージ | Apple の container ツール(Docker のデーモンではないので、Control Plane が動かせません) |
Docker のエンジンで動かす
Section titled “Docker のエンジンで動かす”イメージは linux/arm64 でも公開されていて、Mac は合うほうを取ります。Linux と違うのは、コンテナから Docker を動かすときの配線です。
colima・OrbStack・Docker Desktop のそれぞれで、ワークスペースの起動、linux/arm64、共有ディレクトリの home の所有者と権限、headless Chromium、停止→起動で home が残ることを確かめてあります。
- colima は
colima start --vm-type vz --mount-type virtiofsで起動したものです - OrbStack と Docker Desktop は、Mac にログインした画面から 1 回起動しておく必要があります。そのあとは、どのターミナルからでも下のコマンドが動きます
1. .env を書く
Section titled “1. .env を書く”Docker Compose で構築する のシークレットに加えて、次を書きます。
AUTH=dev # one fixed user, no IdPAF_ALLOW_INSECURE_DEV_AUTH=1 # required: the CP refuses AUTH=dev on Docker without itAF_PROVISION=auto # the template's `invite` leaves that user in no tenantPUBLIC_BASE_URL=http://127.0.0.1:8099AF_TRUSTED_PROXY_HOPS=0 # no Caddy in front; the template's 1 assumes oneVERSION=<version> # the template's `dev` is not a published CP tagWS_IMAGE=ghcr.io/k-k1/agent-fleet/workspace:<version># (B) a directory the engine shares with its VM — under your home works for all threeDATA_DIR=/Users/<you>/agent-fleet/data# (C) the socket's group as the engine reports it, not a host `docker` group# (measured: 991 on colima, 0 on OrbStack and Docker Desktop):# docker run --rm -v /var/run/docker.sock:/var/run/docker.sock alpine stat -c %g /var/run/docker.sockDOCKER_GID=<that number>| 値 | 理由 |
|---|---|
DATA_DIR |
エンジンが VM と共有するディレクトリに置きます。ホームディレクトリの下なら 3 つのエンジンのどれでも共有されます |
DOCKER_GID |
ホストの docker グループではなく、エンジンが見せるソケットのグループです。colima では 991、OrbStack と Docker Desktop では 0 でした。エンジンごとに測り直します |
2. オーバーレイを足して起動する
Section titled “2. オーバーレイを足して起動する”docker compose -f docker-compose.yml -f docker-compose.macos.yml up -dMac のブラウザで http://127.0.0.1:8099 を開きます。
オーバーレイが変えること
Section titled “オーバーレイが変えること”コンテナから Docker を動かす 3 つの制約 のうち、Mac で変わるところです。
| 制約 | Mac での扱い |
|---|---|
| A. ホストのネットワーク | Mac ではデーモンが Linux の VM の中で動くので、「ホスト」は VM です。オーバーレイは Control Plane をブリッジネットワークに置き、host.docker.internal(WS_AGENT_HOST)でワークスペースに届きます。ワークスペースの中の 127.0.0.1 はワークスペース自身を指すので、ワークスペースには同じ名前で ワークスペース専用のリスナー を渡します。2 つのポートは Mac のループバックにだけ公開されます |
B. DATA_DIR の絶対パス |
home は、エンジンが VM と共有するディレクトリに置かれます。colima と virtiofs では、ファイルは uid 1000 と権限(~/.ssh は 700、新しいファイルは 600)を保ち、書き込みもコンテナ自身のディスクより遅くありませんでした。ほかのエンジンのファイル共有は振る舞いが違うことがあります |
| C. ユーザーと docker グループ | 上の DOCKER_GID |
まだ確かめていない別の方法もあります。Docker Desktop 4.34 以降はホストネットワーキングを有効にでき(Settings → Resources → Network)、OrbStack は network_mode: host に対応しています。これを使えば、docker-compose.yml をそのまま使えるかもしれません。
Linux の VM でネイティブパッケージを動かす
Section titled “Linux の VM でネイティブパッケージを動かす”macOS には bubblewrap も Linux のユーザー名前空間もなく、ワークスペースの rootfs は Linux です。そのため macOS 用のパッケージはなく、install.sh は Mac では実行を断ります。
- Linux の VM を用意します(Lima、OrbStack のマシン(
orb create ubuntu)など) - VM の中で
linux-arm64のパッケージを入れ、af startします(ネイティブパッケージを入れる) - Mac のブラウザから、VM のポートフォワードで
http://localhost:8099を開きます
- Lima の Ubuntu LTS のテンプレートと、OrbStack のマシンで、インストール・起動・ワークスペースの起動・停止→起動を確かめてあります。OrbStack のマシンのポートは、Mac の
localhostにも届きます - Ubuntu の VM は、ほかの Ubuntu 23.10 以降と同じく、特権のないユーザー名前空間を制限しています。先に AppArmor の設定 をしておきます
うまくいかないとき
Section titled “うまくいかないとき”| 症状 | 見るところ |
|---|---|
Control Plane が AUTH=dev を拒んで起動しない |
AF_ALLOW_INSECURE_DEV_AUTH=1 |
| サインインしても、どのテナントにも入れない | AF_PROVISION=auto |
| docker のソケットで permission denied | DOCKER_GID を、使っているエンジンで測り直したか |
| エンジンを切り替えたら、前のデータが見える・ポートが衝突する | エンジンごとに DATA_DIR を分け、前のエンジンを止めてから docker context use <名前> で切り替えます |
エージェント向け
この指示をエージェントに送ると、このページを読ませられます。
https://agent-fleet.org/docs/ja/operate/compose/macos/index.md を読んで