> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/vi/mo-dun-6-may-ao/01-vm-creation-lifecycle.md).

# Tạo VM & Vòng đời

## Tổng quan

Máy ảo là đơn vị khối lượng công việc chính trong VergeOS. Giao diện VergeOS cung cấp quy trình tinh gọn để tạo VM, gắn lưu trữ và mạng, và quản lý toàn bộ vòng đời -- từ lần khởi động đầu tiên cho đến ảnh chụp nhanh, bản sao, và di chuyển nóng. Dù bạn đang xây dựng một máy chủ thử nghiệm đơn lẻ hay triển khai hàng trăm khối lượng công việc sản xuất, quy trình đều tuân theo cùng một mẫu nhất quán.

VergeOS cung cấp bốn phương thức để tạo VM:

| Phương thức      | Mô tả                                                   | Trường hợp sử dụng                                  |
| ---------------- | ------------------------------------------------------- | --------------------------------------------------- |
| **VM tùy chỉnh** | VM trống không có ổ đĩa hay NIC -- bạn cấu hình mọi thứ | Toàn quyền kiểm soát cấu hình phần cứng             |
| **Recipe**       | Mẫu golden-image dựng sẵn với các câu hỏi hướng dẫn     | Triển khai chuẩn hóa, lặp lại được                  |
| **Sao chép**     | Bản sao của một VM hiện có với địa chỉ MAC mới          | Sao chép nhanh các khối lượng công việc đang chạy   |
| **Nhập**         | Từ các tệp OVF/OVA, VMX, VMDK, VHDX hoặc QCOW2          | Di chuyển từ VMware, Hyper-V hoặc các nền tảng khác |

```mermaid
flowchart LR
    subgraph creation["Các phương thức tạo VM"]
        direction TB
        C["VM tùy chỉnh"]
        R["Công thức"]
        CL["Sao chép"]
        I["Nhập"]
    end

    subgraph config["Cấu hình"]
        direction TB
        CPU["CPU & RAM"]
        D["Ổ đĩa"]
        N["NIC"]
        ADV["Cài đặt nâng cao"]
    end

    subgraph lifecycle["Các thao tác vòng đời"]
        direction TB
        START["Khởi động / Tắt / Khởi động lại"]
        SNAP["Ảnh chụp nhanh"]
        CLONE["Sao chép"]
        MIG["Di chuyển nóng"]
    end

    creation --> config --> lifecycle
```

## Tạo VM tùy chỉnh

Một VM tùy chỉnh được tạo dưới dạng một vỏ trống -- không có ổ đĩa, không có NIC, không có hệ điều hành. Điều này cho bạn toàn quyền kiểm soát mọi khía cạnh của cấu hình phần cứng trước khi cài đặt hệ điều hành khách.

### Hướng dẫn từng bước

1. Từ **Bảng điều khiển đám mây**, nhấp vào **Máy** > **Máy ảo**.
2. Nhấp **Mới** từ menu bên trái.
3. Chọn **-- Tùy chỉnh --** từ danh sách tùy chọn.
4. Nhấp **Tiếp theo** và cấu hình các trường VM (xem phần tham chiếu trường bên dưới).
5. Nhấp **Gửi** để tạo VM.
6. Thêm **ổ đĩa** và **NIC** từ bảng điều khiển VM (được trình bày chi tiết ở các phần bên dưới).
7. **Bật nguồn** VM và cài đặt hệ điều hành khách từ ISO hoặc đĩa nhập.

{% hint style="success" %}
**Bắt đầu nhanh**

Nếu bạn chỉ muốn có một VM hoạt động thật nhanh, hãy dùng **Recipe** thay vì Custom. Recipe bao gồm các ổ đĩa, NIC và ảnh hệ điều hành đã được cấu hình sẵn -- bạn chỉ cần trả lời vài câu hỏi (số lõi, RAM, mạng, tầng lưu trữ) và VM sẵn sàng khởi động.
{% endhint %}

## Tham chiếu trường VM

Khi tạo hoặc chỉnh sửa VM, các trường sau kiểm soát cấu hình phần cứng của nó:

| Trường                   | Mô tả                                                                                                                                               | Khuyến nghị                                                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Tên**                  | Định danh duy nhất của VM                                                                                                                           | Dùng tên mô tả, nhất quán                                                                                                     |
| **Số lõi CPU**           | Số lõi CPU ảo                                                                                                                                       | Bắt đầu ở mức thận trọng; tăng dần khi cần                                                                                    |
| **RAM (MB)**             | Phân bổ bộ nhớ tính bằng megabyte                                                                                                                   | Bắt đầu thận trọng với phân bổ RAM và mở rộng dựa trên giám sát                                                               |
| **Hệ điều hành**         | Windows, Linux, FreeBSD hoặc Khác                                                                                                                   | Ảnh hưởng đến cờ QEMU và tối ưu hóa hiệu năng                                                                                 |
| **Loại máy**             | Q35 (hiện đại) hoặc i440FX (di sản)                                                                                                                 | **Q35** được khuyến nghị cho tất cả VM mới                                                                                    |
| **UEFI**                 | Bật firmware khởi động UEFI                                                                                                                         | Bắt buộc cho Secure Boot và các tính năng hệ điều hành hiện đại                                                               |
| **Khởi động an toàn**    | Xác thực chữ ký chuỗi khởi động                                                                                                                     | Bật cho Windows Server 2016+ và Linux được tăng cường bảo mật                                                                 |
| **QEMU Guest Agent**     | Kênh giao tiếp từ host sang guest                                                                                                                   | **Luôn bật** -- bắt buộc cho ảnh chụp nhanh quiesced                                                                          |
| **Video**                | Bộ điều hợp hiển thị (`std`, `cirrus`, `vmware`, `qxl`, `virtio`)                                                                                   | Mặc định VESA 2.0 tiêu chuẩn; chọn QXL khi dùng console SPICE; chỉ chọn VirtIO khi nút vật lý có GPU đủ năng lực (ví dụ: VDI) |
| **Console**              | VNC, SPICE hoặc Serial                                                                                                                              | SPICE cho máy tính để bàn; VNC cho sử dụng chung                                                                              |
| **Thứ tự khởi động**     | Độ ưu tiên của các thiết bị khởi động                                                                                                               | Đặt ổ đĩa hệ điều hành ở thứ tự 0                                                                                             |
| **Nhóm HA**              | Nhóm vị trí cân bằng tải cao; tên nhóm giữ các VM trên các nút riêng biệt (độ ưu tiên âm), và tiền tố `+tên` đặt chúng cùng nhau (độ ưu tiên dương) | Giữ các VM liên quan trên các nút riêng biệt                                                                                  |
| **Nút ưu tiên**          | Ghim VM vào một nút cụ thể                                                                                                                          | Sử dụng tiết chế -- làm giảm tính linh hoạt của chuyển đổi dự phòng                                                           |
| **Hồ sơ ảnh chụp nhanh** | Lịch chụp nhanh tự động                                                                                                                             | Gán để sao lưu riêng cho từng VM ngoài ảnh chụp nhanh hệ thống                                                                |
| **RTC Base**             | UTC hoặc Giờ địa phương                                                                                                                             | Dùng UTC cho Linux; cấu hình Windows dùng UTC hoặc đặt thành Giờ địa phương                                                   |
| **Cho phép hot-plug**    | Bật hot-plug cho ổ đĩa/NIC                                                                                                                          | Được bật theo mặc định -- cứ để nguyên                                                                                        |

{% hint style="info" %}
**Cầu nối VMware**

Biểu mẫu tạo VM của VergeOS tương tự rất sát với hộp thoại **Chỉnh sửa cài đặt** : Machine Type Q35 tương ứng với phiên bản phần cứng ảo mới hơn, và Guest Agent thay thế VMware Tools cho ảnh chụp nhanh quiesced, báo cáo IP và tắt máy an toàn. VM được tạo dưới dạng vỏ trống; ổ đĩa và NIC được thêm như các đối tượng riêng biệt.
{% endhint %}

## Thêm ổ đĩa

Các ổ đĩa được thêm vào VM sau khi tạo. Từ **Bảng điều khiển VM**, nhấp vào **Ổ đĩa** > **Mới** (hoặc dùng **Ổ đĩa mới** phím tắt ở menu bên trái).

### Các loại phương tiện ổ đĩa

| Loại phương tiện | Mô tả                                                                      |
| ---------------- | -------------------------------------------------------------------------- |
| **Đĩa**          | Đĩa ảo trống (thin-provisioned)                                            |
| **CD-ROM**       | Phương tiện ISO chỉ đọc để cài đặt hệ điều hành                            |
| **Sao chép đĩa** | Bản sao của một `.raw` đĩa hiện có trong cùng đám mây                      |
| **Nhập đĩa**     | Tạo từ các ảnh đĩa đã tải lên (`.vmdk`, `.qcow2`, `.vhd`, `.vhdx`, `.raw`) |
| **Không bền**    | Quay lại ảnh golden image ở mỗi lần khởi động (lý tưởng cho VDI)           |
| **Đĩa EFI**      | Đĩa firmware UEFI được tạo tự động (do hệ thống quản lý)                   |

### Các loại giao diện ổ đĩa

| Giao diện                                   | Hiệu năng  | Ghi chú                                                                                                                                                                                  |
| ------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Virtio-SCSI**                             | Xuất sắc   | **Được khuyến nghị cho tất cả VM mới.** Hỗ trợ hot-plug, TRIM/discard và thay đổi kích thước trực tuyến. Linux có sẵn trình điều khiển sẵn; Windows yêu cầu ISO trình điều khiển VirtIO. |
| **Virtio-SCSI (Bộ điều khiển chuyên dụng)** | Xuất sắc   | Dùng khi kết hợp các ổ đĩa thuộc các tầng lưu trữ khác nhau trong cùng một VM.                                                                                                           |
| **Virtio (Di sản)**                         | I/O tối đa | Thông lượng thô cao nhất nhưng thiếu các tính năng SCSI như TRIM.                                                                                                                        |
| **SATA (AHCI)**                             | Tốt        | Chỉ dành cho loại máy Q35. Tương thích rộng với nhiều hệ điều hành khách.                                                                                                                |
| **IDE**                                     | Cơ bản     | Chỉ dành cho loại máy i440FX. Tương thích di sản.                                                                                                                                        |
| **LSI**                                     | Tốt        | Chế độ tương thích VMware.                                                                                                                                                               |

### Tầng ưu tiên

Mỗi ổ đĩa đều được gán một **tầng ưu tiên** xác định tầng lưu trữ vSAN nào sẽ chứa dữ liệu của nó. Chọn dựa trên yêu cầu khối lượng công việc của bạn:

* **Tầng 1** (NVMe) -- Hiệu năng cao nhất cho cơ sở dữ liệu và khối lượng công việc nhạy độ trễ
* **Tầng 2** (SSD) -- Cân bằng tốt giữa hiệu năng và dung lượng
* **Tầng 3** (SSD/HDD) -- Lưu trữ đa dụng
* **Tầng 4–5** (HDD/Archive) -- Tối ưu dung lượng cho dữ liệu lạnh

{% hint style="success" %}
VergeOS sử dụng **thin provisioning** -- việc cấp phát kích thước đĩa lớn không tiêu tốn dung lượng cho đến khi guest thực sự ghi dữ liệu. Thường tốt hơn là cấp phát dư ban đầu thay vì phải mở rộng sau này.
{% endhint %}

## Thêm NIC

Từ Bảng điều khiển VM, nhấp vào **NIC** > **Mới** để thêm một giao diện mạng.

### Các trường cấu hình NIC

| Trường          | Mô tả                                                                                                                                                            |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tên**         | Nhãn tùy chọn (khuyến nghị nếu có nhiều NIC)                                                                                                                     |
| **Giao diện**   | **Virtio** (khuyến nghị), Intel E1000, AMD PCnet, Realtek 8139. Các VM VMware/Hyper-V đã nhập cũng có thể xuất hiện `e1000e`, `vmxnet3`hoặc `igb` (Intel 82576). |
| **Mạng**        | Mạng ảo đích (nội bộ hoặc bên ngoài)                                                                                                                             |
| **Địa chỉ MAC** | Tự động tạo hoặc chỉ định thủ công                                                                                                                               |
| **Đã bật**      | Bật/tắt NIC mà không xóa                                                                                                                                         |
| **Tài sản**     | Định danh duy nhất để dùng trong các công thức                                                                                                                   |

{% hint style="success" %}
**Virtio** cung cấp hiệu năng mạng tốt nhất. Linux có sẵn trình điều khiển VirtIO. Với Windows, cài trình điều khiển từ [ISO trình điều khiển VirtIO](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso) hoặc dùng các ISO Windows tùy chỉnh của VergeOS, vốn đã gói sẵn chúng.
{% endhint %}

## Khả năng hot-plug

VergeOS hỗ trợ sửa đổi một số phần cứng VM khi VM đang chạy, được điều khiển bởi **Cho phép hot-plug** thiết lập (được bật theo mặc định).

### Những gì có thể hot-plug

| Tài nguyên                    | Hot-plug? | Ghi chú                                                         |
| ----------------------------- | --------- | --------------------------------------------------------------- |
| **Ổ đĩa**                     | Có        | Hệ điều hành khách phải hỗ trợ hot-add; khuyến nghị Virtio-SCSI |
| **NIC**                       | Có        | Được hỗ trợ rộng rãi bởi các hệ điều hành khách hiện đại        |
| **Thay đổi kích thước ổ đĩa** | Có        | Các ổ đĩa Virtio-SCSI có thể mở rộng mà không cần chu kỳ nguồn  |

### Những gì yêu cầu chu kỳ nguồn

| Tài nguyên       | Ghi chú                                                         |
| ---------------- | --------------------------------------------------------------- |
| **RAM**          | Thay đổi bộ nhớ luôn yêu cầu tắt rồi bật lại VM                 |
| **Số lõi CPU**   | Thay đổi số lõi luôn yêu cầu chu kỳ nguồn                       |
| **Loại console** | Thay đổi VNC/SPICE/Serial có hiệu lực ở lần bật nguồn tiếp theo |
| **Card đồ họa**  | Thay đổi bộ điều hợp video yêu cầu chu kỳ nguồn                 |
| **Loại máy**     | Thay đổi chipset yêu cầu chu kỳ nguồn                           |
| **UEFI/BIOS**    | Thay đổi chế độ khởi động yêu cầu chu kỳ nguồn                  |

{% hint style="info" %}
**Cầu nối Nutanix**

Đang chuyển từ Nutanix AHV? Hot-plug của VergeOS hoạt động trên ổ đĩa và NIC cho VM; để thay đổi kích thước CPU/RAM trực tiếp, hãy dùng **nút tenant** — hệ thống cha có thể điều chỉnh số lõi và RAM của một nút tenant mà không cần khởi động lại các khối lượng công việc đang chạy bên trong nó.
{% endhint %}

## Tạo VM từ bản sao

Sao chép tạo ra một phiên bản VM mới như một bản sao của một VM hiện có. Điều này hữu ích để sao chép nhanh các khối lượng công việc, tạo môi trường thử nghiệm hoặc mở rộng các máy chủ giống hệt nhau.

### Tùy chọn sao chép

| Tùy chọn                     | Mặc định          | Mô tả                                                                                           |
| ---------------------------- | ----------------- | ----------------------------------------------------------------------------------------------- |
| **Tên VM**                   | `<original>clone` | Đổi tên theo ý muốn                                                                             |
| **Giữ nguyên địa chỉ MAC**   | Tắt               | Tạo MAC mới (an toàn khi hoạt động trên cùng mạng)                                              |
| **Giữ nguyên UUID thiết bị** | Tắt               | Tạo UUID mới (chỉ bật nếu ứng dụng yêu cầu)                                                     |
| **Làm yên hệ thống tệp**     | Tắt               | Đóng băng hệ thống tệp và xả bộ đệm để tạo bản sao nhất quán với ứng dụng (yêu cầu Guest Agent) |

### Hướng dẫn sao chép

1. Đi tới **Máy** > **Máy ảo** > **Mới**.
2. Chọn **--Sao chép--** từ danh sách tùy chọn.
3. Chọn VM nguồn từ danh sách có sẵn.
4. Nhấp **Tiếp theo**, cấu hình các tùy chọn sao chép và nhấp vào **Gửi**.

{% hint style="warning" %}
Chạy một bản sao trên cùng mạng với bản gốc và **Giữ nguyên địa chỉ MAC** được bật sẽ gây xung đột mạng. Luôn xác minh rằng địa chỉ MAC và cấu hình IP là duy nhất trước khi bật bản sao.
{% endhint %}

## Các thao tác vòng đời

Sau khi VM được tạo và cấu hình, các thao tác sau có sẵn từ Bảng điều khiển VM:

```mermaid
stateDiagram-v2
    [*] --> Dừng
    Dừng --> Đang chạy : Bật nguồn
    Đang chạy --> Dừng : Tắt nguồn / Shutdown
    Đang chạy --> Đang chạy : Khởi động lại
    Đang chạy --> Ngủ đông : Ngủ đông
    Ngủ đông --> Đang chạy : Tiếp tục
    Đang chạy --> Đang chạy : Di chuyển nóng
    Đang chạy --> Ảnh chụp nhanh : Chụp ảnh nhanh
    Ảnh chụp nhanh --> Đang chạy
    Dừng --> Đã sao chép : Sao chép
    Đã sao chép --> [*]
```

| Thao tác           | Mô tả                                                                          |
| ------------------ | ------------------------------------------------------------------------------ |
| **Bật nguồn**      | Khởi động VM                                                                   |
| **Tắt nguồn**      | Cắt nguồn ngay lập tức (dùng Shutdown để dừng an toàn)                         |
| **Shutdown**       | Tắt an toàn do ACPI khởi phát qua hệ điều hành khách                           |
| **Khởi động lại**  | Khởi động lại an toàn                                                          |
| **Ngủ đông**       | Lưu trạng thái VM vào đĩa và dừng lại (tiếp tục từ cùng trạng thái)            |
| **Ảnh chụp nhanh** | Tạo bản sao lưu tại thời điểm cụ thể (thủ công hoặc theo lịch)                 |
| **Sao chép**       | Tạo một bản sao của VM                                                         |
| **Di chuyển nóng** | Di chuyển một VM đang chạy sang nút khác mà không có thời gian ngừng hoạt động |

### Các phương thức chụp nhanh

VergeOS cung cấp ba mức bảo vệ ảnh chụp nhanh VM:

| Phương thức                          | Phạm vi                        | Hỗ trợ quiesce     | Trường hợp sử dụng                                      |
| ------------------------------------ | ------------------------------ | ------------------ | ------------------------------------------------------- |
| **Ảnh chụp nhanh toàn hệ thống**     | Tất cả VM, tenant, cài đặt     | Không              | Các điểm khôi phục DR trên toàn hệ thống                |
| **Ảnh chụp nhanh hệ thống một phần** | Chỉ các VM/tenant được gắn thẻ | Có (theo thẻ)      | Tần suất cao hơn cho các khối lượng công việc được chọn |
| **Ảnh chụp nhanh từng VM**           | Một VM                         | Có (nếu được chọn) | Bảo vệ theo từng VM, sao lưu trước bảo trì              |

**Ảnh chụp nhanh quiesced** đóng băng hệ thống tệp của máy khách và xả bộ đệm ghi trước khi chụp, cung cấp các bản sao lưu nhất quán với ứng dụng. Trên các VM Windows, các VSS writer được gọi cho những ứng dụng hỗ trợ VSS.  **Guest Agent phải được cài đặt và đăng ký** để ảnh chụp nhanh quiesced hoạt động.

### Di chuyển nóng

Di chuyển nóng chuyển một VM đang chạy từ nút vật lý này sang nút vật lý khác mà không có thời gian ngừng hoạt động. Điều này rất cần thiết cho:

* **Bảo trì theo kế hoạch** -- Di chuyển VM ra khỏi nút trước khi đưa nút đó offline
* **Cân bằng tải** -- Phân bổ lại khối lượng công việc trên toàn cụm
* **Nâng cấp phần cứng** -- Di chuyển VM ra khỏi một nút trước khi thay thế các thành phần

VergeOS xử lý di chuyển nóng tự động trong các thao tác bảo trì, hoặc bạn có thể kích hoạt thủ công từ Bảng điều khiển VM.

## Guest Agent

Tính năng **QEMU Guest Agent** là một dịch vụ nhẹ được cài trong hệ điều hành khách, cho phép giao tiếp từ host sang guest. Đây là yếu tố quan trọng đối với các VM sản xuất.

### Lợi ích của Guest Agent

* **Ảnh chụp nhanh quiesced** -- Sao lưu nhất quán với ứng dụng nhờ đóng băng hệ thống tệp
* **Báo cáo địa chỉ IP** -- IP và hostname của guest hiển thị trên bảng điều khiển VM
* **Tắt an toàn** -- Tắt nguồn đáng tin cậy mà không phụ thuộc vào ACPI
* **Tích hợp VSS** -- Windows Volume Shadow Copy cho ảnh chụp nhanh nhất quán với cơ sở dữ liệu

### Cài đặt

| Nền tảng          | Lệnh cài đặt                                                                                                                                                                     |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Debian/Ubuntu** | `apt-get install qemu-guest-agent`                                                                                                                                               |
| **RHEL/CentOS**   | `yum install qemu-guest-agent`                                                                                                                                                   |
| **Windows**       | Cài đặt `virtio-win-guest-tools.exe` từ [gói trình điều khiển VirtIO](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win-guest-tools.exe) |

Sau khi cài đặt, hãy xác minh tác nhân đã được kết nối bằng cách kiểm tra **Guest Agent** ô chọn trên Bảng điều khiển VM -- một số phiên bản sẽ xuất hiện bên cạnh khi kết nối thành công.

## Thực hành tốt nhất

### Chỉnh dung lượng RAM phù hợp

Bắt đầu thận trọng với việc phân bổ RAM và tăng dần dựa trên việc theo dõi khối lượng công việc thực tế.

### Sử dụng VirtIO ở mọi nơi

Chọn **Virtio-SCSI** cho ổ đĩa và **Virtio** cho NIC. Những trình điều khiển bán ảo hóa này mang lại hiệu năng gần như gốc. Cài đặt trình điều khiển VirtIO trên Windows trước khi chuyển đổi giao diện.

### Luôn bật Guest Agent

Tác nhân khách cho phép tạo ảnh chụp nhanh khi hệ thống được làm yên, báo cáo IP và tắt máy an toàn. Cài đặt nó trên mọi VM sản xuất ngay sau khi thiết lập hệ điều hành.

### Tắt chế độ tiết kiệm điện trong máy khách

Các tính năng tiết kiệm điện của hệ điều hành khách không mang lại lợi ích trong môi trường ảo và có thể gây ra sự cố hiệu năng. Hãy sử dụng một **Hiệu năng** hồ sơ nguồn trong máy khách.

## Lộ trình bắt đầu

1. **Tạo một VM tùy chỉnh** với 2 lõi, 4 GB RAM, kiểu máy Q35, bật UEFI, bật Guest Agent
2. **Thêm một đĩa Virtio-SCSI** (50 GB trên gói bạn chọn) và một **CD-ROM** với một ISO hệ điều hành
3. **Thêm một NIC Virtio** được kết nối với mạng nội bộ của bạn
4. **Bật nguồn** và cài đặt hệ điều hành khách
5. **Cài đặt Tác nhân khách** bên trong máy khách
6. **Tạo ảnh chụp nhanh** làm điểm khôi phục đầu tiên của bạn
7. **Kiểm tra các thao tác vòng đời** -- khởi động lại, sao chép và di chuyển VM


---

# 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.verge.io/learn-the-platform/vi/mo-dun-6-may-ao/01-vm-creation-lifecycle.md?ask=<question>&goal=<endgoal>
```

`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.