> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# クイックスタート
> アウトポストを作成し、単一のマシンからセッションを処理する
* Outposts が有効になっている組織
* 必要な Outposts スコープを持つ [v3 API トークン](/ja/api-reference/v3/overview):
* アウトポストを管理するオーケストレーター用の `account.outposts.orchestrator` (マシンスコープを含む)
* キューを読み取り、セッションを引き取る／解放するワーカー用の `account.outposts.machine`
* 以下を備えたマシン (VM またはコンテナ) :
* Devin CLI がインストールされている
* [マシン依存関係](/ja/onboard-devin/outposts#machine-dependencies)
* リポジトリがクローンされ、リモートが設定されている
* セッションに必要なビルドツール、パッケージレジストリ、シークレット、内部サービスにアクセスできること
セッションは、ユーザーの権限でマシン上に直接実行されます。ワーカーは、エージェントに自由に作業させても差し支えない専用ディレクトリで実行することをおすすめします。できれば、デスク上の Mac Mini のように、長時間の自律的な作業専用のマシンで実行するのが理想です。
[Devin CLI](/ja/cli) をダウンロードしてインストールします。
```bash theme={null}
curl -fsSL https://cli.devin.ai/install.sh | bash
```
[Devin Cloud](https://app.devin.ai) で、Settings → Environment → Outposts に移動し、「Create Outpost」ボタンをクリックします。
アウトポストに名前を付け、提供するマシンの種類 (例: Linux、Windows、Mac) を選択します。次に、「Create」ボタンをクリックします。
アウトポストを作成すると、割り当てるワーカーが Devin に認証するためのアウトポストトークンが発行されます。
トークンをコピーして、安全な場所に保存してください。**トークンはアウトポスト作成時に一度だけ表示されます**。
ワーカーを実行したいディレクトリに移動します。
```bash theme={null}
cd /path/to/worker/directory
```
次に、先ほどコピーしたアウトポスト名とトークンを指定して `devin worker start` コマンドを実行します。
```bash theme={null}
devin worker start --outpost= --token=
```
[Devin Cloud](https://app.devin.ai) で新しいセッションを開始し、アウトポスト上で実行するよう設定します。「Configuration」→「Virtual environment」に、新しいアウトポストが表示されます。これを選択すると、そのアウトポスト上でセッションを実行できます。
これで、あなたのマシンでビルドを始めるよう Devin に依頼できます。まずは次のような簡単なものを試してみてください。
```
Create a "hello world" python script for me
```
ワーカーのディレクトリにスクリプトが現れるはずです。
### 次のステップ
コードがあるディレクトリでワーカーを起動し、その上でビルドするよう Devin に依頼してください。セッションからは、ワーカーの作業ディレクトリ配下にチェックアウトされたリポジトリを参照できます。より多くのセッションを同時に処理するには、同じアウトポストを指定したワーカーをより多くのマシンで実行してください。N 台のワーカーで N 件のセッションを同時に処理し、それ以外はキューで待機します。
常駐ワーカーを維持する代わりに、セッションがキューに入るたびにマシンを自動的にプロビジョニングします。
すでに利用しているプラットフォーム上でアウトポストを実行できます — Namespace、Modal、E2B などに対応しています。
[Devin Cloud](https://app.devin.ai) で Settings → Environment → Outposts を開き、"Create Outpost" ボタンをクリックします。
アウトポストに名前を付け、プラットフォームとして Linux を選択します (コンテナは Linux 上で実行されるためです) 。その後、"Create" ボタンをクリックします。
アウトポストを作成すると、そのアウトポストに割り当てるワーカーが Devin への認証に利用するアウトポストトークンが発行されます。
トークンをコピーし、今後の利用に備えて安全な場所に保存してください。**トークンはアウトポストの作成時に一度だけ表示されます**。
公式のDevin CLIイメージ (`public.ecr.aws/e0h8a4b6/devin-cli`) をベースに、[マシンに必要な依存関係](/ja/onboard-devin/outposts#machine-dependencies) と、セッションに必要なリポジトリやツールを追加します:
```dockerfile Dockerfile theme={null}
# Devin CLI はプリインストール済みで、イメージの entrypoint として設定されています。
# :stable を使用するか、特定の CLI バージョンタグを固定してください。
FROM public.ecr.aws/e0h8a4b6/devin-cli:stable
# git は必須です。ffmpeg を追加すると画面録画機能が有効になります。
RUN apt-get update && apt-get install -y --no-install-recommends \
ca-certificates git ffmpeg \
&& rm -rf /var/lib/apt/lists/*
# ワーカーが実行されるディレクトリ
WORKDIR /repos
# 必要に応じて、セッションで使用するリポジトリをチェックアウトしてください:
# RUN git clone https://github.com/your-org/app.git \
# && git clone https://github.com/your-org/infra.git
CMD ["worker", "start"]
```
または、Devin に Dockerfile の作成を依頼します:
```
Write a Dockerfile for a Devin Outposts worker image. Base it on
public.ecr.aws/e0h8a4b6/devin-cli:stable, which has the Devin CLI preinstalled
as the image's entrypoint. Install git and ffmpeg. Clone these repositories
into the working directory the worker runs in: . The default
command should be ["worker", "start"].
```
Browser機能を使うには、イメージ内に Chrome または Chromium が必要です。また、`DEVIN_CHROME_PATH` でそのバイナリを指定する必要があります。ベースイメージは Ubuntu ですが、Ubuntu の `chromium` apt パッケージは snap 用のスタブであり、コンテナでは動作しません。そのため、amd64 イメージでは代わりに Google Chrome をインストールしてください。
```dockerfile theme={null}
RUN apt-get update && apt-get install -y --no-install-recommends curl \
&& curl -fsSL https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -o /tmp/chrome.deb \
&& apt-get install -y --no-install-recommends /tmp/chrome.deb \
&& rm /tmp/chrome.deb && rm -rf /var/lib/apt/lists/*
ENV DEVIN_CHROME_PATH=/usr/bin/google-chrome
```
非公開リポジトリの場合は、実行時にクローンやリモート操作が機能するよう、お好みの方法 (例: [build secrets](https://docs.docker.com/build/building/secrets/)) で認証情報を組み込んでください。
Dockerfile の準備ができたら、イメージをビルドします。
```bash theme={null}
docker build -t devin-worker .
```
先ほどコピーしたトークンとご使用のアウトポスト名を指定して、`worker start` コマンドでイメージからコンテナを起動します (イメージのentrypointはDevin CLIなので、引数はそのまま`devin`に渡されます) :
```bash theme={null}
docker run devin-worker \
worker start --outpost= --token=
```
[Devin Cloud](https://app.devin.ai) で新しいセッションを開始し、Outpost 上で実行するように設定します。"Configuration" → "Virtual environment" に、新しいアウトポストが表示されます。これを選択すると、そのアウトポスト上でセッションが実行されます。
これで、Devin にコンテナ内でビルドを開始するよう依頼できます。まずは次のような簡単なものを試してみてください
```
「hello world」のPythonスクリプトを作成してください
```
すると、コンテナの作業ディレクトリにスクリプトが現れます！
### 次のステップ
Devin に作業させたいリポジトリをイメージに組み込み、その上でビルドするよう Devin に指示してください。セッションでは、ワーカーの作業ディレクトリ配下にチェックアウトされたリポジトリを参照できます。より多くのセッションを同時に処理するには、同じアウトポストを指定したコンテナを複数起動してください。N 個のワーカーが N 個のセッションを同時に処理し、残りはキューで待機します。
常時稼働のワーカーを維持することなく、セッションがキューに入ると自動的にコンテナをプロビジョニングします。
既に利用しているプラットフォーム上でアウトポストを実行できます — Namespace、Modal、E2B など。