summaryrefslogtreecommitdiff
path: root/docs/docsite/rst/scenario_guides/guide_azure.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docsite/rst/scenario_guides/guide_azure.rst')
-rw-r--r--docs/docsite/rst/scenario_guides/guide_azure.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/docsite/rst/scenario_guides/guide_azure.rst b/docs/docsite/rst/scenario_guides/guide_azure.rst
index 1bc0462d32..77c7736c1c 100644
--- a/docs/docsite/rst/scenario_guides/guide_azure.rst
+++ b/docs/docsite/rst/scenario_guides/guide_azure.rst
@@ -257,6 +257,30 @@ virtual network already with an existing subnet, you can run the following to cr
version: latest
+Creating a Virtual Machine in Availability Zones
+..................................................
+
+If you want to create a VM in an availability zone,
+consider the following:
+
+* Both OS disk and data disk must be a 'managed disk', not an 'unmanaged disk'.
+* When creating a VM with the ``azure_rm_virtualmachine`` module,
+ you need to explicitly set the ``managed_disk_type`` parameter
+ to change the OS disk to a managed disk.
+ Otherwise, the OS disk becomes an unmanaged disk..
+* When you create a data disk with the ``azure_rm_manageddisk`` module,
+ you need to explicitly specify the ``storage_account_type`` parameter
+ to make it a managed disk.
+ Otherwise, the data disk will be an unmanaged disk.
+* A managed disk does not require a storage account or a storage container,
+ unlike a n unmanaged disk.
+ In particular, note that once a VM is created on an unmanaged disk,
+ an unnecessary storage container named "vhds" is automatically created.
+* When you create an IP address with the ``azure_rm_publicipaddress`` module,
+ you must set the ``sku`` parameter to ``standard``.
+ Otherwise, the IP address cannot be used in an availability zone.
+
+
Dynamic Inventory Script
------------------------