تكوين الوحدات النمطية Terraform

يتم تحديد كل موارد البنية الأساسية للاحتساب والشبكات والتخزين اللازمة لهذا الحل في وحدات Terraform

قبل البدء

قبل بدء تكوين الوحدات النمطية Terraform، أكمل الخطوات التالية:

  1. تعرف على أساسيات Terraform.

    على الحد الأدنى، اطلع على مقدمة في وثائق نموذج Terrraform.

  2. اجعل المعلومات التالية جاهزة:
    • Ocd للأرض المستأجرة الخاصة بك.

      يمكنك العثور على OCID الخاص بالأرض المستأجرة في وحدة تحكم ويب Oracle Cloud Infrastructure. حدد الإدارة من قائمة الخدمات ثم انقر تفاصيل الأرض المستأجرة.

    • OCID الخاص بالمستخدم الذي تريد استخدام Terraform للتصديق في Oracle Cloud Infrastructure.

      للعثور على Ocd للمستخدم، حدد هوية من قائمة الخدمات، ثم حدد المستخدمون. حدد موقع اسم المستخدم في القائمة، وانسخ Ocd الخاص به.

    • معرف Ocd للمقارنة التي تريد تكوين الموارد بها.

      للعثور على OCID بمقارنة، حدد هوية من قائمة الخدمات، ثم حدد مقارنات. حدد موقع المقارنة الذي تحتاجه في القائمة وانسخ Ocd الخاص به.

    • معرف المنطقة التي تريد تكوين الموارد فيها.

      على سبيل المثال، معرف المنطقة الشرقية للولايات المتحدة (Ashburn) هو us-ashburn-1.

      راجع المناطق ونطاقات الإتاحة.

  3. حدد ما يلي:
  4. تحقق من أن حدود خدمة الأرض المستأجرة يمكن أن تستوعب كل الموارد التي تريد تكوينها.

تحميل رمز المنطقة

رمز المنطقة لهذا الحل متاح على GitHub.

  1. في جزء الاستكشاف على اليمين، انقر على تنزيل رمز.
  2. انقر على Git Repo.
  3. استنساخ المخزن أو تنزيله إلى جهاز الكمبيوتر المحلي.

حول رمز المنطقة

يحتوي رمز المنطقة الذي قمت بتنزيله على الهيكل التالي:

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • دليل _docs: يشتمل على مخططات البنية.
  • *.tf: ملفات تكوين Terraform التي يستخدمها الحل. لا تقم بتحرير هذه الملفات.
  • env-vars: اسكربت لتعيين متغيرات البيئة لـ Terraform.
  • LICENSE.md: شروط الترخيص الخاصة بالرمز.
  • modules: الأدلة التي تحتوي على تكوينات Terraform الأساسية للموارد التي تقوم بتكوينها باستخدام هذا الحل. لا تقم بتحريرها.
  • orm: يحتوي على ملف مضغوط يمكن استخدامه لتكوين مكدس في Oracle Cloud Infrastructure Resource Manager، بدلاً من استخدام Terraform لتوزيع الحل.
  • README.md: وثائق البدء السريع للرمز.
  • schema.yaml: القيود والمراجعات الخاصة بالمتغيرات المستخدمة في رمز Terraform. يُستخدم هذا الملف عند توزيع الموارد باستخدام Oracle Resource Manager. لا تقم بتحرير هذا الملف.
  • terraform.tfvars: متغيرات Terraform. ستقوم بتعيين قيم للمتغيرات في هذا الملف لاحقًا.
  • userdata: يحتوي على اسكربت يتم تشغيله في طبعات الحساب بعد تكوينها. لا تقم بتحرير الملفات في هذا الدليل.

تعيين متغيرات البيئة للمنطقة

يشتمل رمز "المنطقة" على ملف اسكربت يمكنك استخدامه لتخزين قيم معلمات Terraform معينة كمتغيرات بيئة.

  1. تأكد من إتمام المتطلبات المسبقة الموضحة مسبقًا.
    يرجى الاطلاع على قبل البدء.
  2. في جهاز الكمبيوتر المحلي الخاص بك، انتقل إلى الدليل الذي قمت بتنزيل رمز Terraform فيه.
  3. في دليل المستوى العلوي للرمز، حدد موقع الملف env-vars وفتحه في محرر النص العادي.
  4. أدخل القيم المناسبة للمتغيرات في الملف.

    ملاحظة:

    عند تحديد قيمة لكل متغير، تذكر عدم تعليق السطر؛ مما يؤدي إلى إزالة حرف # (شفرة هاش) في بداية السطر.
  5. تحقق من القيم التي قمت بتحديدها.
    إذا قمت بحذف أية قيم، فستتم مطالبتك بالإدخال عند تشغيل Terraform. إذا قمت بتقديم قيم غير صحيحة، سوف يؤدي إجراء Terraform إلى حدوث خطأ.
  6. عند التأكد من صحة كل القيم، قم بحفظ الملف وإغلاقه.
  7. قم بتعيين متغيرات البيئة عن طريق تشغيل الأمر التالي من الدليل الذي يحتوي على ملف متغيرات البيئة، عن طريق تشغيل الأمر التالي:
    source ./env-vars
  8. تحقق من تعيين كل متغيرات البيئة، عن طريق تشغيل الأمر التالي:
    env | grep TF
    يتم عرض متغيرات البيئة التي تقوم بتعيينها.

تعيين معلمات التوزيع

حدد الحساب والشبكات وقاعدة البيانات وموارد التخزين المطلوب تكوينها وخصائصها.

  1. تأكد من إتمام المتطلبات المسبقة الموضحة مسبقًا.
    يرجى الاطلاع على قبل البدء.
  2. في دليل المستوى العلوي للرمز الذي قمت بتنزيله أو نسخه، حدد موقع ملف terraform.tfvars، ثم قم بفتحه في محرر النص العادي.
  3. تعيين قيم للمتغيرات المدرجة في terraform.tfvars.
    يحتوي ملف README في التعليمات البرمجية التي قمت بتنزيلها على أوصاف للمتغيرات، وهو يشتمل على عينة من ملف terraform.tfvars مكتمل.
  4. قم بحفظ وإغلاق terraform.tfvars.