Merge pull request #49719 from TomArcher/ansible-common-prereqs-sections-into-include-file

Ansible - Create include files for 'Cloud Shell vs. Create/Configure VM' prereqs

Author: GitHubber17

articles/ansible/ansible-create-configure-aks.md

@@ -7,7 +7,7 @@ author: tomarcher
 manager: jeconnoc
 ms.author: tarcher
 ms.topic: tutorial
-ms.date: 08/21/2018
+ms.date: 08/23/2018
 ---
 
 # Create and configure Azure Kubernetes Service clusters in Azure using Ansible
@@ -17,19 +17,7 @@ Ansible allows you to automate the deployment and configuration of resources in
 - **Azure subscription** - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) before you begin.
 - **Azure service principal** - When [creating the service principal](/cli/azure/create-an-azure-service-principal-azure-cli?view=azure-cli-latest#create-the-service-principal), note the following values: **appId**, **displayName**, **password**, and **tenant**.
 
-- **Configure Azure Cloud Shell** or **Install and configure Ansible on a Linux virtual machine**
-
-  **Configure Azure Cloud Shell**
-
-  1. **Configure Azure Cloud Shell** - If you are new to Azure Cloud Shell, the article, [Quickstart for Bash in Azure Cloud Shell](/azure/cloud-shell/quickstart), illustrates how to start and configure Cloud Shell. 
-
-  **--OR--**
-
-  **Install and configure Ansible on a Linux virtual machine**
-
-  1. **Install Ansible** - Install Ansible on a [supported Linux platform](/azure/virtual-machines/linux/ansible-install-configure#install-ansible-on-an-azure-linux-virtual-machine).
-
-  1. **Configure Ansible** - [Create Azure credentials and configure Ansible](/azure/virtual-machines/linux/ansible-install-configure#create-azure-credentials)
+- [!INCLUDE [ansible-prereqs-for-cloudshell-use-or-vm-creation1.md](../../includes/ansible-prereqs-for-cloudshell-use-or-vm-creation1.md)] [!INCLUDE [ansible-prereqs-for-cloudshell-use-or-vm-creation2.md](../../includes/ansible-prereqs-for-cloudshell-use-or-vm-creation2.md)]
 
 > [!Note]
 > Ansible 2.6 is required to run the following the sample playbooks in this tutorial. 

articles/virtual-machines/linux/ansible-create-vm.md

@@ -7,7 +7,7 @@ author: tomarcher
 manager: jeconnoc
 ms.author: tarcher
 ms.topic: quickstart
-ms.date: 08/21/2018
+ms.date: 08/22/2018
 ---
 
 # Use Ansible to create a Linux virtual machine in Azure
@@ -17,19 +17,7 @@ Using a declarative language, Ansible allows you to automate the creation, confi
 
 - **Azure subscription** - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
 
-- **Configure Azure Cloud Shell** or **Install and configure Ansible on a Linux virtual machine**
-
-  **Configure Azure Cloud Shell**
-
-  1. **Configure Azure Cloud Shell** - If you are new to Azure Cloud Shell, the article, [Quickstart for Bash in Azure Cloud Shell](/azure/cloud-shell/quickstart), illustrates how to start and configure Cloud Shell. 
-
-  **--OR--**
-
-  **Install and configure Ansible on a Linux virtual machine**
-
-  1. **Install Ansible** - Install Ansible on a [supported Linux platform](/azure/virtual-machines/linux/ansible-install-configure#install-ansible-on-an-azure-linux-virtual-machine).
-
-  1. **Configure Ansible** - [Create Azure credentials and configure Ansible](/azure/virtual-machines/linux/ansible-install-configure#create-azure-credentials)
+- [!INCLUDE [ansible-prereqs-for-cloudshell-use-or-vm-creation1.md](../../../includes/ansible-prereqs-for-cloudshell-use-or-vm-creation1.md)]
 
 ## Create a resource group
 Ansible needs a resource group in which your resources are deployed. The following sample Ansible playbook section creates a resource group named `myResourceGroup` in the `eastus` location:

articles/virtual-machines/linux/ansible-manage-linux-vm.md

@@ -7,7 +7,7 @@ author: tomarcher
 manager: jeconnoc
 ms.author: tarcher
 ms.topic: quickstart
-ms.date: 08/21/2018
+ms.date: 08/22/2018
 ---
 
 # Use Ansible to manage a Linux virtual machine in Azure
@@ -17,21 +17,7 @@ Ansible allows you to automate the deployment and configuration of resources in
 
 - **Azure subscription** - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
 
-- **Configure Azure Cloud Shell** or **Install and configure Ansible on a Linux virtual machine**
-
-  **Configure Azure Cloud Shell**
-
-  1. **Configure Azure Cloud Shell** - If you are new to Azure Cloud Shell, the article, [Quickstart for Bash in Azure Cloud Shell](/azure/cloud-shell/quickstart), illustrates how to start and configure Cloud Shell. 
-
-  1. **Linux virtual machine** - If you don't have access to a Linux virtual machine, you can [create a virtual machine with Ansible](ansible-create-vm.md).
-
-  **--OR--**
-
-  **Install and configure Ansible on a Linux virtual machine**
-
-  1. **Install Ansible** - Install Ansible on a [supported Linux platform](/azure/virtual-machines/linux/ansible-install-configure#install-ansible-on-an-azure-linux-virtual-machine).
-
-  1. **Configure Ansible** - [Create Azure credentials and configure Ansible](/azure/virtual-machines/linux/ansible-install-configure#create-azure-credentials)
+- [!INCLUDE [ansible-prereqs-for-cloudshell-use-or-vm-creation1.md](../../../includes/ansible-prereqs-for-cloudshell-use-or-vm-creation1.md)] [!INCLUDE [ansible-prereqs-for-cloudshell-use-or-vm-creation2.md](../../../includes/ansible-prereqs-for-cloudshell-use-or-vm-creation2.md)]
 
 ## Use Ansible to deallocate (stop) an Azure virtual machine
 This section illustrates how to use Ansible to deallocate (stop) an Azure virtual machine

includes/ansible-prereqs-for-cloudshell-use-or-vm-creation1.md

@@ -0,0 +1,9 @@
+---
+ author: tomarcher
+ ms.service: ansible
+ ms.topic: include
+ ms.date: 08/23/2018
+ ms.author: tarcher
+---
+
+**Install Ansible** - [Install](/azure/virtual-machines/linux/ansible-install-configure#install-ansible-on-an-azure-linux-virtual-machine) and [configure](/azure/virtual-machines/linux/ansible-install-configure#create-azure-credentials) Ansible on a Linux virtual machine **--OR--** [configure Azure Cloud Shell](/azure/cloud-shell/quickstart)

includes/ansible-prereqs-for-cloudshell-use-or-vm-creation2.md

@@ -0,0 +1,9 @@
+---
+ author: tomarcher
+ ms.service: ansible
+ ms.topic: include
+ ms.date: 08/23/2018
+ ms.author: tarcher
+---
+
+ and - if you don't have access to a Linux virtual machine - [create a virtual machine with Ansible](/azure/virtual-machines/linux/ansible-create-vm.md).