1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00
Daniel efa340b605 docs: Add external property back to compose and add swarm secrets example using compose (#25522)
<!--Delete sections as needed -->

## Description

Added back the attribute `external` in the `/reference/compose/secrets`
section with a warning that this attribute is only available for Docker
Swarm. Additionally, I added a small toy reference example to the
section "Defining and using Secrets in compose files" and moved the
section outside of the "Examples" section. The reason why I did this is
because I noticed the Examples are all runnable steps that showcase
concrete usage of secrets, the example I added is just a
skeleton/reference to how they should be used in conjunction with
`docker secret create...`, not a true able-to-run example like the ones
below. I also changed the hyperlink from
`/reference/compose-file/legacy-versions.md` to
`/reference/compose-file/secrets.md`.

A few caveats that I wasn't sure about when writing this:
- I'm not sure if using the "[!NOTE]" in the attributes list is the
approach maintainers and writers might favor and I can change it
accordingly
- I'd love to hear feedback on moving "Defining and using secrets in
compose files" outside of "Examples" due to my reasoning above

Edit:
I'm also not opposed to making a fully working example using compose,
stack and secrets and putting the section back under `Examples`

<!-- Tell us what you did and why -->

## Related issues or tickets
 #25491 
<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-08-27 08:51:49 +01:00
2026-08-20 19:18:07 +05:30
2026-08-26 15:42:04 -05:00
2025-01-30 07:54:26 -08:00
2026-08-26 15:42:04 -05:00
2026-03-31 15:20:07 +02:00
2026-01-05 08:34:39 +01:00
2024-09-16 14:43:05 +02:00
2025-07-16 15:13:38 +02:00
2026-08-26 15:42:04 -05:00
2016-09-30 01:51:56 -07:00
2026-06-09 10:59:31 +02:00
2025-04-02 15:46:24 -04:00

Docs @ Docker

Welcome to Docker Documentation


Welcome to the Docker Documentation repository. This is the source for the Docker Docs Website.

Feel free to open pull requests or issues. Our docs are completely open source, and we deeply appreciate contributions from the Docker community!

Provide feedback

We’d love to hear your feedback! To submit feedback:

  • Click New issue on the docs repository, or
  • Click Request changes in the right column of every page on docs.docker.com, or
  • Click Give feedback on every page in the docs.

To get community support, use the Docker Community Slack. Personalized support is available through the Docker Pro, Team, and Business subscriptions. See Docker Pricing for details.

If you have an idea for a new feature or behavior change in a specific aspect of Docker or have found a product bug, file an issue in the project's repository.

Contribute to Docker docs

We welcome contributions! To get started:

Copyright 2013-2026 Docker, Inc., released under the Apache 2.0 license.

Description
Репозиторий с исходным кодом для документации Docker
Readme Apache-2.0 932 MiB
Languages
Markdown 95.1%
HTML 2.3%
CSS 0.7%
Go 0.7%
JavaScript 0.7%
Other 0.2%