1. Home
  2. Docker Enterprise products
  3. Universal Control Plane overview
  4. Deploying an application package

Deploying an application package

Deploying an application package

Docker Enterprise 2.1 introduces application packages in Docker. With application packages, you can add metadata and settings to an existing Compose file. This gives operators more context about applications that they deploy and manage.

An application package can have one of these formats:

  • Directory format: Defined by metadata.yml, a docker-compose.yml, and a settings.yml files inside a my-app.dockerapp folder. This is also called the folder format.
  • Single-file format: Defined by metadata.yml, docker-compose.yml, and settings.yml concatenated in that order and separated by ---\n in a single file named named my-app.dockerapp.

Once an application package has been deployed, you manipulate and manage it as you would any stack.

Creating a stack in the UCP web UI

To create a stack in the UCP web interface, follow these steps:

  1. Go to the UCP web interface.

  2. In the lefthand menu, first select Shared Resources, then Stacks.

    ../_images/ucp-create-stack.png

  3. Select Create Stack to display 1. Configure Application in the stack creation dialog.

    ../_images/ucp-config-stack.png

  4. Enter a name for the stack in the Name field.

  5. Select either Swarm Services or Kubernetes Workloads for the orchestrator mode. If you select Kubernetes, also select a namespace in the Namespace drop-down list.

    ../_images/ucp-stack-namespace.png

  6. Select either Compose File or App Package for the Application File Mode.

  7. Select Next.

  8. If you selected Compose file, enter or upload your docker-compose.yml in 2. Add Application File.

    ../_images/ucp-stack-compose.png

    or if you selected App Package, enter or upload the application package in the single-file format.

    ../_images/ucp-stack-package.png

  9. Select Create.

Single-file application package example

Here is an example of a single-file application package:

version: 0.1.0
name: hello-world
description: "Hello, World!"
namespace: myHubUsername
maintainers:
  - name: user
    email: "user@email.com"
---
version: "3.6"
services:
  hello:
    image: hashicorp/http-echo
    command: ["-text", "${text}"]
    ports:
      - ${port}:5678

---
port: 8080
text: Hello, World!
updated: 2023-07-26 11:20