Utilisation des éléments CCI dans les modèles VMware Aria Automation

Vous pouvez ajouter des éléments d'interface de consommation de cloud (CCI) pour utiliser le service CCI dans un modèle de VMware Aria Automation, afin que vos utilisateurs puissent demander des charges de travail basées sur Kubernetes à l'aide du service de machine virtuelle et de Tanzu Kubernetes Grid Service dans un espace de noms de superviseur.

Pour afficher les éléments CCI, développez la section Interface de consommation Cloud de la bibliothèque de ressources de votre modèle de cloud ou tapez cci dans le champ Types de ressources.

Le tableau ci-dessous montre les trois types de ressources CCI disponibles dans le modèle.

Ressource d'espace de noms de superviseur CCI.Supervisor.Namespace	Créez un espace de noms de superviseur qui fournit un espace de travail basé sur Kubernetes avec des limites de ressources, un accès utilisateur et des services de superviseur disponibles, afin que les utilisateurs puissent provisionner des ressources de machine virtuelle et TKG en fonction des besoins de l'application.
Ressource de superviseur CCI.Supervisor.Resource	Créez une ressource Kubernetes de superviseur prise en charge dans un espace de noms de superviseur, telle que virtualmachines, virtualmachineservices, tanzukubernetesclusters, persistentvolumeclaims, secrets, etc., en fonction du manifeste Kubernetes transmis à la ressource de superviseur en cours de configuration.
Ressource TKG CCI.TKG.Resource	Créez des ressources Kubernetes prises en charge dans un cluster TKG.

Note : Avant de pouvoir ajouter des éléments CCI à votre modèle de cloud, un administrateur VMware Aria Automation doit d'abord configurer CCI. Reportez-vous à la section Installation et configuration de l'interface de consommation de cloud.

Pour ajouter des éléments à votre modèle, faites-les glisser et déposez-les sur le canevas. Si vos ressources ont une relation basée sur le contexte, vous pouvez les déposer dans une configuration imbriquée avec les règles suivantes :

• CCI.Supervisor.Namespace : déposer directement sur le canevas.
• CCI.Supervisor.Resource : déposer sur une ressource d'espace de noms de superviseur ou directement sur le canevas.
• CCI.TKG.Resource : déposer sur une autre ressource TKG, une ressource de superviseur ou directement sur le canevas. Les ressources CCI sont limitées à cinq niveaux d'imbrication.

Dans la vue de canevas ci-dessous, une ressource TKG est en train d'être glissée vers la ressource de superviseur cciTKGCluster. Un espace de noms de superviseur qui contient une ressource de superviseur contenant une ressource TKG affiche trois niveaux d'imbrication.

Les exemples suivants montrent comment les ressources CCI telles que cciNamespace et cciTKGCluster s'affichent dans le code YAML de votre modèle de cloud. Chaque exemple est nettoyé pour afficher uniquement les lignes importantes.

Exemple de ressource d'espace de noms de superviseur

CCI.Supervisor.Namespace représente l'espace de travail basé sur Kubernetes de superviseur dans lequel les ressources IaaS de superviseur gérées par l'utilisateur vSphere pour l'application sont créées.

Cet exemple définit une ressource d'espace de noms de superviseur CCI nommée cciNamespace pour provisionner un espace de noms de superviseur appelé demo.

Note : Lorsque vous faites glisser et déposez une ressource d'espace de noms de superviseur CCI sur le canevas, vous devez entrer une valeur pour la propriété name dans le code YAML.

Pour vous assurer que l'espace de noms est provisionné sur un superviseur ciblé, vous devez configurer l'espace de noms de superviseur avec les éléments className et regionName définis par le projet.

formatVersion: 1
inputs: {}
resources:
  cciNamespace:
    type: CCI.Supervisor.Namespace
    properties:
      name: demo
      className: default
      regionName: dev-us-west

Exemple de ressource de superviseur

Utilisez CCI.Supervisor.Resource pour transmettre le manifeste Kubernetes pour les objets Kubernetes pris en charge pour s'exécuter dans un contexte d'espace de noms de superviseur.

• Pour provisionner la ressource de superviseur dans un espace de noms de superviseur particulier, configurez la propriété de contexte de la ressource de superviseur en la mappant à l'ID de l'espace de noms de superviseur à l'aide d'une expression de liaison de modèle, par exemplecontext: ${resource.cciNamespace.id}.
• Pour spécifier les objets à provisionner, configurez la propriété de manifeste de la ressource de superviseur en transmettant le manifeste Kubernetes à l'objet Kubernetes que vous créez.

Cet exemple crée une ressource de superviseur nommée cciTKGCluster dans l'espace de noms de superviseur cciNamespace en fournissant un manifeste Kubernetes pour un cluster TKG qui spécifie le réseau, la topologie, la taille du plan de contrôle et le nombre de nœuds worker, entre autres paramètres.

formatVersion: 1
inputs: {}
resources:
  cciTKGCluster:
    type: CCI.Supervisor.Resource
    properties:
      context: ${resource.cciNamespace.id}
      manifest:
        apiVersion: cluster.x-k8s.io/v1beta1
        kind: Cluster
        metadata:
          name: ${input.tkg_Name}
          labels:
            tkg-cluster-selector: ${input.tkg_Name}
        spec:
          clusterNetwork:
            cni:
              name: antrea
            pods:
              cidrBlocks:
                - 192.168.156.0/20
            services:
              cidrBlocks:
                - 10.96.0.0/12
            serviceDomain: cluster.local
          topology:
            class: tanzukubernetescluster
            version: v1.24.9---vmware.1-tkg.4
            variables:
              - name: storageClasses
                value:
                  - tmm-kubernetes-storage-policy
              - name: defaultStorageClass
                value: tmm-kubernetes-storage-policy
              - name: vmClass
                value: ${input.controlPlaneVmClassName}
              - name: storageClass
                value: tmm-kubernetes-storage-policy
            controlPlane:
              replicas: ${input.controlPlaneCount}
              metadata:
                annotations:
                  run.tanzu.vmware.com/resolve-os-image: os-name=photon
            workers:
              machineDeployments:
                - class: node-pool
                  name: ${input.tkg_Name}-nodepool
                  replicas: ${input.workerCount}
                  metadata:
                    annotations:
                      run.tanzu.vmware.com/resolve-os-image: os-name=photon
                  variables:
                    overrides:
                      - name: vmClass
                        value: ${input.workerVmClassName}

Cet exemple définit une ressource de superviseur nommée vm dans l'espace de noms de superviseur cciNamespace en fournissant un manifeste Kubernetes qui définit la configuration de la machine virtuelle et inclut une condition basée sur l'attente.

formatVersion: 1
inputs: {}
resources:
  vm:
    type: CCI.Supervisor.Resource
    properties:
      context: ${resource.cciNamespace.id}
      manifest:
        apiVersion: vmoperator.vmware.com/v1alpha1
        kind: VirtualMachine
        metadata:
          finalizers:
            - virtualmachine.vmoperator.vmware.com
          generation: 1
          labels:
            vm-selector: vm-2rfx
          name: vm-2rfx
        spec:
          className: best-effort-xsmall
          imageName: vmi-c3d184be88e1af1cd
          networkInterfaces:
            - networkType: nsx-t
          powerOffMode: hard
          powerState: poweredOn
          restartMode: hard
          storageClass: vsan-default-storage-policy
          suspendMode: hard
      wait:
        conditions:
          - type: VirtualMachinePrereqReady
            status: "False"
            reason: VirtualMachineImageNotReady
            indicatesFailure: true

Sur le canevas, l'espace de noms de superviseur cciNamespace contient deux ressources de superviseur cciTKGCluster et vm.

Exemple de ressource TKG

Utilisez CCI.TKG. Ressource pour créer des ressources Kubernetes prises en charge dans un cluster TKG ou dans un espace de noms s'exécutant sur le cluster TKG.

• Pour lier une ressource TKG à un cluster TKG, mappez l'ID de la ressource de cluster TKG de superviseur avec la propriété de contexte, par exemple context: ${resource.cciTKGCluster.id}.
• Si vous créez un espace de noms dans une ressource TKG nommée cciTKGNamespace par exemple, vous pouvez lier une ressource TKG à l'espace de noms en insérant le nom de la ressource TKG dans la propriété de contexte ou context: ${resource.cciTKGNamespace.id}.
• Le manifeste Kubernetes transmis dans les propriétés de ressource spécifie le type de l'objet Kubernetes à provisionner.

Cet exemple montre un secret en tant que ressource TKG liée à un cluster TKG nommé cciTKGCluster.

...
  tkgSecret:
    type: CCI.TKG.Resource
    properties:
      context: ${resource.cciTKGCluster.id}
      manifest:
        apiVersion: v1
        kind: Secret
        metadata:
          name: nvaie-apikey
        type: Opaque
        data:
          username: KM9hdCCodG9rZW4=
          password: ${base64_encode(input.password)}
...

Sur le canevas, la ressource TKG tkgSecret apparaît imbriquée dans la ressource TKG cciTKGCluster.

Ajout d'une propriété d'attente

La ressource de superviseur et la ressource TKG prennent en charge une propriété d'attente qui attendra des conditions ou des valeurs de champ spécifiques dans une ressource, avant d'envisager la fin de la création de la ressource. Les types de propriétés d'attente sont les suivants :

• Attente de champ : liste de champs dans lesquels chaque champ peut être configuré avec un chemin de propriété et une valeur. La valeur doit correspondre avant que la ressource soit considérée comme étant terminée.
• Attente de condition : liste des conditions qui indiquent la réussite ou l'échec de la création des ressources.

Cet exemple montre une condition d'attente ajoutée à une ressource de superviseur. La condition doit être satisfaite pour que la ressource de superviseur puisse être marquée comme étant terminée.

...
      wait:
        conditions:
          - type: VirtualMachinePrereqReady
            status: "False"
            reason: VirtualMachineImageNotReady
            indicatesFailure: true
...

Pour ajouter des paramètres facultatifs à l'aide de l'interface utilisateur, cliquez sur l'ampoule en regard du nom de la ressource dans le panneau Code.