インストーラーの環境変数

目標: 実行前に環境変数を設定することで、スクリプトを編集せずに install.sh / install.ps1 を操作します。

前提条件Copy Anchor Link

• POSIX シェル（bash）または PowerShell 5.1+。以下の PowerShell の例は pwsh（PowerShell 7+）を実行します。Windows PowerShell 5.1 では、代わりに powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1 を実行します。
• 変数はインストーラーの冒頭で一度だけ読み込まれるため、同じコマンド内で設定し（または先にエクスポートし）、それからインストーラーを実行します。

インストーラーの変数Copy Anchor Link

APOTHEM_SOURCE はクローンよりも優先されます。src/apothem を含むチェックアウトに設定されている場合、インストーラーはそれを直接使用し、APOTHEM_REPO / APOTHEM_REF には決して触れず、タグの解決と署名の検証をスキップします（検証対象として取得されるものが何もないためです）。

APOTHEM_HOME が git クローンではない既存のディレクトリを指している場合、インストーラーはそのディレクトリの削除を拒否します。そのディレクトリを別の場所へ移動するか、APOTHEM_HOME を別の場所に向けるか、--yes（Windows では -Yes）を渡して置き換えを承認してください。 古い空のディレクトリは、このフラグなしで置き換えられます。

信頼モデルCopy Anchor Link

APOTHEM_REF が設定されていない場合、インストーラーは最新の署名付きリリースタグを解決し、いずれかの構成をマテリアライズする前に git verify-tag でその署名を検証します。署名されていないタグや改ざんされたタグは、インストールを中断させます。 メンテナーの公開鍵がローカルのキーリングにない署名付きタグの場合は、代わりに鍵のインポート手順を案内して中断します — 鍵をインポートし、そのフィンガープリントを SECURITY.md で公開されている値と照合してください。 既知のリリースを固定するには APOTHEM_REF=<tag> を使い、タグはリリースページから取得します。固定したタグも同じ方法で検証されます。 移動するブランチを選ぶには、APOTHEM_REF=main に加えて APOTHEM_ALLOW_UNVERIFIED=1 を指定します。このインストールは検証されません。main だけを指定すると、ブランチは署名付きタグではないため中止します。 検証の失敗を警告付きで通過させるには、APOTHEM_ALLOW_UNVERIFIED=1 だけを設定します（エアギャップ環境、ローカル、または署名付きリリース以前の用途）。

APOTHEM_REF=vMAJOR.MINOR.PATCH bash install.sh

APOTHEM_VERIFY=checksum bash install.sh

APOTHEM_ALLOW_UNVERIFIED=1 bash install.sh

手順（POSIX bash）Copy Anchor Link

1. デフォルト以外のユーザースコープのハーネスをインストールします。

   Copy Text

   APOTHEM_HARNESS=codex bash install.sh

2. インストール先を固定し、移動する main ブランチを選択します。ブランチは署名付きタグではないため、インストーラーには APOTHEM_ALLOW_UNVERIFIED=1 も必要です。

   Copy Text

   APOTHEM_REF=main APOTHEM_ALLOW_UNVERIFIED=1 APOTHEM_HOME=/opt/apothem bash install.sh

3. ローカルチェックアウトとカスタムプロファイルを使用し、検証をスキップします。

   Copy Text

   APOTHEM_SOURCE=/work/apothem \
   APOTHEM_PROFILE=/work/profile.yaml \
   APOTHEM_SKIP_VERIFY=1 \
   bash install.sh

手順（PowerShell）Copy Anchor Link

インストーラーを実行する前に、各変数を $env: に設定します。

$env:APOTHEM_HARNESS = 'codex'
pwsh -NoProfile -File install.ps1

$env:APOTHEM_ALLOW_UNVERIFIED = '1'
$env:APOTHEM_REF = 'main'
$env:APOTHEM_HOME = 'C:\opt\apothem'
pwsh -NoProfile -File install.ps1

$env:APOTHEM_SOURCE = 'C:\work\apothem'
$env:APOTHEM_PROFILE = 'C:\work\profile.yaml'
$env:APOTHEM_SKIP_VERIFY = '1'
pwsh -NoProfile -File install.ps1

検証Copy Anchor Link

インストーラーは ✓ Harness <name> installed を出力し、続いて（APOTHEM_SKIP_VERIFY=1 でない限り）✓ verify passed を出力します。 インストーラーとは別に確認するには、次を実行します。

apothem verify --harness codex

Cursor のようなプロジェクトスコープのハーネスでは、インストーラーの後に、インストールと検証を --project を付けて自分で実行します。

apothem install --harness cursor --project /path/to/project
apothem verify --harness cursor --project /path/to/project

プロファイルがまだ存在しなかった場合、インストーラーはサンプルからプロファイルを作成し、同じ実行の中でそのままインストールと検証に進みます。 サンプルの識別情報フィールドはプレースホルダーであるため、インストールは注意書きを出力します。$APOTHEM_PROFILE を編集してから、apothem update --harness <name> を実行してあなたの識別情報を適用してください。 プロファイルがない状態での --dry-run は、サンプルをその代わりとして用いてプレビューし、何も書き込みません。

関連Copy Anchor Link

• インストールでは、ワンショットのネットワークインストールを扱います。
• ハーネスを追加するでは、初回インストール後に CLI を通じてハーネスを追加する方法を扱います。