> For the complete documentation index, see [llms.txt](https://docs-epc.gitbook.io/ncs-documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-epc.gitbook.io/ncs-documents/public-api/getting-start-with-ncs-public-api/terraform-with-openstack.md). # Terraform with Openstack ## **Prerequisites** * มี instance หรือ Devices ที่ติดตั้ง Terraform ([How to install](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli)) * การกำหนด Provider ([OpenStack Provider](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs)) * Data ที่ต้องใช้ใน Terraform (สามารถหาได้จาก [space.nipa.cloud](https://space.nipa.cloud/)) * Provider 1. `username` and `password` : นำมาจากที่ผู้ใช้กรอกเข้าเว็ป portal 2. `tenant_id` or `tenant_name`: เอาไว้ระบุ project ที่เราจะใช้งาน Terraform สามารถหาได้จาก project\_id หรือ project\_name 3. Terraform version **:** รองรับversion >= 1.8.4 4. Openstack version **:** รองรับversion \~> 2.0.0 5. `auth_url` : ต้องใช้ url นี้ [https://identity-api.nipa.cloud](https://identity-api.nipa.cloud/) ในการ Authentication 6. `region` : เลือกพื้นที่ หรือ เขตในการสร้าง instance * Instance 1. `image_id` หรือ `image_name` : ใช้สำหรับกำหนด OS ให้กับ instance 2. `flavor_id` หรือ `flavor_name` : ใช้สำหรับกำหนด Machine Type ให้กับ instance 3. `availability_zone` : ระบุพื้นที่ที่กำลังใช้งาน * NCP-BKK * NCP-BKK2 * NCP-NON * NCP-KKN 4. `key_pair` : จำเป็นต้องสร้าง key pair ก่อนจึงจะนำไปใช้งานได้ 1. ซึ่งเมื่อสร้างเสร็จเเล้วจะได้ไฟล์ **.pem** สามารถใช้ remote เข้า instance ด้วยคำสั่ง `ssh -i [target = pathfile] username@hostname` 5. `security_groups` : สามารถระบุชื่อ security group เพื่อนำมาใช้ได้ * **Network** 1. `network_id` : เป็น id networkเเต่ละตัว ซึ่งสามารถนำไปใช้ในการสร้าง port เเละ subnet 2. `pool` : เป็น External network ที่เป็น public ของเเต่ละ AZ ที่เราสามารถนำมาใช้สร้าง floating ip ใน Terraform 3. `port_id` : id port ของ instance ตัวนั้นๆ ## **วิธีการสร้าง instance** 1. สร้างไฟล์ openstack\_provider.tf {% code overflow="wrap" %} ```bash touch openstack_provider.tf ``` {% endcode %}
2. เเก้ไขไฟล์ openstack\_provider.tf ดังนี้ ```yaml # Define required providers #กำหนด Provider สำหรับใช้งาน terraform {   required_version = ">= 1.8.2"   required_providers {     openstack = {       source  = "terraform-provider-openstack/openstack"       version = "~> 2.0.0"     }   } } # Configure the OpenStack Provider provider "openstack" {   user_name   = "xxxxxx" #user name ใช้ user เดียวกันกับที่ login ใน portal   password    = "xxxxxx" #password ใช้ password เดียวกันกับที่ login ใน portal   tenant_name     = "xxxxxx" #เป็น ID ของ tenant หากเว้นไว้จะใช้จากตัวเเปร OS_PROJECT_NAME ของ environment   auth_url      = " https://identity-api.nipa.cloud"   region        = "NCP-TH" #เขตหรือพื้นที่ใช้สำหรับสร้างตัว instance } ``` Note : สามารถอ่านข้อมูลเพิ่มเติมได้ที่ [openstack provider](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs) 3. ใช้คำสั่ง `terraform init` เพื่อเริ่มใช้งาน terraform เป็นขั้นตอนแรกที่สำคัญในการเริ่มต้นใช้งาน Terraform เนื่องจากมันจะจัดเตรียมสภาพแวดล้อมให้พร้อมสำหรับการดำเนินการคำสั่ง Terraform อื่น ๆ เช่น `terraform plan` หรือ `terraform apply` ```bash terraform init ```
เมื่อ init สำเร็จจะปรากฎ ผลลัพธ์ดังรูป
folder `.terraform` และ file `.terraform.lock.hcl` ที่เกิดขึ้นจากการใช้คำสั่ง `terraform init`เมื่อทำการ init เรียบร้อย ก็จะสามารถเพิ่ม resource ต่างๆ เพื่อใช้จัดการ infrastructure ด้วย terraform ได้ 4. สร้างไฟล์ ที่ชื่อว่า **compute\_instance.tf** ```bash touch compute_instance.tf ```
5. ทำการเเก้ไขไฟล์ compute\_instance.tf ```yaml resource "openstack_networking_port_v2" "port_for_test" { name = "openstack_networking_floatingip_associate_v2_port" network_id = "{Network_id}" # network id } resource "openstack_compute_instance_v2" "myinstance" { name = "myinstance" #ชื่อของ instance flavor_id = "{flavor_id}" #ใส่ instance flavor id ที่ต้องการ key_pair = "my_key_pair_name" #ใส่ชื่อ key pair ที่ generate จาก Portal security_groups = ["default"] availability_zone = "NCP-BKK" #สามารถเลือก availability_zone ได้ block_device { uuid = "af3ea4e9-f664-4801-9b1a-59aa3c206342" source_type = "image" volume_size = 10 boot_index = 0 destination_type = "volume" } network { port = openstack_networking_port_v2.port_for_test.id } } ``` Note : สามารถอ่านข้อมูลเพิ่มเติมได้ที่ [openstack\_compute\_instance\_v2](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs/resources/compute_instance_v2) , [openstack\_networking\_port\_v2](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs/resources/networking_port_v2) 6. ใช้คำสั่ง **`terraform plan`** เพื่อตรวจสอบ script เเละดูว่ามีการเปลี่ยนแปลงใดจะเกิดขึ้นเมื่อใช้คำสั่ง **`terraform apply`** ```bash terraform plan ```
7. ใช้คำสั่ง **`terraform apply`** เพื่อสร้าง instance ```bash terraform apply ```
หลังจากใช้คำสั่ง terraform จะถามว่าต้องการ perform action หรือไม่ ถ้าต้องการให้พิมพ์ yes ถ้าไม่ต้องการให้พิมพ์ no\ หากสร้าง instance สำเร็จจะได้ผลลัพธ์ดังรูป
โดย instance ที่สร้างจะปรากฎในหน้า [space.nipa.cloud](https://space.nipa.cloud/) ที่หัวข้อ COMPUTE > Instances ### การ attach floating ip เข้ากับ instance 1. สร้างไฟล์ **openstack\_networking\_floatingip.tf** ```bash touch openstack_networking_floatingip.tf ``` 2. เเก้ไขไฟล์ **openstack\_networking\_floatingip.tf** {% code overflow="wrap" %} ```yaml resource "openstack_networking_floatingip_v2" "floatip_1" { pool = "Standard_Public_IP_Pool_NON" #ให้กรอกชื่อของ pool ที่มีอยู่ โดยจะต้องอยู่ใน AZ เดียวกัย Instances } ``` {% endcode %} 3. สร้างไฟล์ **openstack\_networking\_floatingip\_associate.tf** ```bash touch openstack_networking_floatingip_associate.tf ``` 4. เเก้ไขไฟล์ **openstack\_networking\_floatingip\_associate.tf** {% code overflow="wrap" %} ``` resource "openstack_networking_floatingip_associate_v2" "floating_ip_associate" { floating_ip = openstack_networking_floatingip_v2.floatip_1.address #เป็นการนำ floating ip จาก resource ในข้อสองมาใส่ port_id = openstack_networking_port_v2.port_for_test.id } ``` {% endcode %} 5. ใช้คำสั่ง **`terraform plan`** ```bash terraform plan ```
6. ใช้คำสั่ง **`terraform apply`** เพื่อสร้าง floating ip เเละผูกเข้ากับ instance ```bash terraform apply ```
หลังจากใช้คำสั่ง terraform จะถามว่าต้องการ perform action หรือไม่ ถ้าต้องการให้พิมพ์ yes ถ้าไม่ต้องการให้พิมพ์ no หลังจากใช้คำสั่งเเล้วจะปรากฎผลลัพธ์ ดังรูป
เมื่อตรวจสอบ Instance ในหน้า [space.nipa.cloud](https://space.nipa.cloud/) จะพบว่า Instance จะมี External Ip ที่ทำให้ instance สามารถเข้าถูกเข้าถึงได้จากภายนอก ### วิธีการลบ Instance **`terraform destroy`** คำสั่งสำหรับลบ infrastructure ที่ถูกสร้างขึ้นทั้งหมดที่ถูกสร้างขึ้นด้วยไฟล์ .tf ใน folder นั้นๆ ```bash terraform destroy ```
หลังจากใช้คำสั่ง terraform จะถามว่าต้องการ perform action หรือไม่ ถ้าต้องการ ให้พิมพ์ yes ถ้าไม่ต้องการ ให้พิมพ์ no จะได้ผลลัพธ์ดังรูป
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs-epc.gitbook.io/ncs-documents/public-api/getting-start-with-ncs-public-api/terraform-with-openstack.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.