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

Add link to Azure roles document

This commit is contained in:
Traci Morrison 2019-10-15 14:52:35 -04:00
parent 27924717da
commit c6432e3995
1 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
cluster/azure.md
View File

@ -12,6 +12,7 @@ title: Get started with Docker Cluster on Azure
- Service Principal App Secret - Service Principal App Secret
- Subscription UUID - Subscription UUID
- Tenant UUID - Tenant UUID
- Organizations wishing to provision roles with explicit permissions should refer to [Azure Roles](https://github.com/docker/cluster/blob/master/docs/azure_role.md) to determine the necessary permissions.
More information can be found on obtaining these with either the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli?view=azure-cli-latest) or through the [Azure Portal](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal). More information can be found on obtaining these with either the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli?view=azure-cli-latest) or through the [Azure Portal](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal).
@ -36,12 +37,12 @@ $ export CLUSTER_SECRETS_FILE=~/.my-secrets/my-azure-creds.sh
$ docker cluster create .... $ docker cluster create ....
``` ```
Docker cluster will bindmount this file into its container runtime to inject the Docker Cluster will bindmount this file into its container runtime to inject the
credential data as needed. credential data as needed.
## Create a cluster ## Create a cluster
When you create a docker cluster in Azure, the cluster created has: When you create a Docker Cluster in Azure, the cluster created has:
- 3 UCP Managers - 3 UCP Managers
- 3 Workers - 3 Workers
- 3 DTR Replicas - 3 DTR Replicas
@ -94,7 +95,7 @@ The values will be substituted in the cluster definition. This makes it
easy to define a reusable cluster definition and then change the variables easy to define a reusable cluster definition and then change the variables
to create multiple instances of a cluster. to create multiple instances of a cluster.
Run `docker cluster create --file cluster.yml --name quickstart` Run `docker cluster create --file cluster.yml --name quickstart`.
$ docker cluster create --file cluster.yml --name quickstart $ docker cluster create --file cluster.yml --name quickstart
Please provide a value for ucp_password: Please provide a value for ucp_password:
@ -134,21 +135,21 @@ After about 15-20 minutes, Docker Enterprise installation will complete:
e58dd2a77567 e58dd2a77567
After all operations complete succesfully, the cluster id will be the last statement After all operations complete successfully, the cluster id will be the last statement
to print. You can log in to the URL and begin interacting with the cluster. to print. You can log in to the URL and begin interacting with the cluster.
## View cluster information ## View cluster information
To see an inventory of the current clusters you've created, run `docker cluster ls` To see an inventory of the current clusters you've created, run `docker cluster ls`.
$ docker cluster ls $ docker cluster ls
ID NAME PROVIDER ENDPOINT STATE ID NAME PROVIDER ENDPOINT STATE
e58dd2a77567 quickstart azurerm https://ucp-e58dd2a77567-y4pl.centralus.cloudapp.azure.com running e58dd2a77567 quickstart azurerm https://ucp-e58dd2a77567-y4pl.centralus.cloudapp.azure.com running
To see detailed information about an individual cluster, run `docker cluster inspect quickstart` To see detailed information about an individual cluster, run `docker cluster inspect quickstart`.
$ docker cluster inspect quickstart
```yaml ```yaml
$ docker cluster inspect quickstart
name: quickstart name: quickstart
shortid: e58dd2a77567 shortid: e58dd2a77567
variable: variable:
@ -216,13 +217,13 @@ The information displayed by `docker cluster inspect` can be used as a cluster d
## Use context ## Use context
Docker cluster creates a context on your local machine. To use this context, and interact with the cluster, run `docker context use quickstart` Docker Cluster creates a context on your local machine. To use this context, and interact with the cluster, run `docker context use quickstart`.
$ docker context use quickstart $ docker context use quickstart
quickstart quickstart
Current context is now "quickstart" Current context is now "quickstart"
To verify that the client is connected to the cluster, run `docker version` To verify that the client is connected to the cluster, run `docker version`.
```bash ```bash
$ docker version $ docker version
@ -300,7 +301,7 @@ resource:
``` ```
Since the cluster is already created, the next step is to `update` the cluster's Since the cluster is already created, the next step is to `update` the cluster's
desired state. Run `docker cluster update quickstart --file cluster.yml` desired state. Run `docker cluster update quickstart --file cluster.yml`.
$ docker cluster update quickstart --file cluster.yml $ docker cluster update quickstart --file cluster.yml
Docker Enterprise Platform 3.0 Docker Enterprise Platform 3.0
@ -308,7 +309,7 @@ desired state. Run `docker cluster update quickstart --file cluster.yml`
Planning cluster on azure [OK] Planning cluster on azure [OK]
Updating: [================== ] 30% Updating: [================== ] 30%
After about 10 minutes the update operation adds the new nodes and joins them to the cluster: After about 10 minutes, the update operation adds the new nodes and joins them to the cluster:
$ docker cluster update quickstart --file examples/docs.yml $ docker cluster update quickstart --file examples/docs.yml
Please provide a value for ucp_password Please provide a value for ucp_password
@ -323,7 +324,7 @@ After about 10 minutes the update operation adds the new nodes and joins them to
e58dd2a77567 e58dd2a77567
A quick `docker cluster inspect e58dd2a77567` will show the worker count increased: Run `docker cluster inspect e58dd2a77567` to view increased worker count.
```yaml ```yaml
... ...
@ -338,7 +339,7 @@ A quick `docker cluster inspect e58dd2a77567` will show the worker count increas
## Backup a cluster ## Backup a cluster
Before we proceed with more operations on the cluster, let's take a backup of the running cluster. To create a full backup of the cluster, run `docker cluster backup quickstart --file "backup-$(date '+%Y-%m-%d').tar.gz" ` Before we proceed with more operations on the cluster, let's take a backup of the running cluster. To create a full backup of the cluster, run `docker cluster backup quickstart --file "backup-$(date '+%Y-%m-%d').tar.gz" `.
Provide a passphrase to encrypt the UCP backup. Provide a passphrase to encrypt the UCP backup.
@ -351,7 +352,7 @@ Provide a passphrase to encrypt the UCP backup.
Save the backups on external storage for disaster recovery. Save the backups on external storage for disaster recovery.
To restore a cluster, run `docker cluster restore quickstart --file backup-2019-05-07.tar.gz` To restore a cluster, run `docker cluster restore quickstart --file backup-2019-05-07.tar.gz`.
Provide the passphrase from the backup step to decrypt the UCP backup. Provide the passphrase from the backup step to decrypt the UCP backup.
@ -369,7 +370,7 @@ cluster:
version: docker/ucp:3.2.0 version: docker/ucp:3.2.0
``` ```
Run `docker cluster update quickstart --file cluster.yml ` Run `docker cluster update quickstart --file cluster.yml `.
$ docker cluster update quickstart --file examples/docs.yml $ docker cluster update quickstart --file examples/docs.yml
Please provide a value for ucp_password Please provide a value for ucp_password
@ -386,7 +387,7 @@ Run `docker cluster update quickstart --file cluster.yml `
## Destroy a cluster ## Destroy a cluster
When the cluster has reached end-of-life, run `docker cluster rm quickstart` When the cluster has reached end-of-life, run `docker cluster rm quickstart`.
$ docker cluster rm quickstart $ docker cluster rm quickstart
Removing quickstart Removing quickstart