CLI 1.1.7.3. 在 macOS 上安装 OpenShift CLI 1.1.8. 手动创建安装配置文件 1.1.8.1. 安装配置参数 1.1.8.1.1. 所需的配置参数 1.1.8.1.2. 网络配置参数 1.1.8.1.3. 可选配置参数 1.1.8.2. 裸机 install-config.yaml 文件示例 1.1.8.3. 在安装过程中配置集群范围代理 1.1.9. 配置三节点集群 CLI 1.2.7.3. 在 macOS 上安装 OpenShift CLI 1.2.8. 手动创建安装配置文件 1.2.8.1. 安装配置参数 1.2.8.1.1. 所需的配置参数 1.2.8.1.2. 网络配置参数 1.2.8.1.3. 可选配置参数 1.2.8.2. 裸机 install-config.yaml 文件示例 1.2.9. 网络配置阶段 1.2.10. 指定高级网络配置 用户置备 DNS 要求 1.3.6. 生成 SSH 私钥并将其添加到代理中 1.3.7. 手动创建安装配置文件 1.3.7.1. 安装配置参数 1.3.7.1.1. 所需的配置参数 1.3.7.1.2. 网络配置参数 1.3.7.1.3. 可选配置参数 1.3.7.2. 裸机 install-config.yaml 文件示例 1.3.7.3. 在安装过程中配置集群范围代理 1.3.8.

在全局范围内禁用构建策略访问 11.2. 在全局范围内限制用户使用构建策略 11.3. 在项目范围内限制用户使用构建策略 第 第 12 章 章 构 构建配置 建配置资 资源 源 12.1. 构建控制器配置参数 12.2. 配置构建设置 第 第 13 章 章 构 构建故障排除 建故障排除 13.1. 解决资源访问遭到拒绝的问题 13.2. 服务证书生成失败 第 第 14 章 章 为构 为构建 建设 Platform 4.4 构 构建（ 建（build） ） 2 目 目录 录 3 第 1 章 理解镜像构建 1.1. 构建（BUILD） 构建 (build)是将输入参数转换为结果对象的过程。此过程最常用于将输入参数或源代码转换为可运行的镜 像。BuildConfig 对象是整个构建过程的定义。 OpenShift Container Platform 使用 Kubernetes，从构建镜像创建容器并将它们推送到容器镜像 --from-dir 时，还可以指定要提取的存档的 URL。 --from-archive：指定的存档发送到构建器，并在构建器上下文目录中提取。此选项与 --from-dir 的行为相同；只要这些选项的参数是目录，就会首先在主机上创建存档。 在上方列出的每种情形中： 如果 BuildConfig 已经定义了 Binary 源类型，它会有效地被忽略并且替换成客户端发送的内 容。 如果 BuildConfig

OPENSHIFT 构建 使用 OpenShift 构建时，您可以使用声明性构建过程创建云原生应用程序。您可以在用于创建 BuildConfig 对象的 YAML 文件中定义构建过程。此定义包括构建触发器、输入参数和源代码等属性。部 署之后，BuildConfig 对象通常构建可运行的镜像并将其推送到容器镜像 registry。 OpenShift 构建为构建策略提供以下可扩展的支持： Docker 构建 CONTAINER PLATFORM CI/CD 概述 概述 3 第 2 章 构建（BUILD） 2.1. 理解镜像构建 2.1.1. Builds 构建 (build) 是将输入参数转换为结果对象的过程。此过程最常用于将输入参数或源代码转换为可运行的 镜像。BuildConfig 对象是整个构建过程的定义。 OpenShift Container Platform 使用 Kubernetes，从构建镜像创建容器并将它们推送到容器镜像 Dockerfile 构建容器镜像。有关使用 Dockerfile 构建容器 镜像的更多信息，请参阅 Dockerfile 参考文档。 提示 提示 如果使用 buildArgs 数组设置 Docker 构建参数，请参阅 Dockerfile 参考文档中了解 ARG 和 FROM 如何 交互。 2.1.1.2. Source-to-image 构 构建 建 Source-to-Image (S2I) 是

OPERATOR 2.1. 云平台和 OPENSTACK 上的镜像 REGISTRY 2.2. 裸机和 VSPHERE 上的镜像 REGISTRY 2.3. IMAGE REGISTRY OPERATOR 配置参数 2.4. 使用 CRD 启用 IMAGE REGISTRY 默认路由 2.5. 为镜像 REGISTRY 访问配置额外的信任存储 2.6. 为 IMAGE REGISTRY OPERATOR 配置一个存储凭证 上安装或升级安装程序置备的基础架构集群时，Image Registry Operator 会将 spec.storage.managementState 参数设置为 Managed。如果 spec.storage.managementState 参数设置为 Unmanaged，则 Image Registry Operator 不会执行与存储相关的操作。 当部署了control plane后，Operator imageregistry.operator.openshift.io." 2.3. IMAGE REGISTRY OPERATOR 配置参数 configs.imageregistry.operator.openshift.io资源提供以下配置参数。 参数 参数 描述 描述 managementState Managed: Operator 在资源被更新时对 registry 进行相应更新。

服务器根据项目模板自动置备新的项目，模板通过集群的项目配置资 源中的 projectRequestTemplate 参数来标识。如果没有定义该参数，API 服务器会创建一个默认模板， 该模板将以请求的名称创建项目，并将请求用户分配至该项目的 admin 角色。 提交项目请求时，API 会替换模板中的以下参数： 表 2.1. 默认项目模板参数 参数 参数 描述 描述 PROJECT_NAME 项目的名称。必需。 PROJECT_DISPLAYNAME CLI： i. 编辑 project.config.openshift.io/cluster 资源： 6. 更新 spec 部分，使其包含 projectRequestTemplate 和 name 参数，再设置您上传的项目模板 的名称。默认名称为 project-request。 带 带有自定 有自定义项 义项目模板的 目模板的项 项目配置 目配置资 资源 源 7. 保存更改后，创建一个新项目来验证是否成功应用了您的更改。 置为默认 状态。 使用 CLI 更新角色绑定： i. 运行以下命令： ii. 在显示的角色绑定中，将 rbac.authorization.kubernetes.io/autoupdate 参数值设置为 false，如下例所示： 使用单个命令更新角色绑定： 5. 以通过身份验证的用户身份登陆，验证是否无法再自助置备项目： 输 输出示例 出示例 您可以对此项目请求消息进行自定义，以提供特定于您的组织的更多有用说明。

目配置资 源中的 projectRequestTemplate 参数来标识。如果没有定义该参数，API 服务器会创建一个默认模板， 该模板将以请求的名称创建项目，并将请求用户分配至该项目的 admin 角色。 提交项目请求时，API 会替换模板中的以下参数： 表 表 2.1. 默 默认项 认项目模板参数 目模板参数 参数 参数 描述 描述 PROJECT_NAME 项目的名称。必需。 PROJECT_DISPLAYNAME CLI： i. 编辑 project.config.openshift.io/cluster 资源： 6. 更新 spec 部分，使其包含 projectRequestTemplate 和 name 参数，再设置您上传的项目模板 的名称。默认名称为 project-request。 带 带有自定 有自定义项 义项目模板的 目模板的项 项目配置 目配置资 资源 源 7. 保存更改后，创建一个新项目来验证是否成功应用了您的更改。 置为默认 状态。 使用 CLI 更新角色绑定： i. 运行以下命令： ii. 在显示的角色绑定中，将 rbac.authorization.kubernetes.io/autoupdate 参数值设置为 false，如下例所示： 使用单个命令更新角色绑定： 5. 以通过身份验证的用户身份登陆，验证是否无法再自助置备项目： 输 输出示例 出示例 您可以对此项目请求消息进行自定义，以提供特定于您的组织的更多有用说明。

openshift.io资源来禁用Web控制台。 编辑 consoles.operator.openshift.io 资源： 以下示例显示了资源中可以修改的参数： 将managementState参数值设置为Removed以禁用Web控制台。此参数的其他有效值 是Managed（启用由集群控制的控制台），Unmanaged（启用由用户控制管理的Web控制 台）。 $ oc edit consoles 字体。 如果参数或选项是一个变量值，使用 monospaced 字体。 参数使用粗体的 monospaced 字体，选项使用 monospaced 字体。 8.6. 其他资源 关于声音和音调的要求，请参考 PatternFly’s brand voice and tone guidelines 。 关于其他 UX 内容指南，请参考 PatternFly 的 UX 编写风格指南。 OpenShift

VSPHERE 上的镜像 REGISTRY 2.3. IMAGE REGISTRY OPERATOR 在可用区间分布 2.4. 其他资源 2.5. IMAGE REGISTRY OPERATOR 配置参数 2.6. 使用 CRD 启用 IMAGE REGISTRY 默认路由 2.7. 为镜像 REGISTRY 访问配置额外的信任存储 2.8. 为 IMAGE REGISTRY OPERATOR 配置一个存储凭证 上安装或升级安装程序置备的基础架构 集群时，Image Registry Operator 会将 spec.storage.managementState 参数设置为 Managed。如果 spec.storage.managementState 参数设置为 Unmanaged，则 Image Registry Operator 不会执行与存储相关的操作。 当部署了control plane后，Operator topologySpreadConstraints。在这种情况下，只有您提供的约束会被应用。 2.4. 其他资源 配置 pod 拓扑分布限制 2.5. IMAGE REGISTRY OPERATOR 配置参数 topologySpreadConstraints: - labelSelector: matchLabels: docker-registry: default

？ 服务代理（service broker）是实现应用程序的编程发现和部署的一个步骤。但它并非一个长时间运行 的进程，所以无法执行第 2 天操作，如升级、故障转移或扩展。它在安装时提供对可调参数的自定义 和参数化，而 Operator 则可持续监控集群的当前状态。非集群服务仍非常适合于 Service Broker，但 也存在合适于这些服务的 Operator。 2.1.2. Operator Framework package 路径提供 的“latest”或“newest”Operator 不一定是最高版本号。更应将其视为频道的 head 引用，类 似 Git 存储库。 每个 CSV 均有一个 replaces 参数，指明所替换的是哪个 Operator。这样便构建了一个可通过 OLM 查 询的 CSV 图，且不同频道之间可共享更新。可将频道视为更新图表的入口点： 图 2.5. OLM 的可用 的可用频道更新 olm.gvk 依赖项。例外情况 是，指定 olm.package 约束来替代。 设置最小版本 置最小版本 Kubernetes 文档中与 API 的改变相关的部分描述了 Kubernetes 风格的 Operator 允许进行哪些更改。 只要 API 向后兼容，Operator 就允许 Operator 对 API 进行更新，而不需要更改 API 的版本。 对于 Operator 依赖项，这意味着了解依赖的

SSH 私钥并将其添加到代理中 4.5.4. 获取安装程序 4.5.5. 创建安装配置文件 4.5.5.1. 安装配置参数 4.5.5.1.1. 所需的配置参数 4.5.5.1.2. 网络配置参数 4.5.5.1.3. 可选配置参数 4.5.5.1.4. 可选的 AWS 配置参数 4.5.5.2. 支持的 AWS 机器类型 4.5.5.3. AWS 的自定义 install-config.yaml 4.7 安装 安装 2 4.6.5. 网络配置阶段 4.6.6. 创建安装配置文件 4.6.6.1. 安装配置参数 4.6.6.1.1. 所需的配置参数 4.6.6.1.2. 网络配置参数 4.6.6.1.3. 可选配置参数 4.6.6.1.4. 可选的 AWS 配置参数 4.6.6.2. 支持的 AWS 机器类型 4.6.6.3. AWS 的自定义 install-config.yaml 的互联网访问 4.7.5. 生成 SSH 私钥并将其添加到代理中 4.7.6. 创建安装配置文件 4.7.6.1. 安装配置参数 4.7.6.1.1. 所需的配置参数 4.7.6.1.2. 网络配置参数 4.7.6.1.3. 可选配置参数 4.7.6.1.4. 可选的 AWS 配置参数 4.7.6.2. AWS 的自定义 install-config.yaml 文件示例 4.7.6.3. 在安装过程中配置集群范围代理