构建应用程序

流程

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. 单击 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. 单击 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 视图中，点 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 风格的应用程序。

   • Serverless Deployment，创建 Knative 服务。

     注意

     只有集群中安装 OpenShift Serverless Operator 时，Import from git 表单中才会显示 Serverless Deployment 选项。如需了解更多详细信息，请参阅 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. 在控制台的 Administrator 视角中，导航到 Operators → OperatorHub。
2. 使用 Filter by keyword 复选框在目录中搜索 Service Binding Operator。点 Service Binding Operator 标题。
3. 阅读 Service Binding Operator 页面中有关 Operator 的简单描述。点 Install。

4. 在 Install Operator 页面中：

   1. 为 Installation Mode 选择 All namespaces on the cluster (default)。选择该项会将 Operator 安装至默认openshift-operators 命名空间，这将启用 Operator 以进行监视并在集群中的所有命名空间中可用。
   2. 为 Approval Strategy 选择 Automatic。这样可确保以后对 Operator 的升级由 Operator Lifecycle Manager (OLM) 自动进行。如果您选择 Manual 批准策略，OLM 会创建一个更新请求。作为集群管理员，您必须手动批准 OLM 更新请求，才可将 Operator 更新至新版本。

   3. 选择一个 Update Channel。

      • 默认情况下，stable 频道启用 Service Binding Operator 最新稳定且受支持的发行版本。

5. 点 Install。

   注意

   Operator 会自动安装到 openshift-operators 命名空间中。

6. 在 Installed Operator — ready for use 窗格中，点 View Operator。您会看到 Installed Operators 页面中列出的 Operator。
7. 验证 Status 是否已设置为 Succeeded 来确认已成功安装 Service Binding Operator。

流程

1. 在 shell 中运行以下命令来在 my-petclinic 命名空间中创建 PostgresCluster CR：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: postgres-operator.crunchydata.com/v1beta1
   kind: PostgresCluster
   metadata:
     name: hippo
   spec:
     image: registry.developers.crunchydata.com/crunchydata/crunchy-postgres-ha:centos8-13.4-0
     postgresVersion: 13
     instances:
       - name: instance1
         dataVolumeClaimSpec:
           accessModes:
           - "ReadWriteOnce"
           resources:
             requests:
               storage: 1Gi
     backups:
       pgbackrest:
         image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbackrest:centos8-2.33-2
         repos:
         - name: repo1
           volume:
             volumeClaimSpec:
               accessModes:
               - "ReadWriteOnce"
               resources:
                 requests:
                   storage: 1Gi
         - name: repo2
           volume:
             volumeClaimSpec:
               accessModes:
               - "ReadWriteOnce"
               resources:
                 requests:
                   storage: 1Gi
     proxy:
       pgBouncer:
         image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbouncer:centos8-1.15-2
   EOD

   此 PostgresCluster CR 中的注解启用服务绑定连接并触发 Operator 协调。

   输出会验证数据库实例是否已创建：

   输出示例

   postgrescluster.postgres-operator.crunchydata.com/hippo created

2. 创建数据库实例后，确保 my-petclinic 命名空间中的所有 pod 都在运行：

   $ oc get pods -n my-petclinic

   输出（需要几分钟）验证是否创建并配置了数据库：

   输出示例

   NAME                               READY   STATUS    RESTARTS   AGE
   hippo-backup-nqjg-2rq94            1/1     Running   0          35s
   hippo-instance1-nw92-0             3/3     Running   0          112s
   hippo-pgbouncer-57b98f4476-znsk5   2/2     Running   0          112s
   hippo-repo-host-0                  1/1     Running   0          112s

   配置了数据库后，您可以部署示例应用程序并将其连接到数据库服务。

流程

1. 在 shell 中运行以下命令，使用 PostgresCluster 自定义资源(CR)部署 spring-petclinic 应用程序：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: spring-petclinic
     labels:
       app: spring-petclinic
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: spring-petclinic
     template:
       metadata:
         labels:
           app: spring-petclinic
       spec:
         containers:
           - name: app
             image: quay.io/service-binding/spring-petclinic:latest
             imagePullPolicy: Always
             env:
             - name: SPRING_PROFILES_ACTIVE
               value: postgres
             ports:
             - name: http
               containerPort: 8080
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: spring-petclinic
     name: spring-petclinic
   spec:
     type: NodePort
     ports:
       - port: 80
         protocol: TCP
         targetPort: 8080
     selector:
       app: spring-petclinic
   EOD

   输出会验证 Spring PetClinic 示例应用是否已创建并部署：

   输出示例

   deployment.apps/spring-petclinic created
   service/spring-petclinic created

   注意

   如果要在 web 控制台的 Developer 视角中使用 容器镜像 部署应用程序，则必须在高级选项的 Deployment 部分输入以下环境变量：

   • 名称：SPRING_PROFILES_ACTIVE
   • 值： postgres

2. 运行以下命令，验证应用程序是否还没有连接到数据库服务：

   $ oc get pods -n my-petclinic

   显示 CrashLoopBackOff 状态需要几分钟时间 ：

   输出示例

   NAME                                READY   STATUS             RESTARTS      AGE
   spring-petclinic-5b4c7999d4-wzdtz   0/1     CrashLoopBackOff   4 (13s ago)   2m25s

   在这个阶段，pod 无法启动。如果您尝试与应用交互，它会返回错误。

流程

1. 创建 ServiceBinding CR 以项目绑定数据：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: binding.operators.coreos.com/v1alpha1
   kind: ServiceBinding
   metadata:
     name: spring-petclinic-pgcluster
   spec:
     services: 1
       - group: postgres-operator.crunchydata.com
         version: v1beta1
         kind: PostgresCluster 2
         name: hippo
     application: 3
       name: spring-petclinic
       group: apps
       version: v1
       resource: deployments
   EOD

   1

   指定服务资源列表。

   2

   数据库的 CR。

   3

   示例应用程序，指向带有嵌入式 PodSpec 的 Deployment 或任何其他类似资源。

   输出会验证是否已创建 ServiceBinding CR 以将绑定数据项目到示例应用程序中。

   输出示例

   servicebinding.binding.operators.coreos.com/spring-petclinic created

2. 验证服务绑定的请求是否成功：

   $ oc get servicebindings -n my-petclinic

   输出示例

   NAME                         READY   REASON              AGE
   spring-petclinic-pgcluster   True    ApplicationsBound   7s

   默认情况下，来自数据库服务的绑定数据的值作为运行示例应用程序的工作负载容器中的文件进行投射。例如，Secret 资源中的所有值都投射到 bindings/spring-petclinic-pgcluster 目录中。

   注意

   另外，您还可以通过打印出目录内容来验证应用程序中的文件是否包含投射绑定数据：

   $ for i in username password host port type; do oc exec -it deploy/spring-petclinic -n my-petclinic -- /bin/bash -c 'cd /tmp; find /bindings/*/'$i' -exec echo -n {}:" " \; -exec cat {} \;'; echo; done

   输出示例：使用来自 secret 资源的所有值

   /bindings/spring-petclinic-pgcluster/username: hippo
   /bindings/spring-petclinic-pgcluster/password: KXKF{nAI,I-J6zLt:W+FKnze
   /bindings/spring-petclinic-pgcluster/host: hippo-primary.my-petclinic.svc
   /bindings/spring-petclinic-pgcluster/port: 5432
   /bindings/spring-petclinic-pgcluster/type: postgresql

3. 设置应用程序端口的端口转发，以便从本地环境访问示例应用程序：

   $ oc port-forward --address 0.0.0.0 svc/spring-petclinic 8080:80 -n my-petclinic

   输出示例

   Forwarding from 0.0.0.0:8080 -> 8080
   Handling connection for 8080

4. 访问 http://localhost:8080/petclinic。

   现在，您可以在 localhost:8080 远程访问 Spring PetClinic 示例应用程序，并查看应用程序现在连接到数据库服务。

流程

1. 要在 my-petclinic 命名空间中部署 Dev4Devs PostgreSQL Operator，请在 shell 中运行以下命令：

验证

1. 安装 Operator 后，列出 openshift-operators 命名空间中的 Operator 订阅：

   $ oc get subs -n openshift-operators

   输出示例

   NAME                               PACKAGE                            SOURCE                  CHANNEL
   postgresql-operator-dev4devs-com   postgresql-operator-dev4devs-com   ibm-multiarch-catalog   alpha
   rh-service-binding-operator        rh-service-binding-operator        redhat-operators        stable

流程

1. 在 shell 中运行以下命令来在 my-petclinic 命名空间中创建 Database CR：

   $ oc apply -f - << EOD
   apiVersion: postgresql.dev4devs.com/v1alpha1
   kind: Database
   metadata:
     name: sampledatabase
     namespace: my-petclinic
     annotations:
       host: sampledatabase
       type: postgresql
       port: "5432"
       service.binding/database: 'path={.spec.databaseName}'
       service.binding/port: 'path={.metadata.annotations.port}'
       service.binding/password: 'path={.spec.databasePassword}'
       service.binding/username: 'path={.spec.databaseUser}'
       service.binding/type: 'path={.metadata.annotations.type}'
       service.binding/host: 'path={.metadata.annotations.host}'
   spec:
     databaseCpu: 30m
     databaseCpuLimit: 60m
     databaseMemoryLimit: 512Mi
     databaseMemoryRequest: 128Mi
     databaseName: "sampledb"
     databaseNameKeyEnvVar: POSTGRESQL_DATABASE
     databasePassword: "samplepwd"
     databasePasswordKeyEnvVar: POSTGRESQL_PASSWORD
     databaseStorageRequest: 1Gi
     databaseUser: "sampleuser"
     databaseUserKeyEnvVar: POSTGRESQL_USER
     image: registry.redhat.io/rhel8/postgresql-13:latest
     databaseStorageClassName: nfs-storage-provisioner
     size: 1
   EOD

   此 Database CR 中添加的注解可启用服务绑定连接并触发 Operator 协调。

   输出会验证数据库实例是否已创建：

   输出示例

   database.postgresql.dev4devs.com/sampledatabase created

2. 创建数据库实例后，确保 my-petclinic 命名空间中的所有 pod 都在运行：

   $ oc get pods -n my-petclinic

   输出（需要几分钟）验证是否创建并配置了数据库：

   输出示例

   NAME                                     READY    STATUS      RESTARTS   AGE
   sampledatabase-cbc655488-74kss            0/1     Running        0       32s

流程

1. 在 shell 中运行以下命令，使用 PostgresCluster 自定义资源(CR)部署 spring-petclinic 应用程序：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: spring-petclinic
     labels:
       app: spring-petclinic
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: spring-petclinic
     template:
       metadata:
         labels:
           app: spring-petclinic
       spec:
         containers:
           - name: app
             image: quay.io/service-binding/spring-petclinic:latest
             imagePullPolicy: Always
             env:
             - name: SPRING_PROFILES_ACTIVE
               value: postgres
             - name: org.springframework.cloud.bindings.boot.enable
               value: "true"
             ports:
             - name: http
               containerPort: 8080
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: spring-petclinic
     name: spring-petclinic
   spec:
     type: NodePort
     ports:
       - port: 80
         protocol: TCP
         targetPort: 8080
     selector:
       app: spring-petclinic
   EOD

   输出会验证 Spring PetClinic 示例应用是否已创建并部署：

   输出示例

   deployment.apps/spring-petclinic created
   service/spring-petclinic created

   注意

   如果要在 web 控制台的 Developer 视角中使用 容器镜像 部署应用程序，则必须在高级选项的 Deployment 部分输入以下环境变量：

   • 名称：SPRING_PROFILES_ACTIVE
   • 值： postgres

2. 运行以下命令，验证应用程序是否还没有连接到数据库服务：

   $ oc get pods -n my-petclinic

   显示 CrashLoopBackOff 状态需要几分钟：

   输出示例

   NAME                                READY   STATUS             RESTARTS      AGE
   spring-petclinic-5b4c7999d4-wzdtz   0/1     CrashLoopBackOff   4 (13s ago)   2m25s

   在这个阶段，pod 无法启动。如果您尝试与应用交互，它会返回错误。

流程

1. 创建 ServiceBinding CR 以项目绑定数据：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: binding.operators.coreos.com/v1alpha1
   kind: ServiceBinding
   metadata:
       name: spring-petclinic-pgcluster
   spec:
     services: 1
       - group: postgresql.dev4devs.com
         kind: Database 2
         name: sampledatabase
         version: v1alpha1
     application: 3
       name: spring-petclinic
       group: apps
       version: v1
       resource: deployments
   EOD

   1

   指定服务资源列表。

   2

   数据库的 CR。

   3

   示例应用程序，指向带有嵌入式 PodSpec 的 Deployment 或任何其他类似资源。

   输出会验证是否已创建 ServiceBinding CR 以将绑定数据项目到示例应用程序中。

   输出示例

   servicebinding.binding.operators.coreos.com/spring-petclinic created

2. 验证服务绑定的请求是否成功：

   $ oc get servicebindings -n my-petclinic

   输出示例

   NAME                          READY   REASON              AGE
   spring-petclinic-postgresql   True    ApplicationsBound   47m

   默认情况下，来自数据库服务的绑定数据的值作为运行示例应用程序的工作负载容器中的文件进行投射。例如，Secret 资源中的所有值都投射到 bindings/spring-petclinic-pgcluster 目录中。

3. 创建后，您可以进入拓扑来查看可视连接。

   图 5.1. 将 spring-petclinic 连接到示例数据库

   

4. 设置应用程序端口的端口转发，以便从本地环境访问示例应用程序：

   $ oc port-forward --address 0.0.0.0 svc/spring-petclinic 8080:80 -n my-petclinic

   输出示例

   Forwarding from 0.0.0.0:8080 -> 8080
   Handling connection for 8080

5. 访问 http://localhost:8080。

   现在，您可以在 localhost:8080 远程访问 Spring PetClinic 示例应用程序，并查看应用程序现在连接到数据库服务。

1. 默认情况下，作为文件。
2. 作为环境变量，在从 ServiceBinding 资源配置 .spec.bindAsFiles 参数后。

流程

1. 若要将绑定数据显示为文件，请确保工作负载运行的容器中存在现有的 SERVICE_BINDING_ROOT 环境变量，以确定目标文件夹。
2. 要将绑定数据作为环境变量进行项目，请将自定义资源 (CR) 中 ServiceBinding 资源中的 .spec.bindAsFiles 参数的值设置为 false。

流程

1. 将鼠标悬停在 Spring PetClinic 示例应用上，以查看节点上的悬挂箭头。

   图 5.2. 视觉连接器

   
2. 单击箭头并将它拖向 hippo-pgbouncer 部署，以将 Spring PetClinic 示例应用与其连接。
3. 点 spring-petclinic 部署来查看 Overview 面板。在 Details 选项卡下，点 Annotations 部分中的编辑图标，查看 Key = app.openshift.io/connects-to 和 Value = [{"apiVersion":"apps/v1","kind":"Deployment","name":"hippo-pgbouncer"}] 注解添加到部署。

流程

1. 切换到 Developer 视角，并确保您处于适当的项目中，例如 my-petclinic。在 Topology 视图中，把鼠标移到 Spring PetClinic 示例应用程序上，以查看节点上的悬挂箭头。

2. 单击箭头并将它拖向 hippo 数据库 Postgres Cluster，以与 Spring PetClinic 示例应用进行绑定连接。

   或者，在 +Add 视图中点 YAML 选项查看 Import YAML 屏幕。使用 YAML 编辑器并添加 ServiceBinding 资源：

   apiVersion: binding.operators.coreos.com/v1alpha1
   kind: ServiceBinding
   metadata:
       name: spring-petclinic-pgcluster
       namespace: my-petclinic
   spec:
       services:
       - group: postgres-operator.crunchydata.com
         version: v1beta1
         kind: PostgresCluster
         name: hippo
       application:
         name: spring-petclinic
         group: apps
         version: v1
         resource: deployments

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

   • Linux (x86_64, amd64)

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

   • Linux on IBM Z and LinuxONE (s390x)

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

   • Linux on IBM Power (ppc64le)

     # curl -L https://mirror.openshift.com/pub/openshift-v4/clients/helm/latest/helm-linux-ppc64le -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 vault

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

   $ helm repo add openshift-helm-charts https://charts.openshift.io/

   输出示例

   "openshift-helm-charts" has been added to your repositories

3. 更新存储库：

   $ helm repo update

4. 安装 HashiCorp Vault 示例：

   $ helm install example-vault openshift-helm-charts/hashicorp-vault

   输出示例

   NAME: example-vault
   LAST DEPLOYED: Fri Mar 11 12:02:12 2022
   NAMESPACE: vault
   STATUS: deployed
   REVISION: 1
   NOTES:
   Thank you for installing HashiCorp Vault!

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

   $ helm list

   输出示例

   NAME         	NAMESPACE	REVISION	UPDATED                                	STATUS  	CHART       	APP VERSION
   example-vault	vault    	1       	2022-03-11 12:02:12.296226673 +0530 IST	deployed	vault-0.19.0	1.9.2

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

3. 点 Install Helm Chart。

   图 6.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
   version: 0.2.1 5

   1

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

   2

   chart 的名称。

   3

   chart 的描述。

   4

   用作图标的图形的 URL。

   5

   根据 Semantic Versioning(SemVer)2.0.0 规范，您的 chart 的版本。

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。

   图 6.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 的所有修订版本。

   图 6.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。

   图 7.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. 单击 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>