From 327742785ee8a113ad372602e6a11ee2bb9459db Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rapha=C3=ABl=20de=20Courville?= Date: Sat, 21 Sep 2024 13:36:39 +0200 Subject: [PATCH 1/2] Clarify tutorial in ARM32.md --- .github/ARM32.md | 46 ++++++++++++++++++++++++++++------------------ 1 file changed, 28 insertions(+), 18 deletions(-) diff --git a/.github/ARM32.md b/.github/ARM32.md index c8e7d1dc27..a6fcbb0632 100644 --- a/.github/ARM32.md +++ b/.github/ARM32.md @@ -8,23 +8,33 @@ ourselves. ## Instructions -Use [Raspberry Pi Imager](https://www.raspberrypi.com/software/) to download -Raspberry PI OS lite (32bit) to an SD card - -Use the settings to set up a proper hostname and user account. - -Take the written SD card and put it into the Raspberry PI - -Power it up and wait for it to boot - -SSH into the Raspberry PI - -Follow Githubs instructions on how to set up a self-hosted runner -https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners - -Use all the default values in the `./config.sh` setup step - -Use Github instructions to setup the runner as a services so it runs on boot -https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service +### Gathering your Tools + +You will need: + +- A Raspberry Pi +- A micro SD card +- An SD card reader +- A computer + +### Flashing the SD Card +1. Install and open [**Raspberry Pi Imager**](https://www.raspberrypi.com/software/) on your computer +2. In **Raspberry Pi Imager**: + - Select your Raspberry Pi model + - Select "Raspberry PI OS lite (32bit)" as the OS (you may need to look into the sub-menus) + - Select your SD card + - Click NEXT +3. Edit the OS settings: + - Set a hostname (e.g. `processing.local`) + - Set a username and password + - Go to the SERVICES tab and enable SSH with password authentication + - Click SAVE and Apply the OS customisation settings + +### Configuring the Raspberry Pi +1. Take the written SD card and put it into the Raspberry PI +2. Power it up and wait for it to boot +3. SSH into the Raspberry Pi using the hostname, username, and password you set earlier +4. Follow Github's [instructions on how to set up a self-hosted runner](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners). _Note: Use all the default values in the `./config.sh` setup step_ +6. Use Github [instructions to setup the runner as a services](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service) so it runs on boot. Done. From f4d8f9148063f25c7320de121eba94afbfa1ffcc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rapha=C3=ABl=20de=20Courville?= Date: Sat, 21 Sep 2024 13:58:42 +0200 Subject: [PATCH 2/2] Update ARM32.md --- .github/ARM32.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/.github/ARM32.md b/.github/ARM32.md index a6fcbb0632..c0801efd6e 100644 --- a/.github/ARM32.md +++ b/.github/ARM32.md @@ -34,7 +34,9 @@ You will need: 1. Take the written SD card and put it into the Raspberry PI 2. Power it up and wait for it to boot 3. SSH into the Raspberry Pi using the hostname, username, and password you set earlier -4. Follow Github's [instructions on how to set up a self-hosted runner](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners). _Note: Use all the default values in the `./config.sh` setup step_ -6. Use Github [instructions to setup the runner as a services](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service) so it runs on boot. +4. Follow Github's [instructions on how to set up a self-hosted runner](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners). _Note: In the `./config.sh` setup step, you will be prompted to enter a name and other settings. Use default settings by pressing ENTER for each prompt._ +5. Verify that the new runner appears in the list of runners on GitHub. +6. Quit the the runner in the terminal (we will set it up to run automatically on boot). +7. Use Github [instructions to setup the runner as a services](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service) so it runs on boot. Done.