Variables (HCL)

```wiki

متغيرات HCL (HashiCorp Configuration Language)

مقدمة HCL (HashiCorp Configuration Language) هي لغة تكوين قوية ومرنة تستخدم على نطاق واسع في أدوات HashiCorp مثل Terraform و Vault. تسمح HCL بتعريف البنية التحتية ككود (Infrastructure as Code - IaC)، مما يجعل إدارة التكوينات أكثر قابلية للتكرار والأتمتة. تعتبر المتغيرات جزءًا أساسيًا من HCL، حيث تسمح بتخصيص التكوينات دون الحاجة إلى تعديل الكود مباشرةً. هذا المقال يهدف إلى تقديم شرح شامل للمتغيرات في HCL للمبتدئين، مع أمثلة عملية وتفصيل لأفضل الممارسات.

ما هي المتغيرات في HCL؟

المتغيرات في HCL هي أسماء مرتبطة بقيم. تتيح لك تخزين القيم التي يمكن أن تتغير أو تختلف بين البيئات المختلفة. بدلاً من كتابة القيم مباشرةً في التكوين، يمكنك استخدام المتغيرات للإشارة إليها. هذا يجعل التكوينات أكثر مرونة وقابلية للصيانة.

على سبيل المثال، بدلاً من كتابة اسم منطقة AWS مباشرةً في ملف Terraform، يمكنك تعريف متغير باسم `aws_region` وتعيين قيمة المنطقة إليه. بهذه الطريقة، يمكنك تغيير المنطقة بسهولة عن طريق تعديل قيمة المتغير، دون الحاجة إلى تعديل الكود.

تعريف المتغيرات

يتم تعريف المتغيرات في HCL باستخدام الكلمة المفتاحية `variable`. يجب أن يكون لكل متغير اسم ونوع (type) وقيمة افتراضية (default) اختيارية ووصف (description) اختياري.

بناء الجملة العام لتعريف متغير هو:

Admin (talk)hcl variable "اسم_المتغير" {

 type = نوع_البيانات
 default = "القيمة_الافتراضية"
 description = "وصف المتغير"

} Admin (talk)

• اسم_المتغير: الاسم الذي تستخدمه للإشارة إلى المتغير في التكوين. يجب أن يكون الاسم فريدًا داخل النطاق الذي تم تعريفه فيه.
• نوع_البيانات: يحدد نوع القيمة التي يمكن أن يحملها المتغير. تشمل أنواع البيانات الشائعة:

   *   string: نص.
   *   number: رقم.
   *   bool: قيمة منطقية (true أو false).
   *   list(type): قائمة من عناصر من نوع معين.
   *   map(type): خريطة (قاموس) حيث تكون المفاتيح والقيم من نوع معين.
   *   object(type): كائن مع خصائص محددة.

• القيمة_الافتراضية: القيمة التي سيتم استخدامها إذا لم يتم توفير قيمة للمتغير عند استخدامه. إذا لم يتم تحديد قيمة افتراضية، فسيكون المتغير مطلوبًا.
• الوصف: شرح موجز لغرض المتغير. يساعد الوصف في فهم كيفية استخدام المتغير من قبل الآخرين.

أمثلة على تعريف المتغيرات

• متغير نصي بسيط:

Admin (talk)hcl variable "instance_type" {

 type = string
 default = "t2.micro"
 description = "نوع المثيل الذي سيتم استخدامه."

} Admin (talk)

• متغير رقمي:

Admin (talk)hcl variable "port" {

 type = number
 default = 8080
 description = "رقم المنفذ الذي سيتم الاستماع عليه."

} Admin (talk)

• متغير منطقي:

Admin (talk)hcl variable "enable_monitoring" {

 type = bool
 default = true
 description = "تمكين المراقبة أم لا."

} Admin (talk)

• متغير قائمة:

Admin (talk)hcl variable "security_groups" {

 type = list(string)
 default = ["sg-12345678", "sg-87654321"]
 description = "قائمة معرفات مجموعات الأمان."

} Admin (talk)

• متغير خريطة:

Admin (talk)hcl variable "tags" {

 type = map(string)
 default = {
   "Environment" = "Production"
   "Owner"       = "DevOps Team"
 }
 description = "الوسوم التي سيتم تطبيقها على الموارد."

} Admin (talk)

استخدام المتغيرات

بمجرد تعريف المتغيرات، يمكنك استخدامها في التكوين الخاص بك عن طريق الإشارة إلى اسمها بين أقواس مزدوجة `Template:اسم المتغير`.

مثال:

Admin (talk)hcl resource "aws_instance" "example" {

 ami           = "ami-0c55b5a456d719311"
 instance_type = var.instance_type
 tags = var.tags

} Admin (talk)

في هذا المثال، يتم استخدام المتغير `instance_type` لتحديد نوع المثيل، ويتم استخدام المتغير `tags` لتحديد الوسوم التي سيتم تطبيقها على المثيل.

أنواع المتغيرات المتقدمة

• object: يسمح بتعريف متغير يمثل كائنًا مع خصائص محددة. هذا مفيد لتمثيل هياكل بيانات معقدة.

Admin (talk)hcl variable "database_config" {

 type = object({
   host     = string
   port     = number
   username = string
   password = string
 })
 default = {
   host     = "localhost"
   port     = 5432
   username = "admin"
   password = "password123"
 }
 description = "تكوين قاعدة البيانات."

} Admin (talk)

• set: يشبه القائمة، لكنه يضمن أن جميع العناصر فريدة.

Admin (talk)hcl variable "allowed_ips" {

 type    = set(string)
 default = ["10.0.0.1", "10.0.0.2", "10.0.0.3"]
 description = "مجموعة من عناوين IP المسموح بها."

} Admin (talk)

طرق توفير قيم المتغيرات

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

• عبر سطر الأوامر: يمكنك توفير قيم المتغيرات باستخدام الخيار `-var` في Terraform.

Admin (talk)bash terraform apply -var="instance_type=t2.medium" -var="enable_monitoring=false" Admin (talk)

• ملفات المتغيرات: يمكنك تعريف قيم المتغيرات في ملفات منفصلة بامتداد `.tfvars`. سيقوم Terraform تلقائيًا بتحميل هذه الملفات عند تشغيله.

مثال (variables.tfvars):

Admin (talk)hcl instance_type = "t2.large" enable_monitoring = true Admin (talk)

ثم قم بتشغيل:

Admin (talk)bash terraform apply -var-file="variables.tfvars" Admin (talk)

• بيئة التشغيل: يمكنك تعيين قيم المتغيرات باستخدام متغيرات البيئة.

Admin (talk)bash export TF_VAR_instance_type="t2.xlarge" terraform apply Admin (talk)

التحقق من صحة المتغيرات (Validation)

يمكنك إضافة قواعد التحقق من الصحة إلى المتغيرات للتأكد من أن القيم التي يتم توفيرها صحيحة. يتم ذلك باستخدام كتلة `validation`.

مثال:

Admin (talk)hcl variable "port" {

 type = number
 default = 8080
 description = "رقم المنفذ الذي سيتم الاستماع عليه."

 validation {
   condition     = var.port > 1024 && var.port < 65535
   error_message = "يجب أن يكون رقم المنفذ بين 1025 و 65534."
 }

} Admin (talk)

في هذا المثال، يتم التحقق من أن قيمة المتغير `port` تقع بين 1025 و 65534. إذا لم تكن القيمة ضمن هذا النطاق، فسيتم عرض رسالة خطأ.

أفضل الممارسات لاستخدام المتغيرات

• استخدم أسماء وصفية: اختر أسماءً للمتغيرات تعكس بوضوح الغرض منها.
• قم بتوفير وصف: أضف وصفًا لكل متغير لشرح كيفية استخدامه.
• حدد أنواع البيانات: حدد أنواع البيانات المناسبة للمتغيرات لضمان صحة البيانات.
• استخدم القيم الافتراضية: قم بتوفير قيم افتراضية للمتغيرات لجعل التكوينات أكثر سهولة في الاستخدام.
• استخدم التحقق من الصحة: أضف قواعد التحقق من الصحة للتأكد من أن القيم التي يتم توفيرها صحيحة.
• فصل المتغيرات عن التكوين: قم بتخزين المتغيرات في ملفات منفصلة (مثل `.tfvars`) للحفاظ على التكوين نظيفًا وقابلاً للصيانة.

المتغيرات في سياق الخيارات الثنائية (Binary Options)

على الرغم من أن HCL تستخدم في البنية التحتية ككود، فمن الممكن استعارة مفهوم المتغيرات لتطوير استراتيجيات الخيارات الثنائية. يمكنك تعريف "متغيرات" تمثل معلمات استراتيجيتك، مثل:

• فترة انتهاء الصلاحية: (expiry_time)
• مبلغ الاستثمار: (investment_amount)
• مؤشر فني: (technical_indicator) (مثل RSI، Moving Average، MACD)
• عتبات الإشارة: (signal_threshold)
• الأصول المالية: (asset) (مثل Forex، Stocks، Commodities)
• استراتيجية إدارة المخاطر: (risk_management_strategy) (مثل Martingale، Anti-Martingale)
• تحليل حجم التداول: (volume_analysis)
• التحليل الفني: (technical_analysis)
• الاتجاهات: (trends)
• استراتيجية الاختراق: (breakout_strategy)
• استراتيجية التداول العكسي: (reversal_strategy)
• استراتيجية المتوسطات المتحركة: (moving_average_strategy)
• استراتيجية البولينجر باند: (bollinger_bands_strategy)
• استراتيجية القوة النسبية: (rsi_strategy)
• استراتيجية الماكد: (macd_strategy)
• استراتيجية فيبوناتشي: (fibonacci_strategy)
• استراتيجية التداول اللحظي: (scalping_strategy)
• استراتيجية التداول اليومي: (day_trading_strategy)
• استراتيجية التداول المتأرجح: (swing_trading_strategy)
• استراتيجية التداول على المدى الطويل: (position_trading_strategy)
• استراتيجية التداول بناءً على الأخبار: (news_trading_strategy)
• استراتيجية التداول باستخدام أنماط الشموع: (candlestick_pattern_strategy)
• استراتيجية التداول باستخدام خطوط الاتجاه: (trendline_strategy)
• استراتيجية التداول باستخدام مستويات الدعم والمقاومة: (support_resistance_strategy)
• استراتيجية التداول باستخدام الأنماط الرسومية: (chart_pattern_strategy)
• استراتيجية التداول باستخدام التباعدات: (divergence_strategy)

من خلال تحديد هذه "المتغيرات"، يمكنك اختبار استراتيجيتك مع معلمات مختلفة لتحسين أدائها. يمكنك أيضًا إنشاء نظام آلي لتداول الخيارات الثنائية بناءً على هذه المتغيرات.

الخلاصة

المتغيرات هي جزء أساسي من HCL، حيث تسمح بتخصيص التكوينات وجعلها أكثر مرونة وقابلية للصيانة. من خلال فهم كيفية تعريف المتغيرات واستخدامها والتحقق من صحتها، يمكنك كتابة تكوينات HCL أكثر فعالية وقوة. بالإضافة إلى ذلك، يمكن تطبيق مفهوم المتغيرات على مجالات أخرى مثل تطوير استراتيجيات الخيارات الثنائية.

Terraform Vault Infrastructure as Code Configuration Management HCL Documentation Types in HCL Validation in HCL Terraform Variables Vault Variables HCL Expressions HCL Modules HCL Functions الخيارات الثنائية مؤشر القوة النسبية المتوسط المتحرك مؤشر الماكد العملات الأجنبية الأسهم السلع Martingale Anti-Martingale تحليل حجم التداول التحليل الفني الاتجاهات استراتيجية الاختراق استراتيجية التداول العكسي ```

ابدأ التداول الآن

سجّل في IQ Option (الحد الأدنى للإيداع 10 دولار) افتح حساباً في Pocket Option (الحد الأدنى للإيداع 5 دولار)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin لتصلك: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات اتجاهات السوق ✓ مواد تعليمية للمبتدئين