This presentation was created to help you learn where and how to get help with Docker, report or search for issues, and fix small bugs yourself. The last slide was added after the live demo to share the steps you need to follow if you want to fix a bug in an opensource Docker product. If you need more help, come to the Docker forum (https://forums.docker.com) and we will help you to help the community. Please, follow the suggested way in the presentation to ask your questions.
2. Table of contents
I have a problem. Where
and how can I get help?
I have found a bug.
Where can I report it?
Fixing a bug in Docker
Compose v2
Ákos Takács - Getting help, reporting and fixing bugs 1
3. Where can I get help?
Ákos Takács - Getting help, reporting and fixing bugs 2
4. Where can I get help?
Colleagues / Friends
Ákos Takács - Getting help, reporting and fixing bugs 3
5. Where can I get help?
https://www.docker.com/community/
Description of any official
Docker image:
“Where to get help”
https://hub.docker.com/_/nginx
Ákos Takács - Getting help, reporting and fixing bugs 4
6. Where can I get help?
Docker Forum
https://forums.docker.com
Ákos Takács - Getting help, reporting and fixing bugs 5
7. Where can I get help?
StackOverflow / StackExchange
https://stackoverflow.com/questions/tagged/docker
https://devops.stackexchange.com/
Ákos Takács - Getting help, reporting and fixing bugs 6
8. Where can I get help?
https://dockr.ly/slack
Ákos Takács - Getting help, reporting and fixing bugs 7
9. Where can I get help?
https://www.docker.com/support/ (Open a new case)
https://www.docker.com/pricing/contact-sales/
billing@docker.com
Ákos Takács - Getting help, reporting and fixing bugs 8
10. How can I get help?
• Use the language of the forum trying to use correct
spelling
• Share the commands you have run
• Share the expected result
• What is the exact issue, what is the error message?
Clear, detailed description of the issue 1/2
Ákos Takács - Getting help, reporting and fixing bugs 9
11. How can I get help?
• Configuration files without private information
(Dockerfile, docker-compose.yml, config.ini, etc...)
• English operating system with English error messages
(better than translated)
• What have you tried already? (links, commands,
etc…)
Clear, detailed description of the issue 2/2
Ákos Takács - Getting help, reporting and fixing bugs 10
12. How can I get help?
• Avoid disappearing, broken parts of the post
• Avoid broken indentation
• Make sure your thoughts are distinguishable
from inserted codes and outputs
Use code blocks / highlighting
Ákos Takács - Getting help, reporting and fixing bugs 11
13. How can I get help?
Before editing
After editing
Ákos Takács - Getting help, reporting and fixing bugs 12
14. Do not
• …ask for help in private message / e-mail.
• …ask for help in your native language on english forums
• …write
• “experts, I am sure you can solve it in a minute”
• “it’s urgent”
• ”Thanks for nothing…” (be patient, gently remind the forum members)
Ákos Takács - Getting help, reporting and fixing bugs 13
15. Where can I report a bug?
Ákos Takács - Getting help, reporting and fixing bugs 14
16. Where can I report a bug?
Docker
forum
GitHub
Docker
Support
Is it bug?
Ákos Takács - Getting help, reporting and fixing bugs 15
17. Reporting
bugs 1/2
Problems with Docker Hub
• https://github.com/docker/hub-feedback
I don’t know which component is the problem
• https://github.com/docker/for-win
• https://github.com/docker/for-mac
• https://github.com/docker/for-linux
Docker command line interface
• https://github.com/docker/cli
Docker Compose
• https://github.com/docker/compose
BuildX
• https://github.com/docker/buildx
Ákos Takács - Getting help, reporting and fixing bugs 16
18. Reporting
bugs 2/2
Is it in the core?
• https://github.com/moby/moby
Is it in a module like
• https://github.com/moby/buildkit
• https://github.com/moby/vpnkit
Other projects like
• https://github.com/containerd/containerd
Moby Project (“upstream for the Docker Product”)
Ákos Takács - Getting help, reporting and fixing bugs 17
19. Fixing a bug in Docker Compose v2
Ákos Takács - Getting help, reporting and fixing bugs 18
20. Fixing a bug in Docker Compose v2 1/2
• „compose-spec”: The Compose Specification
(https://github.com/compose-spec/compose-spec/blob/master/spec.md)
• Latest Compose release (currently): v2.4.1
• Docker Compose
• compose-spec/compose-go
https://github.com/docker/compose/blob/0dffd5ba9ff571e5cdfa9676a
c961e91ba548ee9/go.mod#L9
• Fixing a bug in Docker Compose
• Testing fixed module in Docker Compose
Ákos Takács - Getting help, reporting and fixing bugs 19
21. Fixing a bug in Docker Compose v2 2/2
• Fork the source code that you want to fix
• Clone the source of Docker Compose in case you want to fix a module
• Build Docker Compose without modified code to test if the bug is still there
• Find the relevant part of the code
• Fix the bug
• Commit the fix (Read the docs or the README file follow the rules)
• Push your modification
• Send a pull request and wait for the approval
Ákos Takács - Getting help, reporting and fixing bugs 20