SupportConsoleDéveloppeursCommencer un essaiContact

11.2. Exemples de fichiers YAML

Pour l'aperçu technologique de l'API de cluster, vous devez créer manuellement les ressources primaires dont l'API de cluster a besoin. Les exemples de fichiers YAML de cette section montrent comment faire fonctionner ces ressources ensemble et configurer les paramètres des machines qu'elles créent en fonction de votre environnement.

11.2.1. Exemple de YAML pour une ressource de cluster de l'API Cluster

La ressource cluster définit le nom et le fournisseur d'infrastructure pour le cluster et est gérée par l'API Cluster. Cette ressource a la même structure pour tous les fournisseurs. 

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
Specify the name of the cluster.
2
Spécifiez le type d'infrastructure pour le cluster. Les valeurs valides sont les suivantes :
  • AWSCluster: Le cluster fonctionne sur Amazon Web Services (AWS).
  • GCPCluster: Le cluster fonctionne sur Google Cloud Platform (GCP).

Les autres ressources de l'API Cluster sont spécifiques à chaque fournisseur. Reportez-vous aux exemples de fichiers YAML pour votre cluster :

11.2.2. Exemples de fichiers YAML pour la configuration des clusters Amazon Web Services

Certaines ressources de l'API Cluster sont spécifiques à un fournisseur. Les exemples de fichiers YAML de cette section présentent des configurations pour un cluster Amazon Web Services (AWS).

11.2.2.1. Exemple de YAML pour une ressource d'infrastructure Cluster API sur Amazon Web Services

La ressource d'infrastructure est spécifique au fournisseur et définit des propriétés qui sont partagées par tous les ensembles de machines de calcul dans le cluster, telles que la région et les sous-réseaux. L'ensemble de machines de calcul fait référence à cette ressource lorsqu'il crée des machines. 

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: AWSCluster 1
metadata:
  name: <cluster_name> 2
  namespace: openshift-cluster-api
spec:
  region: <region> 3
1
Spécifiez le type d'infrastructure pour le cluster. Cette valeur doit correspondre à celle de votre plate-forme.
2
Specify the name of the cluster.
3
Spécifiez la région AWS.

11.2.2.2. Exemple de YAML pour une ressource modèle de machine Cluster API sur Amazon Web Services

La ressource modèle de machine est spécifique au fournisseur et définit les propriétés de base des machines qu'un ensemble de machines de calcul crée. L'ensemble de machines de calcul fait référence à ce modèle lorsqu'il crée des machines. 

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
Indiquez le type de modèle de machine. Cette valeur doit correspondre à celle de votre plate-forme.
2
Spécifiez un nom pour le modèle de machine.
3
Spécifiez les détails de votre environnement. Les valeurs indiquées ici sont des exemples.

11.2.2.3. Exemple de YAML pour un ensemble de machines de calcul Cluster API sur Amazon Web Services

La ressource Ensemble de machines de calcul définit des propriétés supplémentaires pour les machines qu'elle crée. Le jeu de machines de calcul fait également référence à la ressource d'infrastructure et au modèle de machine lors de la création de machines. 

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
Spécifiez un nom pour l'ensemble de machines de calcul.
2 4 6
Specify the name of the cluster.
3
Pour l'API Cluster Technology Preview, l'opérateur peut utiliser le secret des données de l'utilisateur du travailleur à partir de l'espace de noms openshift-machine-api.
5
Indiquez le type de modèle de machine. Cette valeur doit correspondre à celle de votre plate-forme.

11.2.3. Exemples de fichiers YAML pour la configuration des clusters Google Cloud Platform

Certaines ressources de l'API Cluster sont spécifiques à un fournisseur. Les exemples de fichiers YAML de cette section présentent des configurations pour un cluster Google Cloud Platform (GCP).

11.2.3.1. Exemple de YAML pour une ressource d'infrastructure Cluster API sur Google Cloud Platform

La ressource d'infrastructure est spécifique au fournisseur et définit des propriétés qui sont partagées par tous les ensembles de machines de calcul dans le cluster, telles que la région et les sous-réseaux. L'ensemble de machines de calcul fait référence à cette ressource lorsqu'il crée des machines. 

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
Spécifiez le type d'infrastructure pour le cluster. Cette valeur doit correspondre à celle de votre plate-forme.
2 3
Specify the name of the cluster.
4
Spécifiez le nom du projet GCP.
5
Spécifiez la région GCP.

11.2.3.2. Exemple de YAML pour une ressource de modèle de machine Cluster API sur Google Cloud Platform

La ressource modèle de machine est spécifique au fournisseur et définit les propriétés de base des machines qu'un ensemble de machines de calcul crée. L'ensemble de machines de calcul fait référence à ce modèle lorsqu'il crée des machines. 

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
Indiquez le type de modèle de machine. Cette valeur doit correspondre à celle de votre plate-forme.
2
Spécifiez un nom pour le modèle de machine.
3
Spécifiez les détails de votre environnement. Les valeurs indiquées ici sont des exemples.

11.2.3.3. Exemple de YAML pour une ressource d'ensemble de machines de calcul Cluster API sur Google Cloud Platform

La ressource Ensemble de machines de calcul définit des propriétés supplémentaires pour les machines qu'elle crée. Le jeu de machines de calcul fait également référence à la ressource d'infrastructure et au modèle de machine lors de la création de machines. 

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
Spécifiez un nom pour l'ensemble de machines de calcul.
2 4
Specify the name of the cluster.
3
Pour l'API Cluster Technology Preview, l'opérateur peut utiliser le secret des données de l'utilisateur du travailleur à partir de l'espace de noms openshift-machine-api.
5
Indiquez le type de modèle de machine. Cette valeur doit correspondre à celle de votre plate-forme.
7
Spécifiez le domaine de défaillance dans la région GCP.
Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.