diff --git a/public/img/blog/2024/10/ddev-debug-test-banner.png b/public/img/blog/2024/10/ddev-debug-test-banner.png new file mode 100644 index 00000000..968e28b3 Binary files /dev/null and b/public/img/blog/2024/10/ddev-debug-test-banner.png differ diff --git a/src/content/blog/contributor-training.md b/src/content/blog/contributor-training.md index 24ce8b47..09b26f0a 100644 --- a/src/content/blog/contributor-training.md +++ b/src/content/blog/contributor-training.md @@ -1,7 +1,7 @@ --- title: "DDEV Contributor Live Training" pubDate: 2023-07-09 -modifiedDate: 2024-09-19 +modifiedDate: 2024-10-17 summary: Live contributor training is available for those who want to learn to contribute and maintain DDEV. author: Randy Fay featureImage: @@ -60,13 +60,13 @@ Live training sessions will be held weekly on Tuesdays at 8am US MT, 5pm CET or | 2024-07-10 | [Advanced Add-on Techniques](advanced-add-on-contributor-training.md) | | 2024-07-24 | [DDEV Docker Image Maintenance](ddev-docker-image-maintenance.md) | | 2024-09-18 | [Maintaining DDEV Automated Tests](maintaining-ddev-tests-contributor-training.md) | +| 2024-10-12 | [Using `ddev debug test` to support others](ddev-debug-test-contributor-training.md) | **Upcoming Trainings:** * Hostname Resolution and Debugging in DDEV -* Using AI in DDEV Development (Continue.dev, etc.) -* Interpreting `ddev debug test` To Support Users +* Using AI in DDEV Development (ChatGPT, Continue.dev, etc.) * Implementing a New DDEV Project Type * Managing and Maintaining DDEV Docs (Readthedocs.io, etc.) * Using Tmate to Debug GitHub Workflows diff --git a/src/content/blog/ddev-debug-test-contributor-training.md b/src/content/blog/ddev-debug-test-contributor-training.md new file mode 100644 index 00000000..2cb8d5de --- /dev/null +++ b/src/content/blog/ddev-debug-test-contributor-training.md @@ -0,0 +1,44 @@ +--- +title: "Contributor Training: Using `ddev debug test` to support others" +pubDate: 2024-10-12 +# modifiedDate: 2024-10-12 +summary: Contributor training - interpreting and using `ddev debug test` to support others. +author: Randy Fay +featureImage: + src: /img/blog/2024/10/ddev-debug-test-banner.png + alt: Using `ddev debug test` to support others +categories: + - Training + - Guides +--- + + +Here's our October 9, 2024 [Contributor Training](/blog/category/training) on using `ddev debug test` to help other users: + +
+ +
+ +## What is `ddev debug test` anyway? + +`ddev debug test` is really just a [shell script](https://github.com/ddev/ddev/blob/master/cmd/ddev/cmd/scripts/test_ddev.sh) embedded in the `ddev` binary that tries to answer all the questions we've learned to ask in support sessions in our [DDEV Discord channel](https://discord.com/invite/5wjP76mBJD) and the [issue queue](https://github.com/ddev/ddev/issues). There are so many different things that can affect people's DDEV experience, and asking the questions one by one is hard. So when people just run that one command and we can read through the results, it's a big win. + +## What does it check? + +* DDEV version, architecture +* Docker provider and configuration +* Operating system and context +* Project configuration and specialized configuration +* Network connectivity inside and outside the container, and DNS name lookup + +`ddev debug test` will often suggest what's going wrong with a person's DDEV/Docker/OS setup, making sure we know what version they're using and what context they're using it in. + +## How can I contribute to it? + +Add to the script with a PR. Make sure you've manually tested it. + +## Contributions welcome! + +Your suggestions to improve this blog are welcome. You can do a PR to this blog adding your techniques. Info and a training session on how to do a PR to anything in ddev.com is at [DDEV Website For Contributors](ddev-website-for-contributors.md). + +Join us for the next [DDEV Live Contributor Training](/blog/contributor-training/). Sign up at [DDEV Live Events Meetup](https://www.meetup.com/ddev-events/events/).