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> 是在其中创建文件的目录。

流程

1. 运行以下命令来创建工作目录：

   $ mkdir ibi-config-iso-workdir 

   1

   1

   将 ibi-config-iso-workdir 替换为工作目录的名称。

2. 创建安装清单：

   1. 创建定义 install-config 清单的 YAML 文件：

      install-config.yaml 文件示例

      apiVersion: v1
      metadata:
        name: sno-cluster-name
      baseDomain: host.example.com
      compute:
        - architecture: amd64
          hyperthreading: Enabled
          name: worker
          replicas: 0
      controlPlane:
        architecture: amd64
        hyperthreading: Enabled
        name: master
        replicas: 1
      networking:
        clusterNetwork:
        - cidr: 10.128.0.0/14
          hostPrefix: 23
        machineNetwork:
        - cidr: 192.168.200.0/24
        networkType: OVNKubernetes
        serviceNetwork:
        - 172.30.0.0/16
      platform:
        none: {}
      fips: false
      cpuPartitioningMode: "AllNodes"
      pullSecret: '{"auths":{"<your_pull_secret>"}}}'
      sshKey: 'ssh-rsa <your_ssh_pub_key>'

      重要

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

      • 从带有代理配置的 seed 集群创建 seed 镜像。代理配置不必相互匹配。
      • 在安装清单中配置 machineNetwork 字段。
   2. 将文件保存到工作目录中。

3. 可选。运行以下命令，在工作目录中创建配置模板：

   $ openshift-install image-based create config-template --dir ibi-config-iso-workdir/

   输出示例

   INFO Config-Template created in: ibi-config-iso-workdir

   该命令在工作目录中创建 image-based-config.yaml 配置模板：

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: example-image-based-config
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: change-to-hostname
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
     interfaces:
       - name: eth0
         type: ethernet
         state: up
         mac-address: 00:00:00:00:00:00
         ipv4:
           enabled: true
           address:
             - ip: 192.168.122.2
               prefix-length: 23
           dhcp: false

4. 编辑配置文件：

   image-based-config.yaml 文件示例

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: sno-cluster-name
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: host.example.com
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
       interfaces:
         - name: ens1f0
           type: ethernet
           state: up
           ipv4:
             enabled: true
             dhcp: false
             auto-dns: false
             address:
               - ip: 192.168.200.25
                 prefix-length: 24
           ipv6:
             enabled: false
       dns-resolver:
         config:
           server:
             - 192.168.15.47
             - 192.168.15.48
       routes:
         config:
         - destination: 0.0.0.0/0
           metric: 150
           next-hop-address: 192.168.200.254
           next-hop-interface: ens1f0

5. 运行以下命令，在工作目录中创建配置 ISO：

   $ openshift-install image-based create config-image --dir ibi-config-iso-workdir/

   输出示例

   INFO Adding NMConnection file <ens1f0.nmconnection>
   INFO Consuming Install Config from target directory
   INFO Consuming Image-based Config ISO configuration from target directory
   INFO Config-Image created in: ibi-config-iso-workdir/auth

   查看工作目录中的输出：

   输出示例

   ibi-config-iso-workdir/
   ├── auth
   │   ├── kubeadmin-password
   │   └── kubeconfig
   └── imagebasedconfig.iso

6. 使用您首选的方法将 imagebasedconfig.iso 附加到预安装的主机，然后重新启动主机以完成配置过程并部署集群。

1. 运行以下命令，将 kubeconfig 环境变量导出到 kubeconfig 文件中：

   $ export KUBECONFIG=ibi-config-iso-workdir/auth/kubeconfig

2. 运行以下命令验证集群是否响应：

   $ oc get nodes

   输出示例

   NAME                                         STATUS   ROLES                  AGE     VERSION
   node/sno-cluster-name.host.example.com       Ready    control-plane,master   5h15m   v1.30.3