docker app install
Description
Install an application
This command is experimental on the Docker client.
It should not be used in production environments.
To enable experimental features in the Docker CLI, edit the config.json and set
experimental
toenabled
. You can go here for more information.
Usage
docker app install [APP_NAME] [--name INSTALLATION_NAME] [--target-context TARGET_CONTEXT] [OPTIONS]
Extended description
Install an application. By default, the application definition in the current directory will be installed. The APP_NAME can also be:
- a path to a Docker Application definition (.dockerapp) or a CNAB bundle.json
- a registry Application Package reference
For example uses of this command, refer to the examples section below.
Options
Name, shorthand | Default | Description |
--credential-set |
Use a YAML file containing a credential set or a credential set present in the credential store | |
--insecure-registries |
Use HTTP instead of HTTPS when pulling from/pushing to those registries | |
--kubernetes-namespace |
Kubernetes namespace to install into | |
--name |
Installation name (defaults to application name) | |
--orchestrator |
Orchestrator to install on (swarm, kubernetes) | |
--parameters-file |
Override parameters file | |
--pull |
Pull the bundle | |
--set , -s |
Override parameter value | |
--target-context |
Context on which the application is installed (default: |
|
--with-registry-auth |
Sends registry auth |
Examples
$ docker app install myapp.dockerapp --name myinstallation --target-context=mycontext $ docker app install myrepo/myapp:mytag --name myinstallation --target-context=mycontext $ docker app install bundle.json --name myinstallation --credential-set=mycredentials.yml
Parent command
Command | Description |
---|---|
docker app | Docker Application |
Related commands
Command | Description |
docker app bundle | Create a CNAB invocation image and bundle.json for the application |
docker app completion | Generates completion scripts for the specified shell (bash or zsh) |
docker app init | Initialize Docker Application definition |
docker app inspect | Shows metadata, parameters and a summary of the Compose file for a given application |
docker app install | Install an application |
docker app list | List the installations and their last known installation result |
docker app merge | Merge a directory format Docker Application definition into a single file |
docker app pull | Pull an application package from a registry |
docker app push | Push an application package to a registry |
docker app render | Render the Compose file for an Application Package |
docker app split | Split a single-file Docker Application definition into the directory format |
docker app status | Get the installation status of an application |
docker app uninstall | Uninstall an application |
docker app upgrade | Upgrade an installed application |
docker app validate | Checks the rendered application is syntactically correct |
docker app version | Print version information |