102 lines
3.8 KiB
Markdown
102 lines
3.8 KiB
Markdown
|
## Flakes Action
|
||
|
|
|
||
|
|
This action can be retrieved at: `code.252.no/tommy/flakes-action:latest`.
|
||
|
|
|
||
|
|
This container is a little special since it provides a Nix flake designed to generate a docker image to use with
|
||
|
|
[Forgejo runners](https://code.forgejo.org/forgejo/runner). It packages essential tools and helper programs to streamline
|
||
|
|
the code.252.no CI/CD workflows.
|
||
|
|
|
||
|
|
We try to reproduce much-used GitHub actions into one package to avoid calling an excessive amount of images in Forgejo workflows.
|
||
|
|
|
||
|
|
### Supported use cases
|
||
|
|
|
||
|
|
* Flux CI/CD testing
|
||
|
|
* Forgejo comments: post comments to issues
|
||
|
|
* Run commands ad-hoc with `nix run`
|
||
|
|
|
||
|
|
### Docker Image Info
|
||
|
|
|
||
|
|
`code.252.no/tommy/flakes-action:latest` includes:
|
||
|
|
|
||
|
|
- **Nix Environment**: Pre-configured with Nix and essential configurations.
|
||
|
|
- **Helper Programs**: Bundles `flux-local`, `flux-diff`, and `forgejo-comment`.
|
||
|
|
- **Essential Build Tools**: Includes utilities like `git`, `docker`, `bash`, `curl`, `jq`, and more.
|
||
|
|
|
||
|
|
|
||
|
|
### Flake Content
|
||
|
|
|
||
|
|
- **Apps**: Accessible via `nix run` or `nix shell` commands.
|
||
|
|
- **Packages**: Builds a Docker image named `flakes-action` with necessary tools.
|
||
|
|
|
||
|
|
|
||
|
|
### Helper Programs
|
||
|
|
|
||
|
|
The flake provides the following applications:
|
||
|
|
|
||
|
|
| Application | Description | External Ref |
|
||
|
|
|-------------------|-----------------------------------------------------------------|---------------------------------------------------------------------|
|
||
|
|
| `git-sv` | Semantic versioning tool for git based on conventional commits. | [tommy/git-sv](https://code.252.no/tommy/git-sv)
|
||
|
|
| `flux-local` | Tool for performing local Flux operations and diffs. | [allenporter/flux-local](https://github.com/allenporter/flux-local) |
|
||
|
|
| `flux-diff` | Utility to diff Flux resources locally. | [buroa/k8s-gitops](https://github.com/buroa/k8s-gitops/blob/master/.github/workflows/flux-diff.yaml)
|
||
|
|
| `forgejo-comment` | Script to post comments on Forgejo merge requests. | -
|
||
|
|
|
||
|
|
Other standard packages are provided from nixpkgs. For an up-to-date list have a look at `flakes-action` in
|
||
|
|
[flake.nix](./flake.nix).
|
||
|
|
|
||
|
|
|
||
|
|
### Usage
|
||
|
|
|
||
|
|
#### Building
|
||
|
|
|
||
|
|
We provide an example taskfile in `task docker:build-flakesaction` which is used for manual builds on code.252.no. The task uses
|
||
|
|
`nerdctl`, but you may replace this with `docker` or `podman`.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
nix build .#packages.x86_64-linux.flakes-action # build image
|
||
|
|
nerdctl load < result # loads nix build result (tar archive)
|
||
|
|
nerdctl push code.252.no/tommy/flakes-action:latest # push to registry
|
||
|
|
```
|
||
|
|
|
||
|
|
#### In Runner
|
||
|
|
|
||
|
|
We provide examples for use in Kubernetes, but the image may be used with the act runner locally as well.
|
||
|
|
|
||
|
|
To use the Docker image in your Forgejo runner add it to your Helm values (this uses the `bjw-s` `app-template`):
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
[...]
|
||
|
|
values:
|
||
|
|
controllers:
|
||
|
|
forgejo-runner-elkworks:
|
||
|
|
replicas: 2
|
||
|
|
initContainers:
|
||
|
|
runner-register:
|
||
|
|
image:
|
||
|
|
repository: code.forgejo.org/forgejo/runner
|
||
|
|
tag: 4.0.1
|
||
|
|
command:
|
||
|
|
- "forgejo-runner"
|
||
|
|
- "register"
|
||
|
|
- "--no-interactive"
|
||
|
|
- "--token"
|
||
|
|
- $(RUNNER_TOKEN)
|
||
|
|
- "--name"
|
||
|
|
- $(RUNNER_NAME)
|
||
|
|
- "--instance"
|
||
|
|
- $(FORGEJO_INSTANCE_URL)
|
||
|
|
- "--labels"
|
||
|
|
- "flakes-action:docker://code.252.no/tommy/flakes-action:latest,[...]"
|
||
|
|
env:
|
||
|
|
- name: RUNNER_TOKEN
|
||
|
|
valueFrom:
|
||
|
|
secretKeyRef:
|
||
|
|
name: forgejo-runner-elkworks-secret
|
||
|
|
key: RUNNER_TOKEN
|
||
|
|
- name: RUNNER_NAME
|
||
|
|
valueFrom:
|
||
|
|
fieldRef:
|
||
|
|
fieldPath: metadata.name
|
||
|
|
- name: FORGEJO_INSTANCE_URL
|
||
|
|
value: https://code.252.no
|
||
|
|
[...]
|
||
|
|
```
|