Commit Graph

199 Commits

Author SHA1 Message Date
Kristiyan Velkov 4ba5ea0554
added a guide for Dockerized Vue.js application (#22776)
This PR delivers a Vue.js focused guide for containerizing applications
using Docker, aimed at streamlining development, testing, and deployment
workflows. It follows modern DevOps practices and includes a complete
CI/CD setup using GitHub Actions.

## What's Included

- Step-by-step Docker setup for Vue.js applications  
- Local development configuration using Docker Compose  
- Running unit tests (Vitest) inside Docker containers  
- CI/CD pipeline using GitHub Actions for automated builds and
deployments
- Deployment instructions for a local Kubernetes cluster to validate
production readiness
- [fix] for Angular develop docker file.

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

CC: @craig-osterhout, @igor-alexandrov, @ajeetraina
2025-08-04 09:09:27 -07: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
Allie Sadler d4ce08a39c
enterprise: move content (#23100)
<!--Delete sections as needed -->

## Description

Part of https://docker.atlassian.net/browse/ENGDOCS-2836

## 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-07-18 07:49:29 +01:00
Sarah Sanders 5dd8bad4e7
restore Enterprise docs changes (#23094)
Reverts docker/docs#23091 to restore Enterprise doc changes
2025-07-14 17:16:32 -04:00
Sarah Sanders 50c2a3b141
Revert "Enterprise docs section" (#23091)
Reverts docker/docs#23083
2025-07-14 16:36:46 -04:00
Allie Sadler 79d3d6f127
Enterprise docs section (#23083)
<!--Delete sections as needed -->

## Description

As per https://docker.atlassian.net/browse/ENGDOCS-2836

Next up:
 - tidy up/ split the security FAQs
 - move the 'for developers' content up one level
 - beef up the Deploy DD page
 - AOB

(didn't want to include in this PR as it's already too long)

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-14 16:13:54 +01:00
Craig Osterhout 64d94c9a03
guides: add agentic guide (#22937)
<!--Delete sections as needed -->

## Description

Add agentic guide
https://deploy-preview-22937--docsdocker.netlify.app/guides/agentic-ai/

## Related issues or tickets

ENGDOCS-2770

Depends on:
- https://github.com/docker/docs/pull/22935
- https://github.com/docker/docs/pull/22910

## Reviews

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

- [ ] Technical review
- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
Co-authored-by: aevesdocker <allie.sadler@docker.com>
2025-07-10 12:41:27 +02:00
Allie Sadler 17b215a065
Desktop: changes to settings button (#22898)
<!--Delete sections as needed -->

## Description

Changes **Apply & restart** to **Apply**

## 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-07-03 14:29:12 +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
Sarah Sanders a4d2113313
fix: highlighting in code blocks (#22836)
## Description
- Highlighted lines for code blocks in dark mode are not rendering
correctly

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

## Reviews
- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-16 11:15:12 -04:00
Kristiyan Velkov ae2a14a545
[feat] added azure pipelines guide (#22777)
This PR introduces a new CI pipeline using Azure Pipelines to automate
the process of building and pushing Docker images to Docker Hub.

---------

Co-authored-by: Julien Maitrehenry <julien.maitrehenry@me.com>
2025-06-16 14:56:00 +01:00
Sarah Sanders 677533d169
Merge pull request #22775 from sarahsanders-docker/billing-remove-plan
chore: remove plan from docs
2025-06-06 09:24:17 -04:00
Igor Aleksandrov e74a8d72a6
Added Configure GitHub Actions step to the Python guide (#22676)
## Description

Replaced "Configure CI/CD" step of the Python guide with "Configure
GitHub Actions" step to have it similar structure as the Rails guide.

## Related issues or tickets

#22114 

## Reviews

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-06-05 07:40:07 -07:00
Sergei Shitikov d89e8383ce
Update Laravel guide (bump to Laravel 12 and php 8.4) (#22699)
<!--Delete sections as needed -->

## Description

Introduces small update of the Laravel framework guide (bump versions to
the latest Laravel 12 and php 8.4 + updates the related examples repo -
the fork needs to be synced).

## Related issues or tickets

#21268 

## Reviews

<!-- Notes for reviewers here -->
As was discussed on the last docs meeting, to simplify the process the
review will be sent to the one of Docker Captains first.
@igor-alexandrov @ajeetraina 

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-05-28 11:15:14 -07:00
Kristiyan Velkov f23f120cd6
docs: added a guide for Dockerized Angular 19 application (#22535)
This PR introduces a comprehensive, language-specific guide for
containerizing Angular 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 Angular apps using Docker
- Configuration for a local development environment inside containers
- Guidance on running unit tests (Karma/Jasmine) 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**
[Kristiyan
Velkov](https://www.linkedin.com/in/kristiyan-velkov-763130b3/), Docker
Captain and experienced Front-end Engineer
2025-05-27 14:46:31 -07:00
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