docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added the new Azure IP Count install variable (#1296)

This commit is contained in:
Olly P 2019-08-29 12:51:24 +01:00 committed by GitHub
parent d613fb0f6a
commit 03d8135369
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 34 additions and 76 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

109
ee/ucp/admin/install/cloudproviders/install-on-azure.md
View File

@ -205,98 +205,55 @@ for each virtual machine in the virtual machine scale set.
### Adjust the IP Count Value ### Adjust the IP Count Value
If you have manually attached additional IP addresses to the Virtual Machines During a UCP installation, a user can alter the number of Azure IP addresses
(via an ARM Template, Azure CLI or Azure Portal) or you want to reduce the UCP will automatically provision for pods. By default UCP will provision 128
number of IP Addresses automatically provisioned by UCP from the default of 128 addresses, from the same Azure Subnet as the hosts, for each Virtual Machine in
addresses, you can alter the `azure_ip_count` variable in the UCP the cluster. However if you have manually attached additional IP addresses
Configuration file before installation. If you are happy with 128 addresses per to the Virtual Machines (via an ARM Template, Azure CLI or Azure Portal) or you
Virtual Machine, proceed to [installing UCP](#install-ucp). are deploying in to small Azure subnet (less than /16), an `--azure-ip-count`
flag can be used at install time.
Once UCP has been installed, the UCP [configuration > Note: Do not set the `--azure-ip-count` variable to a value of less than 6 if
file](../configure/ucp-configuration-file/) is managed by UCP and populated with > you have not manually provisioned additional IP addresses for each Virtual
all of the cluster configuration data, such as AD/LDAP information or networking > Machine. The UCP installation will need at least 6 IP addresses to allocate
configuration. As there is no Universal Control Plane deployed yet, we are able > to the core UCP components that run as Kubernetes pods. That is in addition
to stage a [configuration file](../configure/ucp-configuration-file/) just > to the Virtual Machine's private IP address.
containing the Azure IP Count value. UCP will populate the rest of the cluster
variables during and after the installation.
Below are some example configuration files with just the `azure_ip_count` Below are some example scenarios which require the `--azure-ip-count` variable
variable defined. These 3-line files can be preloaded into a Docker Swarm prior to be defined.
to installing UCP in order to override the default `azure_ip_count` value of 128 IP
addresses per node. See [UCP configuration file](../configure/ucp-configuration-file/)
to learn more about the configuration file, and other variables that can be staged pre-install.
> Note: Do not set the `azure_ip_count` to a value of less than 6 if you have not **Scenario 1 - Manually Provisioned Addresses**
> manually provisioned additional IP addresses for each Virtual Machine. The UCP
> installation will need at least 6 IP addresses to allocate to the core UCP components
> that run as Kubernetes pods. That is in addition to the Virtual
> Machine's private IP address.
If you have manually provisioned additional IP addresses for each Virtual If you have manually provisioned additional IP addresses for each Virtual
Machine, and want to disallow UCP from dynamically provisioning IP Machine, and want to disable UCP from dynamically provisioning more IP
addresses for you, then your UCP configuration file would be: addresses for you, then you would pass `--azure-ip-count 0` into the UCP
installation command.
```bash **Scenario 2 - Reducing the number of Provisioned Addresses**
$ vi example-config-1
[cluster_config]
azure_ip_count = "0"
```
If you want to reduce the IP addresses dynamically allocated from 128 to a If you want to reduce the number of IP addresses dynamically allocated from 128
custom value, then your UCP configuration file would be: addresses to a custom value due to:
```bash - Primarily using the Swarm Orchestrator
$ vi example-config-2 - Deploying UCP on a small Azure subnet (for example /24)
[cluster_config] - Plan to run a small number of Kubernetes pods on each node.
azure_ip_count = "20" # This value may be different for your environment
```
See [Considerations for IPAM For example if you wanted to provision 16 addresses per virtual machine, then
Configuration](#considerations-for-ipam-configuration) to calculate an you would pass `--azure-ip-count 16` into the UCP installation command.
appropriate value.
To preload this configuration file prior to installing UCP: If you need to adjust this value post-installation, see
[instructions](../configure/ucp-configuration-file/) on how to download the UCP
1. Copy the configuration file to a Virtual Machine that you wish to become a UCP Manager Node. configuration file, change the value, and update the configuration via the API.
If you reduce the value post-installation, existing virtual machines will not
2. Initiate a Swarm on that Virtual Machine. be reconciled, and you will have to manually edit the IP count in Azure.
```bash
$ docker swarm init
```
3. Upload the configuration file to the Swarm, by using a [Docker Swarm Config](/engine/swarm/configs/).
This Swarm Config will need to be named `com.docker.ucp.config`.
```bash
$ docker config create com.docker.ucp.config <local-configuration-file>
```
4. Check that the configuration has been loaded succesfully.
```bash
$ docker config list
ID NAME CREATED UPDATED
igca3q30jz9u3e6ecq1ckyofz com.docker.ucp.config 1 days ago 1 days ago
```
5. You are now ready to [install UCP](#install-ucp). As you have already staged
a UCP configuration file, you will need to add `--existing-config` to the
install command below.
If you need to adjust this value post-installation, see [instructions](../configure/ucp-configuration-file/)
on how to download the UCP configuration file, change the value, and update the configuration via the API.
If you reduce the value post-installation, existing virtual machines will not be
reconciled, and you will have to manually edit the IP count in Azure.
### Install UCP ### Install UCP
Run the following command to install UCP on a manager node. The `--pod-cidr` Run the following command to install UCP on a manager node. The `--pod-cidr`
option maps to the IP address range that you have configured for the Azure option maps to the IP address range that you have configured for the Azure
subnet, and the `--host-address` maps to the private IP address of the master subnet, and the `--host-address` maps to the private IP address of the master
node. Finally if you have set the [Ip Count node. Finally if you want to adjust the amount of IP addresses provisioned to
Value](#adjusting-the-ip-count-value) you will need to add `--existing-config` each virtual machine pass `--azure-ip-count`.
to the install command below.
> Note: The `pod-cidr` range must match the Azure Virtual Network's Subnet > Note: The `pod-cidr` range must match the Azure Virtual Network's Subnet
> attached the hosts. For example, if the Azure Virtual Network had the range > attached the hosts. For example, if the Azure Virtual Network had the range

1
reference/ucp/3.2/cli/install.md
View File

@ -49,6 +49,7 @@ If you are installing on Azure, see [Install UCP on Azure](/ee/ucp/admin/install
| `--interactive, -i` | Run in interactive mode and prompt for configuration values | | `--interactive, -i` | Run in interactive mode and prompt for configuration values |
| `--admin-password` *value* | The UCP administrator password [$UCP_ADMIN_PASSWORD] | | `--admin-password` *value* | The UCP administrator password [$UCP_ADMIN_PASSWORD] |
| `--admin-username` *value* | The UCP administrator username [$UCP_ADMIN_USER] | | `--admin-username` *value* | The UCP administrator username [$UCP_ADMIN_USER] |
| `--azure-ip-count` *value* | Configure the Number of IP Address to be provisioned for each Azure Virtual Machine (default: "128") |
| `--binpack` | Set the Docker Swarm scheduler to binpack mode. Used for backwards compatibility | | `--binpack` | Set the Docker Swarm scheduler to binpack mode. Used for backwards compatibility |
| `--cloud-provider` *value* | The cloud provider for the cluster | | `--cloud-provider` *value* | The cloud provider for the cluster |
| `--cni-installer-url` *value* | A URL pointing to a kubernetes YAML file to be used as an installer for the CNI plugin of the cluster. If specified, the default CNI plugin will not be installed. If the URL is using the HTTPS scheme, no certificate verification will be performed | | `--cni-installer-url` *value* | A URL pointing to a kubernetes YAML file to be used as an installer for the CNI plugin of the cluster. If specified, the default CNI plugin will not be installed. If the URL is using the HTTPS scheme, no certificate verification will be performed |