Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lreimer/hands-on-flux2
Demo repository for GitOps with Flux2 using a branch based monorepo per cluster and application repos.
https://github.com/lreimer/hands-on-flux2
aws eks eksctl flux2 gitops
Last synced: 2 months ago
JSON representation
Demo repository for GitOps with Flux2 using a branch based monorepo per cluster and application repos.
- Host: GitHub
- URL: https://github.com/lreimer/hands-on-flux2
- Owner: lreimer
- License: mit
- Created: 2021-08-16T08:07:50.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-06-30T09:47:12.000Z (over 2 years ago)
- Last Synced: 2023-08-02T08:59:36.953Z (over 1 year ago)
- Topics: aws, eks, eksctl, flux2, gitops
- Language: Makefile
- Homepage:
- Size: 48.8 KB
- Stars: 4
- Watchers: 2
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hands-on Flux2
Demo repository for GitOps with Flux2 using a branch based monorepo per cluster and application repos.
## Prerequisites
You need to have the following tools installed locally to be able to complete all steps:
- [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
- [eksctl](https://eksctl.io/)
- [kubectl](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)
- [flux](https://fluxcd.io/docs/get-started/)
- [Helm](https://helm.sh/docs/intro/install/)
## Bootstrapping
```bash
# define required ENV variables for the next steps to work
$ export GITHUB_TOKEN=
$ export GITHUB_USER=lreimer
$ export AWS_ACCOUNT_ID=`aws sts get-caller-identity --query Account --output text`
# created 2 branches to track the individual cluster states
$ git branch env/dev
$ git branch env/prod
$ git push --all
# setup the dev cluster and GitOps environment
$ make create-dev-cluster
$ make bootstrap-flux2-dev
# next we start to add things to the cluster
# all files to apply in the env/ branches are in the examples directory
# setup the dev cluster and GitOps environment
$ make create-prod-cluster
$ make bootstrap-flux2-prod
$ make destroy-clusters
```
## Examples
### Webhook Receivers
```bash
# the relevant files are found in examples/webhook-receiver/
$ git checkout env/dev
$ cp examples/flux-system/ clusters/flux2-dev-cluster/
$ git add -A && git commit -m "Added webhook receiver for flux-system"
$ git push
# you also need to create the webhook for the Git Repository
# Payload URL: http:///
# Secret: the webhook-token value
$ kubectl -n flux-system get svc/receiver
$ kubectl -n flux-system get receiver/webapp
```
### Infrastructure
In order to declare the infrastructure overlay for the cluster, add the following YAML
to the `clusters/flux2-dev-cluster/flux-system/cluster-sync.yml` definition.
```yaml
apiVersion: kustomize.toolkit.fluxcd.io/v1beta1
kind: Kustomization
metadata:
name: infrastructure
namespace: flux-system
spec:
interval: 5m0s
sourceRef:
kind: GitRepository
name: flux-system
path: ./infrastructure
prune: true
```
Next, you can put and deploy the `Kustomizations` to the `infrastructure/` directory.
To deploy some Helm and Git repository sources as well as useful infrastructure componentsuse the files under `examples/infrastructure/`.
### Applications
In order to declare the infrastructure overlay for the cluster, add the following YAML
to the `clusters/flux2-dev-cluster/flux-system/cluster-sync.yml` definition.
```yaml
apiVersion: kustomize.toolkit.fluxcd.io/v1beta1
kind: Kustomization
metadata:
name: applications
namespace: flux-system
spec:
interval: 5m0s
dependsOn:
- name: infrastructure
sourceRef:
kind: GitRepository
name: flux-system
path: ./applications
prune: true
validation: client
```
Next, you can put and deploy the `Kustomizations` to the `applications/` directory.
To deploy the podinfo example use the files under `examples/applications/`.
## Maintainer
M.-Leander Reimer (@lreimer),
## License
This software is provided under the MIT open source license, read the `LICENSE`
file for details.