التكوين
أنشئ ملفات التكوين التي تحدد إعدادات النشر واتصالات النموذج وتكاملات المصادقة الاختيارية قبل تثبيت IBM Bob ذاتي الاستضافة.
خطّط لثقة الشهادة قبل التثبيت. قرّر ما إذا كان المستخدمون سيصلون إلى Bob من خلال شهادة مقدَّمة من العميل موثوقة بالفعل في مخازن ثقة محطات العمل، أم من خلال مرجع مصادقة (CA) الافتراضي الموقَّع ذاتيًا الذي يُنشأ أثناء التثبيت.
لا يستطيع عميلا bob-ide وbob-shell التواصل مع الواجهة الخلفية لـ Bob حتى تثق محطة عمل العميل بالشهادة التي تقدمها نقطة النهاية الخارجية. ضع استراتيجية توزيع شهاداتك و CA قبل إتاحة الخدمة للمستخدمين.
لمزيد من المعلومات، راجع شهادات TLS. إذا اخترت شهادة يديرها العميل، طبّقها بعد التثبيت باستخدام الأمر bobctl setup-route.
يجب مراجعة التكوينات التالية قبل تشغيل التثبيت:
تكوين تثبيت المجموعة
يحتوي ملف config.yaml على إعدادات النشر التي يستخدمها bobctl. راجع هذا الملف وخصّصه قبل تشغيل أي أوامر تثبيت.
أنشئ ملف تكوين عمل من القالب المقدَّم:
cp config-template.yaml config.yamlحدّث القيم في config.yaml لتتناسب مع بيئتك.
الإعدادات العامة
يحتوي قسم global على إعدادات النشر على مستوى المجموعة.
| الحقل | القيمة الافتراضية | الوصف |
|---|---|---|
operatorNamespace | ibm-bob-operators | فضاء الاسم الذي يُنشر فيه مُشغِّل Bob. يُنشأ تلقائيًا بواسطة bobctl. لا تنشئه يدويًا. |
instanceNamespace | ibm-bob | فضاء الاسم الذي تُنشر فيه الموارد المخصصة لـ Bob وأحمال العمل. يُنشأ تلقائيًا بواسطة bobctl. لا تنشئه يدويًا. |
fileStorageClass | الافتراضي للمجموعة | فئة تخزين ReadWriteMany تُستخدم للوحدات المشتركة، مثل ocs-storagecluster-cephfs. |
blockStorageClass | الافتراضي للمجموعة | فئة تخزين ReadWriteOnce تُستخدم لوحدات قواعد البيانات، مثل ocs-storagecluster-ceph-rbd. |
imagePullPrefix | icr.io | بادئة السجل المستخدمة لصور الحاويات. في عمليات النشر المعزولة عن الشبكة، حدد اسم المضيف لسجل الحاويات الخاص بك. |
imagePullSecretName | ibm-entitlement-key | اسم سر سحب الصور الذي ينشئه الأمر bobctl install --registry-creds. |
إعدادات نسخة Bob
يتحكم قسم bob في تكوين بوابة النموذج ونشر الإضافات الاختيارية.
الإعدادات الأساسية
| الحقل | القيمة الافتراضية | الوصف |
|---|---|---|
modelGateway.secrets.AWS_ACCESS_KEY | لا شيء | مفتاح وصول AWS المستخدم للوصول إلى نماذج Amazon Bedrock. |
modelGateway.secrets.AWS_SECRET_ACCESS_KEY | لا شيء | مفتاح وصول AWS السري المستخدم للوصول إلى نماذج Amazon Bedrock. |
modelGateway.secrets.BOB_AZURE_API_KEY | لا شيء | مفتاح API المستخدم للوصول إلى نماذج Azure OpenAI. |
modelGateway.secrets.BOB_GEMINI_CREDENTIALS | لا شيء | بيانات الاعتماد المستخدمة للوصول إلى نماذج Google Gemini. |
إعدادات إضافات IBM Z الاختيارية
استخدم هذه الإعدادات لتفعيل قدرات خاصة بـ IBM Z. وهي غير مطلوبة لنشر Bob Core. تُنشر فقط الإضافات المعيَّنة إلى true أثناء التثبيت. يمكنك الوصول إلى إضافة ما فقط عندما تكون مثبَّتة في المجموعة ومعيَّنة إليك كاستحقاق. لمزيد من المعلومات، راجع إدارة الاستحقاقات.
| الحقل | القيمة الافتراضية | الوصف |
|---|---|---|
rag.enabled | false | يُنشّط إضافة Bob Premium Package for Z (RAG). عند التعيين إلى true، يُضمَّن OpenSearch تلقائيًا في النشر. |
zProxy.enabled | false | يُنشّط إضافة Bob Premium Package for Z (Proxy). يتطلب rag.enabled: true. |
understand.enabled | false | يُنشّط إضافة Z Understand and Refactor. راجع Z Understand and Refactor. |
للاطلاع على قائمة كاملة بخيارات التكوين المتاحة، راجع ملف config-template.yaml.
يؤدي تنشيط الإضافات إلى زيادة استخدام موارد المجموعة. كل إضافة تُنشّطها تنشر أحمال عمل إضافية وتزيد من استهلاك الموارد. قبل تنشيط الإضافات، راجع متطلبات أحجام المجموعة للتحقق من كفاية سعة المجموعة.
لا يتضمن ملف config.yaml إعدادات تكوين الشهادات. هيّئ TLS الخارجية بعد التثبيت باستخدام الأمر bobctl setup-route. راجع شهادات TLS.
تكوين بيانات الاعتماد ونقاط النهاية
يجب أن يتمكن IBM Bob من المصادقة والتواصل مع نقاط نهاية نماذج الاستدلال والحراسة المهيأة. هيّئ بيانات الاعتماد المطلوبة ومعلومات نقطة النهاية قبل بدء التثبيت.
للتعليمات التفصيلية، راجع تكوين بوابة النماذج.
إنشاء وتحديث ملف تكوين IDP
يُطبَّق تكوين IDP بعد اكتمال تثبيت Bob باستخدام الأمر bobctl configure-idp. لا يلزم أي تكوين IDP قبل تشغيل bobctl install. ومع ذلك، يمكنك إعداد ملف التكوين مسبقًا ليكون جاهزًا عند إعداد اتحاد المستخدمين.
لإنشاء ملف تكوين IDP من القالب:
cp config-idp-template.yaml my-idp.yamlعدّل الملف وحدد نطاقات بريدك الإلكتروني وعناوين بريد المسؤولين وتفاصيل خادم LDAP أو Active Directory الاختيارية، بما فيها معلومات الاتصال وإعدادات البحث وتعيينات المستخدمين.
للاطلاع على تفاصيل التكوين الكاملة، راجع تكامل LDAP.