feat: in docker debug support

[dadrus]

There is no related issue. The PR adds the possibility to debug Kratos in Docker. Since my entire local setup is dockerized, I was using this each time I was working on a PR for Kratos. Since I think I'm not the only one having such a setup, I hope the community will find this option useful. If this PR is going to be accepted, I'll extend the documentation on how to make use of it.

Checklist

• I have read the contributing guidelines.
• I am following the contributing code guidelines.
• I have read the security policy.
• I confirm that this pull request does not address a security vulnerability. If this pull request addresses a security. vulnerability, I confirm that I got green light (please contact security@ory.sh) from the maintainers to push the changes.
• I have added tests that prove my fix is effective or that my feature works. (No tests possible)
• I have added or changed the documentation.

[aeneasr]

Thank you! Maybe it makes sense to move this to contrib? On a side note, we usually delimit docker images with - not . :)

[dadrus]

You're welcome. :) Do you mean to move the corresponding code to contrib or to add the corresponding documentation there? Actually, I don't mind. I do however think the places where I put the two files are better suited for the purpose as these are easier to find for the people.
As for the documentation itself I was thinking about the /docs/docs/debug directory, but if you have a better place in mind, please let me know.

[codecov]

Codecov Report

Merging #1789 (26b8c44) into master (9c365ea) will not change coverage.
The diff coverage is n/a.

❗ Current head 26b8c44 differs from pull request most recent head 6bd3d29. Consider uploading reports for the commit 6bd3d29 to get more accurate results

@@           Coverage Diff           @@
##           master    #1789   +/-   ##
=======================================
  Coverage   74.11%   74.11%           
=======================================
  Files         260      260           
  Lines       12770    12770           
=======================================
  Hits         9465     9465           
  Misses       2674     2674           
  Partials      631      631           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9c365ea...6bd3d29. Read the comment docs.

[dadrus]

@aeneasr : I've added documentation as well as a template file for docker-compose based setups. Please take a look.
Where can I reference the new document from, or is it automatically included?

[aeneasr]

Thank you! The last change would be adding the docs to the sidebar :)

https://github.com/ory/kratos/blob/master/docs/sidebar.json

[aeneasr]

Suggested change

	# Debugging Kratos in Docker
	---
	id: debug-docker-delve-ory-kratos
	title: Debugging Ory Kratos in Docker with Delve
	---

[dadrus]

Done

[aeneasr]

🙏