This is an automated email from the ASF dual-hosted git repository.
hjf pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new c7ead15 [Issue 5401][docs] Add deploy-docker doc (#7769)
c7ead15 is described below
commit c7ead1589fa1c327a2e03beeb57ba4fe78f026c5
Author: sijia-w <53718687+siji...@users.noreply.github.com>
AuthorDate: Mon Aug 10 13:20:27 2020 +0200
[Issue 5401][docs] Add deploy-docker doc (#7769)
* add deploy-docker doc
* Update deploy-docker.md
* Update site2/docs/deploy-docker.md
Co-authored-by: Jennifer Huang
<47805623+jennifer88hu...@users.noreply.github.com>
Co-authored-by: Jennifer Huang
<47805623+jennifer88hu...@users.noreply.github.com>
---
site2/docs/deploy-docker.md | 51 +++++++++++++++++++++++++++++++++++++++++++++
site2/website/sidebars.json | 1 +
2 files changed, 52 insertions(+)
diff --git a/site2/docs/deploy-docker.md b/site2/docs/deploy-docker.md
new file mode 100644
index 0000000..3d29035
--- /dev/null
+++ b/site2/docs/deploy-docker.md
@@ -0,0 +1,51 @@
+---
+id: deploy-docker
+title: Deploy a cluster on Docker
+sidebar_label: Docker
+---
+
+To deploy a Pulsar cluster on Docker, complete the following steps:
+1. Deploy a ZooKeeper cluster (optional)
+2. Initialize cluster metadata
+3. Deploy a BookKeeper cluster
+4. Deploy one or more Pulsar brokers
+
+## Prepare
+
+To run Pulsar on Docker, you need to create a container for each Pulsar
component: ZooKeeper, BookKeeper and broker. You can pull the images of
ZooKeeper and BookKeeper separately on [Docker Hub](https://hub.docker.com/),
and pull a [Pulsar
image](https://hub.docker.com/r/apachepulsar/pulsar-all/tags) for the broker.
You can also pull only one [Pulsar
image](https://hub.docker.com/r/apachepulsar/pulsar-all/tags) and create three
containers with this image. This tutorial takes the second [...]
+
+### Pull a Pulsar image
+You can pull a Pulsar image from [Docker
Hub](https://hub.docker.com/r/apachepulsar/pulsar-all/tags) with the following
command.
+
+```
+docker run -it apachepulsar/pulsar-all:latest
+```
+
+### Create three containers
+Create containers for ZooKeeper, BookKeeper and broker. In this example, they
are named as `zookeeper`, `bookkeeper` and `broker` respectively. You can name
them as you want with the `--name` flag. By default, the container names are
created randomly.
+
+```
+docker run -it --name bookkeeper apachepulsar/pulsar-all:latest /bin/bash
+docker run -it --name zookeeper apachepulsar/pulsar-all:latest /bin/bash
+docker run -it --name broker apachepulsar/pulsar-all:latest /bin/bash
+```
+
+### Create a network
+To deploy a Pulsar cluster on Docker, you need to create a `network` and
connect the containers of ZooKeeper, BookKeeper and broker to this network. The
following command creates the network `pulsar`:
+
+```
+docker network create pulsar
+```
+
+### Connect containers to network
+Connect the containers of ZooKeeper, BookKeeper and broker to the `pulsar`
network with the following commands.
+
+```
+docker network connect pulsar zookeeper
+docker network connect pulsar bookkeeper
+docker network connect pulsar broker
+```
+
+To check whether the containers are successfully connected to the network,
enter the `docker network inspect pulsar` command.
+
+For detailed information about how to deploy ZooKeeper cluster, BookKeeper
cluster, brokers, see [deploy a cluster on bare metal](deploy-bare-metal.md).
diff --git a/site2/website/sidebars.json b/site2/website/sidebars.json
index 50aa36d..a415741 100644
--- a/site2/website/sidebars.json
+++ b/site2/website/sidebars.json
@@ -70,6 +70,7 @@
"deploy-bare-metal",
"deploy-bare-metal-multi-cluster",
"deploy-dcos",
+ "deploy-docker",
"deploy-monitoring"
],
"Administration": [
