https://github.com/oleg-nenashev/mocks-as-code-demo
Demo for the Infrastructure-as-Code in Java
https://github.com/oleg-nenashev/mocks-as-code-demo
gradle infrastructure-as-code localstack pulumi testcontainers wiremock
Last synced: 18 days ago
JSON representation
Demo for the Infrastructure-as-Code in Java
- Host: GitHub
- URL: https://github.com/oleg-nenashev/mocks-as-code-demo
- Owner: oleg-nenashev
- License: apache-2.0
- Created: 2024-05-12T06:22:44.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-05-14T11:55:34.000Z (12 months ago)
- Last Synced: 2025-03-29T06:43:08.854Z (about 1 month ago)
- Topics: gradle, infrastructure-as-code, localstack, pulumi, testcontainers, wiremock
- Language: Java
- Homepage:
- Size: 320 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Mocks as Code for Configuration Management. Demo
Can you do full-stack development with Java? You can!
And what about full-stack platform engineering? You can do it too!
In this demo, we build a full-Java implementation for all key aspects of an application:
- The application itself - Spring Boot
- Build automation - Gradle Build Tool, aka Gradle
- Test automation - with Testcontainers, WireMock, LocalStack and other Java tools
- Configuration Management - with [Pulumi for Java](https://www.pulumi.com/docs/languages-sdks/java/)
- All the build logic - with [Gradle Build Tool](https://gradle.org/), a.k.a Gradle.
We will also use [Gradle Build Scan](https://docs.gradle.org/current/userguide/build_scans.html) for troubleshooting
the Pulumi SDK issues.
This demo is created for the Mocks as Code workshop by Oleg Nenashev.
The same demo setup can be implemented purely in Kotlin,
Golang, Python or any other language supported by Pulumi and Testcontainers.
## Presentation
The presentation for this workshop can be found
[here](https://speakerdeck.com/onenashev/workshop-mocks-as-code-in-cfg-mgmt)
## Prerequisites
- Java 17
- IDE of your choice, tested on Intellij IDEA and VS Code
- Installed Pulumi CLI application and a created account
([Installation Guide](https://www.pulumi.com/docs/install/))
- Testcontainers-compatible Docker Engine, preferably Docker Desktop
(see the requirements [here](https://www.testcontainers.org/supported_docker_environment/))
- Free-tire account on [Gradle Build Scan / Develocity](https://scans.gradle.com/)
For Java tools, consider using [sdkman](https://sdkman.io/) for the demo to make it easier:
```shell
sdk env install
sdk env
```
## Workshop Steps
1. Setting up the environment
2. Testing AWS Service Integrations using LocalStack and Testcontainers,
similar to [this guide](https://testcontainers.com/guides/testing-aws-service-integrations-using-localstack/)
3. Mocking service APIs with WireMock
4. Infrastructure-as-Code with Pulumi and Pulumi SDK for Java, and using the same stack for
Pulumi deployment integration testing
5. Advanced troubleshooting and observability of the configurations with Gradle Build Scan
## Credits
The code implementation is based on the
[aws-java-webserver](https://github.com/pulumi/examples/blob/master/aws-java-webserver)
example from [pulumi/examples](https://github.com/pulumi/examples/).
Some bits of the demo are inspired by [Pulumi CLI fo LocalStack](https://github.com/localstack/pulumi-local) wrapper,
which is adapted inside the integration test.
The bits of the demo will be converted to a Java implementation for it,
contributions are welcome!
## Read More
- [Infrastructure as Code with Java and Pulumi](https://www.pulumi.com/blog/announcing-infrastructure-as-code-with-java-and-pulumi/) by Mikhail Shilkov
- [Unit testing Pulumi programs](https://www.pulumi.com/docs/using-pulumi/testing/unit/)
- [Integration testing for Pulumi programs](https://www.pulumi.com/docs/using-pulumi/testing/integration/)
- [Local Testing With Pulumi](https://www.pulumi.com/blog/local-testing-with-pulumi/)
- [Using Pulumi with LocalStack](https://docs.localstack.cloud/user-guide/integrations/pulumi/)
- [Pulumi and LocalStack — beyond the basics](https://delitescere.medium.com/pulumi-and-localstack-beyond-the-basics-d993f3b94d17) by Josh Graham
- [Testing AWS service integrations using LocalStack](https://testcontainers.com/guides/testing-aws-service-integrations-using-localstack/)
## When something fails
To force kill the Pulumi stack:
```shell
pulumi stack rm --force oleg-nenashev/mocks-as-code/mocks-as-code-demo
```
## License
Most of the code is licensed under the Apache License v2,
unless specified differently.
The application code is based on the [Testing AWS Service Integrations using LocalStack](https://github.com/testcontainers/tc-guide-testing-aws-service-integrations-using-localstack) demo,
and, hence, it uses the MIT License.