| title | description | ms.service | keywords | author | manager | ms.author | ms.topic | ms.date |
|---|---|---|---|---|---|---|---|---|
Create Azure web apps by using Ansible (preview) |
Learn how to use Ansible to create a web app with Java 8 and the Tomcat container runtime in App Service on Linux |
ansible |
ansible, azure, devops, bash, playbook, Azure App Service, Web App, Java |
tomarcher |
jeconnoc |
tarcher |
tutorial |
09/20/2018 |
Azure App Service Web Apps (or just Web Apps) hosts web applications, REST APIs, and mobile back ends. You can develop in your favorite language—.NET, .NET Core, Java, Ruby, Node.js, PHP, or Python.
Ansible enables you to automate the deployment and configuration of resources in your environment. This article shows you how to use Ansible to create a web app by using the Java runtime.
- Azure subscription - If you don't have an Azure subscription, create a free account before you begin.
- [!INCLUDE ansible-prereqs-for-cloudshell-use-or-vm-creation1.md] [!INCLUDE ansible-prereqs-for-cloudshell-use-or-vm-creation2.md]
Note
Ansible 2.7 is required to run the following the sample playbooks in this tutorial. You can install the Ansible 2.7 RC version by running sudo pip install ansible[azure]==2.7.0rc2. After Ansible 2.7 is released, you won't need to specify a version here because the default version will be 2.7.
This section presents a sample Ansible playbook that defines the following resources:
- Resource group, where your App Service plan and web app will be deployed to
- Web app with Java 8 and the Tomcat container runtime in App Service on Linux
- hosts: localhost
connection: local
vars:
resource_group: myfirstResourceGroup
webapp_name: myfirstWebApp
location: eastus
tasks:
- name: Create a resource group
azure_rm_resourcegroup:
name: "{{ resource_group }}"
location: "{{ location }}"
- name: Create App Service on Linux with Java Runtime
azure_rm_webapp:
resource_group: "{{ resource_group }}"
name: "{{ webapp_name }}"
plan:
resource_group: "{{ resource_group }}"
name: myappplan
is_linux: true
sku: S1
number_of_workers: 1
frameworks:
- name: "java"
version: "8"
settings:
java_container: tomcat
java_container_version: 8.5
Save the preceding playbook as firstwebapp.yml.
To run the playbook, use the ansible-playbook command as follows:
ansible-playbook firstwebapp.ymlThe output from running the Ansible playbook shows that the web app was successfully created:
TASK [Create a resource group] *************************************************
changed: [localhost]
TASK [Create App Service on Linux with Java Runtime] ******************************
[WARNING]: Azure API profile latest does not define an entry for
WebSiteManagementClient
changed: [localhost]
PLAY RECAP *********************************************************************
localhost : ok=2 changed=2 unreachable=0 failed=0
You can use Azure Traffic Manager to control how requests from web clients are distributed to apps in Azure App Service. When App Service endpoints are added to an Azure Traffic Manager profile, Traffic Manager tracks the status of your App Service apps. Statuses include running, stopped, and deleted. Traffic Manager can then decide which of those endpoints should receive traffic.
In App Service, an app runs in an App Service plan. An App Service plan defines a set of compute resources for a web app to run. You can manage your App Service plan and web app in different groups.
This section presents a sample Ansible playbook that defines the following resources:
- Resource group, where your app service plan will be deployed to
- App Service plan
- Secondary resource group, where your web app will be deployed to
- Web app with Java 8 and the Tomcat container runtime in App Service on Linux
- Traffic Manager profile
- Traffic Manager endpoint, using the created website
- hosts: localhost
connection: local
vars:
resource_group: myResourceGroup
plan_resource_group: planResourceGroup
app_name: myLinuxWebApp
location: eastus
linux_plan_name: myAppServicePlan
traffic_manager_profile_name: myTrafficManagerProfile
traffic_manager_endpoint_name: myTrafficManagerEndpoint
tasks:
- name: Create resource group
azure_rm_resourcegroup:
name: "{{ resource_group }}"
location: "{{ location }}"
- name: Create secondary resource group
azure_rm_resourcegroup:
name: "{{ plan_resource_group }}"
location: "{{ location }}"
- name: Create App Service Plan
azure_rm_appserviceplan:
resource_group: "{{ plan_resource_group }}"
name: "{{ linux_plan_name }}"
location: "{{ location }}"
is_linux: true
sku: S1
number_of_workers: 1
- name: Create App Service on Linux with Java Runtime
azure_rm_webapp:
resource_group: "{{ resource_group }}"
name: "{{ app_name }}"
plan:
resource_group: "{{ plan_resource_group }}"
name: "{{ linux_plan_name }}"
is_linux: true
sku: S1
number_of_workers: 1
app_settings:
testkey: "testvalue"
frameworks:
- name: java
version: 8
settings:
java_container: "Tomcat"
java_container_version: "8.5"
- name: Get web app facts
azure_rm_webapp_facts:
resource_group: "{{ resource_group }}"
name: "{{ app_name }}"
register: webapp
- name: Create Traffic Manager Profile
azure_rm_trafficmanagerprofile:
resource_group: "{{ resource_group }}"
name: "{{ traffic_manager_profile_name }}"
location: global
routing_method: performance
dns_config:
relative_name: "{{ traffic_manager_profile_name }}"
ttl: 60
monitor_config:
protocol: HTTPS
port: 80
path: '/'
- name: Add endpoint to traffic manager profile, using created web site
azure_rm_trafficmanagerendpoint:
resource_group: "{{ resource_group }}"
profile_name: "{{ traffic_manager_profile_name }}"
name: "{{ traffic_manager_endpoint_name }}"
type: azure_endpoints
location: "{{ location }}"
target_resource_id: "{{ webapp.webapps[0].id }}"
Save the preceding playbook as webapp.yml, or download the playbook.
To run the playbook, use the ansible-playbook command as follows:
ansible-playbook webapp.ymlThe output from running the Ansible playbook shows that the App service plan, web app, Traffic Manager profile, and endpoint were successfully created:
TASK [Create resource group] ****************************************************************************
changed: [localhost]
TASK [Create resource group for app service plan] ****************************************************************************
changed: [localhost]
TASK [Create App Service Plan] ****************************************************************************
[WARNING]: Azure API profile latest does not define an entry for WebSiteManagementClient
changed: [localhost]
TASK [Create App Service on Linux with Java Runtime] ****************************************************************************
changed: [localhost]
TASK [Get web app facts] *****************************************************************************
ok: [localhost]
TASK [Create Traffic Manager Profile] *****************************************************************************
[WARNING]: Azure API profile latest does not define an entry for TrafficManagerManagementClient
changed: [localhost]
TASK [Add endpoint to traffic manager profile, using the web site created above] *****************************************************************************
changed: [localhost]
TASK [Get Traffic Manager Profile facts] ******************************************************************************
ok: [localhost]
PLAY RECAP ******************************************************************************
localhost : ok=9 changed=6 unreachable=0 failed=0
[!div class="nextstepaction"] Ansible on Azure