En tant qu'administrateur de cloud VMware Aria Automation, vous pouvez utiliser une interface de ligne de commande pour configurer l'accès à l'interface de consommation de cloud (CCI) et configurer des constructions de gouvernance. L'interface de ligne de commande utilise l'outil de ligne de commande Kubernetes ou kubectl.

Pour obtenir la liste complète des actions que vous pouvez effectuer à l'aide de l'interface de ligne de commande, reportez-vous à la section Référence de l'API Kubernetes pour l'interface de consommation de cloud.

Note : Vous pouvez également utiliser l'interface utilisateur pour effectuer certaines des étapes suivantes. Des liens vers la documentation de l'interface utilisateur sont fournis avec ces étapes.

Conditions préalables

  • Vérifiez qu'un cluster superviseur est activé sur une instance de vCenter et est enregistré dans VMware Aria Automation.
  • Vérifiez que vous êtes au moins membre de l'organisation dans VMware Aria Automation avec le rôle de service Administrateur pour Automation Assembler ou Automation Service Broker.
  • Vérifiez que vous disposez de éléments suivants :
    • Téléchargement du plug-in CCI kubectl.
    • Jeton d'API pour l'utilisateur Admin ou variable définie pour stocker le mot de passe d'utilisateur.
    • Jeton utilisé avec l'option -t ou informations d'identification de l'administrateur utilisées avec l'option -u pour vous connecter au serveur CCI et contexte par défaut défini sur CCI.
  • Vérifiez que vous avez ajouté un compte cloud vCenter dans Automation Assembler.
  • Vérifiez que le nom du compte de cloud vCenter n'inclut pas d'espaces ni de lettres majuscules. Par exemple, my-vcenter-cloud-account.

Pour plus d'informations sur ces conditions préalables, reportez-vous à la section Installation et configuration de l'interface de consommation de cloud.

Étape 1 : créer un projet et des liaisons de rôle de projet

Pour regrouper les utilisateurs Automation et définir l'accès aux ressources d'infrastructure, vous créez un projet et des liaisons de rôle de projet.

Pour créer un projet et des liaisons de rôle de projet à l'aide de l'interface utilisateur, reportez-vous à la section Ajout d'un projet pour mon équipe de développement Automation Assembler..

  1. Créez un projet.
    kubectl create -f project.yaml
    Exemple de fichier project.yaml.
    apiVersion: project.cci.vmware.com/v1alpha1
    kind: Project
    metadata:
      name: <project_name>
    spec:
      description: <description_of_project>
      sharedResources: true
    
  2. Créez une liaison de rôle de projet pour attribuer des rôles à des utilisateurs ou des groupes dans un projet créé.
    kubectl create -f projectrolebinding.yaml
    L'exemple de fichier projectrolebinding.yaml suivant ajoute un utilisateur disposant du rôle de projet admin. Les valeurs de rôle de projet sont : admin, view ou edit.
    apiVersion: authorization.cci.vmware.com/v1alpha1
    kind: ProjectRoleBinding
    metadata:
      name: cci:user:vmware.com:<user_alias>
      namespace: <project_name>
    roleRef:
      apiGroup: authorization.cci.vmware.com
      kind: ProjectRole
      name: admin
    subjects:
    - kind: User
      name: <[email protected]>

Étape 2: créer une région

Vous créez une région afin de pouvoir attribuer des superviseurs à cette région.

kubectl create -f region.yaml
Exemple de fichier region.yaml.
apiVersion: topology.cci.vmware.com/v1alpha1
kind: Region
metadata:
  name: <region_name>
spec:
  description: <description_of_region>

Étape 3 : associer un superviseur à une région

Pour associer un superviseur à une région, vous recherchez le superviseur que vous souhaitez mettre à jour, puis ajoutez la région et les étiquettes qui seront utilisées pour le positionnement de l'espace de noms.

  1. Pour trouver le superviseur que vous souhaitez mettre à jour, répertoriez les superviseurs. Les ressources du superviseur sont visibles après la collecte de données vCenter.
    kubectl -n cci-config get supervisors
    Voici un exemple de résultat.
    NAME                             AGE
    demo-self-service:domain-c50     75d
    adminannie-vcenter:domain-c8     5d18h
    scale-test-vc-01:domain-c8       56d
  2. Mettez à jour le superviseur nommé adminannie-vcenter:domain-c8.
    kubectl -n cci-config edit supervisor adminannie-vc:domain-c8
    L'exemple suivant inclut les paires de clé-valeur metadata.labels et les spec.regionNames de régions. Les étiquettes environment: testing et fipsMode: strict peuvent être utilisées pour faciliter les décisions de placement du superviseur.
    apiVersion: infrastructure.cci.vmware.com/v1alpha1
    kind: Supervisor
    metadata:
      labels:
        environment: testing
      name: adminannie-vc:domain-c8
      namespace: cci-config
      uid: ccd3d154-6404-47b7-8786-bb2d49ad9f5d
    spec:
      cloudAccountName: adminannie-vc
      externalId: domain-c8
      externalName: wcp-test-dc-cluster
      regionNames:
        - <region_name>
Pour afficher la liste des régions de superviseur dans l'interface utilisateur Automation Assembler ou Automation Service Broker, accédez à :
  • Infrastructure > Configurer > Régions de superviseur
  • Vous pouvez également cliquer sur l'onglet Régions de superviseur pour un projet situé dans Infrastructure > Administration > Projets.
Reportez-vous à la section Affichage des constructions de l'administrateur.

Étape 4 : créer une liaison de région et une configuration de liaison de région

Vous créez une liaison de région et une configuration de liaison de région afin que les utilisateurs d'un projet puissent créer des espaces de noms de superviseur sur les superviseurs d'une région.

  1. Créez une liaison de région.
    kubectl create -f regionbinding.yaml
    Exemple de fichier regionbinding.yaml.
    apiVersion: topology.cci.vmware.com/v1alpha1
    kind: RegionBinding
    metadata:
      name: <region_name>
      namespace: <project_name>

    Une liaison de région n'inclut aucun paramètre de positionnement du superviseur, vous devez donc également créer une configuration de liaison de région.

  2. Créez une configuration de liaison de région pour chaque liaison de région créée. Vous pouvez inclure des expressions de correspondance utilisées pour un filtrage supplémentaire des superviseurs. Les étiquettes de superviseur sont utilisées pour autoriser le positionnement de l'espace de noms de superviseur sur un sous-ensemble de superviseurs d'une région.
    kubectl create -f regionbindingconfig.yaml
    Dans l'exemple suivant de fichier regionbindingconfig.yaml, tous les superviseurs qui correspondent à l'étiquette d'environnement testing peuvent héberger les espaces de noms de superviseur créés dans ce projet et cette région.
    apiVersion: topology.cci.vmware.com/v1alpha1
    kind: RegionBindingConfig
    metadata:
      name: <region_name>
      namespace: <project_name>
    spec:
      supervisorSelector:
        matchExpressions:
          - key: environment
            operator: In
            values:
              - testing

Étape 5 : créer une classe d'espace de noms de superviseur et ajouter une configuration de classe d'espace de noms de superviseur

Pour définir des modèles d'espace de noms avec les paramètres facultatifs qui peuvent être utilisés pour personnaliser les paramètres d'espace de noms lors de la création, vous créez une classe d'espace de noms de superviseur. Ensuite, vous pouvez créer une configuration de classe d'espace de noms de superviseur avec des expressions de correspondance qui sont utilisées pour le filtrage supplémentaire des superviseurs utilisés pour le positionnement de l'espace de noms de superviseur.

Pour créer une classe d'espace de noms de superviseur avec une configuration de classe d'espace de noms de superviseur à l'aide de l'interface utilisateur, reportez-vous à la section Création et configuration de classes d'espace de noms, de configuration de classe d'espace de noms et de liaison de classe d'espaces de noms à l'aide de l'interface utilisateur.

  1. Créez une classe d'espace de noms de superviseur.
    kubectl create -f supervisornamespaceclass.yaml
    Dans l'exemple suivant de fichier supervisornamespaceclass.yaml, l'entrée facultative sous parameters reflète les paramètres de classe d'espace de noms que les utilisateurs fournissent lors de la création de l'espace de noms. Toutes les entrées doivent avoir des valeurs par défaut. Les valeurs sont utilisées pour personnaliser les classes de stockage, les limites et les contraintes supplémentaires. La valeur name doit être en minuscules et ne pas contenir d'espace.
    apiVersion: infrastructure.cci.vmware.com/v1alpha1
    kind: SupervisorNamespaceClass
    metadata:
      name: <class_name>
    spec:
      description: supervisor namespace class
      parameters:
        - name: podcountlimit
          type: Integer
          minimum: 100
          maximum: 1000
          default: 500

    La classe d'espace de noms de superviseur ne contient pas de paramètres de positionnement de superviseur, vous devez donc également créer une configuration de classe d'espace de noms de superviseur.

  2. Créez une configuration de classe d'espace de noms de superviseur.
    kubectl create -f supervisornamespaceclassconfig.yaml
    Le fichier YAML est configuré avec toutes les configurations d'espace de noms de superviseur dont vous souhaitez que l'espace de noms de superviseur hérite et peut inclure :
    • Bibliothèques de contenu qui contiennent les images que le service de machine virtuelle utilise lors du provisionnement des machines virtuelles.
    • Classes de machines virtuelles telles que tailles de T-Shirt.
    • Limites de ressources appliquées au CPU, à la mémoire et au stockage.
    • Classes de stockage à utiliser.
    • SupervisorSelector pour décider quel superviseur utiliser lors de la création de l'espace de noms de superviseur.
    Dans l'exemple suivant de fichier supervisornamespaceclassconfig.yaml, supervisorSelector est utilisé pour faire correspondre les étiquettes de superviseur.
    apiVersion: infrastructure.cci.vmware.com/v1alpha1
    kind: SupervisorNamespaceClassConfig
    metadata:
      name: <class_name>
    spec:
      storageClasses:
        - name: management-storage-policy-thin
      vmClasses:
        - name: big-vm-class
        - name: small-vm-class
      contentSources:
        - name: global-content-library
          type: ContentLibrary
      # Below limits are an EXAMPLE! Setting them may cause unexpected behavior in your namespace
      # Either set reasonable limits, or remove the below section to get unlimited resources
      limits:
        - name: pod_count
          limit: "((parameters.podCountLimit))"
      supervisorSelector:
        matchExpressions:
          - key: environment
            operator: In
            values:
              - testing
    

Étape 6 : associer une classe d'espace de noms à un projet

Pour autoriser la création d'un espace de noms de superviseur à l'aide de la classe d'espace de noms de superviseur dans un projet, créez une liaison de classe d'espace de noms de superviseur.

Pour associer une classe d'espace de noms à un projet à l'aide de l'interface utilisateur, reportez-vous à la section Création et configuration de classes d'espace de noms, de configuration de classe d'espace de noms et de liaison de classe d'espaces de noms à l'aide de l'interface utilisateur.

kubectl create -f supervisornamespaceclassbinding.yaml
Exemple de fichier supervisornamespaceclassbinding.yaml.
  • namespace spécifie le nom du projet que vous souhaitez associer à la classe d'espace de noms de superviseur.
  • Les paramètres overrideParameters sont facultatifs. Ils sont utilisés pour forcer une valeur de paramètre tout en ignorant les valeurs de paramètre fournies lors de la création de l'espace de noms de superviseur. Les types valides sont Entier, Chaîne ou Booléen. La valeur name doit être en minuscules et ne pas contenir d'espace.
apiVersion: infrastructure.cci.vmware.com/v1alpha1
kind: SupervisorNamespaceClassBinding
metadata:
  name: <class_name>
  namespace: <project_name>
spec:
  overrideParameters:
    - name: podcountlimit
      type: Integer
      const: 1000