下载并配置 Open Service Mesh (OSM) 客户端库

选择客户端操作系统

本文显示了如何下载 OSM 客户端库,以运营和配置 Azure Kubernetes 服务(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 版本日历

下载并安装 Open Service Mesh (OSM) 客户端二进制文件

在 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 或osm上基于 bash 的 shell 中,使用以下命令安装 OSM 客户端二进制文件。 这些命令可将 osm 客户端二进制文件复制到 PATH 中的标准用户程序位置。

sudo mv ./linux-amd64/osm /usr/local/bin/osm
sudo chmod +x /usr/local/bin/osm

可使用以下命令验证 osm 客户端库是否已正确添加到路径及其版本号。

osm version

下载并安装 Open Service Mesh (OSM) 客户端二进制文件

在基于 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

下载并安装 Open Service Mesh (OSM) 客户端二进制文件

在 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_CONFIG 文件配置 OSM CLI 变量

用户可以替代默认的 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