You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jul 18, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,17 +47,17 @@ Four primary steps comprise the Docker App process:
47
47
48
48
### Writing an App definition
49
49
50
-
The first step in using Docker App is to write the App definition. This definition can be created (1) from an existing Compose file using the `docker app init` command (2) via a template from the [Application Designer](https://docs.docker.com/ee/desktop/app-designer/), or (3) from scratch.
50
+
The first step in using Docker App is to write the App definition. This definition can be created (1) from an existing [Compose file](https://docs.docker.com/compose/compose-file/) using the `docker app init` command (2) via a template from the [Application Designer](https://docs.docker.com/ee/desktop/app-designer/), or (3) from scratch.
51
51
52
52
The App definition is a .dockerapp folder that contains three distinct pieces: metadata, a service list, and the parameters.
53
53
54
54
| File | Description |
55
55
| :------------ | :------------ |
56
56
| metadata.yml | metadata including the App name and version |
57
-
| docker-compose.yml | Service list defined in a [Compose file](https://docs.docker.com/compose/compose-file/)|
57
+
| docker-compose.yml | Service list defined in a Compose file |
58
58
| parameters.yml | Parameters that can be changed when running the App |
59
59
60
-
*Note: To store additional files in Docker Apps, such as*`prod.yml`*,*`test.yml`*or other config files, you need only to add these files to the *.dockerapp directory. All files will be packaged into the App image through the use of the*`docker app build`*command.*
60
+
*Note: To store additional files in Docker Apps, such as `prod.yml`,`test.yml` or other config files, you need only to add these files to the *.dockerapp directory. All files will be packaged into the App image through the use of the `docker app build` command.*
61
61
62
62
### Building an App image
63
63
@@ -88,7 +88,7 @@ First, create an App definition from an existing Compose file.
88
88
Create a `docker-compose.yml` file that has the following content:
89
89
90
90
```yaml
91
-
version: '3.2'
91
+
version: '3.6'
92
92
services:
93
93
hello:
94
94
image: hashicorp/http-echo
@@ -109,6 +109,7 @@ $ tree
109
109
├── docker-compose.yml
110
110
├── metadata.yml
111
111
└── parameters.yml
112
+
```
112
113
113
114
A new folder named `hello.dockerapp` now exists, which contains three YAML documents:
114
115
* metadata
@@ -133,7 +134,7 @@ The Compose file is the one that was passed in parameters. Thus, if you open `pa
133
134
Edit the `docker-compose.yml` file in the `hello.dockerapp` directory to add some variables:
At this point, an App image with the `myrepo/hello:1.0.1` tag has been built from the `hello.dockerapp` App definition. This immutable App image includes all the service images at fixed versions that you can run or share.
0 commit comments