Deploy a single service app

Deploy a single service app

You can deploy and monitor your services from the MKE web UI. In this example, we’ll deploy an NGINX web server and make it accessible on port 8000.

To deploy a single service:

  1. In your browser, navigate to the MKE web UI and click Services. The Create a Service page opens.

  2. Click Create Service to configure the NGINX service, and complete the following fields:

    Field Value
    Service name nginx
    Image name nginx:latest
  3. In the left pane, click Network.

  4. In the Ports section, click Publish Port and complete the following fields:

    Field Value
    Target port 80
    Protocol tcp
    Publish mode Ingress
    Published port 8000
  5. Click Confirm to map the ports for the NGINX service.

  6. Specify the service image and ports, and click Create to deploy the service into the MKE cluster.

Once the service is up and running, you can view the default NGINX page by going to http://<node-ip>:8000. In the Services list, click the nginx service, and in the details pane, click the link under Published Endpoints.

Clicking the link opens a new tab that shows the default NGINX home page.

Use the CLI to deploy the service

You can also deploy the same service from the CLI. Once you’ve set up your MKE client bundle, enter the following command:

docker service create --name nginx \
  --publish mode=ingress,target=80,published=8000 \
  --label com.docker.ucp.access.owner=<your-username> \
  nginx