terraform provider citrixadc

موفر Terraform Citrix ADC

قامت Citrix بتطوير موفر Terraform مخصص لأتمتة عمليات نشر وتكوينات Citrix ADC. باستخدام Terraform، يمكنك تخصيص ADCs لحالات الاستخدام المختلفة مثل Load Balancing وSSL وContent Switching وGSLB وWAF وما إلى ذلك.

تعرف على المزيد حول أتمتة Citrix ADC هنا

?لنشر Citrix ADC في Public Cloud - AWS وAzure، تحقق من البرامج النصية السحابية في github repo terraform-cloud-scripts.

✉️ في حالة وجود أي مشاكل أو مساعدة فورية، تواصل معنا على [email protected]!

أمثلة ووحدات

• الرجوع إلى الأمثلة
• راجع أيضًا القوالب الذهبية

وثائق موفر Terraform

1. لماذا Terraform لـ Citrix ADC؟
2. التنقل في المستودع
3. فهم تكوين الموفر
4. فهم تكوين الموارد
5. إرشادات عامة حول تكوينات ADC
6. إجراء تغييرات على المتجر المستمر الخاص بـ Citrix ADC
7. قائمة حالات استخدام ADC المدعومة من خلال Terraform
8. استخدام remote-exec للمهام لمرة واحدة

دليل المبتدئين لأتمتة ADC باستخدام Terraform

1. معمل عملي مع أتمتة ADC باستخدام Terraform
2. قم بتثبيت Terraform في الإعداد الخاص بك
3. فهم مستودع موفر خدمة terraform لـ ADC)
4. احصل على تكوين Terraform الأول الخاص بك في ADC
5. كيفية كتابة ملف موارد Terraform لـ ADC
6. قم بإعداد حالة استخدام SSL-Offloading في ADC
7. إجراء تغييرات على المتجر المستمر الخاص بـ Citrix ADC
8. إدارة تكوينات ADC تنجرف في التضاريس
9. استيراد تكوينات ADC إلى ملف موارد Terraform

دليل متقدم حول أتمتة ADC باستخدام Terraform

1. انشر ADC في AWS باستخدام Terraform
2. الاستفادة من مساحات عمل Terraform لإدارة ADCs المتعددة
3. يقوم بتحديث الخدمات ديناميكيًا باستخدام Consul-Terraform-Sync
4. النشر باللونين الأزرق والأخضر مع Citrix ADC وAzure Pipelines

لماذا Terraform لـ Citrix ADC؟

Terraform عبارة عن بنية تحتية مفتوحة المصدر كأداة برمجية للتعليمات البرمجية توفر سير عمل متسق لواجهة سطر الأوامر (CLI) لإدارة مئات الخدمات السحابية. يقوم Terraform بتدوين واجهات برمجة التطبيقات السحابية في ملفات تكوين تعريفية. يمكن استخدام Terraform لنشر ADC وتكوينه . يوفر تكوين Citrix ADC من خلال Terraform فوائد متعددة.

1. البنية التحتية كنهج التعليمات البرمجية لـ ADC - يمكنك تخزين تكوينات ADC في أدوات SCM مثل GitHub والإصدار وتتبعها مثل مستودعات التعليمات البرمجية الأخرى الموجودة لديك.
2. النهج التعريفي لأتمتة ADC - يحتاج المستخدمون فقط إلى تحديد الحالة المستهدفة لـ ADC. ستقوم موارد terraform الخاصة بـ ADC بإجراء استدعاءات API المناسبة لتحقيق الحالة المستهدفة.
3. تعتبر ملفات موارد ADC في Terraform صديقة للإنسان وسهلة الفهم.
4. تخلص من التعقيد المرتبط بالبنية الداخلية لـ Citrix ADC.
5. اكتشف انحرافات التكوين على ADC من خلال Terraform بسهولة.

التنقل في المستودع

1. مجلد citrixadc - يحتوي على كافة مكتبة موارد ADC التي ندعمها من خلال Terraform. ستقوم مكتبات الموارد هذه باستدعاء NITRO APIS داخليًا لتكوين ADC الهدف.
2. مجلد examples - يحتوي على أمثلة للمستخدمين لاستخدام موارد ADC المتنوعة، على سبيل المثال، يحتوي المجلد simple_lb على Resources.tf الذي يوضح كيف يمكن استخدام مورد citrixadc_lbvserver لإنشاء خادم موازنة التحميل على ADC الهدف. وبالمثل، تحتوي المجلدات المختلفة على أمثلة حول تعريف الموارد المختلفة. من المتوقع من المستخدمين مراجعة هذه الأمثلة وتحديد تكوينات ADC المطلوبة.
3. مجلد docs - https://github.com/citrix/terraform-provider-citrixadc/tree/master/docs/resources - يحتوي على وثائق جميع تكوينات الموارد المدعومة من خلال Terraform. ارجع إلى هذا لفهم الحجج والقيم المختلفة التي يأخذها مورد معين.

فهم تكوين الموفر

يحتوي provider.tf على معلومات حول هدف ADC حيث تريد تطبيق التكوين.

 provider "citrixadc" {
    username = " ${ var . ns_user } "  # You can optionally use `NS_LOGIN` environment variables.
    password = " ${ var . ns_password } "  # You can optionally use `NS_PASSWORD` environment variables.
    endpoint = " http://10.71.136.250/ "  # You can optionally use `NS_URL` environment variables.
}

يمكننا استخدام عنوان URL https وقبول شهادة السلطة غير الموثوق بها على Citrix ADC عن طريق تحديد insecure_skip_verify = true

لاستخدام https دون الحاجة إلى تعيين insecure_skip_verify = true اتبع هذا الدليل حول كيفية استبدال شهادة TLS الافتراضية بشهادة من مرجع مصدق موثوق به.

يفضل استخدام https . سيؤدي استخدام http إلى إرسال جميع متغيرات تكوين الموفر بالإضافة إلى متغيرات الموارد بنص واضح. سيتمكن أي شخص يراقب تدفق بيانات HTTP من تحليل القيم الحساسة مثل كلمة مرور الموفر.

تجنب تخزين بيانات اعتماد الموفر في الحالة المحلية باستخدام واجهة خلفية تدعم التشفير. يوصى أيضًا بموفر hasicorp vault لتخزين البيانات الحساسة.

يمكنك أيضًا استخدام متغيرات البيئة كما هو مذكور في التعليقات أعلاه.

يتم دعم الحجج التالية.

• username - هذا هو اسم المستخدم للوصول إلى Citrix ADC. الإعدادات الافتراضية هي nsroot ما لم يتم تعيين متغير البيئة NS_LOGIN
• password - هذه هي كلمة المرور للوصول إلى Citrix ADC. الإعدادات الافتراضية هي nsroot ما لم يتم تعيين متغير البيئة NS_PASSWORD
• endpoint - (مطلوبة) نقطة نهاية Nitro API في النموذج http://<NS_IP>/ أو http://<NS_IP>:<PORT>/ . يمكن تحديده في متغير البيئة NS_URL

• insecure_skip_verify - (اختياري، صحيح/خطأ) ما إذا كان سيتم قبول الشهادة غير الموثوق بها على Citrix ADC عندما تكون نقطة نهاية Citrix ADC هي https

• proxied_ns - (اختياري، NSIP) الهدف Citrix ADC NSIP لمكالمات وكيل MAS. عند تحديد هذا الخيار، يجب أن يشير username password ونقطة endpoint إلى وكيل MAS.

يمكن توفير اسم المستخدم وكلمة المرور ونقطة النهاية في متغيرات البيئة NS_LOGIN و NS_PASSWORD و NS_URL .

تكوين الموارد

يحتوي Resources.tf على الحالة المطلوبة للموارد التي تريدها على الهدف ADC. على سبيل المثال، لإنشاء خادم موازنة التحميل في ADC، يحتوي Resource.tf التالي على التكوينات المطلوبة لـ lbvserver

citrixadc_lbvserver

 resource "citrixadc_lbvserver" "foo" {
  name = " sample_lb "
  ipv46 = " 10.71.136.150 "
  port = 443
  servicetype = " SSL "
  lbmethod = " ROUNDROBIN "
  persistencetype = " COOKIEINSERT "
  sslcertkey = " ${ citrixadc_sslcertkey . foo . certkey } "
  sslprofile = " ns_default_ssl_profile_secure_frontend "
}

لفهم الوسائط والقيم المحتملة والوسائط الأخرى المتاحة لمورد معين، راجع وثائق NITRO API https://developer-docs.citrix.com/projects/netscaler-nitro-api/en/12.0/configuration/ موازنة التحميل/lbvserver/lbvserver/ ووثائق Terraform مثل https://github.com/citrix/terraform-provider-citrixadc/blob/master/docs/resources/lbvserver.md .

لا تتم مزامنة state السمة مع الكائن البعيد. إذا كانت حالة lb vserver غير متزامنة مع تكوين terraform، فستحتاج إلى تشويه المورد يدويًا وتطبيق التكوين مرة أخرى.

إرشادات عامة حول تكوين ADC

تحتوي المجلدات الفرعية الموجودة في مجلد المثال على أمثلة لتكوينات ADC المختلفة من خلال terraform. ارجع إلى مثال simple_lb لفهم البنية والاستخدام أدناه.

بناء

• يصف resources.tf كائنات تكوين NetScaler الفعلية التي سيتم إنشاؤها. سمات هذه الموارد إما مشفرة بشكل ثابت أو يتم البحث عنها من متغيرات الإدخال في terraform.tfvars
• يصف variables.tf متغيرات الإدخال لتكوين terraform. يمكن أن يكون لهذه الإعدادات الافتراضية
• يتم استخدام provider.tf لتحديد اسم المستخدم وكلمة المرور ونقطة النهاية لـ NetScaler. وبدلاً من ذلك، يمكنك تعيين متغيرات البيئة NS_URL وNS_LOGIN وNS_PASSWORD.
• يحتوي terraform.tfvars على المدخلات المتغيرة المحددة في variables.tf

استخدام

• قم بتعديل terraform.tfvars و provider.tf ليناسب نشر NetScaler الخاص بك.
• استخدم terraform plan وتطبيق terraform apply لتكوين NetScaler.

تحديث التكوين الخاص بك

قم بتعديل مجموعة الخدمات الخلفية واستخدم terraform plan وتطبيق terraform apply للتحقق من التغييرات

إجراء تغييرات على المتجر المستمر الخاص بـ Citrix ADC

لن يقوم الموفر بتنفيذ تغييرات التكوين على المتجر المستمر الخاص بـ Citrix ADC. للقيام بذلك، قم بتشغيل البرنامج النصي Shell ns_commit.sh :

 export NS_URL=http:// < host > : < port > /
export NS_LOGIN=nsroot
export NS_PASSWORD=nsroot
./ns_commit.sh

للتأكد من حفظ التكوين في كل عملية تشغيل، يمكننا استخدام شيء مثل terraform apply && ns_commit.sh

يتم دعم حالة استخدام ADC من خلال Terraform

يمكن العثور على قائمة حالات الاستخدام المدعومة في ADC هنا https://registry.terraform.io/providers/citrix/citrixadc/latest/docs.

استخدام remote-exec للمهام لمرة واحدة

يعد Terraform مفيدًا للحفاظ على الحالة المطلوبة لمجموعة من الموارد. وهو أقل فائدة لمهام مثل تكوين الشبكة التي لا تتغير. يشبه تكوين الشبكة استخدام مزود خدمة داخل Terraform. يعرض دليل examples/remote-exec أمثلة لكيفية استخدام Terraform لـ ssh لإنجاز هذه المهام لمرة واحدة.

---

دليل المبتدئين لأتمتة ADC باستخدام Terraform

معمل عملي مع أتمتة ADC باستخدام Terraform

جرب برنامجنا العملي في المختبر لتجربة تجربة استخدام Terraform for ADC.

قم بتثبيت Terraform في الإعداد الخاص بك

الخطوة الأولى لاستخدام Terraform for ADC هي تثبيت Terraform CLI. راجع وثائق Hashicorp لتثبيت Terraform CLI لبيئتك الخاصة.

فهم مستودع موفر خدمة terraform لـ ADC

راجع قسم التنقل في مستودعنا

احصل على تكوين Terraform الأول الخاص بك في ADC

اتبع المقالة حول بدء استخدام Terraform على NetScaler للحصول على التكوين الأول

كيفية كتابة ملف موارد Terraform لـ ADC

لكتابة موارد Terraform لـ Citrix ADC، راجع الروابط التالية وثائق NITRO API أو وثائق تسجيل terraform.

قم بإعداد حالة استخدام SSL-Offloading في ADC

إليك قالب Terraform الذي تتبعه لتكوين إلغاء تحميل SSL.

إجراء تغييرات على المتجر المستمر الخاص بـ Citrix ADC

راجع قسم التغييرات الالتزام

إدارة تكوينات ADC تنجرف في التضاريس

تريد رؤية الحالة الحالية لكيانات ADC في Terraform

• استخدم تحديث terraform لتحديث ملف حالة terraform المحلي الخاص بك ليتوافق مع حالة ADC الحالية
• استخدم عرض terraform لإظهار الحالة الحالية للتكوين بأكمله
• استخدم قائمة حالة terraform لإظهار الموارد التي يتم تتبعها/إدارتها عبر Terraform
• لفحص كيان معين، استخدم عرض حالة تضاريس <entity_name> ، على سبيل المثال عرض حالة تضاريس citrixadc_servicegroup.tf_servicegroup

إذا كنت تريد تجاوز تكوين ADC بالتكوينات الموجودة في ملف مورد Terraform، فقم بذلك

• يمكنك تشغيل خطة Terraform لرؤية الانجرافات/الفرق بين الحالتين
• قم بتشغيل تطبيق terraform لدفع التكوينات المطلوبة (في ملف مورد Terraform الخاص بك) إلى ADC الخاص بك.

قم بتحديث ملف حالة terraform الخاص بك ليعكس الحالة الحالية/الحقيقية لـ ADC

• استخدم تحديث terraform لتحديث ملف حالة terraform المحلي الخاص بك ليتوافق مع حالة ADC الحالية

استيراد تكوينات ADC إلى ملف موارد Terraform

تعرف على كيفية استيراد تكوينات NetScaler الموجودة إلى موارد Terraform هنا

---

دليل متقدم حول أتمتة ADC باستخدام Terraform

انشر ADC في AWS باستخدام Terraform

ارجع إلى البرامج النصية السحابية الخاصة بـ terraform الخاصة بـ AWS والفيديو التجريبي

الاستفادة من مساحات عمل Terraform لإدارة ADCs المتعددة

سيتم تحديده لاحقًا

يقوم بتحديث الخدمات ديناميكيًا باستخدام Consul-Terraform-Sync

يتيح تكامل Consul-Terraform-Sync للمستخدمين إنشاء مجموعات الخدمة وتحديثها وحذفها تلقائيًا في Citrix ADC التي تتم مزامنتها مع إطار عمل Consul Terraform Sync.

النشر باللونين الأزرق والأخضر مع Citrix ADC وAzure Pipelines

قم بدمج ADC وتكوينه لتسهيل نشر اللون الأزرق والأخضر باستخدام Terraform. تحقق من الحل