先决条件

  • Kubernetes 集群，运行 Kubernetes v1.20.0 或者更高版本
  • OSM CLI，或者 helm 3 CLI，或者 OpenShift oc CLI。

Kubernetes 支持

OSM 能够运行在被 OSM 版本发布时所支持的 Kubernetes 版本上。当前支持矩阵是：

开放式服务网格 (OSM) Kubernetes
1.1 1.20 - 1.23
1.0 1.19 - 1.22
0.11 1.19 - 1.22
0.10 1.19 - 1.21

使用 OSM CLI

使用 osm CLI 来安装 OSM 控制平面到一个 Kubernetes 集群上。

OSM CLI 和 chart 兼容性

每一个版本的 OSM CLI 被设计成只能和与其匹配的 OSM Helm 图表一起工作。当一些版本偏差存在时，许多操作或许是可以依旧工作的，但是这些情况并没有经过测试，当使用不同版本的 CLI 和图表时，问题会产生，而且这些问题即便被报告了也可能不会被修复。

运行 CLI

运行 osm install 来安装 OSM 控制平面。

$ osm install
OSM installed successfully in namespace [osm-system] with mesh name [osm]

运行 osm install --help 以了解更多的选项。

Note: 通过 CLI 安装的 OSM 强制部署唯一一个网格在集群里。OSM 安装和管理 CRD，通过添加一个转换网络钩子域到全部的 CRD 来支持多个 API 版本，这个维系了 CRD 到一个指定的 OSM 实例。因此，对 OSM 的正确操作是被强烈建议每个集群只有一个 OSM 网格。

使用 Helm CLI

OSM chart能够通过 Helm CLI 被直接安装。

编辑值文件

您可以通过覆盖值文件来配置 OSM 安装。

  1. 创建一个 values.yaml 文件的副本（确保使用的针对图表的版本是您所要安装的）。

  2. 修改任何您想要定制的值。您可以忽略所有其他的值。

    • 要查阅哪些值对应到 MeshConfig 设定，请参阅 OSM MeshConfig 文档

    • 例如，要设置 MeshConfig 里面的 logLevel 域的值为 info，保存如下的内容作为 override.yaml：

      osm:
  envoyLogLevel: info

Helm 安装

然后运行下面的 helm install 命令。图表版本可以在您打算安装的 Helm 图表的这里找到。

$ helm install <mesh name> osm --repo https://openservicemesh.github.io/osm --version <chart version> --namespace <osm namespace> --values override.yaml

如果您首选使用默认的设置，那么省去 --values 标志。

运行 helm install --help 了解更多选项。

OpenShift

在 OpenShift 上安装 OSM：

  1. 启用特权初始化容器，它们能够正确地设置 iptables。在 OpenShift 上，NET_ADMIN 的能力是不够的。 
    osm install --set="osm.enablePrivilegedInitContainer=true"
    • 如果您已经安装了 OSM，但是没有启用特权初始化容器，那么在 OSM MeshConfig里设置 enablePrivilegedInitContainer 为 true，然后重启网格中的任意的 Pod。
  2. 添加 privileged 安全上下文限制到网格中的每个服务账号。
    • 安装 oc CLI。
    • 添加安全上下文限制到 service account 
       oc adm policy add-scc-to-user privileged -z <service account name> -n <service account namespace>

Pod 安全策略

弃用的：从 v0.10.0 开始，在 OSM 中 PSP 支持已经被弃用了

PSP 支持在 OSM 1.0.0 中将被移除

如果您正在一个集群中运行 OSM，并启用 PSP，传递 --set osm.pspEnabled=true 给您的 osm install 或者 helm install CLI 命令。

在 OSM 中启用 Reconciler

如果您打算在 OSM 中启用 Reconciler，传递 --set osm.enableReconciler=true 给您的 osm install 或者 helm install CLI 命令。关于 Reconciler 的更多信息，请参阅 Reconciler 指南。

检查 OSM 组件

一些组件将被默认安装。检查它们通过使用下面的 kubectl 命令：

# Replace osm-system with the namespace where OSM is installed
$ kubectl get pods,svc,secrets,meshconfigs,serviceaccount --namespace osm-system

一些集群范围（非命名空间组件）也将被安装。检查它们使用下面的 kubectl 命令：

kubectl get clusterrolebinding,clusterrole,mutatingwebhookconfiguration,validatingwebhookconfigurations -l app.kubernetes.io/name=openservicemesh.io

在底层，osm 在控制平面所在的命名空间里通过 Helm 库来创建一个 Helm release 对象。Helm release 名称是 mesh-name。helm CLI 也能够被用来检查更详细的已安装 Kubernetes 清单。去往 https://helm.sh 了解安装 Helm 的指令。

# Replace osm-system with the namespace where OSM is installed
$ helm get manifest osm --namespace osm-system

下一步

现在，OSM 控制平面启动并运行了，添加服务到网格吧。