Deploy Docker Container to Oracle Container Cloud Service

Getting Started with Oracle Container Cloud Service explained how to get started with Oracle’s managed container service. Well, the intent was to show how to get started but getting to “getting started” was itself quite involving. And now this blog will really show how to run a simple Docker container to Oracle Container Service.

Oracle Container Service is built upon Oracle’s StackEngine acquisition that was completed 1.5 years ago. The basis for this blog is going to be a 4 node cluster (1 manager and 3 workers) created following the steps in Getting Started with Oracle Container Cloud Service.

Make sure you note down the user name and password of the service specified during the creation. It is golden, and there is no way to either retrieve it or reset it afterwards. UPDATE: @kapmani clarified that the password can be reset by logging into the manager node.

Anyway, the dashboard looks like:

Similarly, Container Cloud Console with 4 nodes looks like:

Container Cloud Service is accessible using REST API as explained in About Oracle Container Cloud Service REST API. The console itself uses the REST API for fulfilling all the commands.

Oracle Container Cloud Service Concepts

Let’s learn about some concepts first:

• Service – Service comprises of the necessary configuration for running a Docker image as a container on a host, plus default deployment directives. Service is neither container nor image running in containers. It is a high-level configuration objects that you can create, deploy, and manage using Oracle Container Cloud Service. Think of a service as a container ‘template’, or as a set of instructions to follow to deploy a running container.
• Stack – Stack is all the necessary configuration for running a set of services as Docker containers in a coordinated way and managed as a single entity, plus default deployment directives. Think of it as multi-container application. Stacks themselves are neither containers nor images running in containers, but rather are high-level configuration objects that you can create, deploy, and manage using Oracle Container Cloud Service. For example, a stack might be one or more WildFly containers and a Couchbase container. Likewise, a cluster of database or application nodes can be built as a stack.
• Deployment – A Deployment comprises a service or stack in which Docker containers are managed, deployed, and scaled according to a set of orchestration rules that you’ve defined. A single deployment can result in the creation of one or many Docker containers, across one or many hosts in a resource pool.
• Resource Pool – Resource pools are a way to organize hosts and combine them into isolated groups of compute resources. Resource pools enable you to manage your Docker environment more effectively by deploying services and stacks efficiently across multiple hosts.Three resource pools are defined out of the box:
  

Rest of the terms like Containers, Images and Hosts are pretty straight forward.

Run Couchbase in Oracle Container Cloud Service

• Click on Services, New Service
• Oracle Container Service only supports Compose v2. So a simple Compose file definition can be used for service definition:
  
  YAML

  version: "2" services: db: image: arungupta/couchbase ports: - 8091:8091 - 8092:8092 - 8093:8093 - 11210:11210

  1 2 3 4 5 6 7 8 9

  version: "2" services:   db:     image: arungupta/couchbase     ports:       - 8091:8091       - 8092:8092       - 8093:8093       - 11210:11210

  
  The image arungupta/couchbase is built from github.com/arun-gupta/docker-images/tree/master/couchbase. It uses Couchbase REST API to pre-configure the Couchbase server. The common Couchbase networking ports for application development are also exposed.

  In the YAML tab, use the Compose definition from above:
  
  Alternatively, you can use the builder or docker run command as well. In our case, use the Compose definition and then specify the Service Description.

• Click on Save to save the service definition. The updated list now includes Couchbase service:
  
• Click on Deploy to deploy the container:
  
• Take the defaults and click on Deploy to start the deployment.
• The Docker image is download and the container is started. The screen is refreshed to show Deployments:
  A single instance of the container is now up and running,  Other details like resource pool, hostname and uptime are also displayed.

Details about Couchbase Container in Oracle Cloud

Let’s get some details about the Couchbase container in Oracle Cloud:

• Click on the container name shown in Container Name column to see more details about the container:
  
  The typical output that you’ll inspect from the docker inspect command is shown here.
• Click on View Logs to see the container logs:
  
  This is equivalent to the docker container logs command.
  These logs are generated from when Couchbase REST API is configuring the server.
• Click on Hosts to see the complete list of hosts:
  
• A single instance of container is running. Select the host that is running the container to see more details:
  
  Note the public_ip of the host. This IP address will be used to access Couchbase Web Console later.Another key part to note here is that this host is running Docker 1.10.3. That is the case with other hosts as well, as expected.

Access Couchbase

Now, let’s access the Couchbase Web Console. In our case, this is available at 129.152.159.64:8091. This shows the main login screen as:

Use Administrator as Username and password as password, click on Sign In to see the main screen of the console:

Click on Server Nodes to see that data, index and query services are running:

Pretty cool, eh!

A future blog post will show how to create a Couchbase cluster, run a simple application against this cluster and other fun stuff.

Use any of the Couchbase Starter Kits to get started with Couchbase.

Want to learn more about running Couchbase in containers?

• Couchbase on Containers
• Couchbase Developer Portal
• @couchhasedev and @couchbase