Plugins¶

Argo CD allows integrating more config management tools using config management plugins. Following changes are required to configure new plugin:

Make sure required binaries are available in argocd-repo-server pod. The binaries can be added via volume mounts or using custom image (see custom_tools).
Register a new plugin in argocd-cm ConfigMap:

data:
  configManagementPlugins: |
    - name: pluginName
      init:                          # Optional command to initialize application source directory
        command: ["sample command"]
        args: ["sample args"]
      generate:                      # Command to generate manifests YAML
        command: ["sample command"]
        args: ["sample args"]

The generate command must print a valid YAML stream to stdout. Both init and generate commands are executed inside the application source directory.

Create an application and specify required config management plugin name.

argocd app create <appName> --config-management-plugin <pluginName>

More config management plugin examples are available in argocd-example-apps.

Environment¶

Commands have access to

The system environment variables
Standard build environment
Variables in the application spec (References to system and build variables will get interpolated in the variables' values):

v1.2

spec:
  source:
    plugin:
      env:
        - name: FOO
          value: bar
        - name: REV
          value: test-$ARGOCD_APP_REVISION