Operasional

Menjalankan Human Plugin sehari-hari.

Markdown

Pembaruan

Jalankan image latest, dan perbarui saat Unico mengumumkan rilis:

• Docker Compose: docker compose pull && docker compose up -d.
• Kubernetes: kubectl -n human-plugin rollout restart deployment/human-plugin, dengan imagePullPolicy: Always.

Rilis baru menyiapkan tabel yang dibutuhkannya saat startup, sebelum menerima traffic, sehingga tidak diperlukan langkah database manual. Lakukan backup database sebelum memperbarui produksi, lalu periksa /health/ready dan satu permintaan create yang nyata sesudahnya.

Merotasi kredensial

Access key. Unico menerbitkan key baru dengan jendela tumpang tindih. Perbarui HUMAN_API_ACCESS_KEY di .env atau Secret Anda, restart Human Plugin (docker compose up -d --force-recreate, atau kubectl -n human-plugin rollout restart deployment/human-plugin), pastikan create berhasil, lalu minta Unico mencabut key yang lama.

Kredensial registry. Unico menerbitkan token baru selagi token lama masih berfungsi. Login ulang dengan token baru (atau buat ulang pull secret Kubernetes), lakukan pull sekali untuk memastikan, lalu minta Unico mencabut token yang lama. Container yang sedang berjalan tidak terpengaruh.

Kata sandi database. Ubah di PostgreSQL dan di POSTGRES_PASSWORD, lalu restart Human Plugin.

Shutdown

Saat menerima SIGTERM, Human Plugin berhenti menerima koneksi dan menunggu hingga 55 detik untuk permintaan yang sedang berjalan, karena sebuah create dapat memakan waktu hingga 30 detik lalu menyimpan hasilnya. Atur stop timeout minimal 60 detik. Create yang terpotong akan ditetapkan sebagai gagal pada pembacaan berikutnya.

Penskalaan

Human Plugin tidak menyimpan state permintaan di memori, sehingga beberapa container dapat berbagi satu database. Tambahkan satu replika untuk setiap 1.500 transaksi per menit, dan naikkan max_connections PostgreSQL menjadi 25 × jumlah replika + 10. Lihat Persyaratan perangkat keras.

Katalog atribut

Human Plugin mengunduh katalog atribut sekali saat startup. Versi katalog baru sampai ke container pada restart berikutnya. Me-restart container satu per satu menjaga layanan tetap tersedia.

Backup

Database Anda menyimpan intelligence yang menjadi dasar perhitungan data.ndocs. Lakukan backup dengan perangkat Anda sendiri dan uji proses restore. Kehilangan database berarti kehilangan intelligence, dan itu tidak dapat dibangun ulang.