在 Microsoft Azure Kubernetes Service 上安装 Red Hat Developer Hub

流程

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: my-rhdh-project
   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.yaml Developer Hub 配置文件的 my-rhdh-app-config 配置映射：

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

7. 创建一个 & lt;my_product_secrets > secret，并添加名为 BACKEND_SECRET 的键，并带有 Base64 编码的字符串 值，如下例所示：

   apiVersion: v1
   kind: Secret
   metadata:
     name: <my_product_secrets> 

   1

   
   stringData:
     BACKEND_SECRET: "xxx"

   1

   <my_product_secrets > 是您首选的 Developer Hub secret 名称，其中 < my_product_secrets > 指定 Developer Hub 中 secret 配置的标识符。

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

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

   1

   1

   <my_product_secrets > 是您首选的 Developer Hub secret 名称，其中 < my_product_secrets > 指定 Developer Hub 中 secret 配置的标识符。

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

   kubectl -n my-rhdh-project apply -f rhdh.yaml

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

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

    kubectl -n my-rhdh-project delete -f rhdh.yaml

流程

1. 运行以下命令登录到 AKS：

   az login [--tenant=<optional_directory_name>]

2. 运行以下命令来创建资源组：

   az group create --name <resource_group_name> --location <location>

   提示

   您可以运行以下命令来列出可用的区域：

   az account list-locations -o table

3. 运行以下命令来创建 AKS 集群：

   az aks create \
   --resource-group <resource_group_name> \
   --name <cluster_name> \
   --enable-managed-identity \
   --generate-ssh-keys

   您可以参阅- -help 来获得其他选项。

4. 运行以下命令来连接到集群：

   az aks get-credentials --resource-group <resource_group_name> --name <cluster_name>

   上一命令配置 Kubernetes 客户端，并将 kubeconfig 中的当前上下文设置为指向您的 AKS 集群。

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

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

6. 创建并激活 < my-rhdh-project> 命名空间：

   DEPLOYMENT_NAME=<redhat-developer-hub>
   NAMESPACE=<rhdh>
   kubectl create namespace ${NAMESPACE}
   kubectl config set-context --current --namespace=${NAMESPACE}

7. 运行以下命令，创建一个 pull secret，用于从红帽生态系统拉取 Developer Hub 镜像：

   kubectl -n $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>

8. 使用以下模板创建一个名为 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

9. 要使用 Helm Chart 安装 Developer Hub，请运行以下命令：

   helm -n $NAMESPACE install -f values.yaml $DEPLOYMENT_NAME openshift-helm-charts/redhat-developer-hub --version 1.4.3

10. 验证部署状态：

    kubectl get deploy $DEPLOYMENT_NAME -n $NAMESPACE

11. 使用集群中的 Developer Hub 数据库密码和路由器基本 URL 值配置 Developer Hub Helm Chart 实例：

    PASSWORD=$(kubectl get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
    CLUSTER_ROUTER_BASE=$(kubectl get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
    helm upgrade $DEPLOYMENT_NAME -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.4.3/redhat-developer-hub-1.4.3.tgz" \
        --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
        --set global.postgresql.auth.password="$PASSWORD"

12. 运行以下命令，显示正在运行的 Developer Hub 实例 URL：

    echo "https://$DEPLOYMENT_NAME-$NAMESPACE.$CLUSTER_ROUTER_BASE"