Makefile

# Details about the Kiali operator image.
OPERATOR_IMAGE_NAME ?= quay.io/kiali/kiali-operator
OPERATOR_IMAGE_VERSION ?= dev
OPERATOR_NAMESPACE ?= kiali-operator

# When deploying the Kiali operator via operator-create target, this indicates if it should install Kiali also.
OPERATOR_INSTALL_KIALI ?= false

# When installing Kiali, here are some configuration settings for it.
AUTH_STRATEGY ?= openshift
CREDENTIALS_USERNAME ?= admin
CREDENTIALS_PASSPHRASE ?= admin
IMAGE_VERSION ?= dev
NAMESPACE ?= istio-system
VERBOSE_MODE ?= 3

# Find the client executable (either istiooc or oc or kubectl)
OC ?= $(shell which istiooc 2>/dev/null || which oc 2>/dev/null || which kubectl 2>/dev/null || echo "MISSING-OC/KUBECTL-FROM-PATH")

.PHONY: help
all: help
help: Makefile
	@echo
	@echo "Choose a make target to run:"
	@echo
	@sed -n 's/^##//p' $< | column -t -s ':' |  sed -e 's/^/ /'
	@echo

.ensure-operator-sdk-exists:
	@$(eval OP_SDK ?= $(shell which operator-sdk 2>/dev/null || echo -n ""))
	@if [ "${OP_SDK}" == "" ]; then \
	  echo "ERROR: You need operator-sdk in your PATH. You can get it from https://github.com/operator-framework/operator-sdk/releases"; \
	  exit 1; \
	fi

## operator-build: Build the Kiali operator container image
# Requires operator-sdk - download it from https://github.com/operator-framework/operator-sdk/releases
operator-build: .ensure-operator-sdk-exists
	@echo Build operator
	${OP_SDK} build ${OPERATOR_IMAGE_NAME}:${OPERATOR_IMAGE_VERSION}

## operator-push: Push the Kiali operator container image to a remote repo
operator-push:
	@echo Push operator image to image repo
	docker push ${OPERATOR_IMAGE_NAME}:${OPERATOR_IMAGE_VERSION}

.ensure-operator-ns-does-not-exist:
	@_cmd="${OC} get namespace ${OPERATOR_NAMESPACE}"; \
	$$_cmd > /dev/null 2>&1 ; \
	while [ $$? -eq 0 ]; do \
	  echo "Waiting for the operator namespace [${OPERATOR_NAMESPACE}] to terminate" ; \
	  sleep 4 ; \
	  $$_cmd 2> /dev/null; \
	done ; \
	exit 0

## operator-create: Deploy the Kiali operator to the cluster using the install script.
# By default, this target will not deploy Kiali - it will only deploy the operator.
# You can tell it to also install Kiali by setting OPERATOR_INSTALL_KIALII=true.
# The Kiali operator does not create secrets, but this calls the install script
# which can create a Kiali secret for you as a convienence so you don't have
# to remember to do it yourself. It will only do this if it was told to install Kiali.
operator-create: operator-delete .ensure-operator-ns-does-not-exist
	@echo Deploy Operator
	OPERATOR_IMAGE_NAME="${OPERATOR_IMAGE_NAME}" \
OPERATOR_IMAGE_VERSION="${OPERATOR_IMAGE_VERSION}" \
OPERATOR_NAMESPACE="${OPERATOR_NAMESPACE}" \
OPERATOR_INSTALL_KIALI="${OPERATOR_INSTALL_KIALI}" \
AUTH_STRATEGY="${AUTH_STRATEGY}" \
CREDENTIALS_USERNAME="${CREDENTIALS_USERNAME}" \
CREDENTIALS_PASSPHRASE="${CREDENTIALS_PASSPHRASE}" \
IMAGE_VERSION="${IMAGE_VERSION}" \
NAMESPACE="${NAMESPACE}" \
deploy/deploy-kiali-operator.sh

## operator-delete: Remove the Kiali operator resources from the cluster along with Kiali itself
operator-delete: purge-kiali
	@echo Remove Operator
	${OC} delete --ignore-not-found=true all,sa,deployments,clusterroles,clusterrolebindings,customresourcedefinitions --selector=app=kiali-operator -n ${OPERATOR_NAMESPACE}
	${OC} delete --ignore-not-found=true namespace ${OPERATOR_NAMESPACE}

## secret-create: Create a Kiali secret using CREDENTIALS_USERNAME and CREDENTIALS_PASSPHRASE.
secret-create:
	@echo Create the secret
	${OC} create secret generic kiali -n ${NAMESPACE} --from-literal "username=${CREDENTIALS_USERNAME}" --from-literal "passphrase=${CREDENTIALS_PASSPHRASE}"
	${OC} label secret kiali app=kiali -n ${NAMESPACE}

## secret-delete: Delete the Kiali secret.
secret-delete:
	@echo Delete the secret
	${OC} delete --ignore-not-found=true secret --selector=app=kiali -n ${NAMESPACE}

## kiali-create: Create a Kiali CR to the cluster, informing the Kiali operator to install Kiali.
ifeq ($(AUTH_STRATEGY), "login")
kiali-create: secret-create
else
kiali-create:
endif
	@echo Deploy Kiali using the settings found in deploy/kiali/kiali_cr_dev.yaml
	cat deploy/kiali/kiali_cr_dev.yaml | \
AUTH_STRATEGY="${AUTH_STRATEGY}" \
IMAGE_VERSION=${IMAGE_VERSION} \
NAMESPACE="${NAMESPACE}" \
VERBOSE_MODE="${VERBOSE_MODE}" \
envsubst | ${OC} apply -n ${OPERATOR_NAMESPACE} -f -

## kiali-delete: Remove a Kiali CR from the cluster, informing the Kiali operator to uninstall Kiali.
kiali-delete: secret-delete
	@echo Remove Kiali
	${OC} delete --ignore-not-found=true kiali kiali -n ${OPERATOR_NAMESPACE}

## purge-kiali: Purges all Kiali resources directly without going through the operator or ansible.
purge-kiali:
	@echo Purge Kiali resources
	${OC} patch kiali kiali -n ${OPERATOR_NAMESPACE} -p '{"metadata":{"finalizers": []}}' --type=merge ; true
	${OC} delete all,secrets,sa,templates,configmaps,deployments,clusterroles,clusterrolebindings,ingresses,customresourcedefinitions,oauthclients.oauth.openshift.io --selector=app=kiali -n ${NAMESPACE}

## run-playbook: Run the dev playbook to run the Ansible script locally.
run-playbook:
	ansible-playbook -vvv -i dev-hosts dev-playbook.yml

## run-playbook-tag: Run a tagged set of tasks via dev playbook to run parts of the Ansible script locally.
# To use this, add "tags: test" to one or more tasks - those are the tasks that will be run.
run-playbook-tag:
	ansible-playbook -vvv -i dev-hosts dev-playbook.yml --tags test