Red Hat Developer Hub 的管理指南

流程

1. 运行以下命令，使用 oc 命令行工具登录到 OpenShift Container Platform 帐户：

   oc login -u <user> -p <password> https://api.<hostname>:6443

2. 运行以下命令，使用 podman 命令行工具登录到 OpenShift Container Platform 镜像 registry：

   podman login -u kubeadmin -p $(oc whoami -t) default-route-openshift-image-registry.<hostname>

   注意

   您可以运行以下命令来获取 OpenShift Container Platform 镜像 registry 的完整主机名，然后使用命令中的主机名登录：

   REGISTRY_HOST=$(oc get route default-route -n openshift-image-registry --template='{{ .spec.host }}')

   podman login -u kubeadmin -p $(oc whoami -t) $REGISTRY_HOST

3. 运行以下命令，登录到 podman 中的 registry.redhat.io ：

   podman login registry.redhat.io

   有关 registry 身份验证的更多信息，请参阅 Red Hat Container Registry 身份验证。

4. 运行以下命令，将 Developer Hub 和 PostgreSQL 镜像从 Red Hat Image registry 拉取到您的工作站：

   podman pull registry.redhat.io/rhdh/rhdh-hub-rhel9:{product-chart-version}

   podman pull registry.redhat.io/rhel9/postgresql-15:latest

5. 运行以下命令，将这两个镜像推送到内部 OpenShift Container Platform 镜像 registry：

   podman push --remove-signatures registry.redhat.io/rhdh/rhdh-hub-rhel9:{product-chart-version} default-route-openshift-image-registry.<hostname>/<project_name>/rhdh-hub-rhel9:{product-chart-version}

   podman push --remove-signatures registry.redhat.io/rhel9/postgresql-15:latest default-route-openshift-image-registry.<hostname>/<project_name>/postgresql-15:latest

   有关直接将镜像推送到 OpenShift Container Platform 镜像 registry 的更多信息，请参阅 如何直接将镜像推送到 OpenShift 4 registry 中。

   重要

   如果发生 x509 错误，请验证您已在 系统上安装了用于 OpenShift Container Platform 路由的 CA 证书。

6. 使用以下命令验证 OpenShift Container Platform 内部 registry 中是否存在这两个镜像：

   oc get imagestream -n <project_name>

7. 运行以下命令，为这两个镜像启用本地镜像查找：

   oc set image-lookup postgresql-15

   oc set image-lookup  rhdh-hub-rhel9

8. 进入 YAML 视图，并使用以下值更新 backstage 和 postgresql 的 image 部分：

   Developer Hub 镜像的值示例

   upstream:
     backstage:
       image:
         registry: ""
         repository: rhdh-hub-rhel9
         tag: latest

   PostgreSQL 镜像的值示例

   upstream:
     postgresql:
       image:
         registry: ""
         repository: postgresql-15
         tag: latest

9. 使用 Helm Chart 安装 Red Hat Developer Hub。有关安装 Developer Hub 的更多信息，请参阅 第 2.1 节 “使用 Helm Chart 在 OpenShift Container Platform 上部署 Red Hat Developer Hub”。

流程

1. 在 OpenShift Container Platform Web 控制台中，选择 ConfigMaps 选项卡。
2. 点 Create ConfigMap。

3. 在 Create ConfigMap 页面中，根据需要在 Configure via 中选择 YAML view 选项，并编辑该文件。

   使用 GitHub 动态插件的 ConfigMap 对象示例

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: dynamic-plugins-rhdh
   data:
     dynamic-plugins.yaml: |
       includes:
         - dynamic-plugins.default.yaml
       plugins:
         - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-dynamic'
           disabled: false
           pluginConfig: {}

4. 点 Create。
5. 转至 Topology 选项卡。

6. 点击您要使用的 Red Hat Developer Hub 实例的 overflow 菜单，然后选择 Edit Backstage 来加载 Red Hat Developer Hub 实例的 YAML 视图。

   

7. 将 dynamicPluginsConfigMapName 字段添加到 Backstage CR。例如：

   apiVersion: rhdh.redhat.com/v1alpha1
   kind: Backstage
   metadata:
     name: my-rhdh
   spec:
     application:
   # ...
       dynamicPluginsConfigMapName: dynamic-plugins-rhdh
   # ...

8. 点击 Save。
9. 返回到 Topology 视图，并等待 Red Hat Developer Hub pod 启动。
10. 点 Open URL 图标开始使用带有新配置更改的 Red Hat Developer Hub 平台。

流程

1. 下载并运行镜像脚本以安装自定义 Operator 目录并镜像相关的镜像： prepare-restricted-environment.sh (source)。

   curl -sSLO https://raw.githubusercontent.com/janus-idp/operator/1.1.x/.rhdh/scripts/prepare-restricted-environment.sh
   
   # if you do not already have a target mirror registry
   # and want the script to create one for you
   # use the following example:
   bash prepare-restricted-environment.sh \
      --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.14" \
      --prod_operator_package_name "rhdh" \
      --prod_operator_bundle_name "rhdh-operator" \
      --prod_operator_version "v1.1.1"
   
   # if you already have a target mirror registry
   # use the following example:
   bash prepare-restricted-environment.sh \
      --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.14" \
      --prod_operator_package_name "rhdh" \
      --prod_operator_bundle_name "rhdh-operator" \
      --prod_operator_version "v1.1.1" \
      --use_existing_mirror_registry "my_registry"

   注意

   完成该脚本可能需要几分钟时间，因为它会将多个镜像复制到镜像 registry。

流程

1. 在终端中运行以下命令，以创建安装 Operator 的 rhdh-operator 命名空间：

   kubectl create namespace rhdh-operator

2. 使用以下命令创建 pull secret：

   kubectl -n rhdh-operator create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<user_name> \ 

   1

   
       --docker-password=<password> \ 

   2

   
       --docker-email=<email> 

   3

   1

   在命令中输入您的用户名。

   2

   在命令中输入您的密码。

   3

   在命令中输入您的电子邮件地址。

   创建的 pull secret 用于从红帽生态系统中拉取 Developer Hub 镜像。

3. 创建一个 CatalogSource 资源，其中包含来自红帽生态系统的 Operator：

   cat <<EOF | kubectl -n rhdh-operator apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: redhat-catalog
   spec:
     sourceType: grpc
     image: registry.redhat.io/redhat/redhat-operator-index:v4.15
     secrets:
     - "rhdh-pull-secret"
     displayName: Red Hat Operators
   EOF

4. 按如下方式创建 OperatorGroup 资源：

   cat <<EOF | kubectl apply -n rhdh-operator -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: rhdh-operator-group
   EOF

5. 使用以下代码创建 Subscription 资源：

   cat <<EOF | kubectl apply -n rhdh-operator -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: rhdh
     namespace: rhdh-operator
   spec:
     channel: fast
     installPlanApproval: Automatic
     name: rhdh
     source: redhat-catalog
     sourceNamespace: rhdh-operator
     startingCSV: rhdh-operator.v1.1.2
   EOF

6. 运行以下命令验证创建的 Operator 是否正在运行：

   kubectl -n rhdh-operator get pods -w

   如果 Operator pod 显示 ImagePullBackOff 状态，则您可能需要直接在 Operator 部署清单中拉取镜像。

   提示

   您可以在 deployment.spec.template.spec.imagePullSecrets 列表中包含所需的 secret 名称，并使用 kubectl get deployment -n rhdh-operator 命令验证部署名称：

   kubectl -n rhdh-operator patch deployment \
       rhdh.fast --patch '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"rhdh-pull-secret"}]}}}}' \
       --type=merge

7. 更新 Operator 的默认配置，以确保 Developer Hub 资源可以按照以下流程在 EKS 中正确启动：

   1. 使用以下命令，编辑 rhdh-operator 命名空间中的 backstage-default-config ConfigMap：

      kubectl -n rhdh-operator edit configmap backstage-default-config

   2. 找到 db-statefulset.yaml 字符串，并将 fsGroup 添加到其 spec.template.spec.securityContext 中，如下例所示：

        db-statefulset.yaml: |
          apiVersion: apps/v1
          kind: StatefulSet
      --- TRUNCATED ---
          spec:
          --- TRUNCATED ---
            restartPolicy: Always
            securityContext:
            # You can assign any random value as fsGroup
              fsGroup: 2000
            serviceAccount: default
            serviceAccountName: default
      --- TRUNCATED ---

   3. 找到 deployment.yaml 字符串，并将 fsGroup 添加到规格中，如下例所示：

        deployment.yaml: |
          apiVersion: apps/v1
          kind: Deployment
      --- TRUNCATED ---
          spec:
            securityContext:
              # You can assign any random value as fsGroup
              fsGroup: 3000
            automountServiceAccountToken: false
      --- TRUNCATED ---

   4. 找到 service.yaml 字符串，并将 类型改为 NodePort，如下所示：

        service.yaml: |
          apiVersion: v1
          kind: Service
          spec:
           # NodePort is required for the ALB to route to the Service
            type: NodePort
      --- TRUNCATED ---

   5. 保存并退出。

      等待几分钟，直到更改自动应用到 Operator pod。

流程

1. 使用以下命令将 Operator 存储库克隆到本地机器中：

   git clone --depth=1 https://github.com/janus-idp/operator.git rhdh-operator && cd rhdh-operator

2. 运行以下命令并生成部署清单：

   make deployment-manifest

   以上命令生成一个名为 rhdh-operator-<VERSION>.yaml 的文件，该文件会被手动更新。

3. 运行以下命令在生成的部署清单中应用替换：

   sed -i "s/backstage-operator/rhdh-operator/g" rhdh-operator-*.yaml
   sed -i "s/backstage-system/rhdh-operator/g" rhdh-operator-*.yaml
   sed -i "s/backstage-controller-manager/rhdh-controller-manager/g" rhdh-operator-*.yaml

4. 在编辑器中打开生成的部署清单文件并执行以下步骤：

   1. 找到 db-statefulset.yaml 字符串，并将 fsGroup 添加到其 spec.template.spec.securityContext 中，如下例所示：

         db-statefulset.yaml: |
          apiVersion: apps/v1
          kind: StatefulSet
      --- TRUNCATED ---
          spec:
          --- TRUNCATED ---
            restartPolicy: Always
            securityContext:
              # You can assign any random value as fsGroup
              fsGroup: 2000
            serviceAccount: default
            serviceAccountName: default
      --- TRUNCATED ---

   2. 找到 deployment.yaml 字符串，并将 fsGroup 添加到规格中，如下例所示：

        deployment.yaml: |
          apiVersion: apps/v1
          kind: Deployment
      --- TRUNCATED ---
          spec:
            securityContext:
              # You can assign any random value as fsGroup
              fsGroup: 3000
            automountServiceAccountToken: false
      --- TRUNCATED ---

   3. 找到 service.yaml 字符串，并将 类型改为 NodePort，如下所示：

        service.yaml: |
          apiVersion: v1
          kind: Service
          spec:
            # NodePort is required for the ALB to route to the Service
            type: NodePort
      --- TRUNCATED ---

   4. 将默认镜像替换为红帽生态系统中拉取的镜像：

      sed -i "s#gcr.io/kubebuilder/kube-rbac-proxy:.*#registry.redhat.io/openshift4/ose-kube-rbac-proxy:v4.15#g" rhdh-operator-*.yaml
      
      sed -i "s#quay.io/janus-idp/operator:.*#registry.redhat.io/rhdh/rhdh-rhel9-operator:1.1#g" rhdh-operator-*.yaml
      
      sed -i "s#quay.io/janus-idp/backstage-showcase:.*#registry.redhat.io/rhdh/rhdh-hub-rhel9:1.1#g" rhdh-operator-*.yaml
      
      sed -i "s#quay.io/fedora/postgresql-15:.*#registry.redhat.io/rhel9/postgresql-15:latest#g" rhdh-operator-*.yaml

5. 将镜像 pull secret 添加到 Deployment 资源中的清单中，如下所示：

   --- TRUNCATED ---
   
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     labels:
       app.kubernetes.io/component: manager
       app.kubernetes.io/created-by: rhdh-operator
       app.kubernetes.io/instance: controller-manager
       app.kubernetes.io/managed-by: kustomize
       app.kubernetes.io/name: deployment
       app.kubernetes.io/part-of: rhdh-operator
       control-plane: controller-manager
     name: rhdh-controller-manager
     namespace: rhdh-operator
   spec:
     replicas: 1
     selector:
       matchLabels:
         control-plane: controller-manager
     template:
       metadata:
         annotations:
           kubectl.kubernetes.io/default-container: manager
         labels:
           control-plane: controller-manager
       spec:
         imagePullSecrets:
           - name: rhdh-pull-secret
   --- TRUNCATED ---

6. 使用以下命令应用清单来部署 Operator：

   kubectl apply -f rhdh-operator-VERSION.yaml

7. 运行以下命令验证 Operator 是否正在运行：

   kubectl -n rhdh-operator get pods -w

流程

1. 使用以下模板，创建一个名为 app-config-rhdh 的 ConfigMap，其中包含 Developer Hub 配置：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://<rhdh_dns_name>
       backend:
         auth:
           keys:
             - secret: "${BACKEND_SECRET}"
         baseUrl: https://<rhdh_dns_name>
         cors:
           origin: https://<rhdh_dns_name>

2. 创建名为 secrets-rhdh 的 Secret，并添加名为 BACKEND_SECRET 的键，其值为 Base64 编码的字符串 ：

   apiVersion: v1
   kind: Secret
   metadata:
     name: secrets-rhdh
   stringData:
     # TODO: See https://backstage.io/docs/auth/service-to-service-auth/#setup
     BACKEND_SECRET: "xxx"

   重要

   确保您为每个 Developer Hub 实例使用 BACKEND_SECRET 的唯一值。

   您可以使用以下命令生成密钥：

   node-p'require("crypto").randomBytes(24).toString("base64")'

3. 要启用从红帽生态系统目录中拉取 PostgreSQL 镜像，请在部署 Developer Hub 实例的命名空间中将镜像 pull secret 添加到 default 服务帐户中：

   kubectl patch serviceaccount default \
       -p '{"imagePullSecrets": [{"name": "rhdh-pull-secret"}]}' \
       -n <your_namespace>

4. 使用以下模板创建自定义资源文件：

   apiVersion: rhdh.redhat.com/v1alpha1
   kind: Backstage
   metadata:
    # TODO: this the name of your Developer Hub instance
     name: my-rhdh
   spec:
     application:
       imagePullSecrets:
       - "rhdh-pull-secret"
       route:
         enabled: false
       appConfig:
         configMaps:
           - name: "app-config-rhdh"
       extraEnvs:
         secrets:
           - name: "secrets-rhdh"

5. 使用以下模板创建 Ingress 资源，确保根据需要自定义名称：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     # TODO: this the name of your Developer Hub Ingress
     name: my-rhdh
     annotations:
       alb.ingress.kubernetes.io/scheme: internet-facing
   
       alb.ingress.kubernetes.io/target-type: ip
   
       # TODO: Using an ALB HTTPS Listener requires a certificate for your own domain. Fill in the ARN of your certificate, e.g.:
       alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:us-xxx:xxxx:certificate/xxxxxx
   
        alb.ingress.kubernetes.io/listen-ports: '[{"HTTP": 80}, {"HTTPS":443}]'
   
       alb.ingress.kubernetes.io/ssl-redirect: '443'
   
       # TODO: Set your application domain name.
       external-dns.alpha.kubernetes.io/hostname: <rhdh_dns_name>
   
   spec:
     ingressClassName: alb
     rules:
       # TODO: Set your application domain name.
       - host: <rhdh_dns_name>
         http:
           paths:
           - path: /
             pathType: Prefix
             backend:
               service:
                 # TODO: my-rhdh is the name of your Backstage Custom Resource.
                 # Adjust if you changed it!
                 name: backstage-my-rhdh
                 port:
                   name: http-backend

   在前面的模板中，将 ' <rhdh_dns_name>' 替换为您的 Developer Hub 域名，并将 alb.ingress.kubernetes.io/certificate-arn 的值更新为您的证书 ARN。

流程

1. 打开终端并运行以下命令来添加 Helm Chart 仓库：

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

2. 要创建 ImagePull Secret，请运行以下命令：

   kubectl -n <your_namespace> create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<redhat_user_name> \
       --docker-password=<redhat_password> \
       --docker-email=<email>

3. 使用以下模板创建一个名为 values.yaml 的文件：

   global:
     host: <app_address>
   route:
     enabled: false
   upstream:
     ingress:
       enabled: true
       className: webapprouting.kubernetes.azure.com
       host:
     backstage:
       image:
         pullSecrets:
           - rhdh-pull-secret
       podSecurityContext:
         fsGroup: 3000
     postgresql:
       image:
         pullSecrets:
           - rhdh-pull-secret
       primary:
         podSecurityContext:
           enabled: true
           fsGroup: 3000
     volumePermissions:
       enabled: true

4. 要安装 Helm Chart，请运行以下命令：

   helm -n <your_namespace> install -f values.yaml <your_deploy_name> openshift-helm-charts/redhat-developer-hub --version 1.1.1

5. 验证部署状态：

   kubectl get deploy <your_deploy_name>-developer-hub -n <your_namespace>

6. 使用 URL 访问部署的 Developer Hub： https://<app_address&gt;，其中 <app_address> 是之前获取的 Ingress 地址（例如 https://108.141.70.228）。

7. 要升级或删除部署，请运行以下命令：

   upgrade 命令

   helm -n <your_namespace> upgrade -f values.yaml <your_deploy_name> openshift-helm-charts/redhat-developer-hub --version 1.1.1

   delete 命令

   helm -n <your_namespace> delete <your_deploy_name>

流程

1. 获取名为 rhdh-operator-<VERSION>.yaml 的 Red Hat Developer Hub Operator 清单文件，并通过添加以下片段来修改 db-statefulset.yaml 和 deployment.yaml 的默认配置：

   securityContext:
     fsGroup: 300

   以下是清单中的指定位置：

   db-statefulset.yaml: | spec.template.spec
   deployment.yaml: | spec.template.spec

2. 将修改后的 Operator 清单应用到 Kubernetes 集群：

   kubectl apply -f rhdh-operator-<VERSION>.yaml

   注意

   以上命令的执行是集群范围的，需要适当的集群权限。

3. 使用您的红帽凭证创建名为 rhdh-pull-secret 的 ImagePull Secret，以访问受保护的 registry.redhat.io 中的镜像，如下例所示：

   kubectl -n <your_namespace> create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<redhat_user_name> \
       --docker-password=<redhat_password> \
       --docker-email=<email>

4. 创建名为 rhdh-ingress.yaml 的 Ingress 清单文件，指定您的 Developer Hub 服务名称，如下所示：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: rhdh-ingress
     namespace: <your_namespace>
   spec:
     ingressClassName: webapprouting.kubernetes.azure.com
     rules:
       - http:
           paths:
             - path: /
               pathType: Prefix
               backend:
                 service:
                   name: backstage-<your-CR-name>
                   port:
                     name: http-backend

5. 要部署创建的 Ingress，请运行以下命令：

   kubectl -n <your_namespace> apply -f rhdh-ingress.yaml

6. 使用以下示例，创建一个名为 app-config-rhdh 的 ConfigMap，其中包含 Developer Hub 配置：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://<app_address>
       backend:
         auth:
           keys:
             - secret: "${BACKEND_SECRET}"
         baseUrl: https://<app_address>
         cors:
           origin: https://<app_address>

7. 创建名为 secrets-rhdh 的 Secret，并添加一个名为 BACKEND_SECRET 的键，并带有 Base64 编码的字符串 值，如下例所示：

   apiVersion: v1
   kind: Secret
   metadata:
     name: secrets-rhdh
   stringData:
     BACKEND_SECRET: "xxx"

8. 创建名为 rhdh.yaml 的自定义资源(CR)清单文件，并包含之前创建的 rhdh-pull-secret，如下所示：

   apiVersion: rhdh.redhat.com/v1alpha1
   kind: Backstage
   metadata:
     name: <your-rhdh-cr>
   spec:
     application:
       imagePullSecrets:
         - rhdh-pull-secret
       appConfig:
         configMaps:
           - name: "app-config-rhdh"
       extraEnvs:
         secrets:
           - name: "secrets-rhdh"

9. 将 CR 清单应用到您的命名空间：

   kubectl -n <your_namespace> apply -f rhdh.yaml

10. 使用 URL 访问部署的 Developer Hub： https://<app_address&gt;，其中 <app_address> 是之前获取的 Ingress 地址（例如 https://108.141.70.228）。

11. 可选： 要删除 CR，请运行以下命令：

    kubectl -n <your_namespace> delete -f rhdh.yaml

流程

1. 注册应用程序后，请注意以下几点：

   • clientId: Application (client) ID，它位于 App Registration → Overview 下。
   • clientSecret: Secret，在 *App Registration → Certificates & secrets 下找到（如果需要，创建新的）。
   • tenantId: Directory (tenant) ID，它位于 App Registration → Overview 下。

2. 确保 Developer Hub ConfigMap 中包含以下片段：

   auth:
     environment: production
     providers:
       microsoft:
         production:
           clientId: ${AZURE_CLIENT_ID}
           clientSecret: ${AZURE_CLIENT_SECRET}
           tenantId: ${AZURE_TENANT_ID}
           domainHint: ${AZURE_TENANT_ID}
           additionalScopes:
             - Mail.Send

   您可以创建新文件或将其添加到现有文件中。

3. 将 ConfigMap 应用到 Kubernetes 集群：

   kubectl -n <your_namespace> apply -f <app-config>.yaml

4. 创建或重复使用包含 Azure 凭证的现有 Secret，并添加以下片段：

   stringData:
     AZURE_CLIENT_ID: <value-of-clientId>
     AZURE_CLIENT_SECRET: <value-of-clientSecret>
     AZURE_TENANT_ID: <value-of-tenantId>

5. 将 secret 应用到 Kubernetes 集群：

   kubectl -n <your_namespace> apply -f <azure-secrets>.yaml

6. 确保您的 values.yaml 文件引用之前创建的 ConfigMap 和 Secret：

   upstream:
     backstage:
     ...
       extraAppConfig:
         - filename: ...
           configMapRef: <app-config-containing-azure>
       extraEnvVarsSecrets:
         - <secret-containing-azure>

7. 可选： 如果已安装 Helm Chart，请升级它：

   helm -n <your_namespace> upgrade -f <your-values.yaml> <your_deploy_name> redhat-developer/backstage --version 1.1.4

8. 可选： 如果没有更改 rhdh.yaml 文件，例如，您只更新从它引用的 ConfigMap 和 Secret，请通过删除对应的 pod 来刷新 Developer Hub 部署：

   kubectl -n <your_namespace> delete pods -l backstage.io/app=backstage-<your-rhdh-cr>

流程

1. 注册应用程序后，请注意以下几点：

   • clientId: Application (client) ID，它位于 App Registration → Overview 下。
   • clientSecret: Secret，在 *App Registration → Certificates & secrets 下找到（如果需要，创建新的）。
   • tenantId: Directory (tenant) ID，它位于 App Registration → Overview 下。

2. 确保 Developer Hub ConfigMap 中包含以下片段：

   auth:
     environment: production
     providers:
       microsoft:
         production:
           clientId: ${AZURE_CLIENT_ID}
           clientSecret: ${AZURE_CLIENT_SECRET}
           tenantId: ${AZURE_TENANT_ID}
           domainHint: ${AZURE_TENANT_ID}
           additionalScopes:
             - Mail.Send

   您可以创建新文件或将其添加到现有文件中。

3. 将 ConfigMap 应用到 Kubernetes 集群：

   kubectl -n <your_namespace> apply -f <app-config>.yaml

4. 创建或重复使用包含 Azure 凭证的现有 Secret，并添加以下片段：

   stringData:
     AZURE_CLIENT_ID: <value-of-clientId>
     AZURE_CLIENT_SECRET: <value-of-clientSecret>
     AZURE_TENANT_ID: <value-of-tenantId>

5. 将 secret 应用到 Kubernetes 集群：

   kubectl -n <your_namespace> apply -f <azure-secrets>.yaml

6. 确保自定义资源清单包含对之前创建的 ConfigMap 和 Secret 的引用：

   apiVersion: rhdh.redhat.com/v1alpha1
   kind: Backstage
   metadata:
     name: <your-rhdh-cr>
   spec:
     application:
       imagePullSecrets:
       - rhdh-pull-secret
       route:
         enabled: false
       appConfig:
         configMaps:
           - name: <app-config-containing-azure>
       extraEnvs:
         secrets:
           - name: <secret-containing-azure>

7. 应用自定义资源清单：

   kubectl -n <your_namespace> apply -f rhdh.yaml

8. 可选： 如果没有更改 rhdh.yaml 文件，例如，您只更新从它引用的 ConfigMap 和 Secret，请通过删除对应的 pod 来刷新 Developer Hub 部署：

   kubectl -n <your_namespace> delete pods -l backstage.io/app=backstage-<your-rhdh-cr>

流程

1. 前往 Developer Hub 中边栏底部的 管理。

   此时会出现 RBAC 选项卡，在 Developer Hub 中显示所有创建的角色。

2. （可选）点击任何角色来查看 OVERVIEW 页面中的角色信息。
3. 单击 CREATE 以创建角色。
4. 在给定字段中输入角色的名称和描述，然后单击 NEXT。
5. 使用搜索字段添加用户和组，然后单击 NEXT。
6. 从 Add permission policies 部分的下拉菜单中选择 Plugin 和 Permission。
7. 选择或清除要在 Add permission policies 部分中设置的 Policy，然后单击 NEXT。
8. 查看 Review and create 部分中的添加的信息。
9. 点 CREATE。

流程

1. 前往 Developer Hub 中边栏底部的 管理。

   此时会出现 RBAC 选项卡，在 Developer Hub 中显示所有创建的角色。

2. （可选）点击任何角色来查看 OVERVIEW 页面中的角色信息。
3. 选择您要编辑的角色的编辑图标。
4. 编辑角色的详细信息，如名称、描述、用户和组以及权限策略，然后单击 NEXT。
5. 检查角色编辑的详细信息，然后单击 SAVE。

流程

1. 前往 Developer Hub 中边栏底部的 管理。

   此时会出现 RBAC 选项卡，在 Developer Hub 中显示所有创建的角色。

2. （可选）点击任何角色来查看 OVERVIEW 页面中的角色信息。

3. 在您要删除的角色的 Actions 列中选择删除图标。

   删除此角色？ 弹出窗口会出现在屏幕上。

4. 点 DELETE。

流程

1. 识别您要发送请求的相关 API 端点，如 POST /api/permission/policies。根据您的用例调整任何请求详情。

   对于 REST 客户端 ：

   • Authorization ：从 web 控制台输入生成的令牌。
   • HTTP 方法：设置为 POST。
   • URL ：输入 RBAC REST API 基础 URL 和端点，如 http://localhost:7007/api/permission/policies。

   对于 curl 工具 ：

   • -x: 设置为 POST

   • - h ：设置以下标头：

     content-type: application/json

     Authorization: Bearer $token

     $token 是浏览器中从 Web 控制台请求的令牌。

   • URL ：输入以下 RBAC REST API 基础 URL 端点，如 http://localhost:7007/api/permission/policies
   • -d ：添加请求 JSON 正文

   请求示例 ：

   curl -X POST "http://localhost:7007/api/permission/policies" -d '{"entityReference":"role:default/test", "permission": "catalog-entity", "policy": "read", "effect":"allow"}' -H "Content-Type: application/json" -H "Authorization: Bearer $token" -v

2. 执行请求并检查响应。