docs/ee/ucp/deploy-application-package.md

title	description	keywords
Deploy an appliction package	Learn how to deploy an appliction package in UCP	ucp, swarm, kubernetes, application

Beta disclaimer

This is beta content. It is not yet complete and should be considered a work in progress. This content is subject to change without notice.

In Docker 2.1 EE, an application package has one of these formats:

• Three-file format: Defined by a 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 a data from the previously three files concatenated in the order givem and separated by ---\n in a single file named named 'my-app.dockerapp'.
• Image forma t: Defined by a Docker image in the engine store or exported as a tarball.

The docker-app binary lets a user render an application package to a Compose file using the settings values in the settings file or those specified by the user. This Compose file can then be deployed to a cluster running in Swarm mode or Kubernetes using docker stack deploy or to a single engine or Swarm classic cluster using docker-compose up.

The docker-app binary also lets a user deploy an application package directly, essentially executing a docker-app render command followed by a docker stack deploy command.

Once a stack has been deployed, you must use the docker stack or docker-compose commands to manipulate and manage the stack.

Creating a stack in the UCP web interface

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.

   

3. Select Create Stack to display the stack creation dialog.

   

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

5. Select either Swarm Services or Kubernetes Workloads for the orchestrator mode.

Deploying on Swarm

[placeholder]

Deploying on Kubernetes

[placeholder]