Kyvernon

Procédure Pour: développeurs

Ansible

Utiliser les collections community.vmware, vmware.vmware et vmware.vmware_rest avec le contrôleur, les modules vérifiés et les limites connues.

Les collections Ansible pour VMware se connectent au point de terminaison SOAP (community.vmware, vmware.vmware) et au point de terminaison REST (vmware.vmware_rest) du contrôleur. La vérification enregistrée a utilisé ansible-core 2.22.0 avec community.vmware 7.0.0, vmware.vmware 2.13.0 et vmware.vmware_rest 5.0.0.

Avant de commencer

  • Activez les points de terminaison de compatibilité : Paramètres des points de terminaison de compatibilité.
  • Utilisez le compte d'un utilisateur Kyvernon. Les modules utilisent les privilèges du compte comme n'importe quel autre client.
  • Le contrôleur utilise un certificat que les modules ne connaissent pas par défaut : définissez validate_certs: false pour un test, ou faites confiance au certificat sur la machine de contrôle.

Avec la CLI

Définissez la connexion une fois pour tous les modules de la collection, puis exécutez les tâches comme pour vSphere :

YAML
- name: Inventory of Kyvernon
  hosts: localhost
  gather_facts: false
  module_defaults:
    group/community.vmware.vmware:
      hostname: "controller.example.com:8443"
      username: "{{ kyvernon_user }}"
      password: "{{ kyvernon_password }}"
      validate_certs: false
  tasks:
    - name: List the virtual machines
      community.vmware.vmware_vm_info:
      register: vms
    - name: Create a virtual machine
      community.vmware.vmware_guest:
        name: prod-web-01
        datacenter: Datacenter
        folder: /Datacenter/vm
        datastore: ds-local-01
        guest_id: otherLinux64Guest
        hardware:
          num_cpus: 2
          memory_mb: 2048
        disk:
          - size_gb: 20
            type: thin
            datastore: ds-local-01
        networks:
          - name: vm-net-01
        state: present

Conservez le mot de passe dans un fichier de variables chiffré avec Ansible Vault.

Modules vérifiés

CollectionModules
community.vmwarevmware_about_info, vmware_datacenter_info, vmware_host_facts, vmware_datastore_info, vmware_vswitch_info, vmware_portgroup_info, vmware_resource_pool_info, vmware_folder_info, vmware_vm_info, vmware_local_role_info, vmware_guest (création, reconfiguration, clonage, destruction), vmware_guest_info, vmware_guest_disk, vmware_guest_disk_info, vmware_guest_network, vmware_guest_snapshot (création, restauration, suppression de tous), vmware_guest_snapshot_info
vmware.vmwarecluster_info, folder, vm_powerstate
vmware.vmware_restvcenter_datacenter_info, vcenter_host_info, vcenter_datastore_info, vcenter_network_info, vcenter_folder_info, vcenter_resourcepool_info, vcenter_storage_policies_info, content_library_info, vcenter_vm_info, vcenter_vm_hardware_info, les modules d'information sur le matériel pour les disques, les cartes, les lecteurs de CD-ROM, les cartes SCSI et le démarrage, vcenter_vm_hardware_boot, vcenter_vm_hardware_serial, vcenter_vm_tools_info, vcenter_vm_power_info, vcenter_vm_guest_identity_info, vcenter_vm_guest_power_info

La liste complète avec le résultat de chacun figure dans outils vérifiés.

Limites connues

  • Les modules d'étiquettes et de catégories de community.vmware (vmware_category, vmware_tag, vmware_tag_info) ont échoué lors de l'exécution enregistrée, car la bibliothèque Python du SDK vSphere Automation dont ils ont besoin n'était pas installée dans l'environnement de test. Ils ne sont pas vérifiés.
  • Une machine virtuelle sans agent invité en cours d'exécution ne signale ni identité d'invité ni état d'alimentation de l'invité. Les modules qui les lisent renvoient l'erreur correspondante, ce qui est la réponse attendue.
  • Le module vmware_rest pour la version de l'appliance signale une erreur, car le contrôleur n'est pas une appliance vCenter.

Version 0.1. Dernière modification : 2026-11-13