eve-bootstrap

Eve のブートストラップ

Eve プロジェクトをゼロから動作する状態にするまで、すべてを処理するスキルです。認証済みかどうかを検出し、それに応じて処理を調整します。

• 認証済みの場合 → プロジェクトのセットアップに進みます
• 未認証の場合 → プロファイルを作成し、アクセスを申請して、管理者の承認を待ち、自動ログインしてからプロジェクトをセットアップします

ステップ 1：CLI を確認する

eve --version

これが失敗した場合は、先に CLI をインストールしてください。

npm install -g @anthropic/eve-cli

ステップ 2：プロファイルを作成する

既存のプロファイルがあるか確認します。

eve profile list

staging プロファイルがない場合は、作成します。

eve profile create staging --api-url https://api.eve.example.com
eve profile use staging

ステップ 3：認証状態を確認する

eve auth status

これはローカルファイルを確認するのではなく、API を呼び出します。結果は 2 通りです。

認証済みの場合 → ステップ 5 に進む

eve auth status でログイン済みと表示された場合は、ステップ 5：プロジェクトのセットアップに進んでください。

未認証の場合 → ステップ 4 に進む

ステップ 4：アクセスを申請する（新規ユーザーのみ）

使用する SSH 公開鍵を探します。

ls ~/.ssh/*.pub

デフォルトは ~/.ssh/id_ed25519.pub です。鍵がない場合は、生成します。

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519

ユーザーに次の情報を尋ねます。

• 組織名 — 組織に付けたい名前
• メールアドレス — ユーザーアカウント用。任意です

アクセス申請を送信し、承認を待ちます。

eve auth request-access \
  --ssh-key ~/.ssh/id_ed25519.pub \
  --org "My Company" \
  --email [email protected] \
  --wait

--wait フラグは、次の処理を行います。

1. 申請を送信します（未認証）
2. 申請 ID（areq_xxx）を表示します
3. 管理者が承認または却下するまで、5 秒ごとに確認します
4. 承認されると、SSH チャレンジログインを自動的に完了します
5. トークンを ~/.eve/credentials.json に保存します

ユーザーに伝えてください：「申請を承認するには、管理者が eve admin access-requests approve <id> を実行する必要があります。」

承認されると、自分の組織の管理者としてログインした状態になります。

ステップ 5：プロジェクトをセットアップする

組織 ID とプロジェクト ID がわかっている場合は、プロファイルのデフォルト値を設定します。

eve profile set --org <org_id> --project <proj_id>

プロジェクトがまだない場合は、ユーザーに次の情報を尋ねます。

• プロジェクト名とスラッグ（スラッグは変更できないため、短くしてください）
• リポジトリ URL（例：[email protected]:org/repo.git）

# Option A: Ensure project exists
eve project ensure --name "My App" --slug myapp \
  --repo-url [email protected]:org/repo.git --branch main

# Option B: Bootstrap project + environments in one call
eve project bootstrap --name "My App" --repo-url [email protected]:org/repo.git \
  --environments staging,production

URL への影響： スラッグによってデプロイ URL が決まります。 {service}.{orgSlug}-{projectSlug}-{env}.{domain}

ステップ 6：マニフェスト

.eve/manifest.yaml が存在しない場合は、最小限のものを作成します。

schema: eve/compose/v2
project: myapp

registry: "eve"

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    # image is optional; Eve derives it from the service name when managed registry is used
    ports: [3000]
    x-eve:
      ingress:
        public: true
        port: 3000

environments:
  staging:
    pipeline: deploy

pipelines:
  deploy:
    steps:
      - name: build
        action: { type: build }
      - name: release
        depends_on: [build]
        action: { type: release }
      - name: deploy
        depends_on: [release]
        action: { type: deploy }

マニフェストの詳しいガイダンスについては、eve-manifest-authoring スキルを使用してください。

ステップ 7：プラットフォームについて学ぶ

Eve プラットフォームのリファレンスを読み、すべての機能を確認します。

https://showcase.eve.example.com/llms

CLI コマンド、マニフェスト構文、エージェントハーネス、ジョブのライフサイクルなどについて説明しています。

ステップ 8：確認する

eve auth status
eve system health
eve project list

概要

セットアップした内容を表示します。

• プロファイル：名前、API URL
• 認証：メールアドレス、組織名、組織スラッグ
• プロジェクト：名前、スラッグ、リポジトリ URL
• 次の手順：マニフェストを同期する（eve project sync）、デプロイする（eve env deploy staging --ref main --repo-dir .）