eve-new-project-setup

Eve の新規プロジェクト設定

開発者が eve init を実行した後、プロジェクトを Eve Horizon 用に設定する必要がある場合に使用します。

コンテキスト

ユーザーはすでに次を実行しています：

npm install -g @eve-horizon/cli
eve init my-project
cd my-project

このスキルでは、残りの設定（プロファイル、認証、組織／プロジェクトの登録、マニフェストのカスタマイズ、git リモートの設定）を行います。

ステップ 1：CLI の確認

eve --version

これが失敗する場合、CLI はインストールされていません。次を実行してもらいます：

npm install -g @eve-horizon/cli

ステップ 2：プロファイルの設定

ステージング環境用のプロファイルを作成します：

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

ユーザーにメールアドレスを尋ね、デフォルトを設定します：

eve profile set --default-email [email protected]

ステップ 3：認証

現在の認証状態を確認します：

eve auth status

認証されていない場合は、ログインします：

eve auth login

CLI の案内に沿って SSH キーを検出します（必要に応じて GitHub から取得できます）。

プロジェクト作成後にハーネスの認証情報を設定します。

ステップ 4：組織とプロジェクト

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

• 組織名（例：「my-company」）
• プロジェクト名（例：「My App」）
• プロジェクトスラッグ（例：「my-app」）
• リポジトリ URL（例：「[email protected]:me/my-app.git」）

作成するか、すでに存在することを確認します：

eve org ensure my-company --slug myco
eve project ensure --name "My App" --slug my-app --repo-url [email protected]:me/my-app.git --branch main

URL への影響： 組織とプロジェクトのスラッグは、デプロイ URL と K8s 名前空間を直接構成します：

• URL：{service}.{orgSlug}-{projectSlug}-{env}.{domain}（例：api.myco-my-app-staging.eve.example.com）
• 名前空間：eve-{orgSlug}-{projectSlug}-{env}（例：eve-myco-my-app-staging）
• ${ORG_SLUG} は、マニフェストの値で補間に使用できます

スラッグは変更できません。短く、意味のある値を選んでください。

プロファイルのデフォルトとして設定します：

eve profile set --org org_xxx --project proj_xxx

ステップ 5：ハーネスの選択と API キーの設定

対象にするハーネスを尋ねます（複数選択可）：

• mclaude / claude（Anthropic）
• code / codex（OpenAI）
• zai（Z.ai）
• gemini（Google）

ハーネスを必要なシークレットに対応付けます：

• mclaude/claude：ANTHROPIC_API_KEY（推奨）、または eve auth sync による Claude OAuth
• code/codex：OPENAI_API_KEY（推奨）、または CODEX_AUTH_JSON_B64
• zai：Z_AI_API_KEY
• gemini：GEMINI_API_KEY（または GOOGLE_API_KEY）

シークレットの保存先を決めます：

• プロジェクト間でキーを共有する場合は 組織（推奨）
• アプリ固有のキーには プロジェクト
• 個人用キーには ユーザー

一括設定にはシークレットファイルを使用します（スターターリポジトリには secrets.env.example が含まれています）：

cp secrets.env.example secrets.env
eve secrets import --org org_xxx --file ./secrets.env

ホスト上の Claude/Codex OAuth トークンについて：

# Store OAuth tokens in the project scope (or add --system if admin)
eve auth sync --project proj_xxx

ステップ 6：マニフェストの設定

スターターテンプレートには .eve/manifest.yaml が含まれています。プロジェクトの詳細に合わせて更新します：

schema: eve/compose/v2
project: my-app

services:
  api:
    build:
      context: apps/api
    ports: [3000]
    x-eve:
      ingress:
        public: true
        port: 3000

environments:
  staging:
    pipeline: deploy

pipelines:
  deploy:
    steps:
      - name: deploy
        action: { type: deploy }

カスタマイズする主なフィールド：

• project：プロジェクトスラッグと一致させます
• services：アプリのサービスを定義します
• x-eve.ingress：パブリックアクセスを設定します

ステップ 7：Git リモート

プロジェクトには最初、リモートが設定されていません。設定をサポートします：

git remote -v
git remote add origin [email protected]:user/my-app.git
git push -u origin main

ステップ 8：検証

設定を確認するため、次のチェックを実行します：

eve system health
eve auth status
eve profile show

次のステップ

設定が完了したら、次を提案します：

1. ローカルで実行：docker compose up --build
2. シークレットを設定：eve secrets set MY_KEY "value" または eve secrets import --file ./secrets.env
3. ステージングにデプロイ：eve env deploy staging --ref main --repo-dir .
4. ジョブを作成：eve job create --prompt "Review the codebase"

注：環境のマニフェストで pipeline が設定されている場合、eve env deploy <env> --ref <sha> はそのパイプラインを実行します。パイプラインを迂回して直接デプロイするには、--direct を使用します。--ref には 40 文字の SHA を指定するか、--repo-dir／cwd に対して解決される ref を指定する必要があります。

トラブルシューティング

「eve: command not found」

npm install -g @eve-horizon/cli

「Not authenticated」

eve auth login

「No profile」

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