From 33c743213c95c1ef85dc639aa4035946260cd7d6 Mon Sep 17 00:00:00 2001 From: Bryan MacFarlane Date: Mon, 18 Jul 2016 22:06:29 -0400 Subject: [PATCH] 2.103.1 release docs --- README.md | 2 +- docs/preview/latebreaking.md | 42 +++---------------------------- docs/start/envosx.md | 49 ++++++++++++++++++++++++++++++++++++ docs/start/envredhat.md | 38 ++++++++++++++++++++++++++++ docs/start/envubuntu.md | 36 ++++++++++++++++++++++++++ docs/start/startosx.md | 4 +-- docs/start/startredhat.md | 4 +-- docs/start/startubuntu.md | 14 +++++++++-- docs/start/startwin.md | 8 +++--- 9 files changed, 149 insertions(+), 48 deletions(-) create mode 100644 docs/start/envosx.md create mode 100644 docs/start/envredhat.md create mode 100644 docs/start/envubuntu.md diff --git a/README.md b/README.md index d1afce1323..b2cfee10a6 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Supported on Windows, OSX, Ubuntu and Red Hat. Written for the .NET Core CLR as ## Current Release -[v2.103.0](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0) +[v2.103.1](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1) ## Status diff --git a/docs/preview/latebreaking.md b/docs/preview/latebreaking.md index ee97602a16..28fa885b22 100644 --- a/docs/preview/latebreaking.md +++ b/docs/preview/latebreaking.md @@ -1,4 +1,4 @@ -# VSTS Agent Preview - Late breaking instructions +# VSTS Agent System Pre-Requisites ## Windows @@ -8,46 +8,12 @@ Even though the agent has no pre-requisites, many of the tasks we run require Vi ## ![osx](../res/apple_med.png) OSX -Tested on 10.10 (Yosemite) and 10.11 (El Capitan) - -Update OpenSSL - [issue 110](https://github.com/Microsoft/vsts-agent/issues/110) - -```bash -$ openssl version -OpenSSL 1.0.2f 28 Jan 2016 -``` - -Instructions [located here](http://apple.stackexchange.com/questions/126830/how-to-upgrade-openssl-in-os-x) -On last check 1.0.2g was the version so ensure you use correct mv, sn commands. -Restart new terminal after updating. - -If you are using TfsVc, install Oracle Java 1.6+. - -## ![ubuntu](../res/ubuntu_med.png) Ubuntu 14.04 - -Before running the agent, you need to: - -```bash -sudo apt-get install -y libunwind8 libcurl3 libicu52 -``` -If you are using TfsVc, install Oracle Java 1.6+. +[OSX System Pre-Requisties](../start/envosx.md) ## ![ubuntu](../res/ubuntu_med.png) Ubuntu 16.04 -Before running the agent, you need to: - -```bash -sudo apt-get install -y libunwind8 libcurl3 - -wget http://security.ubuntu.com/ubuntu/pool/main/i/icu/libicu52_52.1-8ubuntu0.2_amd64.deb -sudo dpkg -i libicu52_52.1-8ubuntu0.2_amd64.deb -``` -If you are using TfsVc, install Oracle Java 1.6+. +[Ubuntu System Pre-Requisties](../start/envubuntu.md) ## ![redhat](../res/redhat_med.png) RedHat and CentOS -Install dependencies -```bash -sudo yum -y install libunwind.x86_64 icu -``` -If you are using TfsVc, install Oracle Java 1.6+. +[Redhat/CentOS System Pre-Requisties](../start/envredhat.md) diff --git a/docs/start/envosx.md b/docs/start/envosx.md new file mode 100644 index 0000000000..77440e6d00 --- /dev/null +++ b/docs/start/envosx.md @@ -0,0 +1,49 @@ + + +# ![osx](../res/apple_med.png) OSX System Pre-requisites + +## OSX Version + +Tested on 10.10 (Yosemite) and 10.11 (El Capitan). Not domain joined. + +## OSX + +Net core requires update OpenSSL - [issue 110](https://github.com/Microsoft/vsts-agent/issues/110) + +```bash +$ brew update +$ brew install openssl +$ brew link --force openssl +$ openssl version +OpenSSL 1.0.2f 28 Jan 2016 +``` + +[Discussion here](http://apple.stackexchange.com/questions/126830/how-to-upgrade-openssl-in-os-x) + + +## Git + +If you use git, git >= 2.9.0 is a pre-requisite for OSX agents. + +We recommend using [home brew](http://brew.sh) to install + +```bash +$ brew update +$ brew install git +==> Downloading https://homebrew.bintray.com/bottles/git-2.9.0.el_capitan.bottle.tar.gz +... +(restart terminal) +$ git --version +git version 2.9.0 +$ which git +/usr/local/bin/git +$ ls -la /usr/local/bin/git +... /usr/local/bin/git -> ../Cellar/git/2.9.0/bin/git +``` + +## Optionally Java if TfsVc + +The agent distributes team explorer everywhere. + +But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java. + diff --git a/docs/start/envredhat.md b/docs/start/envredhat.md new file mode 100644 index 0000000000..dee728c622 --- /dev/null +++ b/docs/start/envredhat.md @@ -0,0 +1,38 @@ + + +# ![redhat](../res/redhat_med.png) Redhat/CentOS System Pre-requisites + +## Versions + +Tested on Redhat 7.1. Not domain joined. + +## Git + +If you use git, git >= 2.9.0 is a pre-requisite for Redhat/CentOS agents. + +[Based on Install Latest Git on Redhat/Centos](http://tecadmin.net/install-git-2-x-on-centos-rhel-and-fedora/#) + +```bash +$ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel +$ yum install gcc perl-ExtUtils-MakeMaker + +$ cd /usr/src +$ wget https://www.kernel.org/pub/software/scm/git/git-2.9.2.tar.gz +$ tar xzf git-2.9.2.tar.gz + +$ cd git-2.9.2 +$ make prefix=/usr/local/git all +$ make prefix=/usr/local/git install +``` + +In /etc/bash.rs +```bash +export PATH=$PATH:/usr/local/git/bin +``` + +## Optionally Java if TfsVc + +The agent distributes team explorer everywhere. + +But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java. + diff --git a/docs/start/envubuntu.md b/docs/start/envubuntu.md new file mode 100644 index 0000000000..21bc6b75fd --- /dev/null +++ b/docs/start/envubuntu.md @@ -0,0 +1,36 @@ + + +# ![Ubuntu](../res/ubuntu_med.png) Ubuntu System Pre-requisites + +## Versions + +Tested on 16.04 LTS (Yosemite) and 14.04 LTS (El Capitan). Not domain joined. + +16.04 is recommended since latest and supports SystemD for runnings as a service. + +## Git + +If you use git, git >= 2.9.0 is a pre-requisite for Ubuntu agents. + +[Install Latest Git on Ubuntu](http://askubuntu.com/questions/568591/how-do-i-install-the-latest-version-of-git-with-apt/568596) + +```bash +$ sudo apt-add-repository ppa:git-core/ppa +$ sudo apt-get update +$ sudo apt-get install git +``` + +## Optionally Java if TfsVc + +The agent distributes team explorer everywhere. + +But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java. + +## Etc + +There was an assertion that on Ubuntu 16 this was needed. We didn't need. Adding in case it helps someone. We will verify on clean build and dev boxes. + +```bash +apt-get install libcurl4-openssl-dev +``` + diff --git a/docs/start/startosx.md b/docs/start/startosx.md index 8e80f05710..df20745b56 100644 --- a/docs/start/startosx.md +++ b/docs/start/startosx.md @@ -6,13 +6,13 @@ ## Step 2: Download from Releases -Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0) +Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1) ## Step 3: Create the agent ```bash ~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/vsts-agent-osx.10.11-x64-2.103.0.tar.gz +~/myagent$ tar xzf ~/Downloads/vsts-agent-osx.10.11-x64-2.103.1.tar.gz ``` ## Step 4: Configure diff --git a/docs/start/startredhat.md b/docs/start/startredhat.md index 55da67cccd..012c6e48ee 100644 --- a/docs/start/startredhat.md +++ b/docs/start/startredhat.md @@ -6,13 +6,13 @@ ## Step 2: Download from Releases -Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0) +Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1) ## Step 3: Create the agent ```bash ~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/vsts-agent-rhel.7.2-x64-2.103.0.tar.gz +~/myagent$ tar xzf ~/Downloads/vsts-agent-rhel.7.2-x64-2.103.1.tar.gz ``` ## Step 4: Configure diff --git a/docs/start/startubuntu.md b/docs/start/startubuntu.md index 24a26b3309..08b4e2a250 100644 --- a/docs/start/startubuntu.md +++ b/docs/start/startubuntu.md @@ -8,14 +8,24 @@ ## Step 2: Download from Releases -Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0) +Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1) ## Step 3: Create the agent +**16.04** + ```bash ~/$ mkdir myagent && cd myagent -~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.14.04-x64-2.103.0.tar.gz +~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.16.04-x64-2.103.1.tar.gz ``` + +**14.04** + +```bash +~/$ mkdir myagent && cd myagent +~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.14.04-x64-2.103.1.tar.gz +``` + ## Step 4: Configure ```bash diff --git a/docs/start/startwin.md b/docs/start/startwin.md index 9cf32484eb..64ea7102fc 100644 --- a/docs/start/startwin.md +++ b/docs/start/startwin.md @@ -2,18 +2,20 @@ ## Step 1: System Requirements -[Read here](../preview/latebreaking.md) to ensure system packages are installed +The minimum supported version is Windows 7. + +Even though the agent has no pre-requisites, many of the tasks we run require Visual Studio. ## Step 2: Download from Releases -Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0) +Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1) ## Step 3: Create the agent Create a directory for the agent and unzip. Use explorer or from cmd: ```bash c:\ mkdir myagent && cd myagent -C:\myagent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win7-x64-2.103.0.zip", "$PWD") +C:\myagent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win7-x64-2.103.1.zip", "$PWD") ``` ## Step 4: Configure