21.8. Configuration avancée des clusters gérés avec les ressources SiteConfig

Procédure

1. Créer un ensemble de manifestes CR supplémentaires que le pipeline ZTP utilise pour personnaliser l'installation des clusters.

2. Dans votre répertoire personnalisé /siteconfig, créez un dossier /extra-manifest pour vos manifestes supplémentaires. L'exemple suivant illustre un exemple de /siteconfig avec un dossier /extra-manifest:

   siteconfig
   ├── site1-sno-du.yaml
   ├── site2-standard-du.yaml
   └── extra-manifest
       └── 01-example-machine-config.yaml

   Copy to Clipboard Toggle word wrap
3. Ajoutez vos CR de manifestes supplémentaires personnalisés au répertoire siteconfig/extra-manifest.

4. Dans votre CR SiteConfig, saisissez le nom du répertoire dans le champ extraManifestPath, par exemple :

   clusters:
   - clusterName: "example-sno"
     networkType: "OVNKubernetes"
     extraManifestPath: extra-manifest

   Copy to Clipboard Toggle word wrap
5. Sauvegardez les CRs SiteConfig et /extra-manifest et mettez-les dans le repo de configuration du site.

Procédure

1. Pour empêcher le pipeline ZTP d'appliquer le fichier 03-sctp-machine-config-worker.yaml CR, appliquez le YAML suivant dans le SiteConfig CR :

   apiVersion: ran.openshift.io/v1
   kind: SiteConfig
   metadata:
     name: "site1-sno-du"
     namespace: "site1-sno-du"
   spec:
     baseDomain: "example.com"
     pullSecretRef:
       name: "assisted-deployment-pull-secret"
     clusterImageSetNameRef: "openshift-4.12"
     sshPublicKey: "<ssh_public_key>"
     clusters:
   - clusterName: "site1-sno-du"
     extraManifests:
       filter:
         exclude:
           - 03-sctp-machine-config-worker.yaml

   Copy to Clipboard Toggle word wrap

   Le pipeline ZTP ne tient pas compte de la CR 03-sctp-machine-config-worker.yaml lors de l'installation. Tous les autres CR de /source-crs/extra-manifest sont appliqués.

2. Enregistrez le CR SiteConfig et transférez les modifications dans le référentiel de configuration du site.

   Le pipeline ZTP surveille et ajuste les CR qu'il applique en fonction des instructions du filtre SiteConfig.

3. Facultatif : Pour éviter que le pipeline ZTP n'applique toutes les CR /source-crs/extra-manifest pendant l'installation du cluster, appliquez le YAML suivant dans la CR SiteConfig:

   - clusterName: "site1-sno-du"
     extraManifests:
       filter:
         inclusionDefault: exclude

   Copy to Clipboard Toggle word wrap

4. Facultatif : Pour exclure tous les CR de /source-crs/extra-manifest RAN et inclure à la place un fichier CR personnalisé pendant l'installation, modifiez le CR personnalisé de SiteConfig pour définir le dossier des manifestes personnalisés et le fichier include, par exemple :

   clusters:
   - clusterName: "site1-sno-du"
     extraManifestPath: "<custom_manifest_folder>" 

   1

   
     extraManifests:
       filter:
         inclusionDefault: exclude  

   2

   
         include:
           - custom-sctp-machine-config-worker.yaml

   Copy to Clipboard Toggle word wrap

   1

   Remplacez <custom_manifest_folder> par le nom du dossier qui contient les CR de l'installation personnalisée, par exemple, user-custom-manifest/.

   2

   Définissez inclusionDefault sur exclude pour éviter que le pipeline ZTP n'applique les fichiers contenus dans /source-crs/extra-manifest lors de l'installation.

   L'exemple suivant illustre la structure du dossier personnalisé :

   siteconfig
     ├── site1-sno-du.yaml
     └── user-custom-manifest
           └── custom-sctp-machine-config-worker.yaml

   Copy to Clipboard Toggle word wrap