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:

   Copy to Clipboard Toggle word wrap

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

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 :

   Copy to Clipboard Toggle word wrap

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

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 :

   Copy to Clipboard Toggle word wrap

   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

   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:

   Copy to Clipboard Toggle word wrap

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

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 :

   Copy to Clipboard Toggle word wrap

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

   1

   
     extraManifests:
       filter:
         inclusionDefault: exclude  

   2

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

   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é :

   Copy to Clipboard Toggle word wrap

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