第 4 章 Image Based Install Operator

4.1.1. 先决条件
复制链接

如果使用 GitOps ZTP，请配置 GitOps ZTP 环境。要配置环境，请参阅为 GitOps ZTP 准备 hub 集群。
您有默认安装模板。要熟悉默认模板，请参阅默认设置模板
安装和配置您选择的底层操作器。
- 要了解并安装用于单节点 OpenShift 的镜像安装 Operator，请参阅 Image Based Install Operator。
- 要安装 Assisted Installer，请参阅使用 Assisted Installer 安装内部集群。

完成以下步骤，使用 SiteConfig operator 安装集群：

4.1.2. 创建目标命名空间
复制链接

在创建 pull secret、BMC secret、额外清单 ConfigMap 对象和 ClusterInstance 自定义资源时，您需要一个目标命名空间。

完成以下步骤以创建目标命名空间：

为目标命名空间创建 YAML 文件。请参阅以下名为 clusterinstance-namespace.yaml 的示例文件：
```
apiVersion: v1
kind: Namespace
metadata:
  name: example-sno
```
```
apiVersion: v1
kind: Namespace
metadata:
  name: example-sno
```
Copy to Clipboard Toggle word wrap
应用您的文件以创建资源。在 hub 集群中运行以下命令：
```
oc apply -f clusterinstance-namespace.yaml
```
```
oc apply -f clusterinstance-namespace.yaml
```
Copy to Clipboard Toggle word wrap

4.1.3. 创建 pull secret
复制链接

您需要 pull secret 才能使集群从容器 registry 中拉取镜像。完成以下步骤以创建 pull secret：

创建 YAML 文件以拉取镜像。请参阅以下名为 pull-secret.yaml 的文件示例：

apiVersion: v1
kind: Secret
metadata:
  name: pull-secret
  namespace: example-sno 
data:
  .dockerconfigjson: <encoded_docker_configuration> 
type: kubernetes.io/dockerconfigjson

apiVersion: v1
kind: Secret
metadata:
  name: pull-secret
  namespace: example-sno

1


data:
  .dockerconfigjson: <encoded_docker_configuration>

2


type: kubernetes.io/dockerconfigjson

Copy to Clipboard

Toggle word wrap

1: 确保 namespace 值与目标命名空间匹配。
2: 将 base64 编码的配置文件指定为值。

应用该文件以创建资源。在 hub 集群中运行以下命令：
```
oc apply -f pull-secret.yaml
```
```
oc apply -f pull-secret.yaml
```
Copy to Clipboard Toggle word wrap

4.1.4. 创建 BMC secret
复制链接

您需要一个 secret 来连接到基板管理控制器(BMC)。完成以下步骤以创建存储桶。

为 BMC secret 创建 YAML 文件。请参阅以下名为 example-bmc-secret.yaml 的示例文件：

apiVersion: v1
data:
  password: <password>
  username: <username>
kind: Secret
metadata:
  name: example-bmh-secret
  namespace: "example-sno" 
type: Opaque

apiVersion: v1
data:
  password: <password>
  username: <username>
kind: Secret
metadata:
  name: example-bmh-secret
  namespace: "example-sno"

1


type: Opaque

Copy to Clipboard

Toggle word wrap

1: 确保 namespace 值与目标命名空间匹配。

应用该文件以创建资源。在 hub 集群中运行以下命令：
```
oc apply -f example-bmc-secret.yaml
```
```
oc apply -f example-bmc-secret.yaml
```
Copy to Clipboard Toggle word wrap

4.1.5. 可选：创建额外的清单
复制链接

您可以创建在 ClusterInstance 自定义资源中引用的额外清单。完成以下步骤以创建额外的清单：

为额外的清单 ConfigMap 对象创建 YAML 文件，如 enable-crun.yaml ：

apiVersion: v1
kind: ConfigMap
metadata:
  name: enable-crun
  namespace: example-sno 
data:
  enable-crun-master.yaml: |
    apiVersion: machineconfiguration.openshift.io/v1
    kind: ContainerRuntimeConfig
    metadata:
      name: enable-crun-master
    spec:
      machineConfigPoolSelector:
        matchLabels:
          pools.operator.machineconfiguration.openshift.io/master: ""
      containerRuntimeConfig:
        defaultRuntime: crun
  enable-crun-worker.yaml: |
    apiVersion: machineconfiguration.openshift.io/v1
    kind: ContainerRuntimeConfig
    metadata:
      name: enable-crun-worker
    spec:
      machineConfigPoolSelector:
        matchLabels:
          pools.operator.machineconfiguration.openshift.io/worker: ""
      containerRuntimeConfig:
        defaultRuntime: crun

apiVersion: v1
kind: ConfigMap
metadata:
  name: enable-crun
  namespace: example-sno

1


data:
  enable-crun-master.yaml: |
    apiVersion: machineconfiguration.openshift.io/v1
    kind: ContainerRuntimeConfig
    metadata:
      name: enable-crun-master
    spec:
      machineConfigPoolSelector:
        matchLabels:
          pools.operator.machineconfiguration.openshift.io/master: ""
      containerRuntimeConfig:
        defaultRuntime: crun
  enable-crun-worker.yaml: |
    apiVersion: machineconfiguration.openshift.io/v1
    kind: ContainerRuntimeConfig
    metadata:
      name: enable-crun-worker
    spec:
      machineConfigPoolSelector:
        matchLabels:
          pools.operator.machineconfiguration.openshift.io/worker: ""
      containerRuntimeConfig:
        defaultRuntime: crun

Copy to Clipboard

Toggle word wrap

1: 确保 namespace 值与目标命名空间匹配。

在 hub 集群中运行以下命令来创建资源：
```
oc apply -f enable-crun.yaml
```
```
oc apply -f enable-crun.yaml
```
Copy to Clipboard Toggle word wrap

4.1.6. 渲染安装清单
复制链接

引用 ClusterInstance 自定义资源中的模板和支持清单。完成以下步骤，使用默认集群和节点模板呈现安装清单：

在 example-sno 命名空间中，在以下示例中创建名为 clusterinstance-ibi.yaml 的 ClusterInstance 自定义资源：

apiVersion: siteconfig.open-cluster-management.io/v1alpha1
kind: ClusterInstance
metadata:
  name: "example-clusterinstance"
  namespace: "example-sno" 
spec:
  #clusterType: "SNO" 
  holdInstallation: false
  extraManifestsRefs: 
    - name: extra-machine-configs
    - name: enable-crun
  pullSecretRef:
    name: "pull-secret" 
  [...]
  clusterName: "example-sno" 
  [...]
  clusterImageSetNameRef: "img4.17-x86-64"
  [...]
  templateRefs: 
    - name: ibi-cluster-templates-v1
      namespace: rhacm
  [...]
  nodes:
      [...]
      bmcCredentialsName: 
        name: "example-bmh-secret"
      [...]
      templateRefs: 
        - name: ibi-node-templates-v1
          namespace: rhacm
      [...]

apiVersion: siteconfig.open-cluster-management.io/v1alpha1
kind: ClusterInstance
metadata:
  name: "example-clusterinstance"
  namespace: "example-sno"

1


spec:
  #clusterType: "SNO"

2


  holdInstallation: false
  extraManifestsRefs:

3


    - name: extra-machine-configs
    - name: enable-crun
  pullSecretRef:
    name: "pull-secret"

4


  [...]
  clusterName: "example-sno"

5


  [...]
  clusterImageSetNameRef: "img4.17-x86-64"
  [...]
  templateRefs:

6


    - name: ibi-cluster-templates-v1
      namespace: rhacm
  [...]
  nodes:
      [...]
      bmcCredentialsName:

7


        name: "example-bmh-secret"
      [...]
      templateRefs:

8


        - name: ibi-node-templates-v1
          namespace: rhacm
      [...]

Copy to Clipboard

Toggle word wrap

1: 确保 ClusterInstance 自定义资源中的 命名空间 与您定义的目标命名空间匹配。
2: 可选：如果您想要扩展或缩减单节点 OpenShift 集群，则必须将spec.clusterType字段设置为"SNO" 。
3: 引用一个或多个额外清单 ConfigMap 对象的名称。
4: 引用 pull secret 的名称。
5: 确保 ClusterInstance 自定义资源中的 clusterName 字段的值与 namespace 字段的值匹配。
6: 在 spec.templateRefs 字段中引用集群级别 模板的名称。如果使用默认安装模板，命名空间 必须与安装 Operator 的命名空间匹配。
7: 引用 BMC secret 的名称。
8: 在 spec.nodes.templateRefs 字段中引用节点级别 模板的名称。如果使用默认安装模板，命名空间 必须与安装 Operator 的命名空间匹配。

运行以下命令应用该文件并创建资源：
```
oc apply -f clusterinstance-ibi.yaml
```
```
oc apply -f clusterinstance-ibi.yaml
```
Copy to Clipboard Toggle word wrap
创建自定义资源后，SiteConfig operator 开始协调 ClusterInstance 自定义资源，然后验证并呈现安装清单。
SiteConfig operator 继续监控 ClusterDeployment 自定义资源中的更改，以更新相应 ClusterInstance 自定义资源的集群安装进度。

运行以下命令监控进程：

oc get clusterinstance <cluster_name> -n <target_namespace> -o yaml

oc get clusterinstance <cluster_name> -n <target_namespace> -o yaml

Copy to Clipboard

Toggle word wrap

有关成功生成清单，请参阅 status.conditions 部分中的以下示例输出：

message: Applied site config manifests
reason: Completed
status: "True"
type: RenderedTemplatesApplied

message: Applied site config manifests
reason: Completed
status: "True"
type: RenderedTemplatesApplied

Copy to Clipboard

Toggle word wrap

运行以下命令，检查 SiteConfig operator 呈现的清单：

oc get clusterinstance <cluster_name> -n <target_namespace> -o jsonpath='{.status.manifestsRendered}'

oc get clusterinstance <cluster_name> -n <target_namespace> -o jsonpath='{.status.manifestsRendered}'

Copy to Clipboard

Toggle word wrap

如需有关状态条件的更多信息，请参阅 ClusterInstance API。

4.1. 使用 SiteConfig Operator 安装单节点 OpenShift 集群
复制链接

4.1.1. 先决条件
复制链接

4.1.2. 创建目标命名空间
复制链接

4.1.3. 创建 pull secret
复制链接

4.1.4. 创建 BMC secret
复制链接

4.1.5. 可选：创建额外的清单
复制链接

4.1.6. 渲染安装清单
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第 4 章 Image Based Install Operator

4.1. 使用 SiteConfig Operator 安装单节点 OpenShift 集群复制链接链接已复制到粘贴板!

4.1.1. 先决条件复制链接链接已复制到粘贴板!

4.1.2. 创建目标命名空间复制链接链接已复制到粘贴板!

4.1.3. 创建 pull secret复制链接链接已复制到粘贴板!

4.1.4. 创建 BMC secret复制链接链接已复制到粘贴板!

4.1.5. 可选：创建额外的清单复制链接链接已复制到粘贴板!

4.1.6. 渲染安装清单复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

4.1. 使用 SiteConfig Operator 安装单节点 OpenShift 集群
复制链接

4.1.1. 先决条件
复制链接

4.1.2. 创建目标命名空间
复制链接

4.1.3. 创建 pull secret
复制链接

4.1.4. 创建 BMC secret
复制链接

4.1.5. 可选：创建额外的清单
复制链接

4.1.6. 渲染安装清单
复制链接