Development notes ‐ operator‐sdk version

Random notes on developing for SusQL Operator -- recent operator sdk version

(NEEDS UPDATING!!!!!!)

Changes to the main branch automatically rebuild and push the container image via github action, but non-main branches or forked repos need to be hand-built and pushed to a developer specific location to avoid overwriting the official images.

Sample steps to build and push image

export OPERATOR_IMG=REGISTRYURL/REPOSITORYNAME/susql-controller:latest
podman login
make operator-build && make operator-push

If necessary export CONTAINER_TOOL to docker or podman before building. (Though at this moment there is an issue open to cleanly support this.)

To use a development container image, the following environment variables can be specified at deploy time.

SUSQL_REGISTRY
SUSQL_IMAGE_NAME
SUSQL_IMAGE_TAG

Simple functional verification

cd susql-operator/test
oc create -f labelgroups.yaml
oc create -f training-job-1.yaml
oc create -f training-job-2.yaml

bash labelgroups.sh
sleep 10
bash labelgroups.sh

# remove test artifacts on completion
oc delete -f training-job-2.yaml
oc delete -f training-job-1.yaml
oc delete -f labelgroups.yaml

Troubleshooting

• Verify configuration displayed at install and run time
• Double check that Kepler is functioning (e.g., expected output from OpenShift Observe Dashboards, etc)
• Look at SusQL controller pod log output

kubectl logs -n openshift-operators $( kubectl get pod -n openshift-operators | grep susql-operator | cut -f 1 -d" " )

• Verify accessibility and contents of appropriate Prometheus databases.
• The log level can be changed by editing zapcore.Level(-2) in cmd/main.go and recreating the container image. (Eventually, log level will be configurable.)