building.md

Building the operator

General environment requirements

A kubernetes cluster

Currently the operator is tested against kubernetes v1.20. You can install a Minikube or a CodeReady Containers(CRC) to deploy the operator.

Docker

Current version being used is v20.10. Checkout this page for help on installing docker on your specific operating system.

Go v1.16

Install Go version v1.16 following this guide.

operator-sdk v1.15.0

Install operator-sdk following this guide.

Get the code

git clone https://github.com/artemiscloud/activemq-artemis-operator
cd activemq-artemis-operator
git checkout main

Building the code locally

make

or

make build

Building the operator image

There are 2 variables you may need to override in order to push the images to your preferred registry.

OPERATOR_IMAGE_REPO (your preferred image registry name, for example quay.io/hgao/operator

and

OPERATOR_VERSION (the image's tag, for example v1.1)

Now build the image passing the variables

make OPERATOR_IMAGE_REPO=<your repo> OPERATOR_VERSION=<tag> docker-build

If finished sucessfully it will print the image url in the end. The image url is like

${OPERATOR_IMAGE_REPO}:${TAG}

Push the image to registry

docker push ${OPERATOR_IMAGE_REPO}:${TAG}

or use the make target docker-push

make OPERATOR_IMAGE_REPO=<your repo> OPERATOR_VERSION=<tag> docker-push

Now follow the quickstart to deploy the operator.