1.9. 主机清单简介

运行以下命令，检查您已有一个裸机主机自定义资源定义：

oc get crd baremetalhosts.metal3.io

Error from server (NotFound): customresourcedefinitions.apiextensions.k8s.io "baremetalhosts.metal3.io" not found

如果您没有裸机主机自定义资源定义，请下载 metal3.io_baremetalhosts.yaml 文件，并通过运行以下命令来创建资源来应用内容：

oc apply -f

运行以下命令检查是否有 Provisioning 资源：

oc get provisioning

在与基础架构 Operator 相同的命名空间中创建 ConfigMap，为镜像 registry 指定 ca-bundle.crt 和 registry.conf 的值。您的文件 ConfigMap 可能类似以下示例：

apiVersion: v1
kind: ConfigMap
metadata:
  name: <mirror-config>
  namespace: multicluster-engine
  labels:
    app: assisted-service
data:
  ca-bundle.crt: |
    <certificate-content>
  registries.conf: |
    unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
    [[registry]]
       prefix = ""
       location = "registry.redhat.io/multicluster-engine"
       mirror-by-digest-only = true
       [[registry.mirror]]
       location = "mirror.registry.com:5000/multicluster-engine"

注： 您必须将 mirror-by-digest-only 设置为 true，因为发行镜像是使用摘要指定的。

unqualified-search-registries 列表中的 registry 会自动添加到 PUBLIC_CONTAINER_REGISTRIES 环境变量中的身份验证忽略列表中。当验证受管集群的 pull secret 时，指定的 registry 不需要身份验证。

创建名为 headers 的文件并添加类似以下示例的内容：

{
  "Authorization": "Basic xyz"
}

创建名为 query_params 的文件并添加类似以下示例的内容：

{
  "api_key": "myexampleapikey",
}

使用以下命令登录到受管集群：

oc login

在 AgentServiceConfig 资源中添加 agent-install.openshift.io/service-image-base: el8 注解。

您的 AgentServiceConfig 资源可能类似以下 YAML：

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  annotations:
    agent-install.openshift.io/service-image-base: el8
...

在主机清单设置中添加以下信息：

运行以下命令登录到您的 hub 集群：

oc login

为您的资源创建一个命名空间。

创建包含 OpenShift Container Platform pull secret 的 Secret 自定义资源。

创建基础架构环境。

运行以下命令来应用 YAML 内容：

oc apply -f infra-env.yaml

要验证主机清单是否已创建，请使用以下命令检查状态：

oc describe infraenv myinfraenv -n <your_namespace>

创建名为 nmstateconfig.yaml 的文件并添加类似以下模板的内容。根据需要替换值：

apiVersion: agent-install.openshift.io/v1beta1
kind: NMStateConfig
metadata:
  name: mynmstateconfig
  namespace: <your-infraenv-namespace>
  labels:
    some-key: <some-value>
spec:
  config:
    interfaces:
      - name: eth0
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:14
        ipv4:
          enabled: true
          address:
            - ip: 192.168.111.30
              prefix-length: 24
          dhcp: false
      - name: eth1
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:15
        ipv4:
          enabled: true
          address:
            - ip: 192.168.140.30
              prefix-length: 24
          dhcp: false
    dns-resolver:
      config:
        server:
          - 192.168.126.1
    routes:
      config:
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.111.1
          next-hop-interface: eth1
          table-id: 254
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.140.1
          next-hop-interface: eth1
          table-id: 254
  interfaces:
    - name: "eth0"
      macAddress: "02:00:00:80:12:14"
    - name: "eth1"
      macAddress: "02:00:00:80:12:15"

运行以下命令来应用 YAML 内容：

oc apply -f nmstateconfig.yaml

点 Add hosts 并选择 With Discovery ISO。

现在，您会看到一个 URL 来下载 ISO 文件。引导的主机出现在主机清单表中。显示主机可能需要几分钟时间。

注： 默认情况下，提供的 ISO 是 最小 ISO。最小 ISO 不包含根文件系统 RootFS。稍后下载 RootFS。要显示完整的 ISO，请将 URL 中的 minimal.iso 替换为 full.iso。

运行以下命令，以查看 InfraEnv 自定义资源中的下载 URL：

oc get infraenv -n <infra env namespace> <infra env name> -o jsonpath='{.status.isoDownloadURL}'

请参见以下输出：

https://assisted-image-service-assisted-installer.apps.example-acm-hub.com/byapikey/eyJhbGciOiJFUzI1NiIsInC93XVCJ9.eyJpbmZyYV9lbnZfaWQcTA0Y38sWVjYi02MTA0LTQ4NDMtODasdkOGIxYTZkZGM5ZTUifQ.3ydTpHaXJmTasd7uDp2NvGUFRKin3Z9Qct3lvDky1N-5zj3KsRePhAM48aUccBqmucGt3g/4.16/x86_64/minimal.iso

注： 默认情况下，提供的 ISO 是 最小 ISO。最小 ISO 不包含根文件系统 RootFS。稍后下载 RootFS。要显示完整的 ISO，请将 URL 中的 minimal.iso 替换为 full.iso。

使用 URL 下载 ISO 文件并使用 ISO 文件引导主机。

接下来，您需要批准每个主机。请参见以下步骤：

运行以下命令列出所有 代理 ：

oc get agent -n <infra env namespace>

您会收到类似以下输出的输出：

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
24a92a6f-ea35-4d6f-9579-8f04c0d3591e             false      auto-assign

使用错误批准状态，从列表中 批准 任何 代理。运行以下命令:

oc patch agent -n <infra env namespace> <agent name> -p '{"spec":{"approved":true}}' --type merge

运行以下命令确认批准状态：

oc get agent -n <infra env namespace>

您会收到一个类似于以下输出的输出，其值为 true ：

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
173e3a84-88e2-4fe1-967f-1a9242503bec             true       auto-assign

通过应用以下 YAML 内容并替换需要的值来创建 BMC secret：

apiVersion: v1
kind: Secret
metadata:
  name: <bmc-secret-name>
  namespace: <your_infraenv_namespace> 1
type: Opaque
data:
  username: <username>
  password: <password>

通过应用以下 YAML 内容并在需要时替换值来创建裸机主机：

apiVersion: metal3.io/v1alpha1
kind: BareMetalHost
metadata:
  name: <bmh-name>
  namespace: <your_infraenv_namespace> 1
  annotations:
    inspect.metal3.io: disabled
  labels:
    infraenvs.agent-install.openshift.io: <your-infraenv> 2
spec:
  online: true
  automatedCleaningMode: disabled 3
  bootMACAddress: <your-mac-address>  4
  bmc:
    address: <machine-address> 5
    credentialsName: <bmc-secret-name> 6
  rootDeviceHints:
    deviceName: /dev/sda 7