16.4. 部署单节点 OpenShift 集群

流程

1. 运行以下命令来创建 ibi-ns 命名空间：

   $ oc create namespace ibi-ns

2. 为您的镜像 registry 创建 Secret 资源：

   1. 创建为镜像 registry 定义 Secret 资源的 YAML 文件：

      secret-image-registry.yaml 文件示例

      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-image-pull-secret
        namespace: ibi-ns
      stringData:
        .dockerconfigjson: <base64-docker-auth-code> 

      1

      
      type: kubernetes.io/dockerconfigjson

      1

      您必须提供 base64 编码的凭证详情。有关使用镜像 pull secret 的更多信息，请参阅"添加资源"部分。

   2. 运行以下命令，为您的镜像 registry 创建 Secret 资源：

      $ oc create -f secret-image-registry.yaml

3. 可选：为主机配置静态网络：

   1. 以 nmstate 格式创建一个包含静态网络配置的 Secret 资源：

      host-network-config-secret.yaml 文件示例

      apiVersion: v1
      kind: Secret
      metadata:
       name: host-network-config-secret 

      1

      
       namespace: ibi-ns
      type: Opaque
      stringData:
       nmstate: | 

      2

      
        interfaces:
          - name: ens1f0 

      3

      
            type: ethernet
            state: up
            ipv4:
              enabled: true
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
              dhcp: false 

      4

      
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - 192.168.15.47 

      5

      
              - 192.168.15.48
        routes:
          config: 

      6

      
            - destination: 0.0.0.0/0
              metric: 150
              next-hop-address: 192.168.200.254
              next-hop-interface: ens1f0
              table-id: 254

      1

      指定 Secret 资源的名称。

      2

      以 nmstate 格式定义静态网络配置。

      3

      指定主机上的接口名称。接口的名称必须与操作系统中显示的实际 NIC 名称匹配。要使用 MAC 地址进行 NIC 匹配，请将 identifier 字段设置为 mac-address。

      4

      您必须指定 dhcp: false 以确保 nmstate 为接口分配静态 IP 地址。

      5

      指定系统将用于解析域名的一个或多个 DNS 服务器。

      6

      在本例中，默认路由通过 ens1f0 接口配置为下一个跃点 IP 地址 192.168.200.254。

4. 创建 BareMetalHost 和 Secret 资源：

   1. 创建定义 BareMetalHost 和 Secret 资源的 YAML 文件：

      ibi-bmh.yaml 文件示例

      apiVersion: metal3.io/v1alpha1
      kind: BareMetalHost
      metadata:
        name: ibi-bmh 

      1

      
        namespace: ibi-ns
      spec:
        online: false 

      2

      
        bootMACAddress: 00:a5:12:55:62:64 

      3

      
        bmc:
          address: redfish-virtualmedia+http://192.168.111.1:8000/redfish/v1/Systems/8a5babac-94d0-4c20-b282-50dc3a0a32b5 

      4

      
          credentialsName: ibi-bmh-bmc-secret 

      5

      
        preprovisioningNetworkDataName: host-network-config-secret 

      6

      
        automatedCleaningMode: disabled 

      7

      
        externallyProvisioned: true 

      8

      
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-bmh-secret 

      9

      
        namespace: ibi-ns
      type: Opaque
      data:
        username: <user_name> 

      10

      
        password: <password> 

      11

      1

      指定 BareMetalHost 资源的名称。

      2

      指定主机是否应在线。

      3

      指定主机引导 MAC 地址。

      4

      指定 BMC 地址。您只能使用支持虚拟介质网络引导的裸机主机驱动程序，如 redfish-virtualmedia 和 idrac-virtualmedia。

      5

      指定裸机主机 Secret 资源的名称。

      6

      可选：如果您需要主机静态网络配置，请指定包含配置的 Secret 资源的名称。

      7

      您必须指定 automatedCleaningMode:disabled，以防止置备服务在磁盘检查过程中删除所有预安装工件，如 seed 镜像。

      8

      您必须指定 externallyProvisioned: true，才能启用主机从预安装的磁盘引导，而不是配置 ISO。

      9

      指定 Secret 资源的名称。

      10

      指定用户名。

      11

      指定密码。

   2. 运行以下命令来创建 BareMetalHost 和 Secret 资源：

      $ oc create -f ibi-bmh.yaml

5. 创建 ClusterImageSet 资源：

   1. 创建定义 ClusterImageSet 资源的 YAML 文件：

      ibi-cluster-image-set.yaml 文件示例

      apiVersion: hive.openshift.io/v1
      kind: ClusterImageSet
      metadata:
        name: ibi-img-version-arch 

      1

      
      spec:
        releaseImage: ibi.example.com:path/to/release/images:version-arch 

      2

      1

      指定 ClusterImageSet 资源的名称。

      2

      指定用于部署的发行镜像的地址。如果您在生成镜像期间使用不同的镜像 registry，请确保发行镜像的 OpenShift Container Platform 版本保持不变。

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

      $ oc apply -f ibi-cluster-image-set.yaml

6. 创建 ImageClusterInstall 资源：

   1. 创建定义 ImageClusterInstall 资源的 YAML 文件：

      ibi-image-cluster-install.yaml 文件示例

      apiVersion: extensions.hive.openshift.io/v1alpha1
      kind: ImageClusterInstall
      metadata:
        name: ibi-image-install 

      1

      
        namespace: ibi-ns
      spec:
        bareMetalHostRef:
          name: ibi-bmh 

      2

      
          namespace: ibi-ns
        clusterDeploymentRef:
          name: ibi-cluster-deployment 

      3

      
        hostname: ibi-host 

      4

      
        imageSetRef:
          name: ibi-img-version-arch 

      5

      
        machineNetwork: 10.0.0.0/24 

      6

      
        proxy: 

      7

      
          httpProxy: "http://proxy.example.com:8080"
          #httpsProxy: "http://proxy.example.com:8080"
          #noProxy: "no_proxy.example.com"

      1

      指定 ImageClusterInstall 资源的名称。

      2

      为基于镜像的安装指定您要针对的 BareMetalHost 资源。

      3

      指定要用于目标主机的镜像安装的 ClusterDeployment 资源的名称。

      4

      指定集群的主机名。

      5

      指定用来定义用于部署的容器镜像的 ClusterImageSet 资源的名称。

      6

      指定外部网络的公共 CIDR (Classless Inter-Domain Routing)。

      7

      可选：指定一个用于集群部署的代理。

      重要

      如果您的集群部署需要代理配置，您必须执行以下操作：

      • 从带有代理配置的 seed 集群创建 seed 镜像。代理配置不必相互匹配。
      • 在安装清单中配置 machineNetwork 字段。

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

      $ oc create -f ibi-image-cluster-install.yaml

7. 创建 ClusterDeployment 资源：

   1. 创建定义 ClusterDeployment 资源的 YAML 文件：

      ibi-cluster-deployment.yaml 文件示例

      apiVersion: hive.openshift.io/v1
      kind: ClusterDeployment
      metadata:
        name: ibi-cluster-deployment 

      1

      
        namespace: ibi-ns 

      2

      
      spec:
        baseDomain: example.com 

      3

      
        clusterInstallRef:
          group: extensions.hive.openshift.io
          kind: ImageClusterInstall
          name: ibi-image-install 

      4

      
          version: v1alpha1
        clusterName: ibi-cluster 

      5

      
        platform:
          none: {}
        pullSecretRef:
          name: ibi-image-pull-secret 

      6

      1

      指定 ClusterDeployment 资源的名称。

      2

      指定 ClusterDeployment 资源的命名空间。

      3

      指定集群应属于的基域。

      4

      指定 ImageClusterInstall 的名称，在其中定义了用于目标主机的基于镜像安装的容器镜像。

      5

      为集群指定一个名称。

      6

      指定用于从镜像 registry 中拉取镜像的 secret。

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

      $ oc apply -f ibi-cluster-deployment.yaml

8. 创建 ManagedCluster 资源：

   1. 创建定义 ManagedCluster 资源的 YAML 文件：

      ibi-managed.yaml 文件示例

      apiVersion: cluster.open-cluster-management.io/v1
      kind: ManagedCluster
      metadata:
        name: sno-ibi 

      1

      
      spec:
        hubAcceptsClient: true 

      2

      1

      指定 ManagedCluster 资源的名称。

      2

      指定 true 以启用 RHACM 管理集群。

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

      $ oc apply -f ibi-managed.yaml

验证

1. 运行以下命令，检查 hub 集群中 ImageClusterInstall 的状态，以监控目标主机安装的进度：

   $ oc get imageclusterinstall

   输出示例

   NAME       REQUIREMENTSMET           COMPLETED                     BAREMETALHOSTREF
   target-0   HostValidationSucceeded   ClusterInstallationSucceeded  ibi-bmh

   警告

   如果 ImageClusterInstall 资源被删除，IBI Operator 会重新附加 BareMetalHost 资源并重启机器。

2. 安装完成后，您可以运行以下命令来检索 kubeconfig secret 以登录到受管集群：

   $ oc extract secret/<cluster_name>-admin-kubeconfig -n <cluster_namespace>  --to - > <directory>/<cluster_name>-kubeconfig

   • <cluster_name> 是集群的名称。
   • <cluster_namespace> 是集群的命名空间。
   • <directory> 是在其中创建文件的目录。