الإعداد

مفتاح الوصول الخاص بك والاتصال بقاعدة بياناتك. أي قيمة مفقودة أو غير صالحة توقف التشغيل.

Markdown

يقرأ Human Plugin إعداداته من البيئة مرة واحدة عند بدء التشغيل. يتطلب تغيير أي قيمة إعادة تشغيل الحاوية.

مرجع سريع

الحد الأدنى من ملف .env لقاعدة بيانات تستخدم القيم الافتراضية الموضحة أدناه:

.env

HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>

مفتاح الوصول

المتغير	مطلوب	ملاحظات
HUMAN_API_ACCESS_KEY	نعم	مفتاح الوصول الخاص بك. يربط التثبيت بـ Unico ويحدد حسابك. بدون مسافات بيضاء أو أحرف تحكم. لا يُسجَّل أبدًا في السجلات

مفتاح الوصول سر. احتفظ به في مخزن الأسرار لديك وحقنه في الحاوية أثناء التشغيل.

الاتصال بقاعدة البيانات

المتغير	مطلوب	القيمة الافتراضية	ملاحظات
POSTGRES_ADDRESS_HOST	نعم		اسم المضيف أو عنوان IP لخادم PostgreSQL لديك
POSTGRES_PASSWORD	نعم		بدون مسافات بيضاء أو علامات اقتباس مفردة أو شرطات مائلة عكسية أو أحرف تحكم. يرفض Human Plugin البدء إذا وُجد أي منها، دون تسجيل القيمة في السجلات
POSTGRES_ADDRESS_PORT	لا	5432
POSTGRES_USER	لا	postgres	استخدم دورًا (role) مخصصًا لـ Human Plugin
POSTGRES_DATABASE	لا	human_plugin	استخدم قاعدة بيانات مخصصة لـ Human Plugin
POSTGRES_SSL_MODE	لا	require	استخدم disable فقط عندما يعمل PostgreSQL على المضيف نفسه أو كحاوية مساندة (sidecar)

يجب أن تُستخدم قاعدة البيانات من قبل Human Plugin فقط. يحتاج الدور إلى صلاحية إنشاء الجداول فيها: ينشئ Human Plugin جداوله الخاصة ويحدّثها عند بدء التشغيل، قبل أن يقبل الطلبات.

كلمة المرور سر. احتفظ بها في مخزن الأسرار لديك، كما تفعل مع مفتاح الوصول.

كل ما عدا ذلك

تضبط الصورة (image) كل القيم الأخرى. لا تضبط متغيرات أخرى إلا إذا طلبت منك Unico ذلك: فهي ليست جزءًا من الإعداد المدعوم.

مثال

docker run -d --name human-plugin --stop-timeout 60 -p 127.0.0.1:8080:8080 \
  -e HUMAN_API_ACCESS_KEY \
  -e POSTGRES_ADDRESS_HOST=db.internal \
  -e POSTGRES_USER=human_plugin \
  -e POSTGRES_PASSWORD \
  pkg.unico.run/human-plugin-api:latest

الخيار -e NAME بدون قيمة يمرّر المتغير من الصدفة (shell) لديك، فلا تظهر الأسرار في سطر الأوامر.