From e2356ce3ea35446e3536b487a413d65a09a1facd Mon Sep 17 00:00:00 2001 From: Zachariah Dzielinski Date: Sat, 31 Jul 2021 12:38:20 -0600 Subject: [PATCH 1/2] Added docs on cloud-init and qemu-guest-agent --- docs/resources/vm.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/resources/vm.md b/docs/resources/vm.md index 37000cde..0177b530 100644 --- a/docs/resources/vm.md +++ b/docs/resources/vm.md @@ -214,3 +214,26 @@ VMs can be imported using the `id`, e.g. ``` $ terraform import ovirt_vm.vm 90593465-e777-4d8d-8e98-51a6d799f6e6 ``` + +## Template / Existing Disk Requirements + +If you are leveraging a template or an existing disk when creating a VM resource. There are a few requirements that must be configured beforehand. + +Mainly, on the template or existing disk, a few packages must be installed for `cloud-init` (IE - the `initialization` section) to work, as well as oVirt data propagation (for network information, etc). + +The following packages and services are generally required: +* `qemu-guest-agent` + * Both installing the package, and enabling the service. + * This allows propagation from subsequent data sources, such as network information. +* `cloud-init` + * Both installing the package, and enabling the service. + * This allows the VM resource to leverage the `cloud-init` features for the `initialization` section. + +Here is a quick example for `RHEL / CentOS 8`: + +```bash +dnf -y install cloud-init cloud-utils-growpart qemu-guest-agent +systemctl enable qemu-guest-agent cloud-init +``` + +There are various other considerations to take into account, especially if you are using other operating systems. But this initial information should give you a baseline to find the specific configuration steps required for your environment. \ No newline at end of file From 3489ca400666c5ed59337f2e7b50fa8e093e424e Mon Sep 17 00:00:00 2001 From: Zachariah Dzielinski Date: Sat, 31 Jul 2021 12:45:10 -0600 Subject: [PATCH 2/2] Added docs on cloud-init and qemu-guest-agent --- docs/resources/vm.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/vm.md b/docs/resources/vm.md index 0177b530..2b583de2 100644 --- a/docs/resources/vm.md +++ b/docs/resources/vm.md @@ -236,4 +236,4 @@ dnf -y install cloud-init cloud-utils-growpart qemu-guest-agent systemctl enable qemu-guest-agent cloud-init ``` -There are various other considerations to take into account, especially if you are using other operating systems. But this initial information should give you a baseline to find the specific configuration steps required for your environment. \ No newline at end of file +There are various other considerations to take into account, especially if you are using other operating systems. But this initial information should give you a baseline to find the specific configuration steps required for your environment. \ No newline at end of file