argocd-image-updater

Argo CD Image Updater

Introduction

Argo CD Image Updater is a tool to automatically update the container images of Kubernetes workloads which are managed by Argo CD. In a nutshell, it uses a dedicated ImageUpdater CR to define how to track and update image versions for your Argo CD Applications. When a new image is available, it updates the application by setting parameter overrides, either through the Argo CD API or by committing changes to a Git repository.

Currently, it will only work with applications that are built using Kustomize or Helm tooling. Applications built from plain YAML or custom tools are not supported yet (and maybe never will).

Documentation

Read the documentation for more information on how to set up and run Argo CD Image Updater and to get known to its features and limitations.

Above URL points to the documentation for the current release. If you are interested in documentation of upcoming features, check out the latest documentation which is up-to-date with the master branch.

Current status

Argo CD Image Updater is under active development. We would not recommend it yet for critical production workloads, but feel free to give it a spin.

We're very interested in feedback on usability and the user experience as well as in bug discoveries and enhancement requests.

Contributing

You are welcome to contribute to this project by means of raising issues for bugs, sending & discussing enhancement ideas or by contributing code via pull requests.

In any case, please be sure that you have read & understood the currently known design limitations before raising issues.

Also, if you want to contribute code, please make sure that your code

• has its functionality covered by unit tests (coverage goal is 80%),
• is correctly linted,
• is well commented,
• and last but not least is compatible with our license and CLA

License

argocd-image-updater is open source software, released under the Apache 2.0 license

Things that are planned (roadmap)

The following things are on the roadmap

• Extend Argo CD functionality to be able to update images for other types of applications.

• Extend Argo CD functionality to write back to Git

• Provide web hook support to trigger update check for a given image

• Use concurrency for updating multiple applications at once

• Improve error handling

• Support for image tags with i.e. Git commit SHAs

For more details, check out the v1.0.0 milestone

Frequently asked questions

Does it write back the changes to Git?

We're happy to announce that as of v0.9.0 and Argo CD v1.9.0, Argo CD Image Updater is able to commit changes to Git. It will not modify your application's manifests, but instead writes Parameter Overrides to the repository.

We think that this is a good compromise between functionality (have everything in Git) and ease-of-use (minimize conflicts).

Are there plans to extend functionality beyond Kustomize or Helm?

Not yet, since we are dependent upon what functionality Argo CD provides for these types of applications.

Will it ever be fully integrated with Argo CD?

In the current form, probably not. If there is community demand for it, let's see how we can make this happen.

There is an open proposal to migrate this project into the argoproj org (out of the argoproj-labs org) and include it in the installation of Argo CD.