https://github.com/testcontainers/tc-guide-testcontainers-lifecycle
Testcontainers LifeCycle Guide
https://github.com/testcontainers/tc-guide-testcontainers-lifecycle
Last synced: 3 months ago
JSON representation
Testcontainers LifeCycle Guide
- Host: GitHub
- URL: https://github.com/testcontainers/tc-guide-testcontainers-lifecycle
- Owner: testcontainers
- License: mit
- Created: 2023-02-20T04:11:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-26T19:39:21.000Z (over 1 year ago)
- Last Synced: 2024-05-22T18:20:24.288Z (about 1 year ago)
- Language: Java
- Size: 204 KB
- Stars: 2
- Watchers: 8
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Testcontainers LifeCycle Guide
This is sample code for [Testcontainers LifeCycle Guide](https://testcontainers.com/guides/testcontainers-container-lifecycle) guide.
## 1. Setup Environment
Make sure you have Java 8+ and a [compatible Docker environment](https://www.testcontainers.org/supported_docker_environment/) installed.
If you are going to use Maven build tool then make sure Java 17+ is installed.
For example:
```shell
$ java -version
openjdk version "17.0.4" 2022-07-19
OpenJDK Runtime Environment Temurin-17.0.4+8 (build 17.0.4+8)
OpenJDK 64-Bit Server VM Temurin-17.0.4+8 (build 17.0.4+8, mixed mode, sharing)
$ docker version
...
Server: Docker Desktop 4.12.0 (85629)
Engine:
Version: 20.10.17
API version: 1.41 (minimum version 1.12)
Go version: go1.17.11
...
```
## 2. Setup Project
* Clone the repository
```shell
git clone https://github.com/testcontainers/tc-guide-testcontainers-lifecycle.git
cd tc-guide-testcontainers-lifecycle
```
* Open the **tc-guide-testcontainers-lifecycle** project in your favorite IDE.
## 3. Run Tests
Run the command to run the tests.
```shell
$ ./gradlew test //for Gradle
$ ./mvnw verify //for Maven
```
The tests should pass.
> [!NOTE]
> The project is configured to automate the code formatting with spotless plugin
> using prettier-plugin-java, which internally requires Node.js runtime.
> If you don't have Node.js installed and want to disable the code formatting,
> you can pass additional parameter to the build command as shown below:
```shell
./gradlew build -x spotlessCheck //for Gradle
./mvnw verify -Dspotless.check.skip=true //for Maven
```