-
Using
- Importing Services & APIs
- Comparison to alternatives
- OpenAPI Mocking and Testing
- Swagger Mocking and Testing
- AsyncAPI Mocking and Testing
- Postman usage for Microcks
- gRPC Mocking and Testing
- GraphQL Mocking and Testing
- SoapUI Mocking and Testing
- Http Archive usage for Microcks
- Using exposed mocks
- Getting direct API
- Testing with Microcks
- Advanced topics
- Organizing repository
- Templating mock responses
- Dispatcher & dispatching rules
- Microcks APIMetadata
- Monitoring & Observability
- Installing
- Automating
- Administrating
- Guides
Using docker-compose
🗓️ Last updated on June 21, 2023 | 2 | Improve this pageDocker Compose is a tool for easily testing and running multi-container applications. Microcks offers a simple way to set up the minimal required containers to have a functional environment on your local computer.
Usage
To get started, make sure you have Docker installed on your system.
In your terminal issue the following commands:
-
Clone this repository.
git clone https://github.com/microcks/microcks.git --depth 10
-
Change to the install folder
cd microcks/install/docker-compose
-
Spin up the containers
docker compose up -d
This will start the required containers and setup a simple environment for you to use.
Open a new browser tab and point to the http://localhost:8080
endpoint. This will redirect you to the Keycloak
Single Sign On page for login. Use the following default credentials to login into the application:
- Username:
admin
- Password:
microcks123
You will be redirected to the main dashboard page. You can now start using Microcks !
Enabling Asynchronous API features
Support for Asynchronous API features of Microcks are not enabled by default into the docker-compose.yml
file. If you feel your local machine has enough resources to afford it, you can enable them using a slightly different command line.
In your terminal use the following command instead:
docker compose -f docker-compose.yml -f docker-compose-async-addon.yml up -d
Docker compose is now launching additional containers, namely zookeeper
, kafka
and the microcks-async-minion
. The above command should produce the following output:
Creating network "docker-compose_default" with the default driver
Creating microcks-zookeeper ... done
Creating microcks-db ... done
Creating microcks-sso ... done
Creating microcks-postman-runtime ... done
Creating microcks ... done
Creating microcks-kafka ... done
Creating microcks-async-minion ... done
You may want to check our blog post for a detailed walkthrough on starting Async features on docker-compose.
If you’re feeling lucky regarding your machine, you can even add the Kafdrop utility to visualize and troubleshoot Kafka messages with this command:
docker compose -f docker-compose.yml -f docker-compose-async-addon.yml -f kafdrop-addon.yml up -d
Un-authenticated mode
A “keycloakless” version of docker compose is available thanks to:
docker compose -f docker-compose-devmode.yml up -d
This configuration enabled Asynchronous API features in a very lightweight mode using Red Panda broker instead of full-blown Apache Kafka distribution.
Still Didn’t Find Your Answer?
Join our community and get the help you need. Engage with other members, ask questions, and share knowledge to resolve your queries and expand your understanding.
Join the community