安装构建 | 安装 | Red Hat OpenShift 1.2 的构建

先决条件
使用 Web 控制台安装构建
- 使用 Web 控制台创建 ShipwrightBuild 资源
使用 CLI 安装构建
- 使用 CLI 创建 ShipwrightBuild 资源
禁用 ShipwrightBuilds 构建控制器和 webhook pod
其他资源

作为集群管理员，您可以在 OpenShift Container Platform 集群上安装构建。

先决条件

您可以访问 OpenShift Container Platform Web 控制台。
您已安装 oc CLI。
您已以管理员身份登录到 OpenShift Container Platform 集群。
您的集群已启用 Marketplace 功能或手动配置了 Red Hat Operator 目录源。

作为依赖组件，Red Hat OpenShift Pipelines Operator 会在安装过程中与 Red Hat OpenShift Operator 的构建一起自动安装。如果您已安装 Red Hat OpenShift Pipelines Operator，则构建将使用该 Operator 进行其功能。

使用 Web 控制台安装构建

您可以使用 OpenShift Container Platform Web 控制台从 OperatorHub 安装 Red Hat OpenShift Operator 的构建。安装此 Operator 可以让您安装和使用构建组件。

步骤

在 Web 控制台的**管理员**视图中，导航到**Operators** → **OperatorHub** 页面。
使用**按关键字筛选**框在目录中搜索 Red Hat OpenShift Operator 的构建。
点击**Red Hat OpenShift Operator 的构建**磁贴。
阅读有关 Operator 的简短说明，然后点击**安装**。
在**安装 Operator** 页面上
1. 检查**安装模式**是否设置为**集群上的所有命名空间（默认）**。此模式将在默认的 `openshift-operators` 命名空间中安装 Operator，以监视并使其可用于集群中的所有命名空间。
2. 检查**已安装命名空间**是否默认设置为 `openshift-operators`。
3. 为**批准策略**选择**自动**。这确保了 Operator 的未来升级将由 Operator Lifecycle Manager (OLM) 自动处理。如果您选择**手动**批准策略，OLM 将创建一个更新请求。然后，您必须作为集群管理员手动批准 OLM 更新请求才能将 Operator 更新到新版本。
4. 选择一个**更新通道**
  - **更新通道**默认设置为**latest**。最新通道允许安装 Red Hat OpenShift Operator 的构建的最新稳定版本。
  - 要安装 Red Hat OpenShift Operator 的构建的特定版本，集群管理员可以使用相应的 `builds-` 通道。例如，要安装 Red Hat OpenShift Operator 的构建版本 `1.2`，您可以使用 `builds-1.2` 通道。
点击**安装**。

验证

安装 Red Hat OpenShift Operator 的构建后，您必须验证是否创建了必需的资源，以确保控制器能够正常运行。

步骤

在 Web 控制台的**管理员**视图中，选择项目为 openshift-builds。
导航到**Operators** → **已安装 Operators** 页面。
点击**所有实例**选项卡。
在**所有实例**选项卡上，验证是否列出了 `OpenShiftBuild` 和 `ShipwrightBuild` 实例。
现在，导航到**工作负载** → **Pod** 页面。
在**Pod** 页面上，验证是否列出了以下 Pod：
- `openshift-builds` 运算符 Pod
- 构建控制器和构建 webhook Pod
- `SharedResource` daemonset 和 `SharedResource` webhook Pod

使用 Web 控制台创建 ShipwrightBuild 资源

安装 Red Hat OpenShift Operator 的构建后，您必须创建一个 `ShipwrightBuild` 资源才能启用构建控制器的功能。

步骤

在 Web 控制台的**管理员**视图中，导航到**Operators → 已安装 Operators** 页面。
点击列表中的“Red Hat OpenShift Operator 的构建”链接。将打开**操作符详细信息**页面。
选择**Shipwright 构建**选项卡，然后点击**创建 ShipwrightBuild**。
选择**表单视图**或**YAML 视图**来配置新的ShipwrightBuild资源，方式如下：
- 选择**表单视图**或**YAML 视图**后，您将看到为name和targetNamespace字段配置的默认值。如果您不想编辑这些字段，请点击**创建**以使用默认值配置ShipwrightBuild资源。
  
  您可以在**Shipwright 构建**选项卡中查看已创建的资源。

验证

必须在提到的目标命名空间中创建构建控制器和构建 webhook pod。

使用 CLI 安装构建

您也可以使用 CLI 安装构建。

步骤

创建一个sub.yaml订阅对象文件，将命名空间订阅到 Red Hat OpenShift Operator 的构建，如下例所示：

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: openshift-builds-operator
  namespace: openshift-operators
spec:
  channel: <channel-name> (1)
  name: openshift-builds-operator (2)
  source: redhat-operators (3)
  sourceNamespace: openshift-marketplace (4)

1	您要从中订阅操作符的渠道名称。
2	要订阅的操作符名称。
3	提供操作符的 CatalogSource 名称。
4	CatalogSource 的命名空间。对于默认的 OperatorHub CatalogSource，请使用`openshift-marketplace`。

通过运行以下命令来应用订阅对象：
```
$ oc apply -f sub.yml
```
Red Hat OpenShift Operator 的构建现在已安装在默认目标命名空间openshift-operators中。

使用 CLI 创建 ShipwrightBuild 资源

安装 Red Hat OpenShift Operator 的构建后，您必须创建一个 `ShipwrightBuild` 资源才能启用构建控制器的功能。

步骤

创建一个instance.yaml文件，以在shipwright-builds命名空间中创建一个ShipwrightBuild资源，如下例所示：

apiVersion: operator.shipwright.io/v1alpha1
kind: ShipwrightBuild
metadata:
  name: openshift-builds
spec:
  targetNamespace: openshift-builds

通过运行以下命令来应用 YAML 文件：
```
$ oc apply -f instance.yaml
```

验证

运行以下命令以验证ShipwrightBuild资源是否已配置：
```
$ oc get pods -n shipwright-builds
```

禁用 ShipwrightBuilds 构建控制器和 webhook pod

您可以禁用ShipwrightBuilds自定义资源 (CR)，而无需禁用共享资源容器存储接口 (CSI) 驱动程序组件和ShipwrightBuilds自定义资源定义 (CRD)。禁用ShipwrightBuilds CR 会从openshift-builds命名空间中删除ShipwrightBuilds构建控制器和ShipwrightBuilds构建 webhook pod。

步骤

通过运行以下命令禁用ShipwrightBuilds控制器和 webhook：
```
$ oc patch openshiftbuild cluster --type=merge -p '{"spec":{"shipwright":{"build":{"state":"Disabled"}}}}'
```
此命令会禁用构建控制器和 webhook，但不会影响ShipwrightBuilds CRD。

其他资源

将操作符添加到集群