summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst')
-rw-r--r--docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst b/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst
new file mode 100644
index 0000000..0e64bd0
--- /dev/null
+++ b/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/create_vm.rst
@@ -0,0 +1,39 @@
+.. _vmware_rest_create_vm:
+
+*******************************
+How to create a Virtual Machine
+*******************************
+
+.. contents::
+ :local:
+
+
+Introduction
+============
+
+This section shows you how to use Ansible to create a virtual machine.
+
+Scenario requirements
+=====================
+
+You've already followed :ref:`vmware_rest_collect_info` and you've got the following variables defined:
+
+- ``my_cluster_info``
+- ``my_datastore``
+- ``my_virtual_machine_folder``
+- ``my_cluster_info``
+
+How to create a virtual machine
+===============================
+
+In this example, we will use the ``vcenter_vm`` module to create a new guest.
+
+.. literalinclude:: task_outputs/Create_a_VM.task.yaml
+
+Result
+______
+
+.. literalinclude:: task_outputs/Create_a_VM.result.json
+
+.. note::
+ ``vcenter_vm`` accepts more parameters, however you may prefer to start with a simple VM and use the ``vcenter_vm_hardware`` modules to tune it up afterwards. It's easier this way to identify a potential problematical step.