summaryrefslogtreecommitdiff
path: root/docs/installation/cloud/azure.rst
diff options
context:
space:
mode:
authorrebortg <github@ghlr.de>2021-03-29 15:54:07 +0200
committerrebortg <github@ghlr.de>2021-03-29 15:54:07 +0200
commit7b65c14fe261e38e63062ae5f8b1018d375bc06f (patch)
treea79896c6afaf97397fe783f2a8aa1f94c86f16a9 /docs/installation/cloud/azure.rst
parent2fc8e13e94cfe3c31d87f286b210e1c08d098040 (diff)
downloadvyos-documentation-7b65c14fe261e38e63062ae5f8b1018d375bc06f.tar.gz
vyos-documentation-7b65c14fe261e38e63062ae5f8b1018d375bc06f.zip
cloud: backport aws, azure and gcp
Diffstat (limited to 'docs/installation/cloud/azure.rst')
-rw-r--r--docs/installation/cloud/azure.rst72
1 files changed, 72 insertions, 0 deletions
diff --git a/docs/installation/cloud/azure.rst b/docs/installation/cloud/azure.rst
new file mode 100644
index 00000000..e19df986
--- /dev/null
+++ b/docs/installation/cloud/azure.rst
@@ -0,0 +1,72 @@
+#####
+Azure
+#####
+
+Deploy VM
+---------
+
+Deploy VyOS on Azure.
+
+1. Go to the Azure services and Click to **Add new Virtual machine**
+
+2. Choose vm name, resource group, region and click **Browse all public and
+ private images**
+
+.. figure:: /_static/images/cloud-azure-01.png
+
+3. On the marketplace search ``VyOS`` and choose the appropriate subscription
+
+.. figure:: /_static/images/cloud-azure-02.png
+
+4. Generate new SSH key pair or use existing.
+
+.. figure:: /_static/images/cloud-azure-03.png
+
+5. Define network, subnet, Public IP. Or it will be created by default.
+
+.. figure:: /_static/images/cloud-azure-04.png
+
+6. Click ``Review + create``. After a few seconds your deployment will be complete
+
+.. figure:: /_static/images/cloud-azure-05.png
+
+7. Click to your new vm and find out your Public IP address.
+
+.. figure:: /_static/images/cloud-azure-06.png
+
+8. Connect to the instance by SSH key.
+
+ .. code-block:: none
+
+ ssh -i ~/.ssh/vyos_azure vyos@203.0.113.3
+ vyos@vyos-doc-r1:~$
+
+Add interface
+-------------
+
+If instance was deployed with one **eth0** ``WAN`` interface and want to add
+new one. To add new interface an example **eth1** ``LAN`` you need shutdown the
+instance. Attach the interface in the Azure portal and then start the instance.
+
+.. note:: Azure does not allow you attach interface when the instance in the
+ **Running** state.
+
+Absorbing Routes
+----------------
+
+If using as a router, you will want your LAN interface to absorb some or all of the traffic from your VNET by using a route table applied to the subnet.
+
+1. Create a route table and browse to **Configuration**
+
+2. Add one or more routes for networks you want to pass through the VyOS VM. Next hop type **Virtual Appliance** with the **Next Hop Address** of the VyOS ``LAN`` interface.
+
+.. note:: If you want to create a new default route for VMs on the subnet, use **Address Prefix** ``0.0.0.0/0`` Also note that if you want to use this as a typical edge device, you'll want masquerade NAT for the ``WAN`` interface.
+
+Serial Console
+--------------
+
+Azure has a way to access the serial console of a VM, but this needs to be configured on the VyOS. It's there by default, but keep it in mind if you are replacing config.boot and rebooting: ``set system console device ttyS0 speed '9600'``
+
+References
+----------
+https://azure.microsoft.com