Getting Started With Couchbase Using Docker
This blog will explain how you can easily start Couchbase Server 4.0 as a Docker image.
Join the DZone community and get the full member experience.
Join For FreeCouchbase Server 4.0 was recently released and can be downloaded and easily installed. Getting Started with Couchbase explains in very simple and easy steps how to get started with Couchbase. But when living in a container world, everything is a Docker image. And Couchbase also has a Docker image.
This blog will explain how you can easily start Couchbase Server 4.0 as a Docker image.
Install and Configure Docker
Docker is natively supported on Linux. So apt get docker-engine
on Ubuntu or yum install docker-engine
on CentOS will get you ready to use Docker.
On Mac or Windows, this is achieved by installing Docker Machine. Docker Machine to Setup Docker Host explains in detail on how to install and configure Docker Machine.
Here is a brief summary to get you started with Docker:
- Download Docker client:51
> curl -L https://get.docker.com/builds/Darwin/x86_64/docker-1.8.3 > /usr/local/bin/docker
2% Total % Received % Xferd Average Speed Time Time Time Current
3Dload Upload Total Spent Left Speed
4100 8664k 100 8664k 0 0 4139k 0 0:00:02 0:00:02 --:--:-- 4139k
5> chmod +x /usr/local/bin/docker
- Download Docker Machine script:61
> curl -L https://github.com/docker/machine/releases/download/v0.4.1/docker-machine_darwin-amd64 > /usr/local/bin/docker-machine
2% Total % Received % Xferd Average Speed Time Time Time Current
3Dload Upload Total Spent Left Speed
4100 586 0 586 0 0 1103 0 --:--:-- --:--:-- --:--:-- 1103
5100 11.8M 100 11.8M 0 0 2733k 0 0:00:04 0:00:04 --:--:-- 3458k
6> chmod +x /usr/local/bin/docker-machine
- Create Docker Machine host:61
> docker-machine create --driver=virtualbox default
2Creating VirtualBox VM...
3Creating SSH key...
4Starting VirtualBox VM...
5Starting VM...
6To see how to connect Docker to this machine, run: docker-machine env default
- Setup Docker client to connect to this host:1
> eval $(docker-machine env default)
Now your current shell is configured where the Docker client can run containers on the Docker Machine.
Run Couchbase Docker Container
- Starting a Docker container on this machine is pretty straightforward. The CLI downloads the image from Docker Hub and then runs it on the Machine:221
> docker run -d -p 8091:8091 couchbase
2Unable to find image 'couchbase:latest' locally
3latest: Pulling from library/couchbase
4ba2b457ecfb2: Pull complete
526180b0fe8fb: Pull complete
6edd7c1974a70: Pull complete
757bca5139a13: Pull complete
85eb89c4f7e1a: Pull complete
946b6bac823d2: Pull complete
106845430f4274: Pull complete
1192d9ea0b826c: Pull complete
12c02a4d9a78c4: Pull complete
13904ac92614ac: Pull complete
14e924e7d4b1dc: Pull complete
15bbe8a967cf05: Pull complete
1635fb2c30481e: Pull complete
1768eb883fd0c7: Pull complete
18fe1b3bdb1e2f: Pull complete
19library/couchbase:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
20Digest: sha256:388b710593a7a643c49bf38c4b16eb8e175dccac093e9aa8dea5bd2e2d326efd
21Status: Downloaded newer image for couchbase:latest
225b789d2319486ce8a4a4d6a866d8212dde1464601451b9a84a8d3bf80e8aa935
In this CLI, therun
command runs the container using the image id specified as the last argument,-p
publish port8091
from the container to8091
on the Docker Machine,-d
runs the container in the background and prints the container id. - Watch the container status as:31
> docker ps
2CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
35b789d231948 couchbase "/entrypoint.sh couch" 7 minutes ago Up 7 minutes 8092/tcp, 11207/tcp, 11210-11211/tcp, 0.0.0.0:8091->8091/tcp, 18091-18092/tcp sick_yonath
- Find out the IP address of the Docker Machine:21
> docker-machine ip default
2192.168.99.100
- Access the setup console at 192.168.99.100:8091, make sure to specify the exact IP address in your case. This will show the screen:
Configure Couchbase Server
First run of Couchbase Server requires you to configure it, let's do that next!
- Click on the Setup button. Scroll to the bottom of the screen, change the Data RAM Quota to 500 (MB-16530), and click on Next.
- In Couchbase, data is stored in buckets. The server comes pre-installed with some sample buckets. Select the
travel-sample
bucket to install it and click onNext
. - Configure the bucket by taking defaults:
Click onNext
. - Enter personal details, agree to T&C, click on
Next
: - Provide administrator credentials:
Click on
Next
to complete the installation. This brings up Couchbase Web Console:
It takes a few seconds for the travel-sample
bucket to be fully loaded. And once that is done, your Couchbase server is ready to roll!
You can also watch the following presentation from Couchbase Connect:
Talk to us at Couchbase Forums or @couchbase.
Published at DZone with permission of Arun Gupta, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
Comments