diff --git a/content/guides/container-supported-development.md b/content/guides/container-supported-development.md new file mode 100644 index 00000000000..4a506b7d986 --- /dev/null +++ b/content/guides/container-supported-development.md @@ -0,0 +1,76 @@ +--- +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 + time: 20 mins + resource_links: [] +--- + +Containers offer a consistent way to build, share, and run applications across different environments. 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. + +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 + +## Modules + +### What is container-supported development? + +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 pNcrto_wGi0 >}} + +### Demo: running databases locally + +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 VieWeXOwKLU >}} + +### Demo: mocking API endpoints + +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 VXSmX6f8vo0 >}} + +### Demo: developing the cloud locally + +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 JtwUMvR5xlY >}} + +### Demo: adding additional debug and troubleshooting tools + +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 TCZX15aKSu4 >}} + +
\ No newline at end of file diff --git a/content/guides/container-supported-development/_index.md b/content/guides/container-supported-development/_index.md deleted file mode 100644 index 5056b6d91d8..00000000000 --- a/content/guides/container-supported-development/_index.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -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 - time: TBD - resource_links: [] ---- - -Containers offer a consistent way to build, share, and run applications across different environments. 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. - -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 - - -
\ No newline at end of file diff --git a/content/guides/container-supported-development/common-questions.md b/content/guides/container-supported-development/common-questions.md deleted file mode 100644 index 596dda2f74c..00000000000 --- a/content/guides/container-supported-development/common-questions.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Common challenges and questions -description: Explore common challenges and questions related to Docker Compose. -weight: 60 ---- - - - -### 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. - -
diff --git a/content/guides/container-supported-development/demo-additional-tools.md b/content/guides/container-supported-development/demo-additional-tools.md deleted file mode 100644 index 35a1cc1f1b0..00000000000 --- a/content/guides/container-supported-development/demo-additional-tools.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -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 TCZX15aKSu4 >}} - -
diff --git a/content/guides/container-supported-development/demo-cloud.md b/content/guides/container-supported-development/demo-cloud.md deleted file mode 100644 index f3a3c8300ef..00000000000 --- a/content/guides/container-supported-development/demo-cloud.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -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 JtwUMvR5xlY >}} - -
diff --git a/content/guides/container-supported-development/demo-databases.md b/content/guides/container-supported-development/demo-databases.md deleted file mode 100644 index d125f5a321f..00000000000 --- a/content/guides/container-supported-development/demo-databases.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -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 VieWeXOwKLU >}} - -
diff --git a/content/guides/container-supported-development/demo-mock-apis.md b/content/guides/container-supported-development/demo-mock-apis.md deleted file mode 100644 index a3ec9403797..00000000000 --- a/content/guides/container-supported-development/demo-mock-apis.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -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 VXSmX6f8vo0 >}} - -
diff --git a/content/guides/container-supported-development/why.md b/content/guides/container-supported-development/why.md deleted file mode 100644 index b498e1db1af..00000000000 --- a/content/guides/container-supported-development/why.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -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 pNcrto_wGi0 >}} - -