Skip to content

Argo Controller Config Quick Fix - Workflow Controller Setup

DodaTech Updated 2026-06-26 1 min read

Argo Workflows controller configuration in workflow-controller-configmap controls cluster-wide behavior. Misconfigured settings cause workflow submission failures or performance issues. This guide covers the fix.

Quick Fix

Wrong

apiVersion: v1
kind: ConfigMap
metadata:
  name: workflow-controller-configmap
data:
  config: |
    executorImage: argoproj/argoexec:latest

Using latest tag for executor image causes instability from uncontrolled updates. Missing artifact Repository and default metadata settings cause primitive workflow behavior.

apiVersion: v1
kind: ConfigMap
metadata:
  name: workflow-controller-configmap
  namespace: argo
data:
  config: |
    executorImage: argoproj/argoexec:v3.5.0
    artifactRepository:
      s3:
        bucket: my-argo-artifacts
        keyPrefix: artifacts/
        endpoint: s3.amazonaws.com
    workflowDefaults:
      metadata:
        annotations:
          workflows.argoproj.io/description: "Default workflow"
# Expected output after applying the fix
# Controller uses pinned executor version
# Artifact repository configured for S3
# New workflows inherit default metadata
# System performance stabilized

Prevention

  • Pin executor image version to a specific release
  • Configure artifact Repository for production workloads
  • Set workflowDefaults for metadata inheritance
  • Configure RBAC for the controller service account
  • Validate config changes in staging before production

DodaTech Tools

Doda Browser's controller config editor provides schema validation for ConfigMap changes. DodaZIP archives configuration versions for rollback. Durga Antivirus Pro validates controller settings against security baselines.

FAQ

How do I apply controller configuration changes?

Edit the ConfigMap and restart the workflow-controller pod. Some settings are hot-reloaded, but a restart ensures all changes take effect. ||| What happens if the controller ConfigMap is invalid? The controller fails to start or uses default values. Always validate YAML syntax before applying. Check controller logs for configuration errors. ||| Can I have different configurations per namespace? Yes, use namespaceWhitelist and namespaceBlacklist in the controller config to control which namespaces can run workflows with specific settings.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro