Skip to content

Commit

Permalink
docs: update with information about new configurations
Browse files Browse the repository at this point in the history
  • Loading branch information
dr460nf1r3 committed Nov 7, 2023
1 parent 844cb3e commit 3ae0001
Show file tree
Hide file tree
Showing 3 changed files with 26 additions and 1 deletion.
2 changes: 1 addition & 1 deletion docs/src/nixos-containers/github-runner.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## General

With this container, we provide a GitHub runner. This container does **not** have the regular Garuda configurations because it is considered untrusted.
With this container, we provide a GitHub runner as well as (more recently), a GitLab runner. This container does **not** have the regular Garuda configurations because it is considered untrusted.
Access needs to happen by running `nixos-container root-login` on `immortalis` ([click me](http://docs.garudalinux.net/hosts/immortalis.html#connecting-to-the-server)).

## Nix expression
Expand Down
20 changes: 20 additions & 0 deletions docs/src/nixos-containers/repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,26 @@
## General

This is another package builder, that builds packages for our `[garuda]` repository.
This builder is accessed by the [PKGBUILD repos](https://gitlab.com/garuda-linux/pkgbuilds) CI pipelines via SSH to trigger package deployments.

## How to request a build via CI

To lock down any possible action, access has been restricted to a command wrapper. Allowed actions for the `gitlab` user are:

1. Building a specific package
2. Building a full routine

In order to trigger these actions, one needs to do the following:

1. `ssh -p 223 gitlab@builds.garudalinux.org chaotictrigger $pkgname`
2. `ssh -p 223 gitlab@builds.garudalinux.org chaotictrigger routine`

For our PKGBUILD repo, it has been implemented via this [pipeline](https://gitlab.com/garuda-linux/pkgbuilds/-/blob/main/.gitlab-ci.yml?ref_type=heads#L69).

## How packages get built

We switched to a CI-driven workflow for deploying new packages of the `garuda` repository, more details on how to operate the process can be found in the [repository section](../repositories/general.md).
The GitLab runner used to build the packages is located in the untrusted [github-runner](./github-runner.md) container.

## Nix expression

Expand Down
5 changes: 5 additions & 0 deletions docs/src/repositories/general.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# Repositories

## Notifications for new events at GitLab

Since GitLab has an inbuilt Telegram integration, we can leverage this feature to send notifications to our a dedicated [Telegram development updates channel](https://t.me/garuda_updates).
Posts are send for all kinds of relevent, but non-confidential events like commits, comments or new merge requests. Failed pipelines would also be reported here.

## Backing up current repositories

Current repositories may be backed up using [ghorg](https://github.com/gabrie30/ghorg).
Expand Down

0 comments on commit 3ae0001

Please sign in to comment.