2019-10-10 00:52:42 -04:00
## Features
2020-03-24 16:25:11 -04:00
- Update Runner Register GitHub API URL to Support Org-level Runner (#339 #345 #352 )
- Preserve workflow file/line/column for better error messages (#356 )
- Switch to use token service instead of SPS for exchanging oauth token. (#325 )
- Load and print machine setup info from .setup_info (#364 )
- Expose job name as $GITHUB_JOB (#366 )
- Add support for job outputs. (#365 )
- Set CI=true when launch process in actions runner. (#374 )
- Set steps.<id>.outcome and steps.<id>.conclusion. (#372 )
- Add support for workflow/job defaults. (#369 )
- Expose GITHUB_REPOSITORY_OWNER and ${{github.repository_owner}}. (#378 )
2019-10-10 00:52:42 -04:00
## Bugs
2020-03-24 16:25:11 -04:00
- Use authenticate endpoint for testing runner connection. (#311 )
- Commands translate file path from container action (#331 )
- Change problem matchers output to debug (#363 )
- Switch hashFiles to extension function (#362 )
- Add expanded volumes strings to container mounts (#384 )
2019-10-10 00:52:42 -04:00
## Misc
2020-03-24 16:25:11 -04:00
- Add runner auth documentation (#357 )
2019-10-10 00:52:42 -04:00
## Windows x64
2020-01-29 12:58:09 -05:00
We recommend configuring the runner in a root folder of the Windows drive (e.g. "C:\actions-runner"). This will help avoid issues related to service identity folder permissions and long file path restrictions on Windows
2019-11-19 16:27:36 -05:00
```
// Create a folder under the drive root
mkdir \actions-runner ; cd \actions-runner
// Download the latest runner package
2019-12-18 15:28:36 -05:00
Invoke-WebRequest -Uri https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-win-x64-<RUNNER_VERSION>.zip -OutFile actions-runner-win-x64-<RUNNER_VERSION>.zip
2019-11-19 16:27:36 -05:00
// Extract the installer
Add-Type -AssemblyName System.IO.Compression.FileSystem ;
2020-01-29 12:58:09 -05:00
[System.IO.Compression.ZipFile]::ExtractToDirectory("$PWD\actions-runner-win-x64-<RUNNER_VERSION>.zip", "$PWD")
2019-10-10 00:52:42 -04:00
` ``
## OSX
` `` bash
2019-11-19 16:27:36 -05:00
// Create a folder
mkdir actions-runner && cd actions-runner
// Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-osx-x64-<RUNNER_VERSION>.tar.gz
2019-11-19 16:27:36 -05:00
// Extract the installer
tar xzf ./actions-runner-osx-x64-<RUNNER_VERSION>.tar.gz
2019-10-10 00:52:42 -04:00
` ``
## Linux x64
` `` bash
2019-11-19 16:27:36 -05:00
// Create a folder
mkdir actions-runner && cd actions-runner
// Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-x64-<RUNNER_VERSION>.tar.gz
2019-11-19 16:27:36 -05:00
// Extract the installer
tar xzf ./actions-runner-linux-x64-<RUNNER_VERSION>.tar.gz
2019-10-10 00:52:42 -04:00
` ``
2019-11-13 11:26:06 -05:00
2019-11-19 16:27:36 -05:00
## Linux arm64 (Pre-release)
2019-11-13 11:26:06 -05:00
` `` bash
2019-11-19 16:27:36 -05:00
// Create a folder
mkdir actions-runner && cd actions-runner
// Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-arm64-<RUNNER_VERSION>.tar.gz
2019-11-19 16:27:36 -05:00
// Extract the installer
tar xzf ./actions-runner-linux-arm64-<RUNNER_VERSION>.tar.gz
2019-11-13 11:26:06 -05:00
` ``
2019-11-19 16:27:36 -05:00
## Linux arm (Pre-release)
2019-11-13 11:26:06 -05:00
` `` bash
2019-11-19 16:27:36 -05:00
// Create a folder
mkdir actions-runner && cd actions-runner
// Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-arm-<RUNNER_VERSION>.tar.gz
2019-11-19 16:27:36 -05:00
// Extract the installer
tar xzf ./actions-runner-linux-arm-<RUNNER_VERSION>.tar.gz
` ``
## Using your self hosted runner
For additional details about configuring, running, or shutting down the runner please check out our [product docs. ](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners )