This page describes how to create a service on Docker Cloud.
A service is a group of containers of the same image:tag. Services make it simple to scale your application. With Docker Cloud, you simply drag a slider to change the number of containers in a service.
Before you can deploy a service in Docker Cloud, you must have at least one node deployed. If you haven’t done this yet follow the tutorial to deploy a node .
When you create a service in the Docker Cloud web interface, a wizard walks you through configuring the service in three steps.
Note:In this Quickstart tutorial we won’t be working with environment variables or connecting data volumes, but these are also available as optional steps in the wizard.
From any page on Docker Cloud, click the Services section, then click Create.
For the purposes of this tutorial, click the rocket icon and look for the Miscellaneous section.
You will see an image called
Click the dockercloud/hello-world image. This image creates a container that runs NGINX, and shows a simple hello world web page.
In this step Docker Cloud loads all of the Image tags available for the image. In this case our tutorial image dockercloud/hello-world only has one image tag called latest.
For the purposes of this tutorial, you don’t actually need to enter or change anything for most of the fields on the Create Service page.
Since we need to access this container over the Internet, we first need to publish a port. By default, ports are not accessible publicly. To learn more about ports click here.
Click the Ports table, where it says Click to override ports defined in image. This activates that section so you can make changes. Then click the Published checkbox.
For this tutorial leave the Node port set to dynamic. This means that port 80 of the container is mapped to a random available port in the node in which the container is deployed. To force a specific port in the node, click dynamic and specify a port.
Note: Two containers in the same node cannot publish to the same node port.
You don’t need to modify anything else in this service for the tutorial, so click Create and deploy. Docker Cloud creates, and deploys your new service (just like it says on the tin!)
Next, Cloud sends you to the Service’s detailed view. The detailed view contains six informational sections:
Two additional tabs of information are available for each service:
Click the Timeline tab to see a log output similar to the one below. It can take a couple of minutes for the container to deploy.
Deploying... Creating 1 new containers Preparing to deploy container f93b1a05-4444-49e5-98b0-9dc3a7618453 hello-world-1: Choosing best node. Deployment strategy: BALANCE hello-world-1: Deploying in 8468426e-tutorial.node.dockerapp.io hello-world-1: Pulling image dockercloud/hello-world:latest in 8468426e-tutorial.node.dockerapp.io hello-world-1: Creating in 8468426e-tutorial.node.dockerapp.io hello-world-1: Starting with docker id df9525795bef5394e1a33b2ef42e26ba991bdccece4bc4f4f34e1def5c095fe9 in 8468426e-tutorial.node.dockerapp.io hello-world-1: Inspecting and checking its configuration hello-world-1: Running in 8468426e-tutorial.node.dockerapp.io
The web interface will look something like this:
The hello-world status line updates to Running once the container deploys successfully.
The Containers list shows all of the containers in this service. There should just be one for now.
Click the container’s name to go to the Container’s detail view. From this page you can see additional information about the containers, such as endpoints, logs, environment variables, volumes, a terminal, and the console timeline.
The Endpoints section lists the endpoints (ports) that this container is publishing. In the screenshot above, there is a single endpoint: hello-world-66622790-1.9ab56d66.container.docker.io:32768. The endpoint is composed of both the container’s hostname and a port number.
Click the links icon to the right of the endpoint. This opens a new tab and shows the webpage that the hello-world container is hosting.
Congratulations! You’ve successfully deployed your first service using Docker Cloud.
You probably don’t need the
hello-world container to run for very long after you complete the tutorial. To clean up and remove all of the resources you created during this tutorial:
hello-worldcontainer and click the selection that box appears, then click the Terminate icon to the right of the service information.
Both terminated Services and Node Clusters remain in the UI for about five minutes. After that time, they no longer appear.
Learn more about scaling your service, or check out some of our other Deploy an app tutorial.