|
|
@@ -1,6 +1,10 @@
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-
|
|
|
+- [`latest`, `enterprise`, `3.0.3`, `enterprise-3.0.3` (*enterprise/couchbase-server/3.0.3/Dockerfile*)](https://github.com/couchbase/docker/blob/695e9dbe4f8928ec4b66a83568d3d583c8215b1e/enterprise/couchbase-server/3.0.3/Dockerfile)
|
|
|
+- [`3.0.2`, `enterprise-3.0.2` (*enterprise/couchbase-server/3.0.2/Dockerfile*)](https://github.com/couchbase/docker/blob/695e9dbe4f8928ec4b66a83568d3d583c8215b1e/enterprise/couchbase-server/3.0.2/Dockerfile)
|
|
|
+- [`community`, `community-3.0.1` (*community/couchbase-server/3.0.1/Dockerfile*)](https://github.com/couchbase/docker/blob/695e9dbe4f8928ec4b66a83568d3d583c8215b1e/community/couchbase-server/3.0.1/Dockerfile)
|
|
|
+- [`2.5.2`, `enterprise-2.5.2` (*enterprise/couchbase-server/2.5.2/Dockerfile*)](https://github.com/couchbase/docker/blob/695e9dbe4f8928ec4b66a83568d3d583c8215b1e/enterprise/couchbase-server/2.5.2/Dockerfile)
|
|
|
+- [`community-2.2.0` (*community/couchbase-server/2.2.0/Dockerfile*)](https://github.com/couchbase/docker/blob/695e9dbe4f8928ec4b66a83568d3d583c8215b1e/community/couchbase-server/2.2.0/Dockerfile)
|
|
|
|
|
|
For more information about this image and its history, please see the [relevant manifest file (`library/couchbase`)](https://github.com/docker-library/official-images/blob/master/library/couchbase) in the [`docker-library/official-images` GitHub repo](https://github.com/docker-library/official-images).
|
|
|
|
|
|
@@ -16,56 +20,51 @@ For support, please visit the [Couchbase support forum](https://forums.couchbase
|
|
|
|
|
|
# How to use this image: QuickStart
|
|
|
|
|
|
-```
|
|
|
-docker run -d -p 8091:8091 couchbase/server
|
|
|
-```
|
|
|
+ docker run -d -p 8091:8091 couchbase
|
|
|
|
|
|
-At this point go to http://localhost:8091 from the host machine to see the Admin Console web UI. More details and screenshots are given below in the **Single host, single container** section.
|
|
|
+At this point go to http://localhost:8091 from the host machine to see the Admin Console web UI. More details and screenshots are given below in the **Single host, single container** section.
|
|
|
|
|
|
# Background Information
|
|
|
|
|
|
## Networking
|
|
|
|
|
|
-Couchbase Server communicates on a number of different ports (see the [Couchbase Server documentation](http://docs.couchbase.com/admin/admin/Install/install-networkPorts.html "Network ports page on Couchbase Server documentation")). It also is not generally supported for nodes in a cluster to be behind any kind of NAT. For these reasons, Docker's default networking configuration is not ideally suited to Couchbase Server deployments.
|
|
|
+Couchbase Server communicates on a number of different ports (see the [Couchbase Server documentation](http://docs.couchbase.com/admin/admin/Install/install-networkPorts.html)). It also is not generally supported for nodes in a cluster to be behind any kind of NAT. For these reasons, Docker's default networking configuration is not ideally suited to Couchbase Server deployments.
|
|
|
|
|
|
There are several deployment scenarios which this Docker image can easily support. These will be detailed below, along with recommended network arrangements for each.
|
|
|
|
|
|
## Volumes
|
|
|
|
|
|
-A Couchbase Server Docker container will write all persistent and node-specific data under the directory `/opt/couchbase/var`. We recommend mapping this directory to a directory on the host filesystem (using the `-v` option to `docker run`) for the following reasons:
|
|
|
+A Couchbase Server Docker container will write all persistent and node-specific data under the directory `/opt/couchbase/var`. As this directory is declared to be a Docker volume, it will be persisted outside the normal union filesystem. This results in improved performance. It also allows you to easily migrate to a container running an updated point release of Couchbase Server without losing your data with a process like this:
|
|
|
+
|
|
|
+ docker stop my-couchbase-container
|
|
|
+ docker run -d --name my-new-couchbase-container --volumes-from my-couchbase-container ....
|
|
|
+ docker rm my-couchbase-container
|
|
|
|
|
|
-* **Persistence** Storing `/opt/couchbase/var` outside the container allows you to delete the container and re-create it later. You can even update to a container running a later point release of Couchbase Server without losing your data.
|
|
|
-* **Performance** In a standard Docker environment using a union filesystem, leaving `/opt/couchbase/var` "inside" the container will result in some amount of performance degradation.
|
|
|
+By default, the persisted location of the volume on your Docker host will be hidden away in a location managed by the Docker daemon. In order to control its location - in particular, to ensure that it is on a partition with sufficient disk space for your server - we recommend mapping the volume to a specific directory on the host filesystem using the `-v` option to `docker run`.
|
|
|
|
|
|
All of the example commands below will assume you are using volumes mapped to host directories.
|
|
|
|
|
|
*SELinux workaround*
|
|
|
|
|
|
-If you have SELinux enabled, mounting host volumes in a container requires an extra step. Assuming you are mounting the `~/couchbase` directory on the host filesystem, you will need to run the following command once before running your first container on that host:
|
|
|
+If you have SELinux enabled, mounting host volumes in a container requires an extra step. Assuming you are mounting the `~/couchbase` directory on the host filesystem, you will need to run the following command once before running your first container on that host:
|
|
|
|
|
|
-```
|
|
|
-mkdir ~/couchbase && chcon -Rt svirt_sandbox_file_t ~/couchbase
|
|
|
-```
|
|
|
+ mkdir ~/couchbase && chcon -Rt svirt_sandbox_file_t ~/couchbase
|
|
|
|
|
|
## Ulimits
|
|
|
|
|
|
Couchbase normally expects the following changes to ulimits:
|
|
|
|
|
|
-```
|
|
|
-ulimit -n 40960 # nofile: max number of open files
|
|
|
-ulimit -c unlimited # core: max core file size
|
|
|
-ulimit -l unlimited # memlock: maximum locked-in-memory address space
|
|
|
-```
|
|
|
+ ulimit -n 40960 # nofile: max number of open files
|
|
|
+ ulimit -c unlimited # core: max core file size
|
|
|
+ ulimit -l unlimited # memlock: maximum locked-in-memory address space
|
|
|
|
|
|
-These ulimit settings are necessary when running under heavy load; but if you are just doing light testing and development, you can omit these settings and everything will still work.
|
|
|
+These ulimit settings are necessary when running under heavy load; but if you are just doing light testing and development, you can omit these settings and everything will still work.
|
|
|
|
|
|
In order to set the ulimits in your container, you will need to run Couchbase Docker containers with the following additional `--ulimit` flags:
|
|
|
|
|
|
-```
|
|
|
-docker run -d --ulimit nofile=40960:40960 --ulimit core=100000000:100000000 --ulimit memlock=100000000:100000000 couchbase/server
|
|
|
-```
|
|
|
+ docker run -d --ulimit nofile=40960:40960 --ulimit core=100000000:100000000 --ulimit memlock=100000000:100000000 couchbase
|
|
|
|
|
|
-Since `unlimited` is not supported as a value, it sets the core and memlock values to 100 GB. If your system has more than 100 GB RAM, you will want to increase this value to match the available RAM on the system.
|
|
|
+Since `unlimited` is not supported as a value, it sets the core and memlock values to 100 GB. If your system has more than 100 GB RAM, you will want to increase this value to match the available RAM on the system.
|
|
|
|
|
|
NOTE: the `--ulimit` flags only work on Docker 1.6 or later.
|
|
|
|
|
|
@@ -73,36 +72,32 @@ NOTE: the `--ulimit` flags only work on Docker 1.6 or later.
|
|
|
|
|
|
## Single host, single container
|
|
|
|
|
|
-```
|
|
|
-┌───────────────────────┐
|
|
|
-│ Host OS (Linux) │
|
|
|
-│ ┌─────────────────┐ │
|
|
|
-│ │ Container OS │ │
|
|
|
-│ │ (CentOS) │ │
|
|
|
-│ │ ┌───────────┐ │ │
|
|
|
-│ │ │ Couchbase │ │ │
|
|
|
-│ │ │ Server │ │ │
|
|
|
-│ │ └───────────┘ │ │
|
|
|
-│ └─────────────────┘ │
|
|
|
-└───────────────────────┘
|
|
|
-```
|
|
|
+ ┌───────────────────────┐
|
|
|
+ │ Host OS (Linux) │
|
|
|
+ │ ┌─────────────────┐ │
|
|
|
+ │ │ Container OS │ │
|
|
|
+ │ │ (CentOS) │ │
|
|
|
+ │ │ ┌───────────┐ │ │
|
|
|
+ │ │ │ Couchbase │ │ │
|
|
|
+ │ │ │ Server │ │ │
|
|
|
+ │ │ └───────────┘ │ │
|
|
|
+ │ └─────────────────┘ │
|
|
|
+ └───────────────────────┘
|
|
|
|
|
|
This is a quick way to try out Couchbase Server on your own machine with no installation overhead - just *download and run*. In this case, any networking configuration will work; the only real requirement is that port 8091 be exposed so that you can access the Couchbase Admin Console.
|
|
|
|
|
|
**Start the container**
|
|
|
|
|
|
-```
|
|
|
-docker run -d -v ~/couchbase:/opt/couchbase/var -p 8091:8091 couchbase/server
|
|
|
-```
|
|
|
+ docker run -d -v ~/couchbase:/opt/couchbase/var -p 8091:8091 --name my-couchbase-server couchbase
|
|
|
+
|
|
|
+We use the --name option to make it easier to refer to this running container in future.
|
|
|
|
|
|
**Verify container start**
|
|
|
|
|
|
-The `docker run` command above will return a container id, eg, `1163fd8df`. Use the container id to view the logs:
|
|
|
+Use the container name you specified (eg. `my-couchbase-server`) to view the logs:
|
|
|
|
|
|
-```
|
|
|
-$ docker logs 1163fd8df
|
|
|
-Starting Couchbase Server -- Web UI available at http://<ip>:8091
|
|
|
-```
|
|
|
+ $ docker logs my-couchbase-server
|
|
|
+ Starting Couchbase Server -- Web UI available at http://<ip>:8091
|
|
|
|
|
|
**Connect to the Admin Console**
|
|
|
|
|
|
@@ -112,9 +107,9 @@ From the host, connect your browser to http://localhost:8091, and you should see
|
|
|
|
|
|
**Configure**
|
|
|
|
|
|
-* Click "Setup" button
|
|
|
+- Click "Setup" button
|
|
|
|
|
|
-* For all Setup Wizard screens, leave all values as default and click "Next"
|
|
|
+- For all Setup Wizard screens, leave all values as default and click "Next"
|
|
|
|
|
|
After finishing the Setup Wizard, you should see:
|
|
|
|
|
|
@@ -126,79 +121,71 @@ At this point, you are ready to connect to your Couchbase Server node from one o
|
|
|
|
|
|
You should run the SDK on the host and point it to `http://localhost:8091/pools`
|
|
|
|
|
|
-
|
|
|
## Single host, multiple containers
|
|
|
|
|
|
-```
|
|
|
-┌──────────────────────────────────────────────────────────┐
|
|
|
-│ Host OS (Linux) │
|
|
|
-│ │
|
|
|
-│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
|
|
|
-│ │ Container OS │ │ Container OS │ │ Container OS │ │
|
|
|
-│ │ (CentOS) │ │ (CentOS) │ │ (CentOS) │ │
|
|
|
-│ │ ┌───────────┐ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │
|
|
|
-│ │ │ Couchbase │ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │
|
|
|
-│ │ │ Server │ │ │ │ Server │ │ │ │ Server │ │ │
|
|
|
-│ │ └───────────┘ │ │ └───────────┘ │ │ └───────────┘ │ │
|
|
|
-│ └───────────────┘ └───────────────┘ └───────────────┘ │
|
|
|
-└──────────────────────────────────────────────────────────┘
|
|
|
-```
|
|
|
-
|
|
|
-* Useful for testing out a multi-node cluster on your local workstation.
|
|
|
-* Not recommended for production use. (the norm for a production cluster is that each node runs on dedicated hardware)
|
|
|
-* Allows you to experiment with cluster rebalancing and failover.
|
|
|
-* The networking is effectively the same as described the Software-Defined Network section: each container is given an internal IP address by Docker, and each of these IPs is visible to all other containers running on the same host
|
|
|
-* Internal IPs should be used in the Admin Console when adding new nodes to the cluster
|
|
|
-* For external access to the admin console, you should expose port 8091 of exactly one of the containers when you start it.
|
|
|
+ ┌──────────────────────────────────────────────────────────┐
|
|
|
+ │ Host OS (Linux) │
|
|
|
+ │ │
|
|
|
+ │ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
|
|
|
+ │ │ Container OS │ │ Container OS │ │ Container OS │ │
|
|
|
+ │ │ (CentOS) │ │ (CentOS) │ │ (CentOS) │ │
|
|
|
+ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │
|
|
|
+ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │
|
|
|
+ │ │ │ Server │ │ │ │ Server │ │ │ │ Server │ │ │
|
|
|
+ │ │ └───────────┘ │ │ └───────────┘ │ │ └───────────┘ │ │
|
|
|
+ │ └───────────────┘ └───────────────┘ └───────────────┘ │
|
|
|
+ └──────────────────────────────────────────────────────────┘
|
|
|
+
|
|
|
+- Useful for testing out a multi-node cluster on your local workstation.
|
|
|
+- Not recommended for production use. (the norm for a production cluster is that each node runs on dedicated hardware)
|
|
|
+- Allows you to experiment with cluster rebalancing and failover.
|
|
|
+- The networking is effectively the same as described the Software-Defined Network section: each container is given an internal IP address by Docker, and each of these IPs is visible to all other containers running on the same host
|
|
|
+- Internal IPs should be used in the Admin Console when adding new nodes to the cluster
|
|
|
+- For external access to the admin console, you should expose port 8091 of exactly one of the containers when you start it.
|
|
|
|
|
|
You can choose to mount `/opt/couchbase/var` from the host, however you *must give each container a separate host directory*.
|
|
|
|
|
|
-```
|
|
|
-docker run -d -v ~/couchbase/node1:/opt/couchbase/var couchbase/server
|
|
|
-docker run -d -v ~/couchbase/node2:/opt/couchbase/var couchbase/server
|
|
|
-docker run -d -v ~/couchbase/node3:/opt/couchbase/var -p 8091:8091 couchbase/server
|
|
|
-```
|
|
|
+ docker run -d -v ~/couchbase/node1:/opt/couchbase/var couchbase
|
|
|
+ docker run -d -v ~/couchbase/node2:/opt/couchbase/var couchbase
|
|
|
+ docker run -d -v ~/couchbase/node3:/opt/couchbase/var -p 8091:8091 couchbase
|
|
|
|
|
|
**Setting up your Couchbase cluster**
|
|
|
|
|
|
-1. After running the last `docker run` command above, get the <container_id>. Lets call that `<node_3_container_id>`
|
|
|
+1. After running the last `docker run` command above, get the <container_id>. Lets call that `<node_3_container_id>`
|
|
|
|
|
|
-1. Get the ip address of the node 3 container by running `docker inspect --format '{{ .NetworkSettings.IPAddress }}' <node_3_container_id>`. Lets call that `<node_3_ip_addr>`.
|
|
|
+2. Get the ip address of the node 3 container by running `docker inspect --format '{{ .NetworkSettings.IPAddress }}' <node_3_container_id>`. Lets call that `<node_3_ip_addr>`.
|
|
|
|
|
|
-1. From the host, connect to the Admin Console via http://localhost:8091 in your browser and click the "Setup" button.
|
|
|
+3. From the host, connect to the Admin Console via http://localhost:8091 in your browser and click the "Setup" button.
|
|
|
|
|
|
-1. In the hostname field, enter `<node_3_ip_addr>`
|
|
|
+4. In the hostname field, enter `<node_3_ip_addr>`
|
|
|
|
|
|
-1. Accept all default values in the setup wizard. Choose a password that you will remember.
|
|
|
+5. Accept all default values in the setup wizard. Choose a password that you will remember.
|
|
|
|
|
|
-1. Click the Server Nodes menu
|
|
|
+6. Click the Server Nodes menu
|
|
|
|
|
|
-1. Choose the Add Servers button in the Admin Console
|
|
|
+7. Choose the Add Servers button in the Admin Console
|
|
|
|
|
|
-1. For the two remaining containers
|
|
|
+8. For the two remaining containers
|
|
|
|
|
|
- 1. Get the ip address of the container by running `docker inspect --format '{{ .NetworkSettings.IPAddress }}' <node_x_container_id>`. Lets call that `<node_x_ip_addr>`
|
|
|
+ 1. Get the ip address of the container by running `docker inspect --format '{{ .NetworkSettings.IPAddress }}' <node_x_container_id>`. Lets call that `<node_x_ip_addr>`
|
|
|
|
|
|
- 1. In the Server IP Address field, use `<node_x_ip_addr>`
|
|
|
+ 2. In the Server IP Address field, use `<node_x_ip_addr>`
|
|
|
|
|
|
- 1. In the password field, use the password created above.
|
|
|
+ 3. In the password field, use the password created above.
|
|
|
|
|
|
+## Multiple hosts, single container on each host
|
|
|
|
|
|
-## Multiple hosts, single container on each host
|
|
|
-
|
|
|
-```
|
|
|
-┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
|
|
|
-│ Host OS (Linux) │ │ Host OS (Linux) │ │ Host OS (Linux) │
|
|
|
-│ ┌─────────────────┐ │ │ ┌─────────────────┐ │ │ ┌─────────────────┐ │
|
|
|
-│ │ Container OS │ │ │ │ Container OS │ │ │ │ Container OS │ │
|
|
|
-│ │ (CentOS) │ │ │ │ (CentOS) │ │ │ │ (CentOS) │ │
|
|
|
-│ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │
|
|
|
-│ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │
|
|
|
-│ │ │ Server │ │ │ │ │ │ Server │ │ │ │ │ │ Server │ │ │
|
|
|
-│ │ └───────────┘ │ │ │ │ └───────────┘ │ │ │ │ └───────────┘ │ │
|
|
|
-│ └─────────────────┘ │ │ └─────────────────┘ │ │ └─────────────────┘ │
|
|
|
-└───────────────────────┘ └───────────────────────┘ └───────────────────────┘
|
|
|
-```
|
|
|
+ ┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
|
|
|
+ │ Host OS (Linux) │ │ Host OS (Linux) │ │ Host OS (Linux) │
|
|
|
+ │ ┌─────────────────┐ │ │ ┌─────────────────┐ │ │ ┌─────────────────┐ │
|
|
|
+ │ │ Container OS │ │ │ │ Container OS │ │ │ │ Container OS │ │
|
|
|
+ │ │ (CentOS) │ │ │ │ (CentOS) │ │ │ │ (CentOS) │ │
|
|
|
+ │ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │
|
|
|
+ │ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │
|
|
|
+ │ │ │ Server │ │ │ │ │ │ Server │ │ │ │ │ │ Server │ │ │
|
|
|
+ │ │ └───────────┘ │ │ │ │ └───────────┘ │ │ │ │ └───────────┘ │ │
|
|
|
+ │ └─────────────────┘ │ │ └─────────────────┘ │ │ └─────────────────┘ │
|
|
|
+ └───────────────────────┘ └───────────────────────┘ └───────────────────────┘
|
|
|
|
|
|
This is a typical Couchbase Server cluster, where each node runs on a dedicated host, presumably in the same datacenter with high speed network links between them. We assume that the datacenter LAN configuration allows each host in the cluster to see each other host via known IPs.
|
|
|
|
|
|
@@ -206,74 +193,58 @@ Currently, the only supported approach for Couchbase Server on this deployment a
|
|
|
|
|
|
Using the `--net=host` flag will have the following effects:
|
|
|
|
|
|
-* The container will use the host's own networking stack, and bind directly to ports on the host.
|
|
|
-* Removes networking complications with Couchbase Server being behind a NAT.
|
|
|
-* From a networking perspective, it is effectively the same as running Couchbase Server directly on the host.
|
|
|
-* There is no need to use `-p` to "expose" any ports. Each container will use the IP address(es) of its host.
|
|
|
-* Increased efficiency, as there will be no Docker-imposed networking overhead.
|
|
|
+- The container will use the host's own networking stack, and bind directly to ports on the host.
|
|
|
+- Removes networking complications with Couchbase Server being behind a NAT.
|
|
|
+- From a networking perspective, it is effectively the same as running Couchbase Server directly on the host.
|
|
|
+- There is no need to use `-p` to "expose" any ports. Each container will use the IP address(es) of its host.
|
|
|
+- Increased efficiency, as there will be no Docker-imposed networking overhead.
|
|
|
|
|
|
Start a container on *each host* via:
|
|
|
|
|
|
-```
|
|
|
-docker run -d -v ~/couchbase:/opt/couchbase/var --net=host couchbase/server
|
|
|
-```
|
|
|
+ docker run -d -v ~/couchbase:/opt/couchbase/var --net=host couchbase
|
|
|
|
|
|
To configure Couchbase Server:
|
|
|
|
|
|
-* Access the Couchbase Server Admin Console via port 8091 on any of the hosts.
|
|
|
-* Follow the same steps from the *Multiple containers on single host* section, however use the use the host IP address itself rather than using `docker inspect` to discover the IP address.
|
|
|
-
|
|
|
+- Access the Couchbase Server Admin Console via port 8091 on any of the hosts.
|
|
|
+- Follow the same steps from the *Multiple containers on single host* section, however use the use the host IP address itself rather than using `docker inspect` to discover the IP address.
|
|
|
|
|
|
## Multiple hosts, multiple containers per host
|
|
|
|
|
|
-```
|
|
|
-┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
|
|
|
-│ Host OS (Linux) │ │ Host OS (Linux) │
|
|
|
-│ ┌─────────────────┐ ┌─────────────────┐ │ │ ┌─────────────────┐ ┌─────────────────┐ │
|
|
|
-│ │ Container OS │ │ Container OS │ │ │ │ Container OS │ │ Container OS │ │
|
|
|
-│ │ (CentOS) │ │ (CentOS) │ │ │ │ (CentOS) │ │ (CentOS) │ │
|
|
|
-│ │ ┌───────────┐ │ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │
|
|
|
-│ │ │ Couchbase │ │ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │
|
|
|
-│ │ │ Server │ │ │ │ Server │ │ │ │ │ │ Server │ │ │ │ Server │ │ │
|
|
|
-│ │ └───────────┘ │ │ └───────────┘ │ │ │ │ └───────────┘ │ │ └───────────┘ │ │
|
|
|
-│ └─────────────────┘ └─────────────────┘ │ │ └─────────────────┘ └─────────────────┘ │
|
|
|
-└─────────────────────────────────────────┘ └─────────────────────────────────────────┘
|
|
|
-```
|
|
|
-
|
|
|
-* Difficult to achieve with plain vanilla Docker, as there is no native way to allow each container unrestricted access to the internal IPs of containers running on other hosts.
|
|
|
-* There are software networking layers such as [Flannel](https://github.com/coreos/flannel "Flannel") and [Weave](https://github.com/weaveworks/weave "Weave"), but it is beyond the scope of this README to cover how those might be configured.
|
|
|
-* This is not a particularly useful deployment scenario for either testing or production use; you are better off checking out the various [cloud hosting scenarios](https://github.com/couchbase/docker/wiki#container-specific-cloud-hosting-platforms) available.
|
|
|
+ ┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
|
|
|
+ │ Host OS (Linux) │ │ Host OS (Linux) │
|
|
|
+ │ ┌─────────────────┐ ┌─────────────────┐ │ │ ┌─────────────────┐ ┌─────────────────┐ │
|
|
|
+ │ │ Container OS │ │ Container OS │ │ │ │ Container OS │ │ Container OS │ │
|
|
|
+ │ │ (CentOS) │ │ (CentOS) │ │ │ │ (CentOS) │ │ (CentOS) │ │
|
|
|
+ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │ │ │ ┌───────────┐ │ │ ┌───────────┐ │ │
|
|
|
+ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │ │ │ │ Couchbase │ │ │ │ Couchbase │ │ │
|
|
|
+ │ │ │ Server │ │ │ │ Server │ │ │ │ │ │ Server │ │ │ │ Server │ │ │
|
|
|
+ │ │ └───────────┘ │ │ └───────────┘ │ │ │ │ └───────────┘ │ │ └───────────┘ │ │
|
|
|
+ │ └─────────────────┘ └─────────────────┘ │ │ └─────────────────┘ └─────────────────┘ │
|
|
|
+ └─────────────────────────────────────────┘ └─────────────────────────────────────────┘
|
|
|
+
|
|
|
+- Difficult to achieve with plain vanilla Docker, as there is no native way to allow each container unrestricted access to the internal IPs of containers running on other hosts.
|
|
|
+- There are software networking layers such as [Flannel](https://github.com/coreos/flannel) and [Weave](https://github.com/weaveworks/weave), but it is beyond the scope of this README to cover how those might be configured.
|
|
|
+- This is not a particularly useful deployment scenario for either testing or production use; you are better off checking out the various [cloud hosting scenarios](https://github.com/couchbase/docker/wiki#container-specific-cloud-hosting-platforms) available.
|
|
|
|
|
|
## Cloud environments
|
|
|
|
|
|
-Although it is beyond the scope of this README, there is a [github wiki](https://github.com/couchbase/docker/wiki#container-specific-cloud-hosting-platforms) that contains guidance and instructions on how to run Couchbase Server Docker containers in various cloud environments.
|
|
|
-
|
|
|
+Although it is beyond the scope of this README, there is a [github wiki](https://github.com/couchbase/docker/wiki#container-specific-cloud-hosting-platforms) that contains guidance and instructions on how to run Couchbase Server Docker containers in various cloud environments.
|
|
|
|
|
|
-# Licensing
|
|
|
+# License
|
|
|
|
|
|
Couchbase Server comes in two editions:
|
|
|
|
|
|
-* [Community Edition](http://www.couchbase.com/community) -- free for unrestricted use.
|
|
|
-
|
|
|
-* [Enterprise Edition](http://www.couchbase.com/agreement/subscription) -- free for development, paid subscription required for production deployment.
|
|
|
-
|
|
|
-By default, the `latest` docker tag points to the latest Enterprise Edition, as does the `enterprise` docker tag. If you want the Community Edition instead, you should add the `community` tag, which will point to the latest available Community Edition.
|
|
|
-
|
|
|
-```
|
|
|
-docker run couchbase/server:community
|
|
|
-```
|
|
|
+- [Community Edition](http://www.couchbase.com/community) -- free for unrestricted use.
|
|
|
|
|
|
-# License
|
|
|
-
|
|
|
-Couchbase Server comes in two editions:
|
|
|
+- [Enterprise Edition](http://www.couchbase.com/agreement/subscription) -- free for development, paid subscription required for production deployment.
|
|
|
|
|
|
-* [Community Edition](http://www.couchbase.com/community) -- free for unrestricted use.
|
|
|
+By default, the `latest` Docker tag points to the latest Enterprise Edition, as does the `enterprise` Docker tag. If you want the Community Edition instead, you should add the `community` tag, which will point to the latest available Community Edition.
|
|
|
|
|
|
-* [Enterprise Edition](http://www.couchbase.com/agreement/subscription) -- free for development, paid subscription required for production deployment.
|
|
|
+ Docker run couchbase:community
|
|
|
|
|
|
# Supported Docker versions
|
|
|
|
|
|
-This image is officially supported on Docker version 1.6.1.
|
|
|
+This image is officially supported on Docker version 1.6.2.
|
|
|
|
|
|
Support for older versions (down to 1.0) is provided on a best-effort basis.
|
|
|
|
|
|
@@ -281,7 +252,7 @@ Support for older versions (down to 1.0) is provided on a best-effort basis.
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
-Documentation for this image is stored in the [`couchbase/` directory](https://github.com/docker-library/docs/tree/master/couchbase) of the [`docker-library/docs` GitHub repo](https://github.com/docker-library/docs). Be sure to familiarize yourself with the [repository's `REAMDE.md` file](https://github.com/docker-library/docs/blob/master/README.md) before attempting a pull request.
|
|
|
+Documentation for this image is stored in the [`couchbase/` directory](https://github.com/docker-library/docs/tree/master/couchbase) of the [`docker-library/docs` GitHub repo](https://github.com/docker-library/docs). Be sure to familiarize yourself with the [repository's `README.md` file](https://github.com/docker-library/docs/blob/master/README.md) before attempting a pull request.
|
|
|
|
|
|
## Issues
|
|
|
|
Chris Hillery