构建应用程序

流程

1. 浏览至 Home → Project。
2. 点击 Create Project。
3. 输入项目详情。
4. 点击 Create。

1. 点 Project 下拉菜单来查看所有可用的项目。选择 Create Project。

   图 2.1. Create Project

   
2. 在 Create Project 对话框的 Name 项中输入一个唯一的名称，如 myproject。
3. 可选：添加项目的 Display Name 和 Description 详情。
4. 点 Create。
5. 使用左侧导航面板导航到 Project 视图，在仪表板中查看您的项目。

6. 可选：

   • 在屏幕顶部的 Project 下拉菜单中选择 all projects 列出集群中的所有项目。
   • 使用 Details 选项卡查看项目详情。
   • 如果您有足够的项目权限，可以使用 Project Access 选项卡为项目提供或撤销 administrator、edit 和 view 权限。

流程

1. 浏览至 Home → Project。

2. 选择要查看的项目。

   在本页中，点击 Workloads 以查看项目中的工作负载。

流程

1. 要查看项目列表，请运行：

   $ oc get projects

2. 您可以从当前项目更改到其他项目，以进行 CLI 操作。然后，所有操控项目范围内容的后续操作都会使用指定的项目：

   $ oc project <project_name>

1. 在 Developer 视角中,导航到 Project 视图。
2. 在 Project 页面中,选择 Project Access 选项卡。

3. 点击 Add Access 为默认权限添加新权限行。

   图 2.2. 项目权限

   
4. 输入用户名，点 Select a role 下拉列表，然后选择适当的角色。
5. 点击 Save 添加新权限。

1. 在 Search 视图中，使用 Resources 下拉列表搜索 Console。

2. 在可用选项中，选择 Console operator.openshift.io/v1。

   图 2.3. 搜索控制台资源

   
3. 在 Name 列表下选择 cluster。
4. 导航到 YAML 选项卡以查看和编辑 YAML 代码。

5. 在 spec 下的 YAML 代码中，添加或编辑 availableClusterRoles 列表并保存您的更改：

   spec:
     customization:
       projectAccess:
         availableClusterRoles:
         - admin
         - edit
         - view

流程

1. 在 Web 控制台导航菜单顶部的上下文选择器中，选择 Developer。
2. 点击 + Add
3. 在页面顶部，选择要添加到的项目的名称。
4. 单击添加到项目的方法，然后按照工作流操作。

流程

1. 浏览至 Home → Project。
2. 选择一个项目来查看其状态。

流程

1. 运行：

   $ oc status

   此命令提供当前项目的高级概述，以及它的组件和关系。

流程

1. 浏览至 Home → Project。
2. 找到您要从项目列表中删除的项目。
3. 在项目列表的最右侧，从 Options 菜单中 选择 Delete Project。
4. 打开 Delete Project 界面时，在字段中输入要删除的项目名称。
5. 点击 Delete。

流程

1. 运行：

   $ oc delete project <project_name>

流程

1. 以具有 cluster-admin 特权的用户身份登录。

2. 生成默认项目模板：

   $ oc adm create-bootstrap-project-template -o yaml > template.yaml

3. 使用文本编辑器，通过添加对象或修改现有对象来修改生成的 template.yaml 文件。

4. 项目模板必须创建在 openshift-config 命名空间中。加载修改后的模板：

   $ oc create -f template.yaml -n openshift-config

5. 使用 Web 控制台或 CLI 编辑项目配置资源。

   • 使用 Web 控制台：

     1. 导航至 Administration → Cluster Settings 页面。
     2. 点击 Global Configuration，查看所有配置资源。
     3. 找到 Project 的条目，并点击 Edit YAML。

   • 使用 CLI：

     1. 编辑 project.config.openshift.io/cluster 资源：

        $ oc edit project.config.openshift.io/cluster

6. 更新 spec 部分，使其包含 projectRequestTemplate 和 name 参数，再设置您上传的项目模板的名称。默认名称为 project-request。

   带有自定义项目模板的项目配置资源

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestTemplate:
       name: <template_name>

7. 保存更改后，创建一个新项目来验证是否成功应用了您的更改。

流程

1. 以具有 cluster-admin 特权的用户身份登录。

2. 运行以下命令，以查看 self-provisioners 集群角色绑定用法：

   $ oc describe clusterrolebinding.rbac self-provisioners

   输出示例

   Name:		self-provisioners
   Labels:		<none>
   Annotations:	rbac.authorization.kubernetes.io/autoupdate=true
   Role:
     Kind:	ClusterRole
     Name:	self-provisioner
   Subjects:
     Kind	Name				Namespace
     ----	----				---------
     Group	system:authenticated:oauth

   检查 self-provisioners 部分中的主题。

3. 从 system:authenticated:oauth 组中移除 self-provisioner 集群角色。

   • 如果 self-provisioners 集群角色绑定仅将 self-provisioner 角色绑定至 system:authenticated:oauth 组，请运行以下命令：

     $ oc patch clusterrolebinding.rbac self-provisioners -p '{"subjects": null}'

   • 如果 self-provisioners 集群角色将 self-provisioner 角色绑定到 system:authenticated:oauth 组以外的多个用户、组或服务帐户，请运行以下命令：

     $ oc adm policy \
         remove-cluster-role-from-group self-provisioner \
         system:authenticated:oauth

4. 编辑 self-provisioners 集群角色绑定，以防止自动更新角色。自动更新会使集群角色重置为默认状态。

   • 使用 CLI 更新角色绑定：

     1. 运行以下命令：

        $ oc edit clusterrolebinding.rbac self-provisioners

     2. 在显示的角色绑定中，将 rbac.authorization.kubernetes.io/autoupdate 参数值设置为 false，如下例所示：

        apiVersion: authorization.openshift.io/v1
        kind: ClusterRoleBinding
        metadata:
          annotations:
            rbac.authorization.kubernetes.io/autoupdate: "false"
          ...

   • 使用单个命令更新角色绑定：

     $ oc patch clusterrolebinding.rbac self-provisioners -p '{ "metadata": { "annotations": { "rbac.authorization.kubernetes.io/autoupdate": "false" } } }'

5. 以通过身份验证的用户身份登陆，验证是否无法再自助置备项目：

   $ oc new-project test

   输出示例

   Error from server (Forbidden): You may not request a new project via this API.

   您可以对此项目请求消息进行自定义，以提供特定于您的组织的更多有用说明。

流程

1. 使用 Web 控制台或 CLI 编辑项目配置资源。

   • 使用 Web 控制台：

     1. 导航至 Administration → Cluster Settings 页面。
     2. 点击 Global Configuration，查看所有配置资源。
     3. 找到 Project 的条目，并点击 Edit YAML。

   • 使用 CLI：

     1. 以具有 cluster-admin 特权的用户身份登录。

     2. 编辑 project.config.openshift.io/cluster 资源：

        $ oc edit project.config.openshift.io/cluster

2. 更新 spec 部分，使其包含 projectRequestMessage 参数，并将值设为您的自定义消息：

   带有自定义项目请求消息的项目配置资源

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestMessage: <message_string>

   例如：

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestMessage: To request a project, contact your system administrator at projectname@example.com.

3. 保存更改后，请尝试用无法自助置备项目的开发人员或服务帐户创建一个新项目，以验证是否成功应用了您的更改。

流程

1. 在 +Add 视图中，点 Samples 标题查看 Samples 页面。
2. 在 Samples 页面中，选择一个可用的示例应用程序来查看 Create Sample Application 表单。

3. 在 Create Sample Application Form 中：

   • 在 Name 字段中，部署名称会被默认显示。您可以根据需要修改此名称。
   • 在 Builder Image Version 中，会默认选择一个构建器镜像。您可以使用 Builder Image Version 下拉列表修改此镜像版本。
   • 默认添加 Git 存储库 URL 示例。
4. 点 Create 创建示例应用程序。示例应用程序的构建状态显示在 Topology 视图中。创建示例应用程序后，您可以看到添加到应用程序的部署。

流程

1. 在 +Add 视图中，点 View all quick starts 链接来查看 Quick Starts 页面。
2. 在 Quick Starts 页面中，点您要使用的快速启动的标题。
3. 点 Start 开始快速启动。

流程

1. 在 +Add 视图中，点 Git Repository 标题中的 From Git 来查看 Import from git 表单。
2. 在 Git 部分中，输入您要用来创建应用程序的代码库的 Git 存储库 URL。例如，输入此示例 Node.js 应用程序的 URL https://github.com/sclorg/nodejs-ex。这个 URL 随后会被验证。

3. 可选：您可以点 Show Advanced Git Options 来添加详情，例如：

   • git Reference，指向特定的分支、标签或提交中的代码，以用于构建应用程序。
   • Context Dir，指定要用来构建应用程序的应用程序源代码的子目录。
   • Source Secret，创建一个具有用来从私有存储库拉取源代码的凭证的 Secret Name。

4. 可选：现在，您可以通过 Git 存储库导入 devfile、Dockerfile 或构建器镜像来进一步自定义部署。

   • 如果您的 Git 存储库包含 devfile、Dockerfile 或构建器镜像，它会被自动检测并填充到相应的路径字段中。如果同一存储库中检测到 devfile、Dockerfile 和构建器镜像，则默认选择 devfile。
   • 若要编辑文件导入类型并选择不同的策略，请单击 Edit import strategy 选项。
   • 如果检测到多个 devfile、Dockerfile 或构建器镜像，以导入特定的 devfile、Dockerfile 或构建器镜像，请指定与上下文目录相关的相应路径。

5. 在验证 Git URL 后，会选择建议的构建器镜像并标记为星号。如果构建器镜像没有自动探测到，请选择一个构建器镜像。对于 https://github.com/sclorg/nodejs-ex Git URL，默认选择了 Node.js 构建器镜像。

   1. 可选：使用 Builder Image Version 下拉菜单指定版本。
   2. 可选：使用 Edit import 策略来选择不同的策略。

6. 在 General 部分中：

   1. 在 Application 字段中输入应用程序组别的唯一名称，例如 myapp。确保应用程序名称在命名空间中具有唯一性。

   2. 系统会基于 Git 存储库的 URL 自动填充 Name 字段，以标识为此应用程序创建的资源（如果没有存在的应用程序）。如果已有应用程序，可以选择将组件部署到现有应用程序中，创建一个新应用程序，或保持该组件没有被分配。

      注意

      资源名称必须在命名空间中具有唯一性。如果遇到错误，请修改资源名称。

7. 在 Resources 部分，选择：

   • Deployment，以纯 Kubernetes 风格方式创建应用程序。
   • Deployment Config，创建 OpenShift Container Platform 风格的应用程序。
   • Knative Service，创建微服务。
   注意

   只有集群中安装了 Serverless Operator 时，Import from git 表单中才会显示 Knative Service 部分。如需进一步了解详细信息，请参阅有关安装 OpenShift Serverless 的文档。

8. 在 Pipelines 部分，选择 Add Pipeline，然后点 Show Pipeline Visualization 来查看应用程序的管道。
9. Advanced Options 部分中默认选中 Create a route to the application，以便您可以使用公开的 URL 访问应用程序。如果不想通过公共路由公开您的应用程序，可以清除此复选框。
10. 可选：可以使用以下高级选项进一步自定义应用程序：

流程

1. 在 Topology 视图中，右键单击 Topology 视图中的任意位置，以查看 Add to Project 菜单。
2. 将鼠标悬停在 Add to Project 菜单上，以查看菜单选项，然后选择 Upload JAR 文件选项以查看 Upload JAR 文件表单。或者，您可以在 Topology 视图中拖放 JAR 文件。
3. 在 JAR 文件字段中，浏览本地计算机上所需的 JAR 文件并上传该文件。或者，您可以将 JAR 文件拖放到字段。如果将不兼容的文件类型拖放到 Topology 视图中，则右上角会显示一个警报。如果上传表单的字段中丢弃了不兼容的文件类型，则会显示字段错误。
4. 您可以进一步指定可选的 Java 命令来自定义部署的应用程序。默认选择 Runtime Icon 和 Builder Image。如果没有自动探测到构建器镜像，请选择一个构建器镜像。如果需要，您可以使用 Builder Image Version 下拉列表来更改版本。
5. 在可选的 Application Name 字段中输入应用程序的唯一名称作为资源标记。
6. 在 Name 字段中输入唯一组件名称来命名关联的资源。
7. 在 Resources 字段中，为您的应用程序选择资源类型。
8. 在 Advanced options 中，点 Create a Route to the Application 配置您部署的应用程序的公共 URL。

9. 单击 Create 以部署应用。用户会看到一个切换通知，通知 JAR 文件正在上传，这个过程会花费一段时间。相关通知还包括用于查看构建日志的链接。

   注意

   如果用户尝试在构建运行时关闭浏览器标签页，系统会显示一个 Web 警报，询问用户是否真正想离开页面。

流程

1. 在 Developer 视角中，导航到 +Add 视图，从 Developer Catalog 标题中点击 All Services 来查看 Developer Catalog 中的所有可用服务。
2. 在 All Services 下，选择服务类型或您需要添加到项目的组件。在本例中，选择 Databases 以列出所有数据库服务，然后点击 MariaDB 查看该服务的详情。

3. 点 Instantiate Template 查看带有 MariaDB 服务详情的自动填充的模板，然后点 Create 在 Topology 视图中创建并查看 MariaDB 服务的信息。

   图 3.1. Topology 中的 MariaDB

   

流程

1. 针对此流程在 OpenShift Container Platform Web 控制台中新建一个项目。这个示例使用名为 my-etcd 的项目。

2. 导航至 Operators → Installed Operators 页面。由集群管理员安装到集群且可供使用的 Operator 将以集群服务版本（CSV）列表形式显示在此处。CSV 用于启动和管理由 Operator 提供的软件。

   提示

   使用以下命令从 CLI 获得该列表：

   $ oc get csv

3. 在 Installed Operators 页面中，点 etcd Operator 查看更多详情和可用操作。

   正如 Provided API 下所示，该 Operator 提供了三类新资源，包括一种用于 etcd Cluster 的资源（EtcdCluster 资源）。这些对象的工作方式与内置的原生 Kubernetes 对象（如 Deployment 或 ReplicaSet ）相似，但包含特定于管理 etcd 的逻辑。

4. 新建 etcd 集群：

   1. 在 etcd Cluster API 框中，点 Create instance。
   2. 在下一页上，您可对 EtcdCluster 对象的最小起始模板进行任何修改，比如集群大小。现在，点击 Create 即可完成。点击后即可触发 Operator 启动 pod、服务和新 etcd 集群的其他组件。

5. 点 example etcd 集群，然后点 Resources 选项卡，您可以看到项目现在包含很多由 Operator 自动创建和配置的资源。

   验证已创建了支持您从项目中的其他 pod 访问数据库的 Kubernetes 服务。

6. 给定项目中具有 edit 角色的所有用户均可创建、管理和删除应用程序实例（本例中为 etcd 集群），这些实例由已在项目中创建的 Operator 以自助方式管理，就像云服务一样。如果要赋予其他用户这一权利，项目管理员可使用以下命令添加角色：

   $ oc policy add-role-to-user edit <user> -n <target_project>

流程

1. 光标悬停到 MongoDB 服务上，节点上出现悬浮的箭头。

   图 4.8. 连接器

   
2. 点击箭头并将它拖向 Node.js 组件，使它与 MongoDB 服务连接。
3. 点击 MongoDB 服务以查看 Overview 面板。在 Annotations 部分，点编辑图标，查看 Key = app.openshift.io/connects-to 和 Value = [{"apiVersion":"apps.openshift.io/v1", "kind":"DeploymentConfig","name":"nodejs-ex"}] 注解被添加到该服务。

流程

1. 创建一个 CatalogSource 资源，将红帽提供的 PostgresSQL Database Operator 添加到 OperatorHub。

   1. 在 +Add 视图中，点 YAML 选项查看 Import YAML 屏幕。

   2. 添加以下 YAML 文件以应用 CatalogSource 资源：

      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
          name: sample-db-operators
          namespace: openshift-marketplace
      spec:
          sourceType: grpc
          image: quay.io/redhat-developer/sample-db-operators-olm:v1
          displayName: Sample DB OLM registry
          updateStrategy:
              registryPoll:
                  interval: 30m

   3. 点击 Create 在集群中创建 CatalogSource 资源。

2. 安装红帽提供的 PostgreSQL Database Operator:

   1. 在控制台的 Administrator 视角中，进入 Operators → OperatorHub。
   2. 在 Database 类别中，选择 PostgreSQL Database Operator 并安装它。

3. 为应用程序创建数据库 (DB) 实例：

   1. 切换到 Developer 视角，并确保您处于适当的项目中，例如 test-project 。
   2. 在 +Add 视图中，点 YAML 选项查看 Import YAML 屏幕。

   3. 在编辑器中添加服务实例 YAML，并点击 Create 部署该服务。服务 YAML 将如以下示例所示：

      apiVersion: postgresql.baiju.dev/v1alpha1
      kind: Database
      metadata:
       name: db-demo
      spec:
       image: docker.io/postgres
       imageName: postgres
       dbName: db-demo

      DB 实例现在部署在 Topology 视图中。

4. 在 Topology 视图中，将鼠标悬停在 Node.js 组件上可看到节点上悬浮的箭头。

5. 点击箭头并拖向 db-demo-postgresql 服务，以便与 Node.js 应用程序进行绑定连接。服务绑定请求被创建，Service Binding Operator 控制器会将 DB 连接信息作为环境变量注入应用程序部署中。请求成功后，会重新部署应用程序并建立连接。

   图 4.10. 绑定连接器

   

1. 下载 Helm 二进制文件并将其添加到您的路径中：

   # curl -L https://mirror.openshift.com/pub/openshift-v4/clients/helm/latest/helm-linux-amd64 -o /usr/local/bin/helm

2. 使二进制文件可执行：

   # chmod +x /usr/local/bin/helm

3. 检查已安装的版本：

   $ helm version

   输出示例

   version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}

1. 下载最新的 .exe 文件并放入您自己选择的目录 。
2. 右键点击 Start 并点击 Control Panel。
3. 选择 系统和安全性 ，然后点击 系统。
4. 在左侧的菜单中选择高级系统设置并点击底部的环境变量按钮。
5. 在变量部分选择路径并点编辑 。
6. 点新建并输入到 .exe 文件的路径，或者点击 浏览 并选择目录，然后点 确定。

1. 下载最新的 .exe 文件并放入您自己选择的目录 。
2. 点击 搜索 并输入 env 或者 environment。
3. 选择为您的帐户编辑环境变量。
4. 在变量部分选择路径并点编辑 。
5. 点新建并输入到 exe 文件所在目录的路径，或者点击 浏览 并选择目录，然后点击确定。

1. 下载 Helm 二进制文件并将其添加到您的路径中：

   # curl -L https://mirror.openshift.com/pub/openshift-v4/clients/helm/latest/helm-darwin-amd64 -o /usr/local/bin/helm

2. 使二进制文件可执行：

   # chmod +x /usr/local/bin/helm

3. 检查已安装的版本：

   $ helm version

   输出示例

   version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}

流程

1. 创建一个新项目：

   $ oc new-project mysql

2. 将一个 Helm chart 存储库添加到本地 Helm 客户端：

   $ helm repo add stable https://kubernetes-charts.storage.googleapis.com/

   输出示例

   "stable" has been added to your repositories

3. 更新存储库：

   $ helm repo update

4. 安装示例 MySQL chart：

   $ helm install example-mysql stable/mysql

5. 验证 chart 是否已成功安装：

   $ helm list

   输出示例

   NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
   example-mysql mysql 1 2019-12-05 15:06:51.379134163 -0500 EST deployed mysql-1.5.0 5.7.27

1. 在 Developer 视角中，进入 +Add 视图并选择一个项目。然后点击 Helm Chart 选项来查看 Developer Catalog 中的所有 Helm Chart。
2. 选择一个 chart，查看它的描述信息、README 和其他与之相关的信息。

3. 点 Install Helm Chart。

   图 5.1. Developer Catalog 中的 Helm chart

   

4. 在 Install Helm Chart 页面中：

   1. 在 Release Name 项中输入 release 的唯一名称。
   2. 从 Chart Version 下拉列表中选择所需的 chart 版本。

   3. 使用 Form View 或 YAML View 配置 Helm Chart。

      注意

      在可用情况下，您可以在 YAML View 和 Form View 间切换。在不同视图间切换时数据会被保留。

   4. 点击 Install 创建 Helm release。Topology 视图将会显示，其中包括了发行版本。如果 Helm chart 带有发行注记，则 chart 会被预先选择，右侧面板会显示该发行版本的发行注记。

流程

1. 创建一个新项目：

   $ oc new-project nodejs-ex-k

2. 下载包含 OpenShift Container Platform 对象的示例 Node.js chart：

   $ git clone https://github.com/redhat-developer/redhat-helm-charts

3. 进入包含 chart 示例的目录：

   $ cd redhat-helm-charts/alpha/nodejs-ex-k/

4. 编辑 Chart.yaml 文件并添加 chart 描述：

   apiVersion: v2 1
   name: nodejs-ex-k 2
   description: A Helm chart for OpenShift 3
   icon: https://static.redhat.com/libs/redhat/brand-assets/latest/corp/logo.svg 4

   1

   Chart API 版本。对于至少需要 Helm 3 的 Helm Chart，它应该是 v2 。

   2

   chart 的名称。

   3

   chart 的描述。

   4

   用作图标的图形的 URL。

5. 验证 chart 格式是否正确：

   $ helm lint

   输出示例

   [INFO] Chart.yaml: icon is recommended
   
   1 chart(s) linted, 0 chart(s) failed

6. 前往上一个目录级别：

   $ cd ..

7. 安装 chart：

   $ helm install nodejs-chart nodejs-ex-k

8. 验证 chart 是否已成功安装：

   $ helm list

   输出示例

   NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
   nodejs-chart nodejs-ex-k 1 2019-12-05 15:06:51.379134163 -0500 EST deployed nodejs-0.1.0  1.16.0

流程

1. 要添加新的 Helm Chart 仓库，您必须将 Helm Chart 仓库自定义资源（CR）添加到集群中。

   Helm Chart 仓库 CR 示例

   apiVersion: helm.openshift.io/v1beta1
   kind: HelmChartRepository
   metadata:
     name: <name>
   spec:
    # optional name that might be used by console
    # name: <chart-display-name>
     connectionConfig:
       url: <helm-chart-repository-url>

   例如，要添加 Azure 示例 chart 存储库，请运行：

   $ cat <<EOF | oc apply -f -
   apiVersion: helm.openshift.io/v1beta1
   kind: HelmChartRepository
   metadata:
     name: azure-sample-repo
   spec:
     name: azure-sample-repo
     connectionConfig:
       url: https://raw.githubusercontent.com/Azure-Samples/helm-charts/master/docs
   EOF

2. 导航到 web 控制台中的 Developer Catalog，以验证是否已显示 Helm chart 存储库中的 Helm chart。

   例如，使用 Chart 仓库 过滤器从仓库搜索 Helm chart。

   图 5.2. Chart 软件仓库过滤器

   
   注意

   如果集群管理员删除了所有 chart 仓库，则无法在 +Add 视图、Developer Catalog 和左面的导航面板中查看 Helm 选项。

1. 在 openshift-config 命名空间中，使用 PEM 编码格式的自定义 CA 证书创建一个 configmap，并将它存储在配置映射中的 ca-bundle.crt 键下：

   $ oc create configmap helm-ca-cert \
   --from-file=ca-bundle.crt=/path/to/certs/ca.crt \
   -n openshift-config

2. 在 openshift-config 命名空间中，创建一个 Secret 对象来添加客户端 TLS 配置：

   $ oc create secret tls helm-tls-configs \
   --cert=/path/to/certs/client.crt \
   --key=/path/to/certs/client.key \
   -n openshift-config

   请注意：客户端证书和密钥必须采用 PEM 编码格式，并分别保存在 tls.crt 和 tls.key 密钥中。

3. 按如下所示添加 Helm 仓库：

   $ cat <<EOF | oc apply -f -
   apiVersion: helm.openshift.io/v1beta1
   kind: HelmChartRepository
   metadata:
     name: <helm-repository>
   spec:
     name: <helm-repository>
     connectionConfig:
       url: <URL for the Helm repository>
       tlsConfig:
           name: helm-tls-configs
       ca:
   	name: helm-ca-cert
   EOF

   ConfigMap 和 Secret 使用 tlsConfig 和 ca 字段在 HelmChartRepository CR 中消耗。这些证书用于连接 Helm 仓库 URL。

4. 默认情况下，所有经过身份验证的用户都可以访问所有配置的 chart。但是，对于需要证书的 Chart 仓库，您必须为用户提供对 openshift-config 命名空间中 helm-ca-cert 配置映射和 helm-tls-configs secret 的读取访问权限，如下所示：

   $ cat <<EOF | kubectl apply -f -
   apiVersion: rbac.authorization.k8s.io/v1
   kind: Role
   metadata:
     namespace: openshift-config
     name: helm-chartrepos-tls-conf-viewer
   rules:
   - apiGroups: [""]
     resources: ["configmaps"]
     resourceNames: ["helm-ca-cert"]
     verbs: ["get"]
   - apiGroups: [""]
     resources: ["secrets"]
     resourceNames: ["helm-tls-configs"]
     verbs: ["get"]
   ---
   kind: RoleBinding
   apiVersion: rbac.authorization.k8s.io/v1
   metadata:
     namespace: openshift-config
     name: helm-chartrepos-tls-conf-viewer
   subjects:
     - kind: Group
       apiGroup: rbac.authorization.k8s.io
       name: 'system:authenticated'
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: Role
     name: helm-chartrepos-tls-conf-viewer
   EOF

流程

1. 在 Developer 视角中，进入 +Add 视图并选择一个项目。
2. 在 Developer Catalog 标题中，选择 Helm Chart 选项来查看 Developer Catalog 中的所有 Helm chart。

3. 使用 Helm chart 列表左侧的过滤器过滤所需的 chart:

   • 使用 Chart Repositories 过滤器过滤由 Red Hat Certification Charts 或 OpenShift Helm Charts 提供的 chart。
   • 使用 Source 过滤器过滤来自 合作伙伴、 社区 或 红帽 的 chart。认证图表显示为( )图标。

流程

1. 在 Topology 视图中，选择 Helm 发行本来查看侧面面板。
2. 点 Actions → Upgrade Helm Release。
3. 在 Upgrade Helm Release 页面中，选择您要升级到的 Chart Version，然后点 Upgrade 以创建另一个 Helm 发行版本。Helm Releases 页面会显示两个修订版本。

1. 在 Developer 视角中，导航到 Helm 视图以查看命名空间中的 Helm Release 版本。
2. 点击列出的发行版本 旁边的 Options 菜单，然后选择 Rollback。
3. 在 Rollback Helm Release 页中，选择要回滚到的 Revision，点 Rollback。
4. 在 Helm Releases 页面中，点 chart 查看该发行版本的详情和资源。

5. 进入 Revision History 标签页来查看这个 chart 的所有修订版本。

   图 5.3. Helm 修改历史记录

   
6. 如果需要，您可以进一步使用一个特定修订版本旁的 Options 选项 并选择回滚到的修订版本。

流程

1. 在 Topology 视图中，右键点击 Helm 发行版本并选择 Uninstall Helm Release。
2. 在确认提示中，输入 chart 的名称并点击 Uninstall。

1. ReplicationController 定义的元素。
2. 自动创建新部署的触发器。
3. 在部署之间过渡的策略。
4. 生命周期 hook。

1. 执行任何 pre 生命周期 hook。
2. 根据数量扩展新的复制控制器。
3. 根据最大不可用数，缩减旧的复制控制器。
4. 重复这个扩展，直到新的复制控制器达到所需的副本数，并且旧的复制控制器已缩减为零。
5. 执行任何 post 生命周期 hook。

1. 执行任何 pre 生命周期 hook。
2. 将上一部署缩减到零。
3. 执行任何 mid 生命周期 hook。
4. 向上扩展新的部署。
5. 执行任何 post 生命周期 hook。

1. 在 Actions 下拉菜单中，选择 Edit Deployment Config 来查看应用程序的部署配置详情。
2. 在 YAML 编辑器中，将 spec.strategy.type 更改为 Recreate ，然后点 Save。
3. 在 Topology 视图中，选择节点即可看到侧面板中的 Overview 选项卡。Update Strategy 现在设为 Recreate。

4. 使用 Actions 下拉菜单选择 Start Rollout 以使用 recreate 策略启动更新。recreate 策略首先会终止旧版本应用程序的 pod，然后为新版本启动 pod。

   图 6.2. 重新创建更新

   

流程

1. 在一个文件中定义配额。

2. 使用该文件创建配额，并将其应用到项目：

   $ oc create -f <file> [-n <project_name>]

   例如：

   $ oc create -f core-object-counts.yaml -n demoproject

流程

1. 获取项目中定义的配额列表。例如，对于名为 demoproject 的项目：

   $ oc get quota -n demoproject

   输出示例

   NAME                AGE
   besteffort          11m
   compute-resources   2m
   core-object-counts  29m

2. 描述您关注的配额，如 core-object-counts 配额：

   $ oc describe quota core-object-counts -n demoproject

   输出示例

   Name:			core-object-counts
   Namespace:		demoproject
   Resource		Used	Hard
   --------		----	----
   configmaps		3	10
   persistentvolumeclaims	0	4
   replicationcontrollers	3	20
   secrets			9	10
   services		2	10

流程

1. 在项目请求模板中添加资源配额定义：

   • 如果集群中不存在项目请求模板：

     1. 创建 bootstrap 项目模板并将其输出到名为 template.yaml 的文件：

        $ oc adm create-bootstrap-project-template -o yaml > template.yaml

     2. 在 template.yaml 中添加资源配额定义。以下示例定义了名为 'storage-consumption' 的资源配额。定义必须在模板的 parameter: 部分前添加：

        - apiVersion: v1
          kind: ResourceQuota
          metadata:
            name: storage-consumption
            namespace: ${PROJECT_NAME}
          spec:
            hard:
              persistentvolumeclaims: "10" 1
              requests.storage: "50Gi" 2
              gold.storageclass.storage.k8s.io/requests.storage: "10Gi" 3
              silver.storageclass.storage.k8s.io/requests.storage: "20Gi" 4
              silver.storageclass.storage.k8s.io/persistentvolumeclaims: "5" 5
              bronze.storageclass.storage.k8s.io/requests.storage: "0" 6
              bronze.storageclass.storage.k8s.io/persistentvolumeclaims: "0" 7

        1

        项目中的持久性卷声明总数。

        2

        在一个项目中的所有持久性卷声明中，请求的存储总和不能超过这个值。

        3

        在一个项目中的所有持久性卷声明中，金级存储类中请求的存储总和不能超过这个值。

        4

        在一个项目中的所有持久性卷声明中，银级存储类中请求的存储总和不能超过这个值。

        5

        在一个项目中的所有持久性卷声明中，银级存储类中声明总数不能超过这个值。

        6

        在一个项目中的所有持久性卷声明中，铜级存储类中请求的存储总和不能超过这个值。如果此值设为 0，则 bronze 存储类无法请求存储。

        7

        在一个项目中的所有持久性卷声明中，铜级存储类中请求的存储总和不能超过这个值。如果此值设为 0，则 bronze 存储类无法创建声明。

     3. 通过 openshift-config 命名空间中修改的 template.yaml 文件创建项目请求模板：

        $ oc create -f template.yaml -n openshift-config

        注意

        要将配置作为 kubectl.kubernetes.io/last-applied-configuration注解包括，将 --save-config 选项添加到 oc create 命令中。

        默认情况下，模板称为 project-request。

   • 如果项目请求模板已在集群中存在：

     注意

     如果您使用配置文件以声明性或必要方式管理集群中的对象，请使用这些文件编辑现有项目请求模板。

     1. 列出 openshift-config 命名空间中的模板：

        $ oc get templates -n openshift-config

     2. 编辑现有项目请求模板：

        $ oc edit template <project_request_template> -n openshift-config

     3. 将资源配额定义（如前面的 storage-consumption 示例）添加到现有模板中。定义必须在模板的 parameter: 部分前添加。

2. 如果您创建了项目请求模板，在集群的项目配置资源中引用它：

   1. 访问项目配置资源进行编辑：

      • 使用 web 控制台：

        1. 导航至 Administration → Cluster Settings 页面。
        2. 点击 Global Configuration，查看所有配置资源。
        3. 找到 Project 的条目，并点击 Edit YAML。

      • 使用 CLI：

        1. 编辑 project.config.openshift.io/cluster 资源：

           $ oc edit project.config.openshift.io/cluster

   2. 更新项目配置资源的 spec 部分，使其包含 projectRequestTemplate 和 name 参数。以下示例引用了默认项目请求模板（名称为 project-request）:

      apiVersion: config.openshift.io/v1
      kind: Project
      metadata:
        ...
      spec:
        projectRequestTemplate:
          name: project-request

3. 验证在创建项目时是否应用了资源配额：

   1. 创建一个项目：

      $ oc new-project <project_name>

   2. 列出项目的资源配额：

      $ oc get resourcequotas

   3. 详细描述资源配额：

      $ oc describe resourcequotas <resource_quota_name>

流程

1. 要根据注释选择项目，请运行以下命令：

   $ oc create clusterquota for-user \
        --project-annotation-selector openshift.io/requester=<user_name> \
        --hard pods=10 \
        --hard secrets=20

   这会创建以下 ClusterResourceQuota 对象：

   apiVersion: quota.openshift.io/v1
   kind: ClusterResourceQuota
   metadata:
     name: for-user
   spec:
     quota: 1
       hard:
         pods: "10"
         secrets: "20"
     selector:
       annotations: 2
         openshift.io/requester: <user_name>
       labels: null 3
   status:
     namespaces: 4
     - namespace: ns-one
       status:
         hard:
           pods: "10"
           secrets: "20"
         used:
           pods: "1"
           secrets: "9"
     total: 5
       hard:
         pods: "10"
         secrets: "20"
       used:
         pods: "1"
         secrets: "9"

   1

   将对所选项目强制执行的 ResourceQuotaSpec 对象。

   2

   注解的简单键值选择器。

   3

   可用来选择项目的标签选择器。

   4

   描述每个所选项目中当前配额使用量的各命名空间映射。

   5

   所有选定项目的使用量合计。

   此多项目配额文档使用默认的项目请求端点控制 <user_name> 请求的所有项目。您需要有 10 个 Pod 和 20 个 secret 的限制。

2. 同样，若要根据标签选择项目，请运行以下命令：

   $  oc create clusterresourcequota for-name \1
       --project-label-selector=name=frontend \2
       --hard=pods=10 --hard=secrets=20

   1

   clusterresourcequota 和 clusterquota 是同一命令的别名。for-name 是 ClusterResourceQuota 对象的名称。

   2

   要根据标签选择项目，请使用 --project-label-selector=key=value 格式提供一个键值对。

   这会创建以下 ClusterResourceQuota 对象定义：

   apiVersion: quota.openshift.io/v1
   kind: ClusterResourceQuota
   metadata:
     creationTimestamp: null
     name: for-name
   spec:
     quota:
       hard:
         pods: "10"
         secrets: "20"
     selector:
       annotations: null
       labels:
         matchLabels:
           name: frontend

流程

1. 要查看应用到某一项目的配额，请运行：

   $ oc describe AppliedClusterResourceQuota

   输出示例

   Name:   for-user
   Namespace:  <none>
   Created:  19 hours ago
   Labels:   <none>
   Annotations:  <none>
   Label Selector: <null>
   AnnotationSelector: map[openshift.io/requester:<user-name>]
   Resource  Used  Hard
   --------  ----  ----
   pods        1     10
   secrets     9     20