Commit Graph

196 Commits

Author SHA1 Message Date
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
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