From 6ffb8d7565c0541839a2d2d1885ce1ec62ec13d8 Mon Sep 17 00:00:00 2001
From: LRubin <lrubin@docker.com>
Date: Wed, 18 Jan 2017 10:55:33 -0800
Subject: [PATCH] swarm beta docs for limited publish

Signed-off-by: LRubin <lrubin@docker.com>
---
 .../cloud-swarm/images/swarm-toggle.png       | Bin 0 -> 6544 bytes
 docker-cloud/cloud-swarm/index.md             | 163 ++++++++++++++++++
 2 files changed, 163 insertions(+)
 create mode 100644 docker-cloud/cloud-swarm/images/swarm-toggle.png
 create mode 100644 docker-cloud/cloud-swarm/index.md

diff --git a/docker-cloud/cloud-swarm/images/swarm-toggle.png b/docker-cloud/cloud-swarm/images/swarm-toggle.png
new file mode 100644
index 0000000000000000000000000000000000000000..afe2c03e6faa3dd9251f33c30be387d1fd884f92
GIT binary patch
literal 6544
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
Z5h%|L57C0u|MzJDs3~bG*2!DP{0~ikn?e8p

literal 0
HcmV?d00001

diff --git a/docker-cloud/cloud-swarm/index.md b/docker-cloud/cloud-swarm/index.md
new file mode 100644
index 00000000000..cd9b7346f3c
--- /dev/null
+++ b/docker-cloud/cloud-swarm/index.md
@@ -0,0 +1,163 @@
+---
+description: Work with swarms in Docker Cloud
+keywords: swarm mode, swarms, orchestration Cloud, fleet management
+title: Swarms in Docker Cloud
+---
+
+<br>
+
+<b>Note</b>: All Swarm management features in Docker Cloud are free while in Beta.
+{: style="text-align:center" }
+
+--------
+Docker Cloud now allows you to connect to clusters of Docker Engines running in v1.13 [Swarm Mode](/engine/swarm/).
+
+## Enable Swarm Mode in Docker Cloud
+
+By default, Docker Cloud allows you to manage [node clusters](/docker-cloud/infrastructure/), but you can opt in to use the Beta
+Swarm Mode features. Swarm management replaces the node cluster management
+features when the Swarm Mode interface is enabled.
+
+Click the **Swarm Mode** toggle to enable the swarm mode interface.
+
+![the Swarm Mode toggle](images/swarm-toggle.png)
+
+You can switch between node cluster and swarm mode at any time, and enabling swarm mode does _not_ remove or disconnect existing node clusters.
+
+## Swarm mode and organizations
+
+If you use Docker Cloud in an [organization](/docker-cloud/orgs/), you can
+use Swarm Mode to access any Docker swarms available to your organization.
+Members of the `owners` team grant each team in an organization access to the
+swarms they need. If necessary, you can create new teams to manage beta swarm
+access.
+
+If you use swarm mode as a member of a team other than the `owners` team,
+you will only see the swarms that you have been granted access to.
+
+Members of the `owners` team must switch to the Swarm Mode Docker Cloud
+interface to grant teams access to an organization's swarms. Swarms only appear
+in the [resource management](/docker-cloud/orgs/#/set-team-permissions) screens
+for teams when in the swarm mode interface.
+
+## Register an existing swarm
+
+At this time, you cannot _create_ swarms from within Docker Cloud. However you can register existing swarms as part of the beta functionality.
+
+Before you begin, you need the following:
+
+- a Docker ID
+- a Docker swarm composed of v1.13 (or later) Docker Engine nodes
+- a terminal session connected to one of the swarm's manager nodes
+- incoming port 2376 unblocked on that manager node
+
+> **Note**: The IP to the manager node for your swarm must be open and publicly accessible so that Docker Cloud can connect and run commands.
+
+To register an existing swarm in Docker Cloud:
+
+1. Log in to Docker Cloud if necessary.
+2. If necessary, click the **Swarm mode** toggle to activate the Swarm Mode interface.
+3. Click **Swarms** in the top navigation.
+4. Click **Bring your own swarm**
+5. Select the whole command displayed in the dialog, and copy it to your clipboard.
+6. In terminal or another shell, connect to the Docker Engine running in the swarm's manager node using SSH.
+7. Paste the command you copied into the terminal session connected to the manager node.
+8.  When prompted, log in using your Docker ID and password.
+
+    The registration process uses your Docker ID to determine which namespaces you have access to<!--are allowed to register the swarm under TODO:CLOUD-4079 -->. Once you log in, the CLI lists these namespaces to help you with the next step.
+
+9.  Enter a name, with a namespace before the name if needed, and press Enter.
+
+    If you do not enter a name, the swarm is registered to your Docker ID account using the swarm ID, which the long string displayed before the shell prompt. For example, the prompt might look like this:
+
+    ```none
+    Enter a name for the new cluster [mydockerid/5rdshkgzn1sw016zimgckzx3j]:
+    ```
+
+    Enter a name at the prompt to prevent Docker Cloud from registering the swarm using the long swarm ID as the name.
+
+    To register a swarm with an organization, prefix the new name with the organization name, for example `myorganization/myteamswarm`.
+
+The manager node pulls the `dockercloud/registration` container and runs it on the swarm. The swarm then appears in the **Swarms** screen in Docker Cloud.
+
+### Swarm Registration example
+
+```none
+$ docker@swarm-m:~$ docker run -ti --rm -e -v /v
+ar/run/docker.sock:/var/run/docker.sock dockercloud/registration
+SwarmID of the node: 1btbwtge4xwjj0mjpdpr7jutn
+DockerVersion of the node: 1.24
+Use your Docker ID credentials to authenticate:
+Username: myusername
+Password:
+
+Available namespaces:
+* myorganization
+* pacificocean
+* sealife
+Enter name for the new cluster [myusername/1btbwtge4xwjj0mjpdpr7jutn]:myswarm
+Registering this Docker cluster with Docker Cloud...
+Successfully registered the node as myswarm
+You can now access this cluster using the following command in any Docker Engine:
+	docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock -e DOCKER_HOST dockercloud/client myswarm
+```
+
+## Swarm statuses in Docker Cloud
+
+Swarms that are registered in Docker Cloud appear in the Swarms list. Each line in the list shows the swarm's status. The statuses are:
+
+<!-- TODO - **DEPLOYING**: Docker Cloud is provisioning the nodes of this swarm. -->
+- **DEPLOYED**: the swarm is sending heartbeat pings to Docker Cloud, and Cloud can contact it to run a health check.
+- **UNREACHABLE**: the swarm is sending heartbeart pings, but Docker Cloud cannot contact the swarm.
+- **UNAVAILABLE**: Docker Cloud is not receiving any heartbeats from the swarm.
+- **REMOVED**: the swarm has been unregistered from Docker Cloud and will be removed from the list soon.
+
+> **Note**: [Removing a swarm](#unregister-a-swarm-from-Docker-cloud) only makes the swarm unavailable in Docker Cloud. It does not change the swarm itself or any processes running on the swarm.
+
+## Connect to a swarm through Docker Cloud
+
+Docker Cloud allows you to connect your local Docker Engine to any swarm you
+have access to in Docker Cloud. To do this, you run a proxy container in your local Docker instance, which connects to a manager node on the target swarm.
+
+> **Note**: To connect to a swarm, you must first be logged in to Docker using a Docker ID which has access to the swarm. Use the `docker login` command from your terminal to log in.
+
+1. Log in to Docker Cloud in your web browser.
+2. Click **Swarms** in the top navigation, and click the name of the swarm you want to connect to.
+3. Copy the command provided in the dialog that appears.
+4. In a terminal window connected to your local Docker Engine, paste the command, and press **Enter**.
+
+    The local Docker Engine downloads a containerized Docker Cloud client tool, and connects to the swarm.
+
+5. To complete the connection process, run the `export DOCKER_HOST` command found in the previous command's output.
+
+    Be sure to include the client connection port in the URL. For example `export DOCKER_HOST=tcp://swarmID.myusername.docker.cloud:32768`.
+
+    To switch Docker hosts you can either run the `export` command again to overwrite it, or use `unset DOCKER_HOST`.
+
+## Unregister a swarm from Docker Cloud
+
+Unregistering a swarm from Docker Cloud only removes the swarm from Docker
+Cloud, deletes any access rights granted to teams, and disables proxy
+connections. Unregistering does not stop the services, containers, or processes on the swarm, and it does not disband the swarm or terminate the nodes.
+
+To unregister a swarm from Docker Cloud:
+
+1. Log in to Docker Cloud if necessary.
+2. Click **Swarms** in the top navigation.
+3. Put your mouse cursor on the swarm you want to unregister.
+4. Click the trash can icon that appears.
+5. In the confirmation dialog that appears, click **Unregister**.
+
+Docker Cloud marks the swarm as `REMOVED` and removes the swarm from the list in the next few minutes.
+
+## Reconnect a swarm
+
+If you accidentally unregister a swarm from Docker Cloud, or decide that you
+want to re-register the swarm after it has been removed, you can re-register it
+using the same process as a normal registration. If the swarm is registered to
+an organization, its access permissions were deleted when it was unregistered,
+and must be recreated.
+
+> **Note**: You cannot register a new or different swarm under the name of a
+swarm that was unregistered. To re-register a swarm, it must have the same swarm
+ID as it did when previously registered.