Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

12.2. YAML 文件示例

对于 Cluster API 技术预览，您必须创建 Cluster API 需要的主要资源。本节中的 YAML 文件示例演示如何使这些资源共同工作，并为他们创建适合您环境的机器配置设置。

12.2.1. Cluster API 集群资源的 YAML 示例
复制链接

集群资源定义集群的名称和基础架构供应商，并由 Cluster API 管理。此资源对所有提供程序具有相同的结构。 

apiVersion: cluster.x-k8s.io/v1beta1
kind: Cluster
metadata:
  name: <cluster_name>
1 

  namespace: openshift-cluster-api
spec:
  infrastructureRef:
    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
    kind: <infrastructure_kind>
2 

    name: <cluster_name>
3 

    namespace: openshift-cluster-api
1 3
指定集群的名称。
2
指定集群的基础架构类型。有效值为：
  • AWSCluster ：集群在 Amazon Web Services (AWS) 上运行。
  • GCPCluster ：集群在 Google Cloud Platform (GCP) 上运行。

剩余的 Cluster API 资源是特定于供应商的。请参考集群的 YAML 文件示例：

有些 Cluster API 资源是特定于供应商的。本节中的 YAML 文件示例显示 Amazon Web Services (AWS) 集群的配置。

基础架构资源是特定于提供程序的，定义由集群中所有机器集（如地区和子网）共享的属性。机器集在创建机器时引用此资源。 

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: AWSCluster
1 

metadata:
  name: <cluster_name>
2 

  namespace: openshift-cluster-api
spec:
  region: <region>
3
1
指定集群的基础架构类型。这个值必须与您的平台的值匹配。
2
指定集群的名称。
3
指定 AWS 区域。

机器模板资源是特定于提供程序的，定义机器集创建的机器的基本属性。机器集在创建机器时引用此模板。 

apiVersion: infrastructure.cluster.x-k8s.io/v1alpha4
kind: AWSMachineTemplate
1 

metadata:
  name: <template_name>
2 

  namespace: openshift-cluster-api
spec:
  template:
    spec:
3 

      uncompressedUserData: true
      iamInstanceProfile: ....
      instanceType: m5.large
      cloudInit:
        insecureSkipSecretsManager: true
      ami:
        id: ....
      subnet:
        filters:
        - name: tag:Name
          values:
          - ...
      additionalSecurityGroups:
      - filters:
        - name: tag:Name
          values:
          - ...
1
指定机器模板类型。这个值必须与您的平台的值匹配。
2
为机器模板指定名称。
3
指定您的环境的详情。这里的值为示例。

机器集资源定义它创建的机器的额外属性。机器集也会在创建机器时引用基础架构资源和机器模板。 

apiVersion: cluster.x-k8s.io/v1alpha4
kind: MachineSet
metadata:
  name: <machine_set_name>
1 

  namespace: openshift-cluster-api
spec:
  clusterName: <cluster_name>
2 

  replicas: 1
  selector:
    matchLabels:
      test: example
  template:
    metadata:
      labels:
        test: example
    spec:
      bootstrap:
         dataSecretName: worker-user-data
3 

      clusterName: <cluster_name>
4 

      infrastructureRef:
        apiVersion: infrastructure.cluster.x-k8s.io/v1alpha4
        kind: AWSMachineTemplate
5 

        name: <cluster_name>
6
1
为机器集指定一个名称。
2 4 6
指定集群的名称。
3
对于 Cluster API 技术预览，Operator 可以使用 openshift-machine-api 命名空间中的 worker 用户数据 secret。
5
指定机器模板类型。这个值必须与您的平台的值匹配。

有些 Cluster API 资源是特定于供应商的。本节中的 YAML 文件示例显示 Google Cloud Platform (GCP) 集群的配置。

基础架构资源是特定于提供程序的，定义由集群中所有机器集（如地区和子网）共享的属性。机器集在创建机器时引用此资源。 

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: GCPCluster
1 

metadata:
  name: <cluster_name>
2 

spec:
  network:
    name: <cluster_name>-network
3 

  project: <project>
4 

  region: <region>
5
1
指定集群的基础架构类型。这个值必须与您的平台的值匹配。
2 3
指定集群的名称。
4
指定 GCP 项目名称。
5
指定 GCP 区域。

机器模板资源是特定于提供程序的，定义机器集创建的机器的基本属性。机器集在创建机器时引用此模板。 

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: GCPMachineTemplate
1 

metadata:
  name: <template_name>
2 

  namespace: openshift-cluster-api
spec:
  template:
    spec:
3 

      rootDeviceType: pd-ssd
      rootDeviceSize: 128
      instanceType: n1-standard-4
      image: projects/rhcos-cloud/global/images/rhcos-411-85-202203181601-0-gcp-x86-64
      subnet: <cluster_name>-worker-subnet
      serviceAccounts:
        email: <service_account_email_address>
        scopes:
          - https://www.googleapis.com/auth/cloud-platform
      additionalLabels:
        kubernetes-io-cluster-<cluster_name>: owned
      additionalNetworkTags:
        - <cluster_name>-worker
      ipForwarding: Disabled
1
指定机器模板类型。这个值必须与您的平台的值匹配。
2
为机器模板指定名称。
3
指定您的环境的详情。这里的值为示例。

机器集资源定义它创建的机器的额外属性。机器集也会在创建机器时引用基础架构资源和机器模板。 

apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineSet
metadata:
  name: <machine_set_name>
1 

  namespace: openshift-cluster-api
spec:
  clusterName: <cluster_name>
2 

  replicas: 1
  selector:
    matchLabels:
      test: test
  template:
    metadata:
      labels:
        test: test
    spec:
      bootstrap:
         dataSecretName: worker-user-data
3 

      clusterName: <cluster_name>
4 

      infrastructureRef:
        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
        kind: GCPMachineTemplate
5 

        name: <machine_set_name>
6 

      failureDomain: <failure_domain>
7
1 6
为机器集指定一个名称。
2 4
指定集群的名称。
3
对于 Cluster API 技术预览，Operator 可以使用 openshift-machine-api 命名空间中的 worker 用户数据 secret。
5
指定机器模板类型。这个值必须与您的平台的值匹配。
7
指定 GCP 区域中的故障域。
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部