# Thông số tích hợp với Terraform

\
Nội dung

* [Những thông số truyền từ Terraform](#thongsotichhopvoiterreform-nhungthongsotruyentuterreform)
* [Những thuộc tính truyền cho Terraform](#thongsotichhopvoiterreform-nhungthuoctinhtruyenchoterreform)

## Những thông số truyền từ Terraform <a href="#thongsotichhopvoiterreform-nhungthongsotruyentuterreform" id="thongsotichhopvoiterreform-nhungthongsotruyentuterreform"></a>

### Mẫu truyền ví dụ <a href="#thongsotichhopvoiterreform-mautruyenvidu" id="thongsotichhopvoiterreform-mautruyenvidu"></a>

```
resource "vngcloud_vserver_server" "server"{
 project_id = "pro-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 name = "example-server"
 encryption_volume = false
 flavor_id = "flav-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 image_id = "img-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 network_id = "net-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 root_disk_size = 20
 root_disk_type_id = "vtype-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 ssh_key = "ssh-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 security_group = ["secg-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
 subnet_id = "sub-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

### Các tham số (Arguments) <a href="#thongsotichhopvoiterreform-cacthamso-arguments" id="thongsotichhopvoiterreform-cacthamso-arguments"></a>

<table data-full-width="true"><thead><tr><th width="74">No.</th><th width="112">Thông số</th><th width="116">Bắt buộc</th><th width="114">Loại dữ liệu</th><th width="223">Mô tả</th><th>Dữ liệu mẫu</th></tr></thead><tbody><tr><td>1</td><td><em>project_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của Project.</td><td>pro-462803f3-6858-466f-bf05-df2b33faa360</td></tr><tr><td>2</td><td><em>name</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Tên của Server.</td><td>example-server-name</td></tr><tr><td>3</td><td><em>encryption_volume</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>BOOLEAN</strong></td><td>Server có dùng các Volume mã hóa hay không?</td><td>False</td></tr><tr><td>4</td><td><em>flavor_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của Flavor.</td><td>flav-e2028a81-cc75-47e4-8af1-9eef2f857f84</td></tr><tr><td>5</td><td><em>image_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của Image.</td><td>img-b5bf635e-0456-4765-b493-31d5fcfc05aa</td></tr><tr><td>6</td><td><em>network_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của Network.</td><td>net-961d6867-b65a-40ac-879e-d84e4dc768e0</td></tr><tr><td>7</td><td><em>root_disk_size</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>NUMBER</strong></td><td>Kích thước của boot volume.</td><td>20</td></tr><tr><td>8</td><td><em>root_disk_type_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của loại boot volume.</td><td>vtype-61c3fc5b-f4e9-45b4-8957-8aa7b6029018</td></tr><tr><td>9</td><td><em>ssh_key</em></td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Mã của SSH key.</td><td>ssh-7bd70c56-1f05-4989-a0f0-cc3496b62001</td></tr><tr><td>10</td><td><em>security_group</em></td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Mã của Security group.</td><td>secg-3b12a078-b862-43b5-a56b-d7fc4429e535</td></tr><tr><td>11</td><td><em>subnet_id</em></td><td><strong>BẮT BUỘC</strong></td><td><strong>STRING</strong></td><td>Mã của subnet.</td><td>sub-c1ebba8f-baa8-434c-beb7-2916199bb812</td></tr><tr><td>12</td><td>host_group_id</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Mã của Host Group.</td><td>/</td></tr><tr><td>13</td><td>action</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Những hành động với Server. Các hành động đó có thể là: stop; start; reboot.</td><td>start</td></tr><tr><td>14</td><td>attach_floating</td><td><strong>TÙY CHỌN</strong></td><td><strong>BOOLEAN</strong></td><td>Server có được gắn floating IP không?</td><td>True</td></tr><tr><td>15</td><td>expire_password</td><td><strong>TÙY CHỌN</strong></td><td><strong>BOOLEAN</strong></td><td>Bỏ qua thay đổi password thì false, nếu không thì true.</td><td>False</td></tr><tr><td>16</td><td>os_licence</td><td><strong>TÙY CHỌN</strong></td><td><strong>BOOLEAN</strong></td><td>Bản quyền của Hệ điều hành OS.</td><td>True</td></tr><tr><td>17</td><td>root_disk_encryption_type</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Kiểu mã hóa của boot volume.</td><td>/</td></tr><tr><td>18</td><td>source_type</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Loại Source.</td><td>/</td></tr><tr><td>19</td><td>user_name</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Tên của User.</td><td>usernamestackops</td></tr><tr><td>20</td><td>user_password</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Mật khẩu của USer.</td><td>VngGCloud3030</td></tr><tr><td>21</td><td>server_group</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>Mã của Server Group.</td><td>/</td></tr><tr><td>22</td><td>user_data</td><td><strong>TÙY CHỌN</strong></td><td><strong>STRING</strong></td><td>User_data được cung cấp khi kích hoạt sử dụng server.</td><td>${data.template_cloudinit_config.user_data.rendered}</td></tr><tr><td>23</td><td>user_data_base64_encode</td><td><strong>TÙY CHỌN</strong></td><td><strong>BOOLEAN</strong></td><td>Có được sử dụng trực tiếp mã hóa dữ liệu nhị phân base64 thay vì user_data thường không? Việc sử dụng này thay cho User_data bất cứ khi nào giá trị không phải là chuỗi UTF-8 hợp lệ.</td><td>True</td></tr><tr><td>24</td><td>is_poc</td><td><strong>TÙY CHỌN</strong></td><td><strong>BOOLEAN</strong></td><td>Sử dụng ví POC.</td><td>True</td></tr></tbody></table>

{% hint style="warning" %}
**Ghi chú**

* Với thông tin truyền thay đổi (Resize) thì vẫn truyền thuộc tính <mark style="color:blue;">is\_poc</mark> về hệ thống của GreenNode.
* Nếu không truyền <mark style="color:blue;">is\_poc</mark> thì user sẽ sử dụng ví thường;
* Trường hợp ngừng sử dụng ví POC và sau đó server bị hết hạn sử dụng, tuy nhiên Server chưa tắt liền mà hệ thống VNG sẽ định kỳ có job quét (11h hàng ngày) để xét tắt các Server bị hết hạn, do đó trước 11h user có thể nạp credit để thanh toán sử dụng tiếp Server.
  {% endhint %}

{% hint style="info" %}
**Lưu ý**

Khi Server đã hết hạn và trạng thái là Kết thúc (Terminated). Nếu User muốn gia hạn (renew) tài nguyên (resource) thì **User phải vào User Portal để gia hạn nếu sử dụng Terraform**, vì Terraform không có chức năng gia hạn.
{% endhint %}

## **Những thuộc tính truyền cho Terraform** <a href="#thongsotichhopvoiterreform-nhungthuoctinhtruyenchoterreform" id="thongsotichhopvoiterreform-nhungthuoctinhtruyenchoterreform"></a>

***

Sau khi GreenNode ghi nhận các thông số truyền từ Terraform, sẽ có những thuộc tính sau được xuất ra cho Terreform cho user sử dụng:

* **id** STRING : Mã định danh của Server này;
* **external\_interfaces:** Danh sách các thông tin của Network External:
  * **external\_interfaces** STRING;
  * **floating\_ip** STRING;
  * **interface\_type**STRING;
  * **mac** STRING;
  * **network\_uuid** STRING;
  * **port\_uuid** STRING;
  * **status** STRING;
  * **subnet\_uuid** STRING;
  * **type** STRING;
* **internal\_interfaces:** Danh sách các thông tin của Network External:
  * **external\_interfaces** STRING;
  * **floating\_ip** STRING;
  * **interface\_type** STRING;
  * **mac** STRING;
  * **network\_uuid** STRING;
  * **port\_uuid** STRING;
  * **status** STRING;
  * **subnet\_uuid** STRING;
  * **type** STRING.