Skip to content

Commit 50d2546

Browse files
Merge pull request #461 from gabriel-samfira/update-docs
Update docs to reflect new release
2 parents d2babb7 + 03aa14c commit 50d2546

File tree

3 files changed

+30
-30
lines changed

3 files changed

+30
-30
lines changed

README.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
# GitHub Actions Runner Manager (GARM)
22

3-
[![Go Tests](https://github.com/cloudbase/garm/actions/workflows/go-tests.yml/badge.svg)](https://github.com/cloudbase/garm/actions/workflows/go-tests.yml)
4-
53
<!-- TOC -->
64

7-
- [About GARM](#about-garm)
8-
- [Join us on slack](#join-us-on-slack)
9-
- [Installing](#installing)
10-
- [Quickstart](#quickstart)
11-
- [Installing on Kubernetes](#installing-on-kubernetes)
12-
- [Using GARM](#using-garm)
13-
- [Supported providers](#supported-providers)
14-
- [Installing external providers](#installing-external-providers)
15-
- [Optimizing your runners](#optimizing-your-runners)
16-
- [Write your own provider](#write-your-own-provider)
5+
- [GitHub Actions Runner Manager GARM](#github-actions-runner-manager-garm)
6+
- [About GARM](#about-garm)
7+
- [Join us on slack](#join-us-on-slack)
8+
- [Installing](#installing)
9+
- [Quickstart](#quickstart)
10+
- [Installing on Kubernetes](#installing-on-kubernetes)
11+
- [Using GARM](#using-garm)
12+
- [Supported providers](#supported-providers)
13+
- [Installing external providers](#installing-external-providers)
14+
- [Optimizing your runners](#optimizing-your-runners)
15+
- [Write your own provider](#write-your-own-provider)
1716

1817
<!-- /TOC -->
1918

@@ -34,7 +33,7 @@ Here is a brief architectural diagram of how GARM reacts to workflows triggered
3433
![GARM architecture diagram](/doc/images/garm-light.drawio.svg?raw=true#gh-light-mode-only)
3534
![GARM architecture diagram](/doc/images/garm-dark.drawio.svg?raw=true#gh-dark-mode-only)
3635

37-
:warning: **Important note**: The README and documentation in the `main` branch are relevant to the not yet released code that is present in `main`. Following the documentation from the `main` branch for a stable release of GARM, may lead to errors. To view the documentation for the latest stable release, please switch to the appropriate tag. For information about setting up `v0.1.5`, please refer to the [v0.1.5 tag](https://github.com/cloudbase/garm/tree/v0.1.5).
36+
:warning: **Important note**: The README and documentation in the `main` branch are relevant to the not yet released code that is present in `main`. Following the documentation from the `main` branch for a stable release of GARM, may lead to errors. To view the documentation for the latest stable release, please switch to the appropriate tag. For information about setting up `v0.1.6`, please refer to the [v0.1.6 tag](https://github.com/cloudbase/garm/tree/v0.1.6).
3837

3938
## Join us on slack
4039

doc/quickstart.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,19 @@
22

33
<!-- TOC -->
44

5-
- [Create the config folder](#create-the-config-folder)
6-
- [The config file](#the-config-file)
7-
- [The provider section](#the-provider-section)
8-
- [Starting the service](#starting-the-service)
9-
- [Using Docker](#using-docker)
10-
- [Setting up GARM as a system service](#setting-up-garm-as-a-system-service)
11-
- [Initializing GARM](#initializing-garm)
12-
- [Setting up the webhook](#setting-up-the-webhook)
13-
- [Creating a GitHub endpoint Optional](#creating-a-github-endpoint-optional)
14-
- [Adding credentials](#adding-credentials)
15-
- [Define a repo](#define-a-repo)
16-
- [Create a pool](#create-a-pool)
5+
- [Quick start](#quick-start)
6+
- [Create the config folder](#create-the-config-folder)
7+
- [The config file](#the-config-file)
8+
- [The provider section](#the-provider-section)
9+
- [Starting the service](#starting-the-service)
10+
- [Using Docker](#using-docker)
11+
- [Setting up GARM as a system service](#setting-up-garm-as-a-system-service)
12+
- [Initializing GARM](#initializing-garm)
13+
- [Setting up the webhook](#setting-up-the-webhook)
14+
- [Creating a GitHub endpoint Optional](#creating-a-github-endpoint-optional)
15+
- [Adding credentials](#adding-credentials)
16+
- [Define a repo](#define-a-repo)
17+
- [Create a pool](#create-a-pool)
1718

1819
<!-- /TOC -->
1920

@@ -133,7 +134,7 @@ docker run -d \
133134
-p 80:80 \
134135
-v /etc/garm:/etc/garm:rw \
135136
-v /var/snap/lxd/common/lxd/unix.socket:/var/snap/lxd/common/lxd/unix.socket:rw \
136-
ghcr.io/cloudbase/garm:v0.1.4
137+
ghcr.io/cloudbase/garm:v0.1.6
137138
```
138139

139140
You will notice that we also mounted the LXD unix socket from the host inside the container where the config you pasted expects to find it. If you plan to use an external provider that does not need to connect to LXD over a unix socket, feel free to remove that mount.
@@ -166,7 +167,7 @@ Adding the `garm` user to the LXD group will allow it to connect to the LXD unix
166167
Next, download the latest release from the [releases page](https://github.com/cloudbase/garm/releases).
167168

168169
```bash
169-
wget -q -O - https://github.com/cloudbase/garm/releases/download/v0.1.5/garm-linux-amd64.tgz | tar xzf - -C /usr/local/bin/
170+
wget -q -O - https://github.com/cloudbase/garm/releases/download/v0.1.6/garm-linux-amd64.tgz | tar xzf - -C /usr/local/bin/
170171
```
171172

172173
We'll be running under an unprivileged user. If we want to be able to listen on any port under `1024`, we'll have to set some capabilities on the binary:
@@ -199,7 +200,7 @@ Copy the sample `systemd` service file:
199200

200201
```bash
201202
wget -O /etc/systemd/system/garm.service \
202-
https://raw.githubusercontent.com/cloudbase/garm/v0.1.5/contrib/garm.service
203+
https://raw.githubusercontent.com/cloudbase/garm/v0.1.6/contrib/garm.service
203204
```
204205

205206
Reload the `systemd` daemon and start the service:
@@ -234,7 +235,7 @@ Before we can start using GARM, we need initialize it. This will create the `adm
234235
To initialize GARM, we'll use the `garm-cli` tool. You can download the latest release from the [releases page](https://github.com/cloudbase/garm/releases):
235236

236237
```bash
237-
wget -q -O - https://github.com/cloudbase/garm/releases/download/v0.1.5/garm-cli-linux-amd64.tgz | tar xzf - -C /usr/local/bin/
238+
wget -q -O - https://github.com/cloudbase/garm/releases/download/v0.1.6/garm-cli-linux-amd64.tgz | tar xzf - -C /usr/local/bin/
238239
```
239240

240241
Now we can initialize GARM:

doc/using_garm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ garm-cli controller show
6666
| Webhook Base URL | https://garm.example.com/webhooks |
6767
| Controller Webhook URL | https://garm.example.com/webhooks/a4dd5f41-8e1e-42a7-af53-c0ba5ff6b0b3 |
6868
| Minimum Job Age Backoff | 30 |
69-
| Version | v0.1.5 |
69+
| Version | v0.1.6 |
7070
+-------------------------+----------------------------------------------------------------------------+
7171
```
7272

0 commit comments

Comments
 (0)