Skip to content

Commit d927d3c

Browse files
Matt Dolianmboersma
authored andcommitted
docs(azure): add vnet creation instructions
This is required to ensure that the nodes get a static IP address. If a virtual network is not used, the nodes get a dynamic private IP address that can change when rebooted. This causes problems with etcd.
1 parent 30fefce commit d927d3c

1 file changed

Lines changed: 3 additions & 0 deletions

File tree

docs/installing_deis/azure.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ Create CoreOS Cluster
5353

5454
With the management certificate and cloud config in place, we are ready to create our cluster.
5555

56+
* Create a virtual network with a name of your choosing, containing at least one subnet. This is required to ensure that nodes get a static private IP address. Note the name of the virtual network and subnet for the cluster creation script below.
5657
* Create a container called ``vhds`` within a storage account in the same region as your cluster using the Azure portal. Note the URL of the container for the cluster creation script below.
5758
* Choose a cloud service name for your Deis cluster for the script below. The script will automatically create this cloud service for you.
5859
* Create an `affinity group`_ if you don't already have one. Supply it in quotes with the ``--affinity-group`` parameter. Although *using an affinity group is not mandatory*, it is **highly recommended** since it tells the Azure fabric to place all VMs in the cluster physically close to each other, reducing inter-node latency by a great deal. If you don't want to use affinity groups, specify a `region`_ for Azure to use with a ``--location`` parameter. The default is ``"West US"``. If you specify both parameters, ``location`` will be ignored. Please note that the script *will not* create an affinity group by itself; it expects the affinity group exists.
@@ -75,6 +76,8 @@ With that, let's run the azure-coreos-cluster script which will create the CoreO
7576
--blob-container-url https://[blob container].blob.core.windows.net/vhds/
7677
--data-disk
7778
--custom-data azure-user-data
79+
--virtual-network-name [virtual network name]
80+
--subnet-names [subnet name]
7881
7982
This script will by default provision a 3-node cluster, but you can increase this with the
8083
``--num-nodes`` parameter. Likewise, you can increase the VM size using ``--vm-size``.

0 commit comments

Comments
 (0)