Stand awam
Stand awam menggunakan timbunan permulaan pantas di sebalik pinggir Caddy sedia ada
milik pengendali. Ia ialah pelaksanaan penilaian dengan kelayakan yang dikeluarkan oleh pengendali.
Skrip pelaksanaan semula repositori menyasarkan https://yabanin.ai secara lalai;
halaman ini menerangkan kontrak pelaksanaan itu, bukan semakan ketersediaan langsung.
Akses
Dapatkan akaun pentadbir dan kunci gerbang organisasi daripada pengendali. Kelayakan tetap demo tempatan tidak terpakai di sini.
| Permukaan | Laluan awam | Bahagian belakang |
|---|---|---|
| Laman web dan dokumentasi | /, /docs | Binaan Docusaurus statik |
| Gerbang | /gw/healthz, /gw/v1/... | Gerbang pada port loopback 8082; pinggir menanggalkan /gw |
| Log masuk pentadbir dan API | /auth/..., /api/... | Pentadbir pada port loopback 8086 |
Papan pemuka yang disajikan secara berasingan boleh menggunakan /stand; aset dan penghalaan pinggirnya
diurus di luar skrip pelaksanaan semula permulaan pantas. Gunakan URL papan pemuka
yang diberikan oleh pengendali. Konfigurasi Caddy VPS berkongsi bukan
templat tiga domain dalam deploy/caddy/Caddyfile.tmpl.
Gunakan https://yabanin.ai/gw/v1 sebagai URL asas klien serasi OpenAI, dengan
kunci gerbang anda. Gunakan model yang dipulangkan oleh /gw/v1/models; ujian
asap pelaksanaan semula menjangkakan mock-model yang disemai. Respons olok-olok mengesahkan
laluan permintaan, bukan sambungan penyedia yang sebenar. Untuk mengkonfigurasi huluan yang sebenar,
ikut BYOK dan Persediaan organisasi.
Laksana semula stand sedia ada
Jalankan daripada akar repositori dengan Docker berjalan dan akses SSH ke hos stand sedia ada:
scripts/deploy-public-stand.sh --host operator@stand.example.com
Skrip membina yabanin-quickstart:local untuk linux/amd64, menanda
imej yang sedang dipasang sebagai yabanin-quickstart:previous, memindahkan imej
baharu, dan menyegerakkan hanya file serta skrip Compose/bootstrap permulaan pantas.
Ia kemudian menjalankan docker compose --profile mock up -d --wait dari jauh.
deploy/quickstart/.env dan .stand-key pada hos jauh dikekalkan. Imej
itu datang daripada pohon kerja semasa, termasuk perubahan yang belum dikomit; skrip
merekodkan label komit (dengan -dirty apabila berkenaan) dalam
file .deployed-version jauh. Ia tidak memperuntukkan VPS baharu, DNS, TLS,
binaan papan pemuka, atau sandaran pangkalan data.
| Pilihan | Maksud |
|---|---|
--host USER@HOST | Tindih destinasi SSH |
--skip-build | Pindahkan imej tempatan sedia ada; ia mesti sudah wujud |
--skip-smoke | Langkau semakan selepas pelaksanaan |
--yes | Diterima oleh skrip; buat masa ini ia tidak mempunyai gesaan pengesahan |
YABANIN_STAND_DIR | Direktori sumber jauh, lalai /opt/yabanin-src |
YABANIN_STAND_URL | URL asas awam, lalai https://yabanin.ai |
YABANIN_STAND_HOST | Destinasi SSH apabila --host tiada; tetapkan secara nyata |
Semakan asap meliputi kesihatan gerbang tempatan/awam, penyenaraian model yang disahkan,
pelengkapan sembang olok-olok yang pendek, dan halaman log masuk pentadbir. Skrip membaca
.stand-key melalui SSH tanpa mencetaknya. Semakan ini tidak mengesahkan
penyedia BYOK pengguna atau setiap aliran kerja papan pemuka.
Gulung balik imej
Pada hos stand, selepas mengesahkan imej sebelumnya serasi dengan skema pangkalan data semasa:
docker tag yabanin-quickstart:previous yabanin-quickstart:local
cd /opt/yabanin-src/deploy/quickstart
docker compose --profile mock up -d --wait
Ini menggulung balik imej sahaja. File Compose yang disegerakkan, label versi
yang direkod, dan migrasi pangkalan data tidak diterbalikkan. Simpan sandaran pangkalan data dan
konfigurasi sebelumnya apabila melaksanakan perubahan yang memerlukan lebih daripada
gulung balik imej. Pelaksanaan pertama mungkin tidak mempunyai imej :previous.
Pelaksanaan laman web adalah berasingan
scripts/deploy-site.sh membina web/site, menyandarkan webroot VPS, dan menggunakan
rsync --delete untuk menggantikan kandungannya di tempat. File yang tiada daripada
binaan, termasuk HTML Overview yang dimuat naik secara manual atau aset papan pemuka yang disimpan
di situ, dipadam. Semak kandungan binaan yang lengkap sebelum menerbitkan.
Jangan tukar direktori webroot: bind mount Caddy mengikut inodenya.
Bagi pelaksanaan baharu dengan domain API, pentadbir, dan papan pemuka yang berasingan, volum berterusan yang nyata, amaran, penjanaan status, dan sandaran, gunakan runbook Compose pengeluaran.