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

Port UCP install topics to template (#386) 

* Start porting UCP install topics to template

* Port install topics to template
This commit is contained in:
Jim Galasyn 2018-01-03 09:02:52 -08:00
parent 17be7d18ed
commit 043be2dcd2
8 changed files with 127 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
datacenter/ucp/3.0/guides/admin/install/architecture-specific-images.md
View File

@ -1,8 +1,17 @@
---
title: Architecture-specific images
description: Learn how to use images that are specific to particular hardware architectures in Docker Universal Control Plane.
description: Learn how to deploy Docker Universal Control Plane using images that are specific to particular hardware architectures.
keywords: UCP, Docker EE, image, IBM z, Windows
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: ../configure/join-nodes/
title: Join nodes to your cluster
---
{% if include.version=="ucp-3.0" %}
Docker Universal Control Plane deploys images for a number of different
hardware architectures, including IBM z systems. Some architectures require
@ -41,3 +50,9 @@ following table to ensure that you're pulling the right images for each node.
|-------------------------|----------------|--------------------|
| ucp-agent | ucp-agent-win | ucp-agent-s390x |
| ucp-dsinfo | ucp-dsinfo-win | ucp-dsinfo-s390x |
{% elsif include.version=="ucp-2.2" %}
Learn about [architecture-specific images](/datacenter/ucp/2.2/guides/admin/install/architecture-specific-images.md).
{% endif %}

25
datacenter/ucp/3.0/guides/admin/install/index.md
View File

@ -2,7 +2,18 @@
title: Install UCP for production
description: Learn how to install Docker Universal Control Plane on production.
keywords: Universal Control Plane, UCP, install, Docker EE
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: ../configure/use-your-own-tls-certificates/
title: Use your own TLS certificates
- path: ../configure/join-nodes/
title: Join nodes to your cluster
---
{% if include.version=="ucp-3.0" %}
Docker Universal Control Plane (UCP) is a containerized application that you
can install on-premise or on a cloud infrastructure.
@ -38,7 +49,7 @@ Docker UCP uses named volumes to persist data. If you want
to customize the drivers used to manage these volumes, you can create the
volumes before installing UCP. When you install UCP, the installer
will notice that the volumes already exist, and will start using them.
[Learn about the named volumes used by UCP](../../architecture.md).
[Learn about the named volumes used by UCP](../../ucp-architecture.md).
If these volumes don't exist, they'll be automatically created when installing
UCP.
@ -59,10 +70,10 @@ To install UCP:
```none
# Pull the latest version of UCP
$ docker image pull {{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }}
docker image pull {{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }}
# Install UCP
$ docker container run --rm -it --name ucp \
docker container run --rm -it --name ucp \
-v /var/run/docker.sock:/var/run/docker.sock \
{{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }} install \
--host-address <node-ip-address> \
@ -141,7 +152,9 @@ To add more computational resources to your swarm, you can join worker nodes.
These nodes execute tasks assigned to them by the manager nodes. Follow the
same steps as before, but don't check the **Add node as a manager** option.
## Where to go next
{% elsif include.version=="ucp-2.2" %}
Learn about [installing UCP for production](/datacenter/ucp/2.2/guides/admin/install/index.md).
{% endif %}
* [Use your own TLS certificates](../configure/use-your-own-tls-certificates.md)
* [Join nodes to your cluster](../configure/join-nodes/index.md)

19
datacenter/ucp/3.0/guides/admin/install/install-offline.md
View File

@ -3,7 +3,18 @@ title: Install UCP offline
description: Learn how to install Docker Universal Control Plane. on a machine with
no internet access.
keywords: UCP, install, offline, Docker EE
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: index/
title: Install UCP
- path: system-requirements/
title: System requirements
---
{% if include.version=="ucp-3.0" %}
The procedure to install Docker Universal Control Plane on a host is the same,
whether the host has access to the internet or not.
@ -67,8 +78,10 @@ Follow the same steps for the DTR binaries.
Now that the offline hosts have all the images needed to install UCP,
you can [install Docker UCP on one of the manager nodes](index.md).
{% elsif include.version=="ucp-2.2" %}
Learn about [installing UCP offline](/datacenter/ucp/2.2/guides/admin/install/install-offline.md).
{% endif %}
## Where to go next
* [Install UCP](index.md).
* [System requirements](system-requirements.md)

18
datacenter/ucp/3.0/guides/admin/install/plan-installation.md
View File

@ -2,7 +2,18 @@
title: Plan a production UCP installation
description: Learn about the Docker Universal Control Plane architecture, and the requirements to install it on production.
keywords: UCP, install, Docker EE
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: index/
title: Install UCP
- path: system-requirements/
title: UCP System requirements
---
{% if include.version=="ucp-3.0" %}
Docker Universal Control Plane helps you manage your container cluster from a
centralized place. This article explains what you need to consider before
@ -100,7 +111,8 @@ for all managers, rather than one for each manager node. In this case,
the certificate files are copied automatically to any new
manager nodes joining the cluster or being promoted to a manager role.
## Where to go next
{% elsif include.version=="ucp-2.2" %}
* [UCP system requirements](system-requirements.md)
* [Install UCP](index.md)
Learn about [planning your UCP installation](/datacenter/ucp/2.2/guides/admin/install/plan-installation.md).
{% endif %}

21
datacenter/ucp/3.0/guides/admin/install/system-requirements.md
View File

@ -2,10 +2,22 @@
title: UCP System requirements
description: Learn about the system requirements for installing Docker Universal Control Plane.
keywords: UCP, architecture, requirements, Docker EE
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: plan-installation/
title: Plan your installation
- path: ../../ucp-architecture/
title: UCP architecture
redirect_from:
- /enterprise/admin/install/system-requirements/
---
{% if include.version=="ucp-3.0" %}
Docker Universal Control Plane can be installed on-premises or on the cloud.
Before installing, be sure your infrastructure has these requirements.
@ -117,7 +129,10 @@ UCP {{ page.ucp_version }} requires minimum versions of the following Docker com
- Docker EE Engine 17.06 or higher
- DTR 2.5 or higher
## Where to go next
{% elsif include.version=="ucp-2.2" %}
[UCP System requirements](/datacenter/ucp/2.2/guides/admin/install/system-requirements.md).
{% endif %}
* [UCP architecture](/datacenter/ucp/3.0/guides/ucp-architecture.md)
* [Plan your installation](/datacenter/ucp/3.0/guides/admin/install/plan-installation.md)

17
datacenter/ucp/3.0/guides/admin/install/uninstall.md
View File

@ -2,7 +2,16 @@
title: Uninstall UCP
description: Learn how to uninstall a Docker Universal Control Plane swarm.
keywords: UCP, uninstall, install, Docker EE
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: ../configure/join-nodes/
title: Join nodes to your cluster
---
{% if include.version=="ucp-3.0" %}
Docker UCP is designed to scale as your applications grow in size and usage.
You can [add and remove nodes](../configure/scale-your-cluster.md) from the
@ -26,7 +35,7 @@ To uninstall UCP, log in to a manager node using ssh, and run the following
command:
```bash
$ docker container run --rm -it \
docker container run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock \
--name ucp \
{{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }} uninstall-ucp --interactive
@ -49,6 +58,8 @@ in the swarm won't be able to communicate at all. To fix this, either reinstall
UCP before the certificates expire or disable swarm mode by running
`docker swarm leave --force` on every node.
## Where to go next
{% elsif include.version=="ucp-2.2" %}
* [Join nodes to your cluster](../configure/join-nodes/index.md)
Learn about [uninstalling UCP](/datacenter/ucp/2.2/guides/admin/install/uninstall.md).
{% endif %}

17
datacenter/ucp/3.0/guides/admin/install/upgrade-offline.md
View File

@ -2,7 +2,18 @@
title: Upgrade UCP offline
description: Learn how to upgrade Docker Universal Control Plane on a machine with no internet access.
keywords: ucp, upgrade, offline
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: upgrade/
title: Upgrade UCP
- path: ../../release-notes/
title: Release Notes
---
{% if include.version=="ucp-3.0" %}
Upgrading Universal Control Plane is the same, whether your hosts have access to
the internet or not.
@ -55,8 +66,8 @@ For each machine that you want to manage with UCP:
Now that the offline hosts have all the images needed to upgrade UCP,
you can [upgrade Docker UCP](upgrade.md).
{% elsif include.version=="ucp-2.2" %}
## Where to go next
Learn about [upgrading UCP offline](/datacenter/ucp/2.2/guides/admin/install/upgrade-offline.md).
* [Upgrade UCP](upgrade.md)
* [Release Notes](release-notes.md)
{% endif %}

19
datacenter/ucp/3.0/guides/admin/install/upgrade.md
View File

@ -2,7 +2,16 @@
title: Upgrade to UCP 3.0
description: Learn how to upgrade Docker Universal Control Plane with minimal impact to your users.
keywords: UCP, upgrade, update
ui_tabs:
- version: ucp-3.0
orhigher: true
- version: ucp-2.2
orlower: true
next_steps:
- path: ../../release-notes/
title: UCP release notes
---
{% if include.version=="ucp-3.0" %}
This page guides you in upgrading Docker Universal Control Plane (UCP) to
version {{ page.ucp_version }}.
@ -86,9 +95,9 @@ To upgrade from the CLI, log into a UCP manager node using ssh, and run:
```
# Get the latest version of UCP
$ docker image pull {{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }}
docker image pull {{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }}
$ docker container run --rm -it \
docker container run --rm -it \
--name ucp \
-v /var/run/docker.sock:/var/run/docker.sock \
{{ page.ucp_org }}/{{ page.ucp_repo }}:{{ page.ucp_version }} \
@ -101,6 +110,8 @@ for any necessary configuration values.
Once the upgrade finishes, navigate to the UCP web UI and make sure that
all the nodes managed by UCP are healthy.
## Where to go next
{% elsif include.version=="ucp-2.2" %}
* [UCP release notes](../../release-notes/index.md)
Learn about [upgrading UCP](/datacenter/ucp/2.2/guides/admin/install/upgrade.md).
{% endif %}