Github Self-Hosted Agent Setup¶
We are using GitHub Self-Hosted Agents for Windows and macOS testing. The build machines and agents must be set up before use.
Windows Agent Setup¶
- Create the user "testbot" on the machine. The password should be the password of email@example.com (available in 1password)
- In admin PowerShell,
Set-ExecutionPolicy -Scope "CurrentUser" -ExecutionPolicy "RemoteSigned"
- In admin Powershell, download and run windows_buildkite_start.ps1 (Use
curl <url> -O windows_buildkite_start.ps1)
- After restart, in administrative git-bash window,
- Now download and run windows_github_agent_setup.sh
- Launch Docker. It may require you to take further actions.
- Log into Chrome with the user firstname.lastname@example.org and enable Chrome Remote Desktop.
curlextensions in /c/tools/php*/php.ini
- If a laptop, set the "lid closing" setting in settings to do nothing.
- Set the "Sleep after time" setting in settings to never.
winaero tweakerand "Enable user autologin checkbox". Set up the machine to automatically log in on boot. Then run
netplwiz, provide the password for the main user, uncheck the "require a password to log in".
- Add the path
C:\Program Files\git\binto the very front of the system environment variables. Otherwise Windows will try to use its own bash.exe or will try to use PowerShell.
- Install the github self-hosted runner software using the "Add New" instructions on https://github.com/organizations/drud/settings/actions. When it asks if you want it as a service... you do.
.buildkite/sanetestbot.shto check your work.
- Reboot the machine and do a test run. (On windows the machine name only takes effect on reboot.)
Last update: July 7, 2022