archive
/
ansible
mirror of https://github.com/ansible/ansible.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update azure_rm_webapp related document (#59027)

Browse Source 
* Update azure_rm_webapp related document

* resolve format error

* remove whitespace

* update new

* updated according by comments

* update new according by comments

* add support time
pull/59027/merge
Fred-sun 5 years ago committed by ansibot
parent dbd082efe4
commit f088621610
2 changed files with 150 additions and 68 deletions
Show Stats Download Patch File Download Diff File

101
lib/ansible/modules/cloud/azure/azure_rm_webapp.py
Unescape Escape View File

@ -17,7 +17,7 @@ DOCUMENTATION = '''
--- ---
module: azure_rm_webapp module: azure_rm_webapp
version_added: "2.7" version_added: "2.7"
short_description: Manage Web App instance. short_description: Manage Web App instances
description: description:
- Create, update and delete instance of Web App. - Create, update and delete instance of Web App.
@ -38,15 +38,15 @@ options:
plan: plan:
description: description:
- App service plan. Required for creation. - App service plan. Required for creation.
- It can be name of existing app service plan in same resource group as web app. - Can be name of existing app service plan in same resource group as web app.
- "It can be resource id of existing app service plan. eg., - Can be the resource ID of an existing app service plan. For example
/subscriptions/<subs_id>/resourceGroups/<resource_group>/providers/Microsoft.Web/serverFarms/<plan_name>" /subscriptions/<subs_id>/resourceGroups/<resource_group>/providers/Microsoft.Web/serverFarms/<plan_name>.
- It can be a dict which contains C(name), C(resource_group), C(sku), C(is_linux) and C(number_of_workers). - Can be a dict containing five parameters, defined below.
- C(name). Name of app service plan. - C(name), name of app service plan.
- C(resource_group). Resource group name of app service plan. - C(resource_group), resource group of the app service plan.
- C(sku). SKU of app service plan. For allowed sku, please refer to U(https://azure.microsoft.com/en-us/pricing/details/app-service/linux/). - C(sku), SKU of app service plan, allowed values listed on U(https://azure.microsoft.com/en-us/pricing/details/app-service/linux/).
- C(is_linux). Indicates Linux app service plan. type bool. default False. - C(is_linux), whether or not the app service plan is Linux. defaults to C(False).
- C(number_of_workers). Number of workers. - C(number_of_workers), number of workers for app service plan.
frameworks: frameworks:
description: description:
@ -57,8 +57,10 @@ options:
description: description:
- Name of the framework. - Name of the framework.
- Supported framework list for Windows web app and Linux web app is different. - Supported framework list for Windows web app and Linux web app is different.
- For Windows web app, supported names(June 2018) java, net_framework, php, python, node. Multiple framework can be set at same time. - Windows web apps support C(java), C(net_framework), C(php), C(python), and C(node) from June 2018.
- For Linux web app, supported names(June 2018) java, ruby, php, dotnetcore, node. Only one framework can be set. - Windows web apps support multiple framework at the same time.
- Linux web apps support C(java), C(ruby), C(php), C(dotnetcore), and C(node) from June 2018.
- Linux web apps support only one framework.
- Java framework is mutually exclusive with others. - Java framework is mutually exclusive with others.
choices: choices:
- java - java
@ -71,45 +73,52 @@ options:
version: version:
description: description:
- Version of the framework. For Linux web app supported value, see U(https://aka.ms/linux-stacks) for more info. - Version of the framework. For Linux web app supported value, see U(https://aka.ms/linux-stacks) for more info.
- net_framework supported value sample, 'v4.0' for .NET 4.6 and 'v3.0' for .NET 3.5. - C(net_framework) supported value sample, C(v4.0) for .NET 4.6 and C(v3.0) for .NET 3.5.
- php supported value sample, 5.5, 5.6, 7.0. - C(php) supported value sample, C(5.5), C(5.6), C(7.0).
- python supported value sample, e.g., 5.5, 5.6, 7.0. - C(python) supported value sample, C(5.5), C(5.6), C(7.0).
- node supported value sample, 6.6, 6.9. - C(node) supported value sample, C(6.6), C(6.9).
- dotnetcore supported value sample, 1.0, 1,1, 1.2. - C(dotnetcore) supported value sample, C(1.0), C(1.1), C(1.2).
- ruby supported value sample, 2.3. - C(ruby) supported value sample, C(2.3).
- java supported value sample, 1.8, 1.9 for windows web app. 8 for linux web app. - C(java) supported value sample, C(1.9) for Windows web app. C(1.8) for Linux web app.
settings: settings:
description: description:
- List of settings of the framework. - List of settings of the framework.
suboptions: suboptions:
java_container: java_container:
description: Name of Java container. This is supported by specific framework C(java) only. e.g. Tomcat, Jetty. description:
- Name of Java container.
- Supported only when I(frameworks=java). Sample values C(Tomcat), C(Jetty).
java_container_version: java_container_version:
description: description:
- Version of Java container. This is supported by specific framework C(java) only. - Version of Java container.
- For Tomcat, e.g. 8.0, 8.5, 9.0. For Jetty, e.g. 9.1, 9.3. - Supported only when I(frameworks=java).
- Sample values for C(Tomcat), C(8.0), C(8.5), C(9.0). For C(Jetty,), C(9.1), C(9.3).
container_settings: container_settings:
description: Web app container settings. description:
- Web app container settings.
suboptions: suboptions:
name: name:
description: Name of container. eg. "imagename:tag" description:
- Name of container, for example C(imagename:tag).
registry_server_url: registry_server_url:
description: Container registry server url. eg. mydockerregistry.io description:
- Container registry server URL, for example C(mydockerregistry.io).
registry_server_user: registry_server_user:
description: The container registry server user name. description:
- The container registry server user name.
registry_server_password: registry_server_password:
description: description:
- The container registry server password. - The container registry server password.
scm_type: scm_type:
description: description:
- Repository type of deployment source. Eg. LocalGit, GitHub. - Repository type of deployment source, for example C(LocalGit), C(GitHub).
- Please see U(https://docs.microsoft.com/en-us/rest/api/appservice/webapps/createorupdate#scmtype) for more info. - List of supported values maintained at U(https://docs.microsoft.com/en-us/rest/api/appservice/webapps/createorupdate#scmtype).
deployment_source: deployment_source:
description: description:
- Deployment source for git - Deployment source for git.
suboptions: suboptions:
url: url:
description: description:
@ -121,12 +130,11 @@ options:
startup_file: startup_file:
description: description:
- The web's startup file. - The web's startup file.
- This only applies for linux web app. - Used only for Linux web apps.
client_affinity_enabled: client_affinity_enabled:
description: description:
- "True to enable client affinity; False to stop sending session affinity cookies, which route client requests in the - Whether or not to send session affinity cookies, which route client requests in the same session to the same instance.
same session to the same instance."
type: bool type: bool
default: True default: True
@ -137,12 +145,12 @@ options:
dns_registration: dns_registration:
description: description:
- If true web app hostname is not registered with DNS on creation. - Whether or not the web app hostname is registered with DNS on creation. Set to C(false) to register.
type: bool type: bool
skip_custom_domain_verification: skip_custom_domain_verification:
description: description:
- If true, custom (non *.azurewebsites.net) domains associated with web app are not verified. - Whether or not to skip verification of custom (non *.azurewebsites.net) domains associated with web app. Set to C(true) to skip.
type: bool type: bool
ttl_in_seconds: ttl_in_seconds:
@ -169,20 +177,20 @@ options:
default: started default: started
state: state:
description: description:
- Assert the state of the Web App. - State of the Web App.
- Use C(present) to create or update a Web App and C(absent) to delete it. - Use C(present) to create or update a Web App and C(absent) to delete it.
default: present default: present
choices: choices:
- absent - absent
- present - present
extends_documentation_fragment: extends_documentation_fragment:
- azure - azure
- azure_tags - azure_tags
author: author:
- "Yunge Zhu (@yungezz)" - Yunge Zhu (@yungezz)
''' '''
@ -283,12 +291,11 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
azure_webapp: azure_webapp:
description: Id of current web app. description:
- ID of current web app.
returned: always returned: always
type: dict type: str
sample: { sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/sites/myWebApp"
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/sites/myWebApp"
}
''' '''
import time import time

117
lib/ansible/modules/cloud/azure/azure_rm_webapp_facts.py
Unescape Escape View File

@ -19,7 +19,7 @@ module: azure_rm_webapp_facts
version_added: "2.7" version_added: "2.7"
short_description: Get azure web app facts. short_description: Get Azure web app facts
description: description:
- Get facts for a specific web app or all web app in a resource group, or all web app in current subscription. - Get facts for a specific web app or all web app in a resource group, or all web app in current subscription.
@ -44,7 +44,7 @@ extends_documentation_fragment:
- azure - azure
author: author:
- "Yunge Zhu (@yungezz)" - Yunge Zhu (@yungezz)
''' '''
EXAMPLES = ''' EXAMPLES = '''
@ -66,13 +66,14 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
webapps: webapps:
description: List of web apps. description:
- List of web apps.
returned: always returned: always
type: complex type: complex
contains: contains:
id: id:
description: description:
- Id of the web app. - ID of the web app.
returned: always returned: always
type: str type: str
sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/sites/myWebApp sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/sites/myWebApp
@ -81,6 +82,7 @@ webapps:
- Name of the web app. - Name of the web app.
returned: always returned: always
type: str type: str
sample: winwebapp1
resource_group: resource_group:
description: description:
- Resource group of the web app. - Resource group of the web app.
@ -92,58 +94,131 @@ webapps:
- Location of the web app. - Location of the web app.
returned: always returned: always
type: str type: str
sample: eastus
plan: plan:
description: description:
- Id of app service plan used by the web app. - ID of app service plan used by the web app.
returned: always returned: always
type: str type: str
sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan
app_settings: app_settings:
description: description:
- App settings of the application. Only returned when web app has app settings. - App settings of the application. Only returned when web app has app settings.
type: complex returned: always
type: dict
sample: {
"testkey": "testvalue",
"testkey2": "testvalue2"
}
frameworks: frameworks:
description: description:
- Frameworks of the application. Only returned when web app has frameworks. - Frameworks of the application. Only returned when web app has frameworks.
type: complex returned: always
type: list
sample: [
{
"name": "net_framework",
"version": "v4.0"
},
{
"name": "java",
"settings": {
"java_container": "tomcat",
"java_container_version": "8.5"
},
"version": "1.7"
},
{
"name": "php",
"version": "5.6"
}
]
availability_state: availability_state:
description: Availability of this web app. description:
- Availability of this web app.
returned: always
type: str type: str
sample: Normal
default_host_name: default_host_name:
description: Host name of the web app. description:
- Host name of the web app.
returned: always
type: str type: str
sample: vxxisurg397winapp4.azurewebsites.net
enabled: enabled:
description: Indicates the web app enabled or not. description:
- Indicates the web app enabled or not.
returned: always
type: bool type: bool
sample: true
enabled_host_names: enabled_host_names:
description: Enabled host names of the web app. description:
- Enabled host names of the web app.
returned: always
type: list type: list
sample: [
"vxxisurg397winapp4.azurewebsites.net",
"vxxisurg397winapp4.scm.azurewebsites.net"
]
host_name_ssl_states: host_name_ssl_states:
description: SSL state per host names of the web app. description:
- SSL state per host names of the web app.
returned: always
type: list type: list
sample: [
{
"hostType": "Standard",
"name": "vxxisurg397winapp4.azurewebsites.net",
"sslState": "Disabled"
},
{
"hostType": "Repository",
"name": "vxxisurg397winapp4.scm.azurewebsites.net",
"sslState": "Disabled"
}
]
host_names: host_names:
description: Host names of the web app. description:
- Host names of the web app.
returned: always
type: list type: list
sample: [
"vxxisurg397winapp4.azurewebsites.net"
]
outbound_ip_addresses: outbound_ip_addresses:
description: Outbound ip address of the web app. description:
- Outbound IP address of the web app.
returned: always
type: str type: str
sample: "40.71.11.131,40.85.166.200,168.62.166.67,137.135.126.248,137.135.121.45"
ftp_publish_url: ftp_publish_url:
description: Publishing url of the web app when deployment type is FTP. description:
- Publishing URL of the web app when deployment type is FTP.
returned: always
type: str type: str
sample: ftp://xxxx.ftp.azurewebsites.windows.net sample: ftp://xxxx.ftp.azurewebsites.windows.net
state: state:
description: State of the web app. eg. running. description:
- State of the web app.
returned: always
type: str type: str
sample: running
publishing_username: publishing_username:
description: Publishing profile user name. description:
returned: only when I(return_publish_profile) is True. - Publishing profile user name.
returned: only when I(return_publish_profile=True).
type: str type: str
sample: "$vxxisuRG397winapp4"
publishing_password: publishing_password:
description: Publishing profile password. description:
returned: only when I(return_publish_profile) is True. - Publishing profile password.
returned: only when I(return_publish_profile=True).
type: str type: str
sample: "uvANsPQpGjWJmrFfm4Ssd5rpBSqGhjMk11pMSgW2vCsQtNx9tcgZ0xN26s9A"
tags: tags:
description: Tags assigned to the resource. Dictionary of string:string pairs. description:
- Tags assigned to the resource. Dictionary of string:string pairs.
returned: always
type: dict type: dict
sample: { tag1: abc } sample: { tag1: abc }
''' '''

Write Preview
Loading…
Cancel
Save