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. Use the password for
firstname.lastname@example.org, available in 1Password.
- In admin PowerShell,
Set-ExecutionPolicy -Scope "CurrentUser" -ExecutionPolicy "RemoteSigned".
- In admin Powershell, download and run windows_buildkite_start.ps1 with
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
ddevtestbotand enable Chrome Remote Desktop.
- 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
- Install the GitHub self-hosted runner software using the “Add New” instructions on https://github.com/organizations/ddev/settings/actions. When it asks if you want it as a service: yes, 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: March 5, 2023