Kyvernon

Werkwijze Voor: ontwikkelaars

Ansible

De collecties community.vmware, vmware.vmware en vmware.vmware_rest gebruiken met de controller, de geverifieerde modules en de bekende lacunes.

De Ansible-collecties voor VMware maken verbinding met het SOAP-endpoint (community.vmware, vmware.vmware) en met het REST-endpoint (vmware.vmware_rest) van de controller. De vastgelegde verificatie gebruikte ansible-core 2.22.0 met community.vmware 7.0.0, vmware.vmware 2.13.0 en vmware.vmware_rest 5.0.0.

Voordat u begint

  • Schakel de compatibiliteitsendpoints in: Instellingen van de compatibiliteitsendpoints.
  • Gebruik het account van een Kyvernon-gebruiker. De modules gebruiken de bevoegdheden van het account zoals elke andere client.
  • De controller gebruikt een certificaat dat de modules standaard niet kennen: stel voor een test validate_certs: false in, of vertrouw het certificaat op de controlemachine.

Met de CLI

Stel de verbinding eenmaal in voor alle modules van de collectie en voer dan taken uit zoals voor 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

Bewaar het wachtwoord in een versleuteld variabelenbestand van Ansible Vault.

Geverifieerde modules

CollectieModules
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 (aanmaken, herconfigureren, klonen, verwijderen), vmware_guest_info, vmware_guest_disk, vmware_guest_disk_info, vmware_guest_network, vmware_guest_snapshot (aanmaken, terugzetten, alles verwijderen), 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, de hardware-informatiemodules voor schijven, adapters, cd-romstations, SCSI-adapters en boot, 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

De volledige lijst met het resultaat van elke module staat in geverifieerde tools.

Bekende lacunes

  • De tag- en categoriemodules van community.vmware (vmware_category, vmware_tag, vmware_tag_info) mislukten in de vastgelegde run, omdat de Python-bibliotheek van de vSphere Automation SDK die ze nodig hebben niet was geïnstalleerd in de testomgeving. Ze zijn niet geverifieerd.
  • Een virtuele machine zonder draaiende gastagent meldt geen gastidentiteit en geen energietoestand van de gast. De modules die ze lezen, geven de bijbehorende fout terug, en dat is het verwachte antwoord.
  • De vmware_rest-module voor de appliance-versie meldt een fout, omdat de controller geen vCenter-appliance is.

Versie 0.1. Laatst gewijzigd: 2026-11-13