Merge pull request #151771 from phillipgibson/phillipgibson-osm-preview-docs

updated osm preview docs

Author: megvanhuygen

articles/aks/TOC.yml

@@ -0,0 +1,35 @@
+---
+author: phillipgibson
+
+ms.topic: include
+ms.date: 03/15/2021
+ms.author: phillipgibson
+---
+
+## Download and install the OSM client binary
+
+In a bash-based shell on Linux or [Windows Subsystem for Linux][install-wsl], use `curl` to download the OSM release and then extract with `tar` as follows:
+
+```bash
+# Specify the OSM version that will be leveraged throughout these instructions
+OSM_VERSION=v0.8.2
+
+curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-linux-amd64.tar.gz" | tar -vxzf -
+```
+
+The `osm` client binary runs on your client machine and allows you to manage OSM in your AKS cluster. Use the following commands to install the OSM `osm` client binary in a bash-based shell on Linux or [Windows Subsystem for Linux][install-wsl]. These commands copy the `osm` client binary to the standard user program location in your `PATH`.
+
+```bash
+sudo mv ./linux-amd64/osm /usr/local/bin/osm
+sudo chmod +x /usr/local/bin/osm
+```
+
+You can verify the `osm` client library has been correctly added to your path and its version number with the following command.
+
+```
+osm version
+```
+
+<!-- LINKS - external -->
+
+[install-wsl]: /windows/wsl/install-win10

articles/aks/includes/servicemesh/osm/install-osm-binary-linux.md

@@ -0,0 +1,31 @@
+---
+author: phillipgibson
+
+ms.topic: include
+ms.date: 03/15/2021
+ms.author: phillipgibson
+---
+
+## Download and install the OSM client binary
+
+In a bash-based shell, use `curl` to download the OSM release and then extract with `tar` as follows:
+
+```bash
+# Specify the OSM version that will be leveraged throughout these instructions
+OSM_VERSION=v0.8.2
+
+curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-darwin-amd64.tar.gz" | tar -vxzf -
+```
+
+The `osm` client binary runs on your client machine and allows you to manage OSM in your AKS cluster. Use the following commands to install the OSM `osm` client binary in a bash-based shell. These commands copy the `osm` client binary to the standard user program location in your `PATH`.
+
+```bash
+sudo mv ./darwin-amd64/osm /usr/local/bin/osm
+sudo chmod +x /usr/local/bin/osm
+```
+
+You can verify the `osm` client library has been correctly added to your path and its version number with the following command.
+
+```
+osm version
+```

articles/aks/includes/servicemesh/osm/install-osm-binary-macos.md

@@ -0,0 +1,35 @@
+---
+author: phillipgibson
+
+ms.topic: include
+ms.date: 03/15/2021
+ms.author: pgibson
+---
+
+## Download and install the OSM client binary
+
+In a PowerShell-based shell on Windows, use `Invoke-WebRequest` to download the Istio release and then extract with `Expand-Archive` as follows:
+
+```powershell
+# Specify the OSM version that will be leveraged throughout these instructions
+$OSM_VERSION="v0.8.2"
+
+[Net.ServicePointManager]::SecurityProtocol = "tls12"
+$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -URI "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-windows-amd64.zip" -OutFile "osm-$OSM_VERSION.zip"
+Expand-Archive -Path "osm-$OSM_VERSION.zip" -DestinationPath .
+```
+
+The `osm` client binary runs on your client machine and allows you to manage the OSM controller in your AKS cluster. Use the following commands to install the OSM `osm` client binary in a PowerShell-based shell on Windows. These commands copy the `osm` client binary to an OSM folder and then make it available both immediately (in current shell) and permanently (across shell restarts) via your `PATH`. You don't need elevated (Admin) privileges to run these commands and you don't need to restart your shell.
+
+```powershell
+# Copy osm.exe to C:\OSM
+New-Item -ItemType Directory -Force -Path "C:\OSM"
+Move-Item -Path .\windows-amd64\osm.exe -Destination "C:\OSM\"
+
+# Add C:\OSM to PATH.
+# Make the new PATH permanently available for the current User
+$USER_PATH = [environment]::GetEnvironmentVariable("PATH", "User") + ";C:\OSM\"
+[environment]::SetEnvironmentVariable("PATH", $USER_PATH, "User")
+# Make the new PATH immediately available in the current shell
+$env:PATH += ";C:\OSM\"
+```