# کشف قدرت تابع templatefile() تو Terraform: از نگاه یه مهندس DevOps

> نگاهی به تابع templatefile() تو Terraform و مزیت‌هاش نسبت به تمپلیت‌نویسی با Jinja2 برای روندهای کاری زیرساخت به‌عنوان کد. چرا رویکرد مینیمالش به تمپلیت‌نویسی عمدی و مفیده.

- URL: https://ashkmb.com/fa/blog/terraform-templatefile-power/
- Author: Ashkan Kamyab (https://ashkmb.com)
- Published: 2025-09-15
- Language: fa

## تابع `templatefile()` اصلاً چیه؟

این تابع یه مسیر تمپلیت و یه نگاشت از متغیرها می‌گیره: `templatefile(path, vars)`. تمپلیت‌ها از یه سینتکس سرراست استفاده می‌کنن، مثل `${variable}` برای جایگذاری متغیر و `%{ if ... }` / `%{ for ... }` برای ساختارهای کنترلی.

## یه مثال با یوزردیتا

توسعه‌دهنده‌ها به‌جای این‌که اسکریپت‌های چندخطی رو مستقیم توی HCL جاسازی کنن، می‌تونن با فایل‌های `.tpl` مسئولیت‌ها رو از هم جدا کنن. این رویکرد یه پیکربندی ماژولار می‌سازه که تحت کنترل نسخه‌ست و بین محیط‌های مختلف دوباره قابل استفاده‌ست.

مثلاً اسکریپت یوزردیتای یه نمونه‌ی EC2 می‌تونه توی یه فایل تمپلیت باشه:

```hcl
resource "aws_instance" "web" {
  ami           = var.ami_id
  instance_type = var.instance_type

  user_data = templatefile("${path.module}/templates/userdata.tpl", {
    environment = var.environment
    app_name    = var.app_name
    db_host     = aws_db_instance.main.endpoint
  })
}
```

و خود تمپلیت تمیز و خوانا می‌مونه:

```bash
#!/bin/bash
echo "Deploying ${app_name} in ${environment}"
echo "DB_HOST=${db_host}" >> /etc/environment
```

## یکپارچگی با فایل‌های YAML در Kubernetes

تمپلیت‌ها به تیم‌ها اجازه می‌دن مانیفست‌های YAML فعلیشون رو نگه دارن و در عین حال مدیریت پویاشون رو به Terraform بسپرن. می‌تونی یه مانیفست دیپلویمنت رو با متغیرهایی برای اسم اپ، تعداد رپلیکاها و ایمیج کانتینر رندر کنی؛ این‌طوری فایل‌های YAML آشنا می‌مونن و مقدارهای مخصوص هر محیط موقع plan تزریق می‌شن.

## مقایسه‌ی Jinja2 و Terraform

| جنبه | Jinja2 | تابع templatefile() در Terraform |
|--------|--------|--------------------------|
| **سینتکس** | `{{ var }}`، فیلترها، ماکروها | `${var}`، کنترل جریان پایه |
| **پیچیدگی** | بالا (منطق سنگین هم ممکنه) | پایین (عمداً حداقلی) |
| **کاربرد** | تمپلیت‌نویسی همه‌منظوره | ابزار کمکی متمرکز بر IaC |
| **فلسفه** | حداکثر قدرت | قدرت به اندازه‌ی کافی |

نکته‌ی کلیدی: `templatefile()` عمداً مینیماله تا تعریف‌های زیرساخت قابل‌پیش‌بینی بمونن.

## فلسفه‌ی طراحی

رویکرد Terraform وضوح رو به توانایی ترجیح می‌ده. منطق زیاد توی تمپلیت‌ها می‌تونه نگهداری رو به کابوس تبدیل کنه، در حالی که محدودیت Terraform همه‌چیز رو معقول نگه می‌داره. این با اصول زیرساخت به‌عنوان کد جور درمیاد: اعلانی، تکرارپذیر و شفاف.

وقتی دیدی داری با محدودیت‌های `templatefile()` می‌جنگی، معمولاً نشونه‌ی اینه که منطق رو ببری توی کد HCL یا یه ابزار مخصوص مدیریت پیکربندی، نه این‌که پیچیدگی بیشتری به تمپلیت‌هات اضافه کنی.

## جمع‌بندی

هر دو ابزار تو جای خودشون مناسبن: Jinja2 برای تولید پیکربندی‌های پیچیده، و `templatefile()` برای تمپلیت‌نویسی سبک توی روندهای کاری Terraform. کشف این قابلیت روند کارم رو بهتر کرد؛ بهبودی که سادگی رو در اولویت می‌ذاره، بدون این‌که از کارایی کم کنه.
