Variabel lingkungan pemasang

Tujuan: menjalankan install.sh / install.ps1 tanpa menyunting skrip, dengan menyetel variabel lingkungan sebelum Anda menjalankannya.

PrasyaratCopy Anchor Link

• Shell POSIX (bash) atau PowerShell 5.1+. Contoh PowerShell di bawah ini menjalankan pwsh (PowerShell 7+). Di Windows PowerShell 5.1, jalankan powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1 sebagai gantinya.
• Variabel dibaca satu kali di bagian atas pemasang, jadi setel variabel tersebut dalam perintah yang sama (atau ekspor terlebih dahulu), lalu jalankan pemasang.

Variabel pemasangCopy Anchor Link

APOTHEM_SOURCE lebih diutamakan daripada klon: ketika disetel ke checkout yang berisi src/apothem, pemasang menggunakannya secara langsung, tidak pernah menyentuh APOTHEM_REPO / APOTHEM_REF, dan melewati resolusi tag serta verifikasi tanda tangan (tidak ada yang diambil untuk diverifikasi).

Ketika APOTHEM_HOME menunjuk ke direktori yang sudah ada dan bukan klon git, pemasang menolak menghapusnya: pindahkan direktori itu ke tempat lain, arahkan APOTHEM_HOME ke lokasi lain, atau berikan --yes (-Yes di Windows) untuk mengizinkan penggantian. Direktori kosong yang usang diganti tanpa flag tersebut.

Model kepercayaanCopy Anchor Link

Tanpa APOTHEM_REF yang disetel, pemasang me-resolve tag rilis bertanda tangan terbaru dan memverifikasi tanda tangannya dengan git verify-tag sebelum mematerialisasikan konfigurasi apa pun; tag yang tidak bertanda tangan atau telah dirusak membatalkan instalasi. Tag bertanda tangan yang kunci publik pemeliharanya tidak ada di keyring lokal justru membatalkan instalasi dengan panduan impor kunci - impor kunci tersebut dan periksa sidik jarinya terhadap nilai yang dipublikasikan di SECURITY.md. Patok rilis yang diketahui dengan APOTHEM_REF=<tag>, dengan mengambil tag dari halaman rilis; tag yang dipatok diverifikasi dengan cara yang sama. Pilih branch yang bergerak dengan APOTHEM_REF=main ditambah APOTHEM_ALLOW_UNVERIFIED=1; instalasi itu tidak diverifikasi, dan main saja membatalkan proses karena branch bukan tag bertanda tangan. Setel APOTHEM_ALLOW_UNVERIFIED=1 secara tersendiri untuk melanjutkan melewati kegagalan verifikasi dengan peringatan (penggunaan air-gapped, lokal, atau rilis pra-penandatanganan).

APOTHEM_REF=vMAJOR.MINOR.PATCH bash install.sh

APOTHEM_VERIFY=checksum bash install.sh

APOTHEM_ALLOW_UNVERIFIED=1 bash install.sh

Langkah-langkah (POSIX bash)Copy Anchor Link

1. Pasang harness bercakupan pengguna non-default:

   Copy Text

   APOTHEM_HARNESS=codex bash install.sh

2. Patok tujuan instalasi dan pilih branch main yang bergerak. Branch bukan tag bertanda tangan, sehingga pemasang juga memerlukan APOTHEM_ALLOW_UNVERIFIED=1:

   Copy Text

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

3. Gunakan checkout lokal dan profil khusus, dengan melewati verifikasi:

   Copy Text

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

Langkah-langkah (PowerShell)Copy Anchor Link

Setel setiap variabel pada $env: sebelum menjalankan pemasang:

$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

VerifikasiCopy Anchor Link

Pemasang mencetak ✓ Harness <name> installed, lalu (kecuali APOTHEM_SKIP_VERIFY=1) ✓ verify passed. Konfirmasikan secara independen:

apothem verify --harness codex

Untuk harness bercakupan proyek seperti Cursor, jalankan sendiri pemasangan dan verifikasi setelah pemasang, dengan --project:

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

Ketika profil belum ada, pemasang membuatnya dari contoh dan terus berjalan untuk memasang dan memverifikasi dalam eksekusi yang sama. Kolom identitas pada contoh adalah placeholder, sehingga instalasi mencetak sebuah catatan; sunting $APOTHEM_PROFILE, lalu jalankan apothem update --harness <name> untuk menerapkan identitas Anda. --dry-run tanpa profil menampilkan pratinjau dengan contoh sebagai profilnya dan tidak menulis apa pun.

TerkaitCopy Anchor Link

• Instalasi mencakup instalasi jaringan sekali jalan.
• Menambah harness mencakup penambahan harness melalui CLI setelah instalasi pertama.