Troubleshooting
Start with the rendered config, then identity, then the connector. A healthy process only means it started.
Compose config
From a checkout, make smoke renders docker-compose.yml and checks the Kafka wiring without starting containers. For a file from the deploy builder:
docker compose -f artificialflow.compose.yml config --quiet
docker compose -f artificialflow.compose.yml ps
docker compose -f artificialflow.compose.yml logs- The generated file needs Compose v2.23 or newer because the gateway config is embedded with
configs.content. IAM_DEPLOYMENT_MODEmust betrueorfalse.externalanddisabledfail startup and name the allowed values.- With
true, the issuer URLs,AUTH_CLIENT_ID, andAUTH_CLAIM_ROLES_PATHare required.AUTH_PRODUCTION=truerefuses to start withfalse. - Elasticsearch needs memory and a minute on first boot. Command and runtime apply migrations before they are ready. Read their logs for a checksum mismatch. Do not edit an applied migration.
make up-releaseon a development branch can start images that do not match that branch. Usemake up, or check out the release branch.- If the command API is up and the connector is missing,
make init-connectoris the recovery step.
Cannot sign in
- With
IAM_DEPLOYMENT_MODE=false, useadmin/admin, or theCONSOLE_ADMIN_USERNAMEandCONSOLE_ADMIN_PASSWORDyou set. - With
true, compare the browser issuer, the internal issuer, the frontend client id, and the redirect origin with IAM and roles.
Query results are empty
curl -fsS http://localhost:8092/healthfor the sync worker.- Kafka topics exist and have consumers.
- The Debezium connector and its tasks are
RUNNINGathttp://localhost:8083/connectors/artificialflow-postgres-connector/status. - Elasticsearch is reachable. Then run
make cqrs-e2e-smokefrom a checkout.
SDK calls are unauthorized
- The machine client has only
artificialflowclient, and the role claim matchesAUTH_CLAIM_ROLES_PATH. - Send the raw access token. The clients add the Bearer prefix.
- In JWT mode the token issuer matches
AUTH_ISSUER_PUBLIC_URL. In introspection mode the endpoint returnsactive=true, a subject, the audience, and the role.
Helm
helm lint ./charts/artificialflow
helm template artificialflow ./charts/artificialflow
helm template artificialflow ./charts/artificialflow -f ./charts/artificialflow/values-kind-smoke.yamliam.modeis the booleantrueorfalse, not the stringexternal,disabled, or a--set-stringvalue.- Remove leftover
migration.*values. The chart refuses to render them. - A long migration that hits the startup probe needs a larger
startupProbe.failureThreshold. Old pods keep serving until the new pods are ready.