From 159e4c506a626be68282e41cc64c28f895d08b35 Mon Sep 17 00:00:00 2001 From: Thomas Boop <52323235+thboop@users.noreply.github.com> Date: Tue, 19 Nov 2019 16:27:36 -0500 Subject: [PATCH] Updated Release Notes to use CLI Downloads (#196) * Updated Release Notes to use CLI Downloads * Add Config and Run steps * Specify Root Drive for Windows * Remove unactionable steps from readme config --- releaseNote.md | 66 +++++++++++++++++++++++++++++--------------------- 1 file changed, 39 insertions(+), 27 deletions(-) diff --git a/releaseNote.md b/releaseNote.md index dd08471f2..1c25bf550 100644 --- a/releaseNote.md +++ b/releaseNote.md @@ -10,49 +10,61 @@ - Fixed code warnings in the Runner tests (#178) - Added support for building the Runner in Visual Studio (#173) -## Agent Downloads - -| | Package | -| ------- | ----------------------------------------------------------------------------------------------------------- | -| Windows x64 | [actions-runner-win-x64-.zip](https://githubassets.azureedge.net/runners//actions-runner-win-x64-.zip) | -| macOS | [actions-runner-osx-x64-.tar.gz](https://githubassets.azureedge.net/runners//actions-runner-osx-x64-.tar.gz) | -| Linux x64 | [actions-runner-linux-x64-.tar.gz](https://githubassets.azureedge.net/runners//actions-runner-linux-x64-.tar.gz) | -| Linux arm64 | [actions-runner-linux-arm64-.tar.gz](https://githubassets.azureedge.net/runners//actions-runner-linux-arm64-.tar.gz) | -| Linux arm | [actions-runner-linux-arm-.tar.gz](https://githubassets.azureedge.net/runners//actions-runner-linux-arm-.tar.gz) | - -After Download: - ## Windows x64 - -``` bash -C:\> mkdir myagent && cd myagent -C:\myagent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\actions-runner-win-x64-.zip", "$PWD") +We recommend configuring the runner under ":\actions-runner". This will help avoid issues related to service identity folder permissions and long file path restrictions on Windows +``` +// Create a folder under the drive root +mkdir \actions-runner ; cd \actions-runner +// Download the latest runner package +Invoke-WebRequest -Uri https://githubassets.azureedge.net/runners//actions-runner-win-x64-.zip -OutFile actions-runner-win-x64-.zip +// Extract the installer +Add-Type -AssemblyName System.IO.Compression.FileSystem ; +[System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\actions-runner-win-x64-.zip", "$PWD") ``` ## OSX ``` bash -~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/actions-runner-osx-x64-.tar.gz +// Create a folder +mkdir actions-runner && cd actions-runner +// Download the latest runner package +curl -O https://githubassets.azureedge.net/runners//actions-runner-osx-x64-.tar.gz +// Extract the installer +tar xzf ./actions-runner-osx-x64-.tar.gz ``` ## Linux x64 ``` bash -~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/actions-runner-linux-x64-.tar.gz +// Create a folder +mkdir actions-runner && cd actions-runner +// Download the latest runner package +curl -O https://githubassets.azureedge.net/runners//actions-runner-linux-x64-.tar.gz +// Extract the installer +tar xzf ./actions-runner-linux-x64-.tar.gz ``` -## Linux arm64 +## Linux arm64 (Pre-release) ``` bash -~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/actions-runner-linux-arm64-.tar.gz +// Create a folder +mkdir actions-runner && cd actions-runner +// Download the latest runner package +curl -O https://githubassets.azureedge.net/runners//actions-runner-linux-arm64-.tar.gz +// Extract the installer +tar xzf ./actions-runner-linux-arm64-.tar.gz ``` -## Linux arm +## Linux arm (Pre-release) ``` bash -~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/actions-runner-linux-arm-.tar.gz -``` \ No newline at end of file +// Create a folder +mkdir actions-runner && cd actions-runner +// Download the latest runner package +curl -O https://githubassets.azureedge.net/runners//actions-runner-linux-arm-.tar.gz +// Extract the installer +tar xzf ./actions-runner-linux-arm-.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)