-
Notifications
You must be signed in to change notification settings - Fork 8.1k
Container supported development learning path #20958
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
dvdksn
merged 8 commits into
docker:main
from
mikesir87:container-supported-development-learning-path
Oct 16, 2024
Merged
Changes from 2 commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
11f291c
WIP - add learning path for container-supported development
mikesir87 3dbef3e
Migrate learning path into new guide format
mikesir87 7a4b4d2
Update content/guides/container-supported-development/_index.md
mikesir87 fce7e0a
Update content/guides/container-supported-development/_index.md
mikesir87 2f2e04a
Add correct YT links for the container-supported guide
mikesir87 dacb39e
Merge the guide back into a single page
mikesir87 e6af145
Update container-supported-development.md
mikesir87 49d6412
Update container-supported-development.md
mikesir87 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| --- | ||
| title: "Faster development and testing with container-supported development" | ||
| linkTitle: Container-supported development | ||
| summary: | | ||
| Containers don't have to be just for your app. Learn how to run your app's dependent services and other debugging tools to enhance your development environment. | ||
| description: | | ||
| Use containers in your local development loop to develop and test faster… even if your main app isn't running in containers. | ||
| levels: [beginner] | ||
| params: | ||
| image: images/learning-paths/container-supported-development.png | ||
| skill: Beginner | ||
| time: TBD | ||
| resource_links: [] | ||
| --- | ||
|
|
||
| Containers provide a standardized ability to build, share, and run applications. While containers are typically used to containerize your application, they also make it incredibly easy to run essential services needed for development. Instead of installing or connecting to a remote database, you can easily launch your own database. But the possibilities don't stop there. | ||
mikesir87 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| With container-supported development, you use containers to enhance your development environment by emulating or running your own instances of the services your app needs. This provides faster feedback loops, less coupling with remote services, and a greater ability to test error states. | ||
|
|
||
| And best of all, you can have these benefits regardless of whether the main app under development is running in containers. | ||
|
|
||
| ## What you'll learn | ||
|
|
||
| - The meaning of container-supported development | ||
| - How to connect non-containerized applications to containerized services | ||
| - Several examples of using containers to emulate or run local instances of services | ||
| - How to use containers to add additional troubleshooting and debugging tools to your development environment | ||
|
|
||
| ## Who's this for? | ||
|
|
||
| - Teams that want to reduce the coupling they have on shared or deployed infrastructure or remote API endpoints | ||
| - Teams that want to reduce the complexity and costs associated with using cloud services directly during development | ||
| - Developers that want to make it easier to visualize what's going on in their databases, queues, etc. | ||
| - Teams that want to reduce the complexity of setting up their development environment without impacting the development of the app itself | ||
|
|
||
|
|
||
| ## Tools integration | ||
|
|
||
| Works well with Docker Compose and Testcontainers | ||
|
|
||
|
|
||
| <div id="lp-survey-anchor"></div> | ||
31 changes: 31 additions & 0 deletions
31
content/guides/container-supported-development/common-questions.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: Common challenges and questions | ||
| description: Explore common challenges and questions related to Docker Compose. | ||
| weight: 60 | ||
| --- | ||
|
|
||
| <!-- vale Docker.HeadingLength = NO --> | ||
|
|
||
| ### Can I use containers to run services locally even if my main application isn't containerized? | ||
|
|
||
| Yes! But there's one extra step required - exposing the required ports. Once the required ports are exposed on the host, the non-containerized application can connect to the service running in the container. | ||
|
|
||
| ### What benefits do I gain by running services in containers over other methods (natively installed, VMs, etc.)? | ||
|
|
||
| Containers provide faster startup times and lower resource consumption compared to VMs. By using containers, you have the ability to package and distribute the services and environment your app needs to run, ensuring everyone on your team can get up and going quickly without spending time installing and troubleshooting native installation issues. | ||
|
|
||
| ### Should I worry about emulating services instead of using the real thing during development? | ||
|
|
||
| For many services, such as databases and caches, your application is connecting to the same thing. As an example, your app will use a MySQL database running in a container the same as a managed MySQL database. Therefore, there's no need to worry here. | ||
|
|
||
| When using emulated services, there is always a risk that behavioral differences might occur. Due diligence is required any time you use an emulating service to ensure it has proper tests and is being kept up-to-date with the original service's behaviors. | ||
|
|
||
| ### How does running services in containers speed up development and testing? | ||
|
|
||
| Containers allow developers to quickly spin up and tear down services, enabling rapid testing and iteration without the overhead of managing dependencies or system configurations manually. By running services locally, you are able to decouple your application from remote and potentially shared resources. | ||
|
|
||
| ### How can I run a completely customized service in my development environment? | ||
|
|
||
| Containers allow you to run any service you'd like. To run customized services, you can build and publish your own images and then use them in your development environment. | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
11 changes: 11 additions & 0 deletions
11
content/guides/container-supported-development/demo-additional-tools.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: "Demo: adding additional debug and troubleshooting tools" | ||
| description: Learn how you can easily add additional services to make troubleshooting and debugging of tools much easier | ||
| weight: 50 | ||
| --- | ||
|
|
||
| Once you start using containers in your development environment, it becomes much easier to add additional containers to visualize the contents of the databases or message queues, seed document stores, or event publishers. In this demo, you'll see a few of these examples, as well as how you can connect multiple containers together to make testing even easier. | ||
|
|
||
| {{< youtube-embed 2EqarOM2V4U >}} | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
13 changes: 13 additions & 0 deletions
13
content/guides/container-supported-development/demo-cloud.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| --- | ||
| title: "Demo: developing the cloud locally" | ||
| description: Learn how you can develop and test against cloud services without actually needing to use the cloud | ||
| weight: 40 | ||
| --- | ||
|
|
||
| When developing apps, it's often easier to outsource aspects of the application to cloud services, such as Amazon S3. However, connecting to those services in local development introduces IAM policies, networking constraints, and provisioning complications. While these requirements are important in a production setting, they complicate development environments significantly. | ||
|
|
||
| With container-supported development, you can run local instances of these services during development and testing, removing the need for complex setups. In this demo, you'll see how LocalStack makes it easy to develop and test applications entirely from the developer's workstation. | ||
|
|
||
| {{< youtube-embed 2EqarOM2V4U >}} | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
11 changes: 11 additions & 0 deletions
11
content/guides/container-supported-development/demo-databases.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: "Demo: running databases locally" | ||
| description: Learn how you can run databases in a container | ||
| weight: 20 | ||
| --- | ||
|
|
||
| With container-supported development, it's easy to run databases locally. In this demo, you'll see how to do so, as well as how to connect a non-containerized application to the database. | ||
|
|
||
| {{< youtube-embed 2EqarOM2V4U >}} | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
13 changes: 13 additions & 0 deletions
13
content/guides/container-supported-development/demo-mock-apis.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| --- | ||
| title: "Demo: mocking API endpoints" | ||
| description: Learn how you can mock API endpoints with containers | ||
| weight: 30 | ||
| --- | ||
|
|
||
| Many APIs require data from other data endpoints. In development, this adds complexities such as the sharing of credentials, uptime/availability, and rate limiting. Instead of relying on those services directly, your application can interact with a mock API server. | ||
|
|
||
| This demo will demonstrate how using WireMock can make it easy to develop and test an application, including the APIs various error states. | ||
|
|
||
| {{< youtube-embed 2EqarOM2V4U >}} | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| title: What is container-supported development? | ||
| description: Learn what container-supported development is and what it looks like | ||
| weight: 10 | ||
| --- | ||
|
|
||
| Container-supported development is the idea of using containers to enhance your development environment by running local instances or emulators of the services your application relies on. Once you're using containers, it's easy to add additional services to visualize or troubleshoot what's going on in your services. | ||
|
|
||
| {{< youtube-embed 2EqarOM2V4U >}} | ||
|
|
||
| <div id="container-supported-development-lp-survey-anchor"></div> |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.