fluxcd
/
source-controller
mirror of https://github.com/fluxcd/source-controller.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
The GitOps Toolkit source management component
2,151 Commits 26 Branches 282 Tags 18 MiB
Go 98.4%
Shell 0.7%
Makefile 0.5%
Smarty 0.3%
Go to file
Hidde Beydals e92418ce17
ci: use bot token for backport 
This allows GitHub Action workflows to be triggered for the PR created
by the bot.

As things are now triggered by the bot, elevated permissions of the
workflow itself are no longer required.

Signed-off-by: Hidde Beydals <hidde@hhh.computer>
(cherry picked from commit 80eeff2739)
 		2023-07-06 11:22:36 +02:00
.github ci: use bot token for backport 2023-07-06 11:22:36 +02:00
api Align go.mod version with Kubernetes 2023-06-26 16:22:06 +03:00
config Release v1.0.0 2023-07-03 18:09:48 +02:00
docs gitrepo: remove obsolete proxy docs 2023-07-03 12:14:51 +05:30
hack Move controllers to internal/controller 2023-05-03 15:35:45 +05:30
internal Revert "Disable "empty repository" Git test" 2023-07-03 12:18:33 +02:00
pkg gcp: update recognized mock storage server path 2023-07-03 14:09:58 +02:00
tests/fuzz Install Go 1.20 for oss-fuzz 2023-06-26 18:40:43 +03:00
.dockerignore libgit2: Remove references to libgit2 from code 2022-12-12 15:34:28 +00:00
.gitignore Update libgit2 to 1.1.1-6 2022-02-07 13:00:57 +00:00
.goreleaser.yaml Add SLSA3 generators to release workflow 2023-06-23 18:13:14 +03:00
CHANGELOG.md Add changelog entry for v1.0.0 2023-07-03 18:09:48 +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 libgit2: Update documentation 2022-12-12 15:34:30 +00:00
Dockerfile Update Alpine to 3.18 2023-05-10 09:25:35 -04:00
LICENSE Initial commit 2020-04-05 11:55:46 +03:00
MAINTAINERS Paulo is Core Maintainer 2023-01-31 17:13:16 +01:00
Makefile Update controller-runtime (v0.15) and K8s (v1.27) 2023-05-24 09:05:42 +02:00
PROJECT Add GitRepository v1 to project file 2023-03-28 12:30:11 +03:00
README.md Add API docs links to readme 2023-03-30 13:10:46 +03:00
go.mod Release v1.0.0 2023-07-03 18:09:48 +02:00
go.sum Update Go dependencies 2023-07-03 13:18:31 +02:00
main.go Update controller-runtime (v0.15) and K8s (v1.27) 2023-05-24 09:05:42 +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, OCI, Helm repositories and S3-compatible buckets. The source-controller implements the source.toolkit.fluxcd.io API and is a core component of the GitOps toolkit.

overview

APIs

Kind API Version
GitRepository source.toolkit.fluxcd.io/v1
OCIRepository source.toolkit.fluxcd.io/v1beta2
HelmRepository source.toolkit.fluxcd.io/v1beta2
HelmChart source.toolkit.fluxcd.io/v1beta2
Bucket source.toolkit.fluxcd.io/v1beta2

Features

  • authenticates to sources (SSH, user/password, API token, Workload Identity)
  • validates source authenticity (PGP, Cosign)
  • 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, Helm and OCI artifacts push events (via notification-controller)

Guides

Roadmap

The roadmap for the Flux family of projects can be found at https://fluxcd.io/roadmap/.

Contributing

This project is Apache 2.0 licensed and accepts contributions via GitHub pull requests. To start contributing please see the development guide.