From 35315b8316d3b88d9eb2b25a3c303acfa2c2255e Mon Sep 17 00:00:00 2001
From: Robert Nesius <robert.a.nesius@intel.com>
Date: Wed, 2 Nov 2016 00:48:27 -0700
Subject: [PATCH] Azure docs - first draft

---
 source/clear_linux_os_on_azure.rst      | 51 +++++++++++++++++++++++++
 source/index_advanced_configuration.rst |  1 +
 2 files changed, 52 insertions(+)
 create mode 100644 source/clear_linux_os_on_azure.rst

diff --git a/source/clear_linux_os_on_azure.rst b/source/clear_linux_os_on_azure.rst
new file mode 100644
index 00000000..e0efa1fa
--- /dev/null
+++ b/source/clear_linux_os_on_azure.rst
@@ -0,0 +1,51 @@
+.. _clear_linux_os_on_azure
+
+Clear Linux OS on Azure
+=======================
+
+Clear Linux OS is now an offering in the Azure Marketplace.
+
+Clear Linux OS is designed with cloud and data-center environments in mind
+and tuned to maximize the performance and value of Intel Architecture.
+In Azure our boot times are lightning-quick, with all on-boot services
+launched in less than a second on nodes with warm caches.
+
+There are three offering os Clear Linux within the Azure Marketplace. They can
+be created through the `Azure Portal <https://portal.azure.com>`_ or by
+using the `Azure Command Line tools <https://github.com/Azure/azure-cli>`_.
+Each offering can be further customized by using the swupd command to install
+additional bundles. Learn more about Clear Linux OS and bundles
+at https://clearlinux.org/documentation.
+
+Offerings
+~~~~~~~~~
+
+The three offerings, and commands to launch vm instances from the command line for each, are:
+
+* **Basic** - This is a bare-bones generic offering, from which users may
+  extend functionality by adding bundles of their choosing:
+
+  * > (command line coming soon)
+
+* **Containers** - This offering comes with the containers-basic bundle already installed.
+
+  * > (command line coming soon) 
+
+* **Machine Learning** - This offering comes with the containrs-basic bundle already installed.
+
+  * > (command line coming soon)
+
+
+SSH Sessions
+~~~~~~~~~~~~
+To keep ssh sessions to Clear Linux Guests in Azure alive, you can give the
+following option to ssh via the command line:
+
+  .. code-block:: console
+  -o ServerAliveInterval=180
+
+Alternatively, you can add this setting to your ssh config file as shotn below. 
+  .. code-block:: console
+  Host *:
+    ServerAliveInterval 180
+
diff --git a/source/index_advanced_configuration.rst b/source/index_advanced_configuration.rst
index 88fc2f55..a28012b6 100644
--- a/source/index_advanced_configuration.rst
+++ b/source/index_advanced_configuration.rst
@@ -11,4 +11,5 @@ Advanced configuration
    ac-dpdk
    ac-ovs-dpdk
    validate_sigs
+   clear_linux_os_on_azure