Jalankan Human Plugin di infrastruktur Anda

Satu container dan satu database PostgreSQL di jaringan Anda, dan Anda sudah terhubung ke Unico.

Markdown

Persyaratan

Persyaratan	Detail
Container runtime	Docker, Docker Compose, atau Kubernetes. Image dibangun untuk linux/amd64 dan linux/arm64 dan berjalan sebagai non-root
PostgreSQL	Versi 16 atau lebih baru. Database yang hanya digunakan oleh Human Plugin, dapat diakses dengan user dan kata sandi. SSL diwajibkan secara default
HTTPS keluar	Ke Unico. Lihat Jaringan dan keamanan
Masuk	Port 8080, HTTP biasa, hanya dari back-end Anda
Secret	Access key Anda dan kata sandi database

Persyaratan perangkat keras

Minimum untuk menjalankan Human Plugin hingga 1.500 transaksi per menit, dengan selfie berukuran hingga 800 KB.

Human Plugin

Sumber daya	Minimum
CPU	1 vCPU per replika
Memori	1 GB per replika

Untuk volume yang lebih besar, tambahkan satu replika untuk setiap 1.500 transaksi per menit. Kami juga menyarankan menjalankan lebih dari satu replika, agar Human Plugin tetap tersedia saat salah satunya di-restart.

PostgreSQL

Sumber daya	Minimum
Versi	16
CPU	2 vCPU
Memori	4 GB
Disk	SSD

Untuk memperkirakan ruang disk, hitung sekitar 1,7 KB per proses × proses per hari × jumlah hari penyimpanan, ditambah 30%.

Jaringan

HTTPS keluar (port 443) ke Unico. Lihat Jaringan dan keamanan.

Image

Human Plugin dipublikasikan sebagai pkg.unico.run/human-plugin-api:latest. Selalu jalankan tag latest, yaitu rilis saat ini. Unduh dengan kredensial registry (username dan token) yang diberikan Unico kepada Anda. Lihat Prasyarat dan akses.

Urutan deployment

1. Buat database khusus dan sebuah role untuk Human Plugin.
2. Atur konfigurasi, dengan secret dari secret store Anda.
3. Jalankan container dengan Docker Compose atau Kubernetes, dengan stop timeout minimal 60 detik.
4. Tunggu hingga GET /health/ready menjawab 200 sebelum mengalirkan traffic. Lihat Kesehatan dan pemantauan.
5. Batasi akses hanya untuk back-end Anda. Lihat Jaringan dan keamanan.
6. Jalankan permintaan create dari Quickstart terhadapnya.

Apa yang terjadi saat startup

Human Plugin mengunduh katalog atribut, terhubung ke PostgreSQL dan menyiapkan tabelnya, lalu membuka port. Ia berhenti dengan error, sebelum mulai mendengarkan, ketika:

• pengaturan yang wajib tidak ada atau tidak valid;
• katalog atribut tidak dapat diunduh;
• PostgreSQL tidak dapat dijangkau, atau role tidak dapat membuat tabel.

Log menyebutkan alasannya. Lihat Pemecahan masalah.

Beberapa instance

Human Plugin tidak menyimpan state permintaan di memori, sehingga beberapa container dapat berbagi satu database. Container yang dimulai bersamaan berkoordinasi melalui database, sehingga Anda dapat meluncurkan replika sekaligus.

Menuju produksi

• Pertahankan stop timeout 60 detik atau lebih.
• Alirkan traffic ke container hanya setelah /health/ready menjawab 200.
• Jangan pernah mengekspos Human Plugin di luar jaringan privat Anda.
• Lakukan backup database: ia menyimpan intelligence Anda. Lihat Operasional.