Skip to content
This repository was archived by the owner on Dec 9, 2025. It is now read-only.

Commit 5f0824f

Browse files
committed
chore: add readme
1 parent 0ea13ea commit 5f0824f

1 file changed

Lines changed: 38 additions & 0 deletions

File tree

README.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
Glu GitOps Example Pipeline
2+
---------------------------
3+
4+
This repository is a demonstration of a GitOps pipeline held together with Glu.
5+
6+
The project consists of:
7+
8+
- A script for to a [Kind](https://kind.sigs.k8s.io/) Kubernetes (K8s) cluster in your local Docker.
9+
- An example [application implemented in Go](./cmd/app) and published as a container image to [GHCR](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry).
10+
- A promotion [pipeline implemented in Go using the Glu framework](./cmd/pipeline).
11+
- Manifests for deploying these to your local kind cluster using [FluxCD](https://github.com/fluxcd/flux2).
12+
13+
All of this is triggered via a single [start script](./start.sh).
14+
Read more below for the necessary dependencies needed to boostrap and run this example.
15+
16+
## Requirements
17+
18+
- [Docker](https://www.docker.com/)
19+
- [Kind](https://kind.sigs.k8s.io/)
20+
- [Go](https://go.dev/)
21+
22+
## Running
23+
24+
Before you get started you're going to want to do the following:
25+
26+
1. Fork this repo!
27+
2. Clone your fork locally.
28+
3. Make a note of your forks GitHub URL.
29+
4. Generate a [GitHub Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) (if you want to experiment with promotions).
30+
31+
> You will need at-least read and write contents scope (`contents:write`).
32+
33+
Once you have done the above, you can run the start script found in the root of this repository.
34+
The script will prompt you for your forks repository URL and access token (given you want to perform promotions).
35+
36+
```console
37+
./start.sh
38+
```

0 commit comments

Comments
 (0)