Hello guys, I have been working with kubernetes, docker, postman and newman a lot lately due some tests on internal microservices. To test these internal microservices I am running postman scripts in the same kubernetes cluster where the services are running.
Kubernetes is an open source container orchestrator, which means you can group together all the containers (services) that share information. You don’t need to expose their endpoints for them to be available among themselves. PS: This is just my brief explanation, but feel free to explore a bit more.
To be able to run tests on internal microservices that are inside a Kubernetes cluster I created a Postman collection and together with Newman run the tests pointing to these services without the need to expose the endpoints.
Creating the postman script
– You will need to have postman installed to create the script
– I am not going through the details of this part, because this is not the aim of this post, but after you create the script on postman you will need to export to api/collections folder.
– Also, you will need to export the environment variables that you create it and save it in the api/envs folder.
– You can see an example of the collection here and an example of the environment variable here. Remember that the hostname needs to be the name of the deployment of your service in kubernetes.
Creating the docker file
– I am using this docker image as base, but you can use any other, you just need to install newman.
– Then we need to build a Docker image containing the postman collection, environment and global variables, data files, etc.
– After this we need to create a jenkins file that will build and push the image to the docker hub, the best practice is you to have a separate pipeline just to build the image (so the tests contains just the tests and don’t take longer than necessary to run), but in this example I am going to have just a separate stage to build the image and another to run the tests.
dockerfile:
FROM postman/newman
WORKDIR /etc/newman/
COPY . /etc/newman/
RUN chmod -R 700 /etc/newman
Creating the kubernetes deployment
– Now we need to create the jenkins file to build and push the docker image to docker hub.
– You can get the full code here.
– But this is the important part, the command below will create a kubernetes deployment in the namespace and run the tests from the image that we have just pushed.
kubectl run microservices-tests -i --rm --namespace=${ENVIRONMENT} --restart=Never --image=${IMAGE}:latest --image-pull-policy=Always -- run /etc/newman/api/collections/collection.postman_collection.json -e /etc/newman/api/envs/${ENVIRONMENT}.postman_environment.json --reporters cli --reporter-cli-no-failures
microservices-testsis the name of the deployment that you are going to create.-iKeep stdin open on the container.--rmis the argument that says to delete this deployment once the command is finished.
--namespace=${ENVIRONMENT}is the name of the namespace (environment) that you will run this deployment, so it needs to be the same as your services are running.--restart=Neveris the argument that says to not restart the deployment once is finished. You don’t want your tests running over and over again forever.--image=${IMAGE}:latestis the image that kubernetes is going to pull.--image-pull-policy=Alwaysthis is to ensure that kubernetes is always pull the image even thought you have pulled before (this is to ensure you have always the latest).--this is to mark the end of the kubernetes commands and everything after is going to be the newman commands/arguments to run the postman script.
So, creating this deployment in the same namespace of your internal services, you can hit them and test the endpoints even though they are not external.
You should see something like this on your console:
This means that your script is running as expected in the cluster.
Thank you guys ! See you next time !
