Local development environment
If you plan on contributing to Camel K, you will end up needing to run and troubleshoot your operator code locally. Here is a guideline that will help you configure your local operator running.
As soon as you build your operator locally you will ask yourself how to test it. The idea is that you execute it locally and instruct it to watch a namespace on a Kubernetes cluster (it may be remote or any local environment). Let’s use a namespace called
You can start with setting the environment variable
WATCH_NAMESPACEwith the namespace you’d like your operator to watch.
The next step is to install an
IntegrationPlatformon the cluster namespace. You probably need to tweak the registry parameters in order to be able to authenticate against an image repository (see below paragraph for local repository instructions).
./kamel install --skip-operator-setup -n operator-test --registry my-registry:5000
Finally, assuming you’ve built your application correctly we can run the operator:
Test the local operator by creating a test
./kamel run xyz.abc -n operator-test
|make sure no other Camel K Operators are watching this namespace, neither you have a global Camel K Operator installed on your cluster.|
If you want to run a local operator togheter with
Minikube you will need an additional step in order to let the local operator push images in the local registry. We need to expose the local registry as described in this procedure:
Enable the addon registry (this should be already in place):
minikube addons enable registry
Podname that is in charge to run the registry and proxy the registry 5000 port to be used locally.
kubectl get pods -n kube-system NAME READY STATUS RESTARTS AGE ... registry-fttbv 1/1 Running 40 89d ... kubectl port-forward --namespace kube-system registry-fttbv 5000:5000
IntegrationPlatformto instruct it to use the
./kamel install --skip-operator-setup -n operator-test --registry localhost:5000 --force
A similar procedure may work if you use other local environments. The idea is to expose the docker registry and be able to use it from your local operator.
Camel K integrations are based on Camel K runtime, generally paired with the operator release. If you need to specify a different runtime, or you have a local Camel K runtime that you want to test, then you will need to specify it in the
./kamel install --skip-operator-setup -n operator-test --registry localhost:5000 --force --runtime-version $version
$version variable must be replaced with the version you are building. For example,
1.3.1-SNAPSHOT. With these instructions, the operator will pick up and use the snapshot version you have released locally.
Alternatively, if no local registry is available, you can use another type of registry as explained in the Registry section.