The GitOps Toolkit source management component
Go to file
Hidde Beydals 5a1fcc213b git: standardise commit and (PGP) verification
This commit refactors the previous `Commit` interface into a
standardised `Commit` struct. This object contains sufficient
information for referencing, observating and (PGP) verification.

- `libgit2` commit checkout does now return `HEAD/<SHA1>` as
  the branch is not taken into account.
- `git2go` objects are now properly `Free`d everywhere
- `Verify` logic is tested.

Signed-off-by: Hidde Beydals <hello@hidde.co>
2021-10-27 00:43:31 +05:30
.github Update fluxcd/golang-with-libgit2 to 1.1.1-1 2021-10-14 13:49:52 -05:00
api Add ReconcileStrategy to HelmChart 2021-10-14 13:49:52 -05:00
config Release v0.16.1 2021-10-22 14:24:22 +02:00
controllers git: standardise commit and (PGP) verification 2021-10-27 00:43:31 +05:30
docs Updated docs to include GCP provider instructions 2021-10-14 14:26:33 -05:00
hack Add LastHandledReconcileAt to source statuses 2020-11-19 13:21:59 +01:00
internal Update github.com/libgit2/git2go to v31.6.1 2021-10-14 13:48:15 -05:00
pkg git: standardise commit and (PGP) verification 2021-10-27 00:43:31 +05:30
.dockerignore Update github.com/libgit2/git2go to v31.6.1 2021-10-14 13:48:15 -05:00
.gitignore Update github.com/libgit2/git2go to v31.6.1 2021-10-14 13:48:15 -05:00
CHANGELOG.md Release v0.16.1 2021-10-22 14:24:22 +02:00
CODE_OF_CONDUCT.md Add governance files like DCO, MAINTAINERS, CoC 2020-04-12 23:54:35 +02:00
DCO Add governance files like DCO, MAINTAINERS, CoC 2020-04-12 23:54:35 +02:00
DEVELOPMENT.md Centralise Contributor docs, add Dev doc 2021-10-26 11:24:41 +02:00
Dockerfile Update fluxcd/golang-with-libgit2 to 1.1.1-1 2021-10-14 13:49:52 -05:00
LICENSE Initial commit 2020-04-05 11:55:46 +03:00
MAINTAINERS Share maintainers from fluxcd/flux2 2020-12-01 12:20:27 +00:00
Makefile Update fluxcd/golang-with-libgit2 to 1.1.1-1 2021-10-14 13:49:52 -05:00
PROJECT Promote API to v1beta1 2020-09-30 16:11:00 +03:00
README.md add CII badge 2021-04-08 12:13:56 +02:00
go.mod git: standardise commit and (PGP) verification 2021-10-27 00:43:31 +05:30
go.sum Added more tests and cleaned up GCP provider logic 2021-10-14 14:26:33 -05:00
main.go Panic on non-nil AddToScheme errors in main init 2021-06-17 15:38:24 +02:00

README.md

Source controller

CII Best Practices e2e report license release

The source-controller is a Kubernetes operator, specialised in artifacts acquisition from external sources such as Git, Helm repositories and S3 buckets. The source-controller implements the source.toolkit.fluxcd.io API and is a core component of the GitOps toolkit.

overview

Features:

  • authenticates to sources (SSH, user/password, API token)
  • validates source authenticity (PGP)
  • detects source changes based on update policies (semver)
  • fetches resources on-demand and on-a-schedule
  • packages the fetched resources into a well-known format (tar.gz, yaml)
  • makes the artifacts addressable by their source identifier (sha, version, ts)
  • makes the artifacts available in-cluster to interested 3rd parties
  • notifies interested 3rd parties of source changes and availability (status conditions, events, hooks)
  • reacts to Git push and Helm chart upload events (via notification-controller)