7.3. 配置自定义 Helm Chart 仓库

流程

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。

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

   图 7.2. Chart 软件仓库过滤器

   
   注意

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

流程

1. 要添加新的命名空间范围的 Helm Chart 仓库，您必须将 Helm Chart 仓库自定义资源(CR)添加到命名空间中。

   命名空间范围的 Helm Chart 仓库 CR 示例

   apiVersion: helm.openshift.io/v1beta1
   kind: ProjectHelmChartRepository
   metadata:
     name: <name>
   spec:
     url: https://my.chart-repo.org/stable
   
     # optional name that might be used by console
     name: <chart-repo-display-name>
   
     # optional and only needed for UI purposes
     description: <My private chart repo>
   
     # required: chart repository URL
     connectionConfig:
       url: <helm-chart-repository-url>

   例如，要将 Azure 示例 chart 存储库添加到 my-namespace 命名空间，请运行：

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

   检查输出来验证是否创建了命名空间范围的 Helm Chart Repository CR：

   输出示例

   projecthelmchartrepository.helm.openshift.io/azure-sample-repo created

2. 导航到 web 控制台中的 Developer Catalog，以验证 my-namespace 命名空间中是否显示了来自 Chart 仓库的 Helm chart。

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

   图 7.3. 命名空间中的 Chart 软件仓库过滤器

   

   或者，运行：

   $ oc get projecthelmchartrepositories --namespace my-namespace

   输出示例

   NAME                     AGE
   azure-sample-repo        1m

   注意

   如果集群管理员或具有适当 RBAC 权限的常规用户删除特定命名空间中的所有 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。认证图表显示为( )图标。