Commit Graph

125 Commits

Author SHA1 Message Date
Manuel de la Peña
b951e92f57 feat(guides): migrate all testcontainers.com guides (#24505)
## Description

Migrate 17 Testcontainers guides from testcontainers.com into the Docker
docs site, covering Java (14 guides), .NET (2 guides), and Node.js (1
guide). This follows up on PR #24450 which added the initial Go and
Python guides.

Each guide is converted from AsciiDoc to Hugo Markdown, split into
multi-chapter stepper navigation, updated to the latest Testcontainers
API, and verified with passing tests running in containers.

Java guides use testcontainers-java 2.0.4 with the new 2.x Maven
coordinates and package names (e.g., `testcontainers-postgresql`,
`org.testcontainers.postgresql.PostgreSQLContainer`). The Quarkus guide
uses Quarkus 3.22.3 with TC 1.x managed by the Quarkus BOM, since no
released Quarkus version ships TC 2.x yet.

## How to test

All code snippets have been verified by running each guide's source
repository tests inside Docker containers with the Docker socket
mounted.

To re-run the verification, use the `/testcontainers-guides-migrator`
skill included in this PR
(`.claude/skills/testcontainers-guides-migrator/SKILL.md`). The skill's
Step 6 documents the exact container commands and macOS Docker Desktop
workarounds (host override, docker-java API version, etc.) needed to run
each language's tests:

```
/testcontainers-guides-migrator I want you to verify all the guides in this branch.
Do a full review, verifying that all code snippets compile, the code is executable,
and ALL the tests pass. Run them as docker containers, never locally.
```

## Related issues or tickets

Supersedes #24450 (expanded from 2 guides to all 19)

## Reviews

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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 10:03:26 +00:00
Manuel de la Peña
36d384d2da docs(guides): add two testcontainers intro guides (go and python) (#24450)
## Description

Migrate the first two Testcontainers getting-started guides from
[testcontainers.com/guides](https://testcontainers.com/guides/) into the
Docker docs site:

- **Getting started with Testcontainers for Go** — multi-page guide with
4 chapters (create project, write tests, test suites, run tests). Code
updated to testcontainers-go v0.41.0 API (`postgres.Run()`,
`CleanupContainer`, `BasicWaitStrategies()`).
- **Getting started with Testcontainers for Python** — multi-page guide
with 3 chapters (create project, write tests, run tests). Code updated
to testcontainers-python 4.14.2 (fixed `get_exposed_port()` returning
`int`).

Each guide appears as its own entry in the `/guides/` listing with
proper language and tag filters (`testing-with-docker`). Chapters render
with stepper navigation in the sidebar.

Also adds:
- A `testing-with-docker` tag to `data/tags.yaml`
- A Claude skill
(`.claude/skills/testcontainers-guides-migrator/SKILL.md`) that
documents the repeatable migration process for the remaining 19 guides
- Links from `content/manuals/testcontainers.md` to the new guides
- Vale vocabulary entries for `pgx`, `Micronaut`, `psycopg`, `pytest`

All guide code was compiled and tests verified passing in containers
with Docker socket mounted.

## Related issues or tickets

No related issues found.

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-03-23 13:58:19 +00:00
Allie Sadler
49b049a688 Compose quickstart refresh (#24221)
<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-03-09 16:00:22 +00:00
David Karlsson
fb692c3dc2 Merge pull request #24112 from docker/agent/issue-23757
docs: address issue #23757
2026-02-28 05:39:39 +01:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
048e4d2861 Update accept.txt (#24226)
<!--Delete sections as needed -->


## Description

[Unsloth](https://github.com/unslothai/unsloth), a project designed to
make fine-tuning models much faster and more accessible.

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

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-02-26 08:18:46 -08:00
Ajeet Singh Raina, Docker Captain, ARM Innovator
fe99265ce2 Add 'Labspaces' to accepted vocabulary list (#24225)
<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

<!-- 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: Craig Osterhout <craig.osterhout@docker.com>
2026-02-26 07:44:57 -08:00
David Karlsson
e32f9cc592 Merge pull request #24102 from dvdksn/sandboxes-461
sandboxes v0.12.0
2026-02-18 11:05:53 +01:00
Shakirth Anisha
d827401e6f Merge pull request #24108 from shakirth-anisha/ros2_guide
docs: Add guide for running ROS2 with Docker
2026-02-16 14:26:51 +01:00
David Karlsson
87fa1fa09b sandboxes: add agent-specific documentation
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-16 10:36:41 +01:00
github-actions[bot]
f208c6c425 docs: address issue #23757
This change was automatically generated by the documentation agent team
in response to issue #23757.

🤖 Generated with cagent

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-11 10:57:57 +01:00
luojiyin
9be23c8032 Fix spelling errors across documentation and config files
- seee → see (hub API docs)
- dameon → daemon (release notes)
- plugable → pluggable (release notes)
- adminstrative → administrative (account docs)
- docekr → Docker (opentelemetry guide)
- addFlagLables → addFlagLabels (tensorflowjs guide)
- terrabytes → terabytes (Vale config)
- Dasboard → Dashboard (Vale vocabulary)
- plaform → platform (CLI docs)
- correponds → corresponds (CLI docs)
- digset → digest (buildx docs)

Signed-off-by: luojiyin <luojiyin@hotmail.com>
2026-02-08 13:15:42 +08:00
David Karlsson
2c7b95ad3c build: build source policies
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-28 10:40:28 +01:00
Craig Osterhout
94a7356940 dhi: add scanner integration (#23952)
<!--Delete sections as needed -->

## Description

Added topic about scanner integrations and moved conceptual info from
how to scan to that topic.
Refreshed how to scan and vex core concept topics.
Added wiz scan.

-
https://deploy-preview-23952--docsdocker.netlify.app/dhi/explore/scanner-integrations/
- https://deploy-preview-23952--docsdocker.netlify.app/dhi/how-to/scan/
-
https://deploy-preview-23952--docsdocker.netlify.app/dhi/core-concepts/vex/

## Related issues or tickets

ENGDOCS-3137

## Reviews

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

- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-01-26 13:38:46 -08:00
David Karlsson
2869118ccb sandboxes: rewrite for microvm-based sandboxes
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-01-26 14:40:47 +01:00
David Karlsson
8a0f520cf5 cagent: model provider setup, a2a, evals, mcp/dmr links
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-12-17 15:14:59 +01:00
Djordje Lukic
365ce6beb8 cagent: completely document fundamentals
Signed-off-by: Djordje Lukic <djordje.lukic@docker.com>
2025-12-10 19:43:53 +01:00
Dorin Geman
e9f52993bc model-runner: document inference engine support and GitHub issue reporting
Signed-off-by: Dorin Geman <dorin.geman@docker.com>
2025-12-05 15:20:14 +02:00
David Karlsson
2595d2f067 vale: add pluggable, stargz to vocabulary
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-18 16:47:44 +01:00
David Karlsson
c152b6077d Merge pull request #23700 from dvdksn/docker-sandboxes
docker sandboxes
2025-11-11 17:07:35 +01:00
David Karlsson
fabb108e1f ai: add docs for local agent sandboxes
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-11 17:03:50 +01:00
Allie Sadler
4d70d60296 ENGDOCS-3081 (#23626)
High-level info about Docker Desktop networking.
Preview:
https://deploy-preview-23626--docsdocker.netlify.app/desktop/features/networking/

Follow-up tasks:
- [ ] tidy up/freshen
https://docs.docker.com/desktop/features/networking/
- [ ] Fix upstream link
2025-11-06 08:57:23 +00:00
Craig Osterhout
86d5f139ef hub: dvp docs update (#23474)
<!--Delete sections as needed -->

## Description

- Added Hub infrastructure as benefit for DVP, and add a visual.
  - Based on existing public info at:
    - https://www.docker.com/trust/availability/
    - https://www.cloudflare.com/case-studies/docker/
- Rearranged topic structure and flesh out the benefits section.
- Added DVP Core GUI and reports to analytics topic
- Added how DVPers can verify no pull limit
- Added that DVP is applied per namespace/org. 

Updated pages:

https://deploy-preview-23474--docsdocker.netlify.app/docker-hub/repos/manage/trusted-content/dvp-program/

https://deploy-preview-23474--docsdocker.netlify.app/docker-hub/repos/manage/trusted-content/insights-analytics/


## Related issues or tickets

ENGDOCS-3020
ENGDOCS-3035

## Reviews

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

- [ ] Editorial review
- [ ] Product review
- [ ] Engineering review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-10-27 12:45:38 -07:00
Paweł Gronowski
772692f0f3 engine/install: deprecate Raspberry Pi OS 32-bit (armhf) support (#23489)
Starting with Docker Engine v29, 32-bit Raspberry Pi OS (armhf) packages
will no longer be provided for new major versions.

<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

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

## Reviews

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

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

---------

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-10-03 11:12:59 +01:00
Michael Irwin
e346b0bcf2 Add a guide for adding pgAdmin to to application stack (#23441)
## Description

Created a new guide that walks users through adding pgAdmin to their
application stack to visualize a PostgreSQL database. Also includes
details on how to auto-connect to the database using Compose config
files.

## Related issues or tickets

None

## Reviews

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

Would appreciate an editorial review, specifically on the usage of
italics/bold around step #4. I believe I followed the editing guidelines
correctly, but a second pair of eyes wouldn't hurt.

Thanks!

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-09-22 11:30:25 -07:00
Marco Franzon
8158dfb501 Add Opentelemetry guide (#23187)
<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

<!-- 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: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
2025-09-09 09:43:03 -04:00
Arthur
c3df922b83 cagent (#23336)
Add cagent docs to open-source section.

---------

Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2025-09-04 15:46:45 +01:00
Craig Osterhout
e8a87205cb dhi: add migration tip (#23327)
<!--Delete sections as needed -->

## Description

Added migration tip to inform existing Docker Hub users that they can
keep using existing workflows and tools when migrating from other images
on Docker Hub.

https://deploy-preview-23327--docsdocker.netlify.app/dhi/get-started/

## Related issues or tickets

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

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-08-31 22:07:49 -07:00
Craig Osterhout
d9ef40f2f9 dhi: add skip-tlog info (#23274)
<!--Delete sections as needed -->

## Description

Added `--skip-tlog` flag info to validate topic.

https://deploy-preview-23274--docsdocker.netlify.app/dhi/how-to/verify/#handle-missing-transparency-log-entries

Vale: Added Rekor to vocab.

## Related issues or tickets

DHI-647

## Reviews

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

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

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-08-27 16:08:18 -07:00
Arthur
20492f8441 mcp: various touch ups (#23251)
Reorder pages in MCP TOC, touch up content, add summary bars, use tabs
where appropriate, etc.
2025-08-20 15:44:19 +02:00
Arthur
26d2041243 chore(vale): build fixes (#23277) 2025-08-20 11:23:38 +02:00
Arthur
f5a8c24b8f vale: delete unwanted styles (#23273) 2025-08-19 17:17:47 +02:00
Allie Sadler
c7f7588084 chore: minor docs fixes (#23270)
<!--Delete sections as needed -->

## Description

Closes
https://github.com/docker/docs/issues/23255#issuecomment-3193651201
adds
https://docker.slack.com/archives/C0105T139BJ/p1755529270222419?thread_ts=1754585623.672069&cid=C0105T139BJ

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-08-19 10:18:39 +01:00
Sarah Sanders
f77ddf3728 freshness: security and subscription (#23230)
<!--Delete sections as needed -->

## Description
Final freshness updates for Security and Subscription pages. Apologies
ahead of time, it is a lot of file updates :')

Updates include:
- Major overhaul of ECI content (this could use the most review)
- Fine tuning of the rest of the docs in these sections (includes
consistency with headings/formatting, page structure, fixing passive
voice, simplifying)
- Deleted all content shortcodes 🥳 

_Vale errors can mostly be ignored unless you see something glaringly
wrong. I addressed all the typo/spelling ones, and added some terms to
accept.txt_

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2918

## Reviews

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

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

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-08-15 15:16:15 -07:00
Arthur
648b55301b fix: fix vale errors (#23218)
<!--Delete sections as needed -->

## Description

Fix Vale and linting errors in AI section.
2025-08-08 10:18:45 +02:00
Arthur
7193d2a882 chore: reduce noice in Vale error reporting (#23146)
Exclude extra release notes from Spelling/Term checks.
Exclude `<a>` from checks.
Add new terms and fix some double space errors.

- Before: 2691
- After: 967
2025-07-24 11:04:55 +02:00
Arthur
4e1d7e3c8d chore: reduce Vale reporting noise (#23142)
Edit Vale config to be more lenient with generated content. 

Number of errors:
- Before: 5473
- After: 2690
2025-07-23 11:10:56 +02:00
Craig Osterhout
194745f522 offload: add initial docs (#22910)
<!--Delete sections as needed -->

## Description

Add initial Docker Offload docs

https://deploy-preview-22910--docsdocker.netlify.app/offload/

https://deploy-preview-22910--docsdocker.netlify.app/reference/cli/docker/offload/

https://deploy-preview-22910--docsdocker.netlify.app/desktop/setup/vm-vdi/

Minor changes
https://deploy-preview-22910--docsdocker.netlify.app/desktop/
https://deploy-preview-22910--docsdocker.netlify.app/
https://deploy-preview-22910--docsdocker.netlify.app/manuals/

Pending sign up page link.

## Related issues or tickets

ENGDOCS-2704

## Reviews

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

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

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-10 12:09:07 +02:00
Arthur
71c77607ed mcp OAuth and VS Code connection (#22904)
Co-authored-by: Daniel Kolev <danibanani.js@gmail.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-07-03 15:04:26 +01:00
Arthur
75160e41de fix: clarify requirements (#22971)
Clarify supported platforms.

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-07-02 10:46:48 +02:00
Sebastiaan van Stijn
b6833c2b1d Merge pull request #22731 from thaJeztah/vale_bgp
vale: add "BGP" (Border Gateway Protocol) to acronyms
2025-07-02 07:58:44 +01:00
Allie Sadler
3ffde2a15b contribute improvement (#22920)
<!--Delete sections as needed -->

## Description

Improvements and additions to the UI elements page of our contribute
section

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-26 09:49:46 +01:00
Esteban Maya
a30fb9e53d EDIT: Update python code guide and include linting, formatting and type checking (#22737)
## Description
* I updated the code in the main Python guide. I noticed some
deprecations in the libraries. I made a refactor and updated the whole
code to be totally up to date with the recent library version
* I added a section about linting, formatting, and type checking to
follow the best practices. I include them in the CI/CD too

@craig-osterhout
@usha-mandya

- [ ] Technical review 
- [ ] Editorial review
- [ ] Product review
2025-06-24 10:23:54 -07:00
Arthur
725e34e85f add platform-split parameter (#22753)
<!--Delete sections as needed -->

## Description

Parameter was missing.

## Related issues or tickets

https://github.com/docker/buildx/issues/3215#issuecomment-2931258854

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-06 14:26:53 +02:00
Arthur
28e68f6af7 chore: delete duplicated vale config (#22767) 2025-06-04 13:02:48 +01:00
Arthur
f18151f86c DMR: plugin install (#22664)
<!--Delete sections as needed -->

## Description

Add DMR Docker Engine plugin install cmd.

## Related issues or tickets

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

## Reviews

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

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

---------

Co-authored-by: Jacob Howard <jacob@xenoscopic.com>
2025-06-03 11:38:48 +02:00
Paweł Gronowski
48faaa886a engine: 28.2.0
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2025-05-28 18:48:20 +02:00
Arthur
6be55cd0d6 dmr: docker model package (#22663)
<!--Delete sections as needed -->

## Description

Add `docker model package`

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

## Related issues or tickets

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

## Reviews

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

- [X] Technical review
- [X] Editorial review
- [ ] Product review
2025-05-19 15:46:10 +02:00
Allie Sadler
4fd64ac50b Compose: spec updates (#22655)
<!--Delete sections as needed -->

## Description

Spec updates on the new attributes released last week (plus some extra -
adds https://github.com/docker/compose/pull/12769 )

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-05-16 14:24:04 +01:00
Sarah Sanders
68fc43e2ef billing: pay by ach transfer (#22473)
<!--Delete sections as needed -->

## Description
- Adds pay by bank account as payment method option
- Adds new section on verifying bank account
- Preview:
https://deploy-preview-22473--docsdocker.netlify.app/billing/payment-method/

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-04-30 12:13:45 -04:00
Paweł Gronowski
a86ab99a21 engine: v28.1.0 (#22438)
<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

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

## Reviews

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

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

---------

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2025-04-17 15:05:52 +01:00