37 37 OpenShift Container Platform 3.11 CLI 参考 参考 2 7.3. 安装插件 7.3.1. Plug-in Loader 7.3.1.1. 搜索顺序 7.4. 编写插件 7.4.1. plugin.yaml Descriptor 7.4.2. 建议的目录结构 7.4.3. 访问运行时属性 37 38 38 38 39 39 7.3. 安装插件 安装插件 将插件的 将插件的 plugin.yaml 描述符、二 描述符、二进 进制文件、脚本和 制文件、脚本和资产 资产文件复制到 文件复制到 oc 搜索插件的一个位置。 搜索插件的一个位置。 目前， 目前，OpenShift Container Platform 不会 不会为 为插件提供 插件提供软 软件包管理器。因此，您的 件包管理器。因此，您的责 程序负责 负责 搜索插件文件 搜索插件文件，并 ，并检查 检查插件是否提供 插件是否提供运 运行所需的最小信息。放置在正确位置的文件 行所需的最小信息。放置在正确位置的文件 不提供最小信息（例如，不完整的 不提供最小信息（例如，不完整的 plugin.yaml 描述符）。 描述符）。 7.3.1.1. 搜索 搜索顺 顺序 序 插件加 插件加载 载程序使用以下搜索 程序使用以下搜索顺

身份验证 在身份验证过程中，搜索 LDAP 目录中与提供的用户名匹配的条目。如果找到一个唯一匹配项，则尝试使 用该条目的可分辨名称 (DN) 以及提供的密码进行简单绑定。 执行下面这些步骤： 1. 通过将配置的 url 中的属性和过滤器与用户提供的用户名组合来生成搜索过滤器。 2. 使用生成的过滤器搜索目录。如果搜索返回的不是一个条目，则拒绝访问。 3. 尝试使用搜索所获条目的 DN 和用户提供的密码绑定到 如果绑定失败，则拒绝访问。 5. 如果绑定成功，则将配置的属性用作身份、电子邮件地址、显示名称和首选用户名来构建一个身 份。 配置的 url 是 RFC 2255 URL，指定要使用的 LDAP 主机和搜索参数。URL 的语法是： ldap://host:port/basedn?attribute?scope?filter $ oc apply -f $ oc login localhost:636。 basedn 所有搜索都应从中开始的目录分支的 DN。至少，这必须是目录树的顶端，但也可指定目 录中的子树。 attribute 要搜索的属性。虽然 RFC 2255 允许使用逗号分隔属性列表，但无论提供多少个属性，都 仅使用第一个属性。如果没有提供任何属性，则默认使用 uid。建议选择一个在您使用的 子树中的所有条目间是唯一的属性。 scope 搜索的范围。可以是 one 或 sub。如果未提供范围，则默认使用

14 分布式追踪 分布式追踪 4 如果您在执行本文档所述的某个流程或 OpenShift Container Platform 时遇到问题，请访问 红帽客户门户 网站。 通过红帽客户门户网站： 搜索或者浏览红帽知识库，了解与红帽产品相关的文章和解决方案。 提交问题单给红帽支持。 访问其他产品文档。 要识别集群中的问题，您可以在 OpenShift Cluster Manager 中使用 Insights。Insights TRACING-3431) 1.2.7. 获取支持 如果您在执行本文档所述的某个流程或 OpenShift Container Platform 时遇到问题，请访问 红帽客户门户 网站。 通过红帽客户门户网站： 搜索或者浏览红帽知识库，了解与红帽产品相关的文章和解决方案。 提交问题单给红帽支持。 访问其他产品文档。 要识别集群中的问题，您可以在 OpenShift Cluster Manager 中使用 Insights。Insights TRACING-3431) 1.3.7. 获取支持 如果您在执行本文档所述的某个流程或 OpenShift Container Platform 时遇到问题，请访问 红帽客户门户 网站。 通过红帽客户门户网站： 搜索或者浏览红帽知识库，了解与红帽产品相关的文章和解决方案。 提交问题单给红帽支持。 访问其他产品文档。 要识别集群中的问题，您可以在 OpenShift Cluster Manager 中使用 Insights。Insights

OpenShift Container Platform Logging 。 2.1.7. 关于导出字段 日志记录系统导出字段。导出的字段出现在日志记录中，可从 Elasticsearch 和 Kibana 搜索。 如需更多信息，请参阅关于导出字段。 2.1.8. 关于 OpenShift Logging 组件 OpenShift Logging（日志记录）组件包括了一个要部署到 OpenShift Container 节点创建为“仅数据”节点，使用 client 和 data 角色。control plane 节点执行集群范围的操作，如创建或删除索引、分 片分配和跟踪节点。数据节点保管分片，并执行与数据相关的操作，如 CRUD、搜索和聚合等。与数据相关的操作会占用大量 I/O、内存和 CPU。务 必要监控这些资源，并在当前节点过载时添加更多数据节点。 例如，如果 nodeCount = 4，则创建以下节点： 输 输出示例 出示例 节点创建为“仅数据”节点，使用 client 和 data 角色。control plane 节点执行集群范围的操作，如创建或删除索引、分片分配和跟踪节点。 数据节点保管分片，并执行与数据相关的操作，如 CRUD、搜索和聚合等。与 数据相关的操作会占用大量 I/O、内存和 CPU。务必要监控这些资源，并在当 前节点过载时添加更多数据节点。 例如，如果 nodeCount = 4，则创建以下节点： 输 输出示例

基础架构和审计日志并将其转发到不同的输出。 垃圾 垃圾回收 回收 垃圾回收是清理集群资源的过程，如终止的容器和没有被任何正在运行的 pod 引用的镜像。 Elasticsearch Elasticsearch 是一个分布式搜索和分析引擎。OpenShift Container Platform 使用 ELasticsearch 作为 OpenShift Container Platform Logging 的默认日志存储。 OpenShift Container Platform Logging 。 2.2.7. 关于导出字段 日志记录系统导出字段。导出的字段出现在日志记录中，可从 Elasticsearch 和 Kibana 搜索。 如需更多信息，请参阅关于导出字段。 2.2.8. 关于 OpenShift Logging 组件 OpenShift Logging（日志记录）组件包括了一个要部署到 OpenShift Container 节点创建为“仅数据”节点，使用 client 和 data 角色。control plane 节点执行集群范围的操作，如创建或删除索引、分 片分配和跟踪节点。数据节点保管分片，并执行与数据相关的操作，如 CRUD、搜索和聚合等。与数据相关的操作会占用大量 I/O、内存和 CPU。务 必要监控这些资源，并在当前节点过载时添加更多数据节点。 例如，如果 nodeCount = 4，则创建以下节点： 输 输出示例 出示例

YAML 代码。 流程 流程 自定义项目的不同集群角色： 1. 在 Search 视图中，使用 Resources 下拉列表搜索 Console。 2. 在可用选项中，选择 Console operator.openshift.io/v1。 图 图 2.3. 搜索控制台 搜索控制台资 资源 源 3. 在 Name 列表下选择 cluster。 4. 导航到 YAML 选项卡以查看和编辑 YAML 控制台导航菜单顶部的上下文选择器中，选择 Developer。 2. 点击 + Add 3. 在页面顶部，选择要添加到的项目的名称。 4. 单击添加到项目的方法，然后按照工作流操作。 注意 注意 您还可以使用快速搜索在拓扑中添加组件。 2.1.9. 使用 Web 控制台检查项目状态 流程 流程 1. 浏览至 Home → Project。 2. 选择一个项目来查看其状态。 2.1.10. 使用 CLI 中所有可用服务的列表。 2. 在 All Services 下，选择 Devfiles 来浏览支持特定语言或框架的 devfile。另外，您可以使用 keyword 过滤器使用其名称、标签或描述搜索特定 devfile。 3. 点击您要用来创建应用程序的 devfile。devfile 标题显示 devfile 的详情，包括 devfile 的名称、描 述、供应商和 devfile 文档。

Operator 配置对象中的 samplesRegistry 字段，使其包含镜像配置中定义 的镜像位置的 hostname 部分： 注意 注意 这是必要的，因为镜像流导入过程在此刻不使用镜像（mirro）或搜索机制。 6. 将所有未镜像的镜像流添加到 Cluster Samples Operator 配置对象的 skippedImagestreams 字 段。或者，如果您不想支持任何示例镜像流，在 Cluster CR 的更改应用到集群中的所 有节点。 在拉取或推送镜像时，容器运行时会搜索 image.config.openshift.io/cluster CR 的 registrySources 参 数中列出的 registry。如果您在 allowedRegistries 参数下创建了 registry 列表，则容器运行时仅搜索这 些 registry。不在列表中的 registry 会被阻断。 警告 CR 的更改应用到集群中的所有节点。 在拉取或推送镜像时，容器运行时会搜索 image.config.openshift.io/cluster CR 的 registrySources 参 数中列出的 registry。如果您在 blockedRegistries 参数下创建了 registry 列表，则容器运行时不会搜索 这些 registry。允许所有其他 registry。

ADMINISTRATOR 视角中访问 METRICS TARGETS 页面 8.2. 搜索和过滤指标目标 8.3. 获取目标的详细信息 8.4. 后续步骤 第 第 9 章 章 管理警 管理警报 报 9.1. 在 ADMINISTRATOR 和 DEVELOPER 视角中访问 ALERTING UI 9.2. 搜索和过滤警报、静默和警报规则 9.3. 获取关于警报、静默和警报规则的信息 9.4 通过从公开服务端点中提取数据从目标集群组件中收集指标。 在 OpenShift Container Platform Web 控制台的 Administrator 视角中，您可以使用 Metrics Targets 页面查看、搜索和过滤当前用于提取的端点，这有助于识别和排除问题。例如，您可以查看目标端点的当 前状态，以查看 OpenShift Container Platform Monitoring 无法从目标组件中提取指标。 Administrator 视角中，选择 Observe → Targets。Metrics Targets 页面会打开，其中包含 为指标提取的所有服务端点目标的列表。 8.2. 搜索和过滤指标目标 指标目标列表可能比较长。您可以根据各种条件过滤和搜索这些目标。 在 Administrator 视角中，Metrics Targets 页面提供有关 OpenShift Container Platform 默认项目和用

Operator 配置对象中的 samplesRegistry 字段，使其包含镜像配置中定义 的镜像位置的 hostname 部分： 注意 注意 这是必要的，因为镜像流导入过程在此刻不使用镜像（mirro）或搜索机制。 6. 将所有未镜像的镜像流添加到 Cluster Samples Operator 配置对象的 skippedImagestreams 字 段。或者，如果您不想支持任何示例镜像流，在 Cluster 14 镜 镜像 像 66 1 2 在拉取或推送镜像时，容器运行时会搜索 image.config.openshift.io/cluster CR 的 registrySources 参 数中列出的 registry。如果您在 allowedRegistries 参数下创建了 registry 列表，则容器运行时仅搜索这 些 registry。不在列表中的 registry 会被阻断。 警告 CR 的更改应用到集群中的所有节点。 在拉取或推送镜像时，容器运行时会搜索 image.config.openshift.io/cluster CR 的 registrySources 参 数中列出的 registry。如果您在 blockedRegistries 参数下创建了 registry 列表，则容器运行时不会搜索 这些 registry。允许所有其他 registry。 警告 警告

YAML 代码。 流程 流程 自定义项目的不同集群角色： 1. 在 Search 视图中，使用 Resources 下拉列表搜索 Console。 2. 在可用选项中，选择 Console operator.openshift.io/v1。 图 2.3. 搜索控制台资源 3. 在 Name 列表下选择 cluster。 4. 导航到 YAML 选项卡以查看和编辑 YAML 代码。 5 控制台导航菜单顶部的上下文选择器中，选择 Developer。 2. 点击 + Add 3. 在页面顶部，选择要添加到的项目的名称。 4. 单击添加到项目的方法，然后按照工作流操作。 注意 注意 您还可以使用快速搜索在拓扑中添加组件。 2.1.9. 使用 Web 控制台检查项目状态 流程 1. 浏览至 Home → Project。 2. 选择一个项目来查看其状态。 2.1.10. 使用 CLI 检查项目状态 Container Platform 服务器上搜索具有与所检测语言匹配的 $ oc new-app /home/user/code/myapp --strategy=docker 第 第 3 章 章 创 创建 建应 应用程序 用程序 25 检测了语言后，new-app 会在 OpenShift Container Platform 服务器上搜索具有与所检测语言匹配的 suppors 注解