The Cloud Agent Operator's reconciliation of the Cloud Agent components can be paused, allowing you to modify and troubleshoot them directly.

Pause Reconciliation

Add the integration.ibm.com/pause annotation to by editing the DpodCloudAgent CR:

apiVersion: integration.ibm.com/v1beta1
kind: DpodCloudAgent
metadata:e
  namespace: gateways-ns
  name: dpod-cloud-agent-dev
  annotations:
    integration.ibm.com/pause: "true"
...

Note: The value must be a string, i.e. "true". Entering true will fail and generate an error message when trying to apply the update.

Or by using the command line with kubectl and yq tools, i.e.:

kubectl get dpodcloudagent <CR Name> -n <CR Namespace> -o yaml | yq w - "metadata.annotations.\"integration.ibm.com/pause\"" "true" --style="double" | kubectl replace -f -

As long as this annotation is set in the DpodCloudAgent CR, the Cloud Agent Operator will not perform any action on that Cloud Agent components.

Continue Reconciliation

When troubleshooting is done, remove the integration.ibm.com/pause annotation by editing the DpodCloudAgent CR or by using the command line tools:

kubectl get dpodcloudagent <CR Name> -n <CR Namespace> -o yaml | yq d - "metadata.annotations.\"integration.ibm.com/pause\"" | kubectl replace -f -

IBM DPOD v1.0.20.x

IBM DataPower Operations Dashboard v1.0.20.x

Pause Reconciliation

Pause Reconciliation

Continue Reconciliation