People ask me how to do this all the time, and I can't find a good example documented anyhwere else. I figure this is a better example of the actual usage of the driver_opts parameter with a real-world use case.
As mentioned in lines 115 through 117, "Values in the shell take precedence over those specified in the `.env` file. If you set `TAG` to a different value in your shell, the substitution in `image` uses that instead:".
This context should also be represented in the order of priority in which variables are processed.
* Update docker-compose run --rm doc
To make the functionality added in
24ab933ebf
explicit in the docs
* Rewrite change as an addendum
Rewrite the change to the end of the page as an addendum to the description of the inner workings of the run command.
* Update example events JSON blob
The example JSON blob given doesn't match up with the values I experience when running `docker-compose events` myself, so I'm updating the documentation to save someone else some time.
* Add link to event types for convenience
The password needs an upper-case and a number to comply. Like that it fails and for a beginner it might not be obvious why - even thought it will print an error; but it's just one line.
Github now only supports TLS1.2 and you need to run the following command to make sure these instructions work. Please let me know if my phrasing is not good and I can update to make it work
* Reword lots of instances of 'will'
* Reword lots of instances of won't
* Reword lots of instances of we'll
* Eradicate you'll
* Eradicate 'be able to' type of phrases
* Eradicate 'unable to' type of phrases
* Eradicate 'has / have to' type of phrases
* Eradicate 'note that' type of phrases
* Eradicate 'in order to' type of phrases
* Redirect to official Chef and Puppet docs
* Eradicate gratuitous 'please'
* Reduce use of e.g.
* Reduce use of i.e.
* Reduce use of N.B.
* Get rid of 'sexagesimal' and correct some errors
- added restart to list of sub-options not supported in stack deploy
- added note to the bottom of restart description that it isn't supported in stack deploy, and to use restart_policy instead.
* Note about setting ipv4/ipv6 not working in swarm
I spent a few hours yesterday assuming this was possible, but it turns out it isn't. Hopefully this will help prevent others from making the same mistake I did.
In this context, I think `docker container create` is more suitable and more respectful to the new syntax and better analogy with `docker network create` and `docker volume create`
After running "docker-compose up", the console shows a nice aggregated output of each container. When running this in detached mode, it's not clear how to later view this aggregated output again. Added a quick note on how this is done.
* added more info about resource constraints to Compose docs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed link in Compose docs, added instructions in test for adding custom target link link IDs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed links
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Fix download urls for compose command completion
Signed-off-by: Harald Albers <github@albersweb.de>
* Use sudo when installing bash completion
Writing to the system-wide completion plugin directory `/etc/bash_completion.d/`
requires root permissions.
Signed-off-by: Harald Albers <github@albersweb.de>
* updates to version variables for compose and machine
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedit to make Compose release version number correct
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* re-org sample to show static loaded image, then using a volume mounte
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* review comments from mstanleyjones and joaofnfernandes
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added a sub-step to make the workflow and output make sense
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* combined notes about shared drives and volumes, reorganized topic order
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Fix docker-compose file version in the example given for the new volumes "long syntax", available from version 3.2.
Currently the example contains version 3 which does not support this syntax.
* re-organized Compose install docs into tabs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* combined d4win and windows server on one tab
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed tabs alignment
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed heading levels to show properly in TOC
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixing tabs and content
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* removed cruft test content from tabs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* final version of tabs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Set toc_max to get headings within tabs out of on-page toc
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added a subtle <hr> under tab topics per review request
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* put back missing Compose Wordpress example
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* addressed review comments, postponing one comment re: yaml code fencing
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Added 'rollback' to the list in the following bullet:
- `failure_action`: What to do if an update fails. One of `continue`, `rollback`, or `pause` (default: `pause`).
* Fix Compose file samples for volumes and other
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixing Compose file example, adding another volume mount example
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* replaced x-ref to volumes info with the right one
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* add bullets to note
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* corrected for description of bind mount as example intro
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* modified volumes example per developer review
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* corrected for legacy stuff on examples, clarified named volumes
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed capitalization in x-refs visible text
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* clarify Compose install prerequisites
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* organized install on Microsoft Server into steps
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* better highlighting and organization for the desktop systems section
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedit for consistency
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* changed Docker server --> Docker per review
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* attempt to clarify Compose / Docker Engine dependencies per reviews
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedits per reviews
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* surface Compose file example at top of topic
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* removed extraneous intro
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added better links to Compose overview docs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed drupal samples link per feedback
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* for all links to , changed to full path
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed link in Swarm Tutorial per review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* better examples to show Compose file structure
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* cleaned up leading spaces in Compose file example
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* cleaned up leading spaces, added a test file
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* expand/collapse accordion full implementation, explanation in test.md
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* delete temporary test file from PR
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fix accordion to work on mobile (cursor style)
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* verified fix for mobile worked, added same to test.md, updated notes and content
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Clarifed details on test page, fixed references for FontAwesome icons
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added endpoint_mode topic for Compose file v3.3
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* incorporated review comments re: features and versioning
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added Compose topics on caching options for performance
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* updated title for Compose topic
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* line wrap per review
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>