Commit Graph

184 Commits

Author SHA1 Message Date
Sebastiaan van Stijn 196062f3a1
remove references to EOL distros and images (#22674)
- replace some examples using EOL alpine versions
- replace some examples using EOL ubuntu 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: Sebastiaan van Stijn <github@gone.nl>
2025-05-21 07:52:04 +01:00
Pradumna Saraf 71109d5f42
docs: Update incorrect port in Docker Compose the go-prometheus-monitoring guide (#22614)
<!--Delete sections as needed -->

## Description

The app service port is `8000`, and I mistakenly mentioned `8080` for
health check while creating this guide. So, it will give an error.

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-05-12 09:48:17 -07:00
Kristiyan Velkov 9084d496e6
docs: added a guide for Dockerized React.js 19 application (#22375)
## Description

This PR introduces a comprehensive, language-specific guide for
containerizing React.js applications using Docker, aimed at helping
developers streamline development, testing, and deployment workflows. It
includes practical steps and examples to set up CI/CD pipelines using
GitHub Actions, aligning with modern DevOps best practices.

**What’s Included**
- Step-by-step instructions to containerize React.js apps using Docker.
- Configuration for a local development environment inside containers.
-  Guidance on running unit tests inside Docker containers.
- Full CI/CD pipeline setup using GitHub Actions for automated builds
and deployments.
- Deployment instructions for a local Kubernetes cluster to validate
production readiness.

 **Credits**
[Krisityan
Velkov](https://www.linkedin.com/in/kristiyan-velkov-763130b3/), Docker
Captain and experienced Front-end Engineer.

---------

Co-authored-by: kristiyan.velkov <kristiyan.velkov@ffw.com>
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-04-24 07:24:22 -07:00
Pradumna Saraf 3a056687f7
docs: add a guide for Golang API Monitoring with Prometheus and Grafana (#22292)
<!--Delete sections as needed -->

## Description

add a guide for Golang API Monitoring with Prometheus and Grafana

## Related issues or tickets

#22291

## Reviews

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

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

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-04-03 11:11:18 -07:00
Bokyeom 7c9f78cda8
Fix typos and align with Docker/Compose specs (#22328)
## Description
- Fixed minor typos like `msyql`, `model`, `.json|`.
- Although `docker remove` works due to CLI fallback, it's not an
official command. Replaced with `docker rm` for correctness and clarity.
- Replaced `docker-compose.yml` with `compose.yaml` to align with the
[Compose
specification.](https://github.com/compose-spec/compose-spec/blob/main/03-compose-file.md)
2025-03-31 08:44:57 +01:00
Marco Franzon 3910565912
Add dex guide (#21926)
<!--Delete sections as needed -->

## Description

In this guide I want to show how to run and configure Dex as container,
to mock an OAuth service, which can be really useful in
development/testing.

## 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>
2025-03-27 13:45:28 -07:00
Bokyeom d16a610c42
fix: replace docker-compose with docker compose CLI (#22320)
## Description

Replace `docker-compose` with `docker compose` CLI in the Java and
Node.js guides to align with the latest Docker standards and ensure
consistency across the docs.

## Related issues or tickets

Closes #22319

<!-- Related issues, pull requests, or Jira tickets -->
2025-03-27 10:28:19 -07:00
happy2discover 81fe132daa
Update develop.md for highlighted lines​ (#22290)
<!--Delete sections as needed -->

## Description
Update develop.md for highlighted lines​

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

## Related issues or tickets
N/A

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-03-24 22:02:23 -04:00
Craig Osterhout 592b28729b
guides: fix port in .net guide (#22269)
<!--Delete sections as needed -->

## Description

The default port changed from 80 to 8080 when we switched to a newer
version of .net in #21877.

https://learn.microsoft.com/en-us/dotnet/core/compatibility/containers/8.0/aspnet-port


https://deploy-preview-22269--docsdocker.netlify.app/guides/dotnet/develop/

https://deploy-preview-22269--docsdocker.netlify.app/guides/dotnet/deploy/

## Related issues or tickets

Closes #22265
Related to #22080
ENGDOCS-2492

## Reviews

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

- [ ] Technical review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-03-17 15:33:50 -07:00
Craig Osterhout a7a2a5217e
hub: sidebar nav (#22123)
<!--Delete sections as needed -->

## Description

Updated Hub nav items to new left nav.


![image](https://github.com/user-attachments/assets/30fc20be-d999-426e-bef6-55cd535d5735)


## Related issues or tickets

ENGDOCS -2447

## Reviews

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

- [ ] Editorial review
- [ ] Product review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-03-17 10:07:57 -07:00
Igor Aleksandrov c3431b0474
Rails guide upgrade (part 2) (#22114)
## Description

This PR has two goals. First of all it continues work that has been done
in #21559. Besides this, and this is more significant, I tried to
improve the structure of the documentation that is currently used for
different language-specific guides like
[PHP](https://docs.docker.com/guides/php/configure-ci-cd/),
[Go](https://docs.docker.com/guides/golang/),
[Python](https://docs.docker.com/guides/python/) and others, including,
of course, Ruby itself.

Each of these guides currently has a [Configure
CI/CD](https://docs.docker.com/guides/python/configure-ci-cd/) section.
Inside this section there is a GitHub Actions workflow example that has
nothing in common with a CI/CD pipeline. It's just an example of how to
build and push an image to a Docker Hub registry. We should be clear in
our documentation and not mislead our users. This was the main reason
why I renamed this section to "Automate your builds with GitHub
Actions". I also updated the content of this section to reflect the new
name and to make it more clear what the user can expect from this guide.
I suggest the same be done for all other language-specific guides.

Besides this, I changed the order of the sections in the Ruby guide. The
"Develop your app" section has been moved down to the bottom of the
guide. This makes more sense to me because of two reasons:

1. It is more important to start using Docker Hub right after you added
the Dockerfile to your project (section number one in all
language-specific guides).

2. I can hardly imagine anybody using Docker to run the app locally for
development purposes (at least for Ruby). What is really essential and
useful is to know how to run services, that are required by your app,
like a database, a cache server, or a local LLM. This is why the
"Develop your app" section should be rewritten to explain how to run the
infrastructure services that are required by the app and not the app
itself.

Below there are screenshots reflecting the changes that have been made
in this PR.

**Before**
<img width="1512" alt="Screenshot 2025-02-27 at 11 26 39"
src="https://github.com/user-attachments/assets/1ca06aea-ffeb-4efb-a14d-27254d2a2110"
/>

**After** 
<img width="1512" alt="Screenshot 2025-02-27 at 11 26 01"
src="https://github.com/user-attachments/assets/7abbe8b7-d1b3-480f-8105-49f967b51e47"
/>

## Related issues or tickets

#21559

## Reviews

- [x] Technical review
- [x] Editorial review
- [ ] Product review
2025-03-12 08:08:51 -07:00
Michael Irwin a4237dac3d
Update image source for kafbat
Kafbath publishes its images to Docker Hub, so changing the registry source to Hub instead of GHCR. Also, instead of using the latest tag, they publish merged changes onto a `main` tag.
2025-03-10 14:53:44 -04:00
Igor Aleksandrov eecf21f26e
Change directory after pulling a sample Docker application (#22179)
## Description

This PR updates `git clone` command for sample repositories with `&& cd
<repo name>`. Forcing to change the working directory should reduce the
risk of forgetting to do.

## Related issues or tickets

## Reviews

@usha-mandya 

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-03-06 08:39:12 -08:00
Allie Sadler eb331a22df
Merge pull request #22117 from aevesdocker/ENGDOCS-2451
ENGDOCS-2451
2025-03-06 14:45:54 +00:00
Sarah Sanders 79d037dc5a
Merge pull request #22160 from sarahsanders-docker/tcc-minutes
subscription: add callout about TCC minutes rollovers
2025-03-05 11:10:13 -05:00
Ville Skyttä ae3eec2c70
docs: grammar and spelling fixes (#22136)
<!--Delete sections as needed -->

## Description

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

Fix a few grammar and spelling errors.


## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-02-28 14:13:37 -08:00
Mohammad-Ali A'RÂBI 25d4796019
Add multi-stage builds to the C++ guide (#21562)
## Description

Having a multi-stage build is an essential thing to learn for
containerizing a compiled language.

## Related issues or tickets

N/A

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-02-27 09:24:01 -08:00
Craig Osterhout 5138abac63
guides: fix layout (#22118)
<!--Delete sections as needed -->

## Description

There were a couple leftover buttons from when the layout changed and
the buttons became auto-generated. Removed the buttons.

## 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-02-27 08:51:59 -08:00
Igor Aleksandrov 123f79504d
Added missing article on multiple pages (#22098)
## Description

In this PR I added an article that was missing from several similar
pages.

## Reviews

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-02-25 09:35:37 +00:00
Roberto Robles 48084c86e5
Update develop.md
Server port is incorrect, due this issue server cannot be available at http://localhost:8080/
2025-02-21 14:55:48 -06:00
Expeto ceafe3f998
new genai rag guide (#21703)
## Description
Added a new guide about RAG with genAI which also explains how RAG
actually work

## Reviews



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

---------

Signed-off-by: Your Name <you@example.com>
Co-authored-by: Your Name <you@example.com>
Co-authored-by: Baransel SAGINDA <redirecter2@gmail.com>
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-13 14:45:03 -08:00
Craig Osterhout ebb2fe4e34
Merge pull request #21893 from Pradumnasaraf/add-deno
docs: Add language-specific guide for Deno runtime
2025-02-13 10:44:52 -08:00
Craig Osterhout 62f8262a70
Update content/guides/deno/develop.md 2025-02-13 10:38:57 -08:00
Craig Osterhout f7014d35ff
Update content/guides/deno/containerize.md 2025-02-13 10:38:51 -08:00
Pradumna Saraf 75a7f4e338
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:38 +05:30
Pradumna Saraf 79fd794564
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:30 +05:30
Pradumna Saraf 188562628e
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:19 +05:30
Pradumna Saraf 74e0931e5b
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:11 +05:30
Pradumna Saraf 223d348ddc
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:04 +05:30
Pradumna Saraf 139fce8441
Update content/guides/deno/configure-ci-cd.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:56 +05:30
Pradumna Saraf 996ff65807
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:51 +05:30
Pradumna Saraf aee0079f97
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:43 +05:30
Sarah Sanders d083617e9d
fix: update include.html for heading error (#21906)
## Description
- Problem: Some include shortcodes produce missing H3 ToC headings (ex:
https://docker.slack.com/archives/C039ZM6GH4Z/p1737545677728649)
- Fix: Update to include.html uses Hugo readFile function to fix parsing
errors and updated all include shortcodes using Find and Replace to use
correct syntax: `{{% "include-file" %}}`

## Related issues or tickets
-
[ENGDOCS-2398](https://docker.atlassian.net/browse/ENGDOCS-2398?atlOrigin=eyJpIjoiZGE3OTBmY2ExOTliNDVjY2JlOTc4Y2ViY2MwNDI3NDEiLCJwIjoiaiJ9)

## Reviews
- [ ] Technical review

[ENGDOCS-2398]:
https://docker.atlassian.net/browse/ENGDOCS-2398?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
2025-01-29 07:31:40 -08:00
Benoit de Chezelles 0f6df87ef1 guides: Fix cert extension to be auto-added by update-ca-certificates 2025-01-29 13:09:32 +01:00
Brandon Hunt e536caae57
Merge pull request #21877 from brandonh6k/main
Update dotnet to .NET 8.0 (LTS)
2025-01-27 11:33:29 +01:00
Pradumna Saraf 9e5c09a5a1
fix: update repository URL in Deno guides to point to the correct source 2025-01-24 16:41:30 +05:30
Pradumna Saraf 935c0d4a49
docs: add Deno getting started guide with containerization and deployment instructions 2025-01-24 16:36:53 +05:30
Allie Sadler 228cc0f586
Engdocs 2329 (#21847)
<!--Delete sections as needed -->

## Description

Admin guide on user and access management

## 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-01-23 15:51:08 +00:00
Igor Alexandrov 98972aa72d Added libyaml-dev to the Rails Dockerfile example 2025-01-15 10:52:03 +04:00
Igor Klimer f42a4ccabe
Fix typo in Java guide for running tests (#21816)
## Description

Fix typo when targeting the `test` stage - it was mentioning a
non-exisiting `--target-test` parameter which could confuse new users:
`unknown flag: --target-test`.
It should be `--target test` or `--target=test`. I went with `--target
test` since that's what is used in the rest of the guide.


## Related issues or tickets

Introduced in https://github.com/docker/docs/pull/19390

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-01-14 14:54:01 -08:00
David Karlsson 644f43d5c9
Merge pull request #21134 from Pradumnasaraf/repo-link-update
docs: Update links to cpp, bun sample repositories
2025-01-14 15:03:41 +01:00
Igor Aleksandrov d7ffb99825
Rails guide upgrade (part 1) (#21559)
## Description

This PR upgrades the Rails framework guide and covers the application
containerization step. In the following PRs, I will update the section
about deploying with Docker Compose, and add a new "Deployment with
Kamal" section.

## Reviews

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-01-14 11:09:18 +01:00
David Karlsson d08fe30d96
Merge pull request #21276 from rw4lll/laravel-compose
Laravel + Docker guide
2025-01-13 14:44:35 +01:00
Sergei Shitikov acf46fb75f guides: Add Docker+Laravel example
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-13 14:42:02 +01:00
Craig Osterhout c808c6fc40
guides: clarify instruction (#21783)
<!--Delete sections as needed -->

## Description

Clarify instruction so users know that the provided file needs to
edited.

## Related issues or tickets

hotjar-12673

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-01-10 15:58:29 -08:00
David Karlsson f062709f4b redirects: add alias for /guides/language/
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-20 16:47:35 +01:00
Michael Irwin 29a1c25cfc Add links to other guides in container-supported development guide
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-18 15:08:03 +01:00
Sarah Sanders 316115fc76
add docker consolidated subscriptions (#21476)
<!--Delete sections as needed -->

## Description

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

## Related issues or tickets

- https://docker.atlassian.net/browse/HD-2066

## Reviews

Final sign offs in Notion doc

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Co-authored-by: Oleg Burov <ob1dev@icloud.com>
2024-12-10 08:37:56 -08:00
David Karlsson b2264d26cb guides: add cross-references to gha intro guide
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-06 12:55:49 +01:00
David Karlsson 8cd992531d guides: docker build github actions primer
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-05 10:05:05 +01:00