مستندات ترافورم (Terraform)

این راهنما شما را در نصب و پیکربندی پروایدر (Provider) Terraform پارس‌پک جهت مدیریت خودکار منابع ابری راهنمایی می‌کند. در پایان این آموزش، یک فایل پیکربندی اولیه برای ساخت ماشین مجازی خواهید داشت.

پیش‌نیازها

پیش از شروع، اطمینان حاصل کنید که موارد زیر را در اختیار دارید:

  • نصب Terraform: نسخه 1.0 یا بالاتر. می‌توانید آن را از وب‌سایت رسمی Terraform دانلود کرده یا از طریق پکیج‌منیجرها (Package Manager) نصب کنید.

  • حساب کاربری پارس‌پک: برای ایجاد زیرساخت و دسترسی به پنل.

  • توکن API: برای احراز هویت ماشین به ماشین (از بخش مدیریت توسعه در پنل دریافت کنید).

  • اعتبار مالی: شارژ بودن کیف پول حساب کاربری جهت ایجاد سرویس‌های جدید.

  • ویرایشگر متن: یک ویرایشگر استاندارد مانند VSCode، Sublime Text یا Vim.

۱. نصب و راه‌اندازی پروایدر

ابتدا یک دایرکتوری جدید برای پروژه خود ایجاد کرده و وارد آن شوید:

mkdir terraform-abrha-example
cd terraform-abrha-example

سپس یک فایل با نام main.tf ایجاد کنید و قطعه کد زیر را برای معرفی پروایدر پارس‌پک در آن قرار دهید:

terraform {
  required_providers {
    abrha = {
      source  = "abrhacom/abrha"
      version = "~> 1.0"
    }
  }
}

برای دریافت پلاگین‌ها و نصب پروایدر، دستور زیر را اجرا کنید:
terraform init

۲. پیکربندی پروایدر و تعریف منابع

برای احراز هویت، باید توکن API خود را در پیکربندی تعریف کنید. در همان فایل main.tf، مقادیر زیر را به انتهای کدهای قبلی اضافه کنید (دقت کنید که به جای xهای داخل قطعه کد، باید توکن دریافتی از پنل پارس‌پک را قرار دهید):

provider "abrha" {
  token = "xxxxxxxxxxxxxxxxxxxxxxxx"
}

resource "abrha_vm" "testVm" {
  image     = "ubuntu24-cloudinit-qcow2"
  region    = "tehran11"
  size      = "irLinuxVPS4"
  name      = "TestVmTerraform"
}

۳. اجرای Terraform

برای بررسی تغییراتی که قرار است روی زیرساخت اعمال شود، دستور زیر را وارد کنید:

terraform plan

در صورت تایید خروجی مرحله قبل، برای اعمال تغییرات و ساخت نهایی سرور دستور زیر را اجرا کنید:
terraform apply

نکته: در هنگام درخواست تایید در ترمینال، کلمه yes را تایپ کنید.

برای مشاهده خروجی‌ها و وضعیت منابع ایجاد شده می‌توانید از دستور زیر استفاده کنید:

terraform output

۴. پاک‌سازی منابع

در صورتی که قصد دارید منابع ایجاد شده (مانند ماشین مجازی تستی) را به طور کامل از زیرساخت حذف کنید، دستور زیر را اجرا کنید:

terraform destroy

مراحل بعدی