https://github.com/fluxcd/image-automation-controller

GitOps Toolkit controller that patches container image tags in Git
https://github.com/fluxcd/image-automation-controller

gitops-toolkit

Last synced: 3 months ago
JSON representation

GitOps Toolkit controller that patches container image tags in Git

• Host: GitHub
• URL: https://github.com/fluxcd/image-automation-controller
• Owner: fluxcd
• License: apache-2.0
• Created: 2020-07-18T13:48:54.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2025-04-14T19:56:55.000Z (about 1 year ago)
• Last Synced: 2025-04-14T22:13:22.782Z (about 1 year ago)
• Topics: gitops-toolkit
• Language: Go
• Homepage: https://fluxcd.io
• Size: 2.4 MB
• Stars: 183
• Watchers: 13
• Forks: 79
• Open Issues: 71
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# image-automation-controller

[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/4789/badge)](https://bestpractices.coreinfrastructure.org/projects/4789)

[![report](https://goreportcard.com/badge/github.com/fluxcd/image-automation-controller)](https://goreportcard.com/report/github.com/fluxcd/image-automation-controller)

[![license](https://img.shields.io/github/license/fluxcd/image-automation-controller.svg)](https://github.com/fluxcd/image-automation-controller/blob/main/LICENSE)

[![release](https://img.shields.io/github/release/fluxcd/image-automation-controller/all.svg)](https://github.com/fluxcd/image-automation-controller/releases)

The image-automation-controller is a [GitOps toolkit](https://fluxcd.io/flux/components/) controller

that extends [Flux](https://github.com/fluxcd/flux2) with automated patch and commit capabilities for container image updates.

![overview](https://fluxcd.io/img/image-update-automation.png)

The [image-reflector-controller](https://github.com/fluxcd/image-reflector-controller) and image-update-automation

work together to update Git repositories when new container images are available.

- The image-reflector-controller scans image repositories and reflects the image metadata in Kubernetes resources.

- The image-automation-controller updates YAML files based on the latest images scanned, and commits the changes to a given Git repository.

## API Specification

| Kind                                                            | API Version                  |

|-----------------------------------------------------------------|------------------------------|

| [ImageUpdateAutomation](docs/spec/v1/imageupdateautomations.md) | `image.toolkit.fluxcd.io/v1` |

## Guides

* [Get started with Flux](https://fluxcd.io/flux/get-started/)

* [Automate image updates to Git](https://fluxcd.io/flux/guides/image-update/)

## Roadmap

The roadmap for the Flux family of projects can be found at .

## Contributing

This project is Apache 2.0 licensed and accepts contributions via GitHub pull requests.

To start contributing please see the [development guide](DEVELOPMENT.md).