本文将讨论如何下载 OSM 客户端库，以便使用它来操作和配置 AKS 的 OSM 附加产品，以及如何为你的环境配置二进制文件。
重要
根据群集运行的 Kubernetes 版本，OSM 加载项会安装不同版本的 OSM。
| Kubernetes 版本 | 安装的 OSM 版本 |
|---|---|
| 1.24.0 或更高版本 | 1.2.5 |
| 介于 1.23.5 和 1.24.0 之间 | 1.1.3 |
| 低于 1.23.5 | 1.0.0 |
如果相应的 AKS 版本已结束生命周期，则较旧版本的 OSM 可能无法安装或获得主动支持。 有关 AKS 版本支持窗口的信息，可以查看 AKS Kubernetes 版本日历。
在 Linux 或适用于 Linux 的 Windows 子系统上的基于 bash 的 shell 中，使用 curl 下载 OSM 发行版，然后使用 tar 进行解压缩，如下所示：
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-linux-amd64.tar.gz" | tar -vxzf -
osm 客户端二进制文件在客户端计算机上运行，这使你可以在 AKS 群集中管理 OSM。 在 Linux 或适用于 Linux 的 Windows 子系统上基于 bash 的 shell 中，使用以下命令安装 OSM osm 客户端二进制文件。 这些命令可将 osm 客户端二进制文件复制到 PATH 中的标准用户程序位置。
sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
可使用以下命令验证 osm 客户端库是否已正确添加到路径及其版本号。
osm version
在基于 bash 的 shell 中，使用 curl 下载 OSM 发行版，然后使用 tar 进行解压缩，如下所示：
# Specify the OSM version that will be leveraged throughout these instructions
OSM_VERSION=v1.2.0
curl -sL "https://github.com/openservicemesh/osm/releases/download/$OSM_VERSION/osm-$OSM_VERSION-darwin-amd64.tar.gz" | tar -vxzf -
osm 客户端二进制文件在客户端计算机上运行，这使你可以在 AKS 群集中管理 OSM。 在基于 bash 的 shell 中使用以下命令安装 OSM osm 客户端二进制文件。 这些命令可将 osm 客户端二进制文件复制到 PATH 中的标准用户程序位置。
sudo mv ./darwin-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm
可使用以下命令验证 osm 客户端库是否已正确添加到路径及其版本号。
osm version
在 Windows 上基于 PowerShell 的 shell 中，使用 Invoke-WebRequest 下载 OSM 发行版，然后使用 Expand-Archive 进行解压缩，如下所示：
# Specify the OSM version that will be leveraged throughout these instructions
$OSM_VERSION="v1.2.0"
[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 .
osm 客户端二进制文件在客户端计算机上运行，这使你可以在 AKS 群集中管理 OSM 控制器。 在 Windows 上基于 PowerShell 的 shell 中，使用以下命令安装 OSM osm 客户端二进制文件。 这些命令可将 osm 客户端二进制文件复制到 OSM 文件夹，然后你可以通过 PATH 使其立即可用（在当前 shell 中）或永久可用（跨 shell 重启）。 不需要提升的（管理员）特权即可运行这些命令，不需重启 shell。
# 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\"
警告
不要尝试使用 osm install 通过二进制文件安装 OSM。 这将导致 OSM 安装未作为附加产品与 AKS 集成。
用户可以替代默认的 OSM CLI 配置来增强加载项体验。 这可以通过创建类似于 kubeconfig 的配置文件来完成。 配置文件可以在 $HOME/.osm/config.yaml 中创建，也可以在使用 OSM_CONFIG 环境变量导出的不同路径创建。
该文件必须包含以下 YAML 格式的内容：
install:
kind: managed
distribution: AKS
namespace: kube-system
如果未在 $HOME/.osm/config.yaml 中创建文件，请记得将 OSM_CONFIG 环境变量设置为指向创建配置文件的路径。
设置 OSM_CONFIG 后，osm env 命令的输出应如下所示：
$ osm env
---
install:
kind: managed
distribution: AKS
namespace: kube-system