Troubleshooting

Information about troubleshooting errors when deploying DevOps Plan.

Error status: keycloak-config-cli Job Failure

The keycloak-config-cli Pod displays an Error status, and the job fails without applying the Keycloak configuration.

This error may occur because the keycloak-config-cli job may be starting before the Keycloak server is fully ready, resulting in a connection failure. Kubernetes will retry the job up to the number of times that is defined in by the backoffLimit. If the retry limit is too low, the job may fail permanently before Keycloak becomes available.

To resolve the issue, perform one of two actions to increase the backoffLimit. The default value is 1. You can increase it to 5:
  1. Option 1: Modify the values.yaml file:
    keycloaksrv:
  keycloakConfigCli:
    backoffLimit: 5  # Try 5 retries instead of the default (usually 1)
  2. Use --set flags with Helm:
    --set keycloaksrv.keycloakConfigCli.backoffLimit=5