modify azure_rm_aks* document (#56293)

This commit is contained in:
Fred-sun 2019-05-13 10:29:10 +08:00 committed by Yunge Zhu
parent c6a8e99d34
commit 35c655c8f5
3 changed files with 24 additions and 16 deletions

View file

@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: azure_rm_aks
version_added: "2.6"
short_description: Manage a managed Azure Container Service (AKS) Instance.
short_description: Manage a managed Azure Container Service (AKS) instance
description:
- Create, update and delete a managed Azure Container Service (AKS) Instance.
- Create, update and delete a managed Azure Container Service (AKS) instance.
options:
resource_group:
@ -47,11 +47,11 @@ options:
- Version of Kubernetes specified when creating the managed cluster.
linux_profile:
description:
- The linux profile suboptions.
- The Linux profile suboptions.
suboptions:
admin_username:
description:
- The Admin Username for the Cluster.
- The Admin Username for the cluster.
required: true
ssh_key:
description:
@ -63,16 +63,16 @@ options:
suboptions:
name:
description:
- Unique name of the agent pool profile in the context of the subscription and resource group.
- Unique name of the agent pool profile in the context of the subscription and resource group.
required: true
count:
description:
- Number of agents (VMs) to host docker containers.
- Allowed values must be in the range of 1 to 100 (inclusive).
- Allowed values must be in the range of C(1) to C(100) (inclusive).
required: true
vm_size:
description:
- The VM Size of each of the Agent Pool VM's (e.g. Standard_F1 / Standard_D2v2).
- The VM Size of each of the Agent Pool VM's (e.g. C(Standard_F1) / C(Standard_D2v2)).
required: true
os_disk_size_gb:
description:
@ -95,7 +95,7 @@ options:
- Existing non-RBAC enabled AKS clusters cannot currently be updated for RBAC use.
type: bool
default: no
version_added: 2.8
version_added: "2.8"
network_profile:
description:
- Profile of network configuration.
@ -107,30 +107,38 @@ options:
- With C(kubenet), nodes get an IP address from the Azure virtual network subnet.
- AKS features such as Virtual Nodes or network policies aren't supported with C(kubenet).
- C(azure) enables Azure Container Networking Interface(CNI), every pod gets an IP address from the subnet and can be accessed directly.
default: kubenet
choices:
- azure
- kubenet
network_policy:
description: Network policy used for building Kubernetes network.
choices:
- azure
- calico
pod_cidr:
description:
- A CIDR notation IP range from which to assign pod IPs when kubenet is used.
- A CIDR notation IP range from which to assign pod IPs when I(network_plugin=kubenet) is used.
- It should be a large address space that isn't in use elsewhere in your network environment.
- This address range must be large enough to accommodate the number of nodes that you expect to scale up to.
default: "10.244.0.0/16"
service_cidr:
description:
- A CIDR notation IP range from which to assign service cluster IPs.
- It must not overlap with any Subnet IP ranges.
- It should be the *.10 address of your service IP address range.
default: "10.0.0.0/16"
dns_service_ip:
description:
- An IP address assigned to the Kubernetes DNS service.
- It must be within the Kubernetes service address range specified in serviceCidr.
default: "10.0.0.10"
docker_bridge_cidr:
description:
- A CIDR notation IP range assigned to the Docker bridge network.
- It must not overlap with any Subnet IP ranges or the Kubernetes service address range.
version_added: 2.8
default: "172.17.0.1/16"
version_added: "2.8"
aad_profile:
description:
- Profile of Azure Active Directory configuration.
@ -145,7 +153,7 @@ options:
description:
- The AAD tenant ID to use for authentication.
- If not specified, will use the tenant of the deployment subscription.
version_added: 2.8
version_added: "2.8"
addon:
description:
- Profile of managed cluster add-on.
@ -188,7 +196,7 @@ options:
subnet_resource_id:
description:
- Subnet associdated to the cluster.
version_added: 2.8
version_added: "2.8"
extends_documentation_fragment:
- azure
@ -228,7 +236,7 @@ EXAMPLES = '''
'''
RETURN = '''
state:
description: Current state of the Azure Container Service (AKS)
description: Current state of the Azure Container Service (AKS).
returned: always
type: dict
example:

View file

@ -18,7 +18,7 @@ module: azure_rm_aks_facts
version_added: "2.6"
short_description: Get Azure Kubernetes Service facts.
short_description: Get Azure Kubernetes Service facts
description:
- Get facts for a specific Azure Kubernetes Service or all Azure Kubernetes Services.
@ -37,7 +37,7 @@ options:
description:
- Show kubeconfig of the AKS cluster.
- Note the operation will cost more network overhead, not recommended when listing AKS.
version_added: 2.8
version_added: "2.8"
choices:
- user
- admin

View file

@ -18,7 +18,7 @@ module: azure_rm_aksversion_facts
version_added: "2.8"
short_description: Get available kubernetes versions supported by Azure Kubernetes Service.
short_description: Get available kubernetes versions supported by Azure Kubernetes Service
description:
- Get available kubernetes versions supported by Azure Kubernetes Service.