DynaMocker

DynaMocker is a simple mocker of a web server which allows you to dynamically modify the *.json file (containing the mock response that you want to fetch to your client) in real time. For those who are found of mice, the app comes with a simple UI, that allows you to add, modify and delete the behavior of each mock API response.

The app can be used through docker-compose or through helm chart.

Docker-compose

The project is made of two images: one for the back-end and another one for the front-end. You have to choose:

• the folder in which your mockApis will be stored : <full_path_to_you_folder>
• the port on which the backend will be hosted: <your_be_port>
• the port on which the frontend will be reachable: <your_fe_port>

Create the .env file in which you insert your chosen env variables:

MOCK_API_FOLDER=<full_path_to_you_folder>
FE_PORT=<your_be_port>
BE_PORT=<your_fe_port>

Create the following docker-compose.yml file:

services:
  dynamocker-be:
    image: raffarus/dynamocker-be:0.0.6
    ports:
      - ${BE_PORT}:8150
    volumes:
      - ${MOCK_API_FOLDER}:/mocks
    environment:
      - BE_PORT=${BE_PORT}
  dynamocker-fe:
    image: raffarus/dynamocker-fe:0.0.6
    ports:
      - ${FE_PORT}:8151
    environment:
      - FE_PORT=${FE_PORT}
      - BE_PORT=${BE_PORT}
    depends_on:
      - dynamocker-be

Then use docker-compose to launch the containers:

$ docker compose -f ./docker-compose.yml --env-file ./.env up -d

You should be able to access the UI to http://localhost:{FE_PORT}.

In case you want to bring down the containers the use:

$ docker compose -f docker/docker-compose.yml --env-file docker/.env down

Helm

You can either pull the Helm Chart from the GitHub repo:

$ wget https://github.com/RaffaRus/dynamocker/releases/download/dynamocker-0.0.6/dynamocker-0.0.6.tgz

modify the values.yaml file with the env variables you choose and then install the chart, or you can add the Helm repo that contains the charts:

$ helm repo add dynamocker-charts-repo https://raffarus.github.io/dynamocker

and then install dynamocker from the repo:

helm install dynamocker dynamocker-charts-repo/dynamocker

Once installed, start using the UI at http://localhost:{FE_PORT}.

Minikube deployment

If you are using minikube, you better specify it in the values. If you do so, the service being created will be of type LoadBalancer, otherwise a NodePort will be created. Since minikube does not handles NodePorts, using a LoadBalancer is better, since the minikube tunnel comand that you give will automatically pickup the LoadBalancer and it will expose the port.

In case you want to have a local folder mounted inside the backend container, then you have to mount the local folder into the minikube node:

$ minikube mount <local_path>:/home/mock-apis

then you can pass the path inside the minikube node to the be app.

In this case the APIs will be expose to http://<EXTERNAL_IP>:<EXTERNAL_PORT>, where the ip and the port can be taken from the outuput of:

kubectl get svc

Reach the mock APIs

In order to reach the mock apis you created, you can find them at http://localhost:{BE_PORT}/dynamocker/api/serve-mock-api/<your_mock_api_url>:

curl http://localhost:{BE_PORT}/dynamocker/api/serve-mock-api/<your_mock_api_url>