From 795a3ab05e374dfa6aa31d61c3177c156c2f68e5 Mon Sep 17 00:00:00 2001 From: "Qi (Keira) Zhang" Date: Thu, 28 Sep 2023 10:44:28 +0800 Subject: [PATCH] Update documentations for v3.0 (#506) Signed-off-by: Qi Zhang --- README.md | 11 ++++---- changelogs/changelog.yml | 57 ++++++++++++++++++++++++++++++++++++++++ docker_file/Dockerfile | 10 +++---- requirements.txt | 2 ++ 4 files changed, 69 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index d10bdd6db..5b9420054 100644 --- a/README.md +++ b/README.md @@ -61,7 +61,7 @@ This project supports below scenarios for end-to-end guest operating system vali * SSH and Python are installed and enabled. * The vm_python variable in vars/test.yml must be set with correct python path. Or user can set PATH in /etc/environment in guest operating system to include the binary directory path to python. * The root user should be enabled and permitted to log in through SSH in Linux guest operating system. - * Execute [ConfigureRemotingForAnsible.ps1](https://github.com/ansible/ansible/blob/devel/examples/scripts/ConfigureRemotingForAnsible.ps1) script in Windows guest operating system in advance. + * Execute [ConfigureRemotingForAnsible.ps1](https://github.com/ansible/ansible-documentation/blob/devel/examples/scripts/ConfigureRemotingForAnsible.ps1) script in Windows guest operating system in advance. ### Compatible Guest Operating Systems @@ -94,14 +94,13 @@ This project supports below scenarios for end-to-end guest operating system vali | Red Hat Enterprise Linux CoreOS (RHCOS) 4.13 and later | | :heavy_check_mark: | :heavy_check_mark: | **Notes** -1. This compatible guest operating systems list is used for this project only. For guest operating system support status on ESXi, please refer to [VMware Compatibility Guide](https://www.vmware.com/resources/compatibility/search.php?deviceCategory=software&testConfig=16). -2. Guest OS marked with (*) only supports autoinstall and doesn't support end-to-end tests for now. +This compatible guest operating systems list is used for this project only. For guest operating system support status on ESXi, please refer to [VMware Compatibility Guide](https://www.vmware.com/resources/compatibility/search.php?deviceCategory=software&testConfig=16). ### Docker images -* Latest (Release v2.3): +* Latest (Release v3.0): * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:latest -* Release v2.3: - * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v2.3 +* Release v3.0: + * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v3.0 Launch testing using Docker image 1. Execute below commands in your machine diff --git a/changelogs/changelog.yml b/changelogs/changelog.yml index 26a964cae..d0a607017 100644 --- a/changelogs/changelog.yml +++ b/changelogs/changelog.yml @@ -1,5 +1,62 @@ ancestor: null releases: + 3.0: + changes: + major_changes: + - Add support for Pardus 21.x test + - Add support for RHEL CoreOS OVA image deployment and test + - Add support for BCLinux 8.x and BCLinux-for-Euler 21.10 autoinstall and test + - Add support for FreeBSD 13.x test + - Add support for openSUSE autoinstall and test + minor_changes: + - Check guest OS full name when short-name is set + - Update URL path of VMware Tools 12.3.0 for Windows + - Add known issue for PVRDMA hot-remove failure on Oracle Linux 8.8 + - Use vmware_guest_disk module to add IDE boot disk + - Set VM boot order before vHBA testing and test file read/write on new disk + - Print error message when reverting VM snapshot failed + - Shutdown guest OS after auto install completes instead of rebooting + - Update checking guest_os_ansible_distribution is Flatcar + - Exit ansible test if VMware Tools installation failed for Windows + - Check base snapshot at env_setup + - Enable Credential Guard for Windows Server + - Skip secureboot and nvdimm testing for guest OS not supporting them + - Check VMware Tools version after OVA/OVF deployment without poweron + - Add vars and tasks to support VGAuth guest operation testing + bugfixes: + - Fix package installation failure at deploy_vm on Ubuntu 23.10 + - Fix undefined variables at rescue or always block when test_setup failed + - Fix dict item names in community.vmware.vmware_vm_config_option result + - Fix undefined error of WSL + - Fix autoinstall issue on FreeBSD 14 + - Check vmtools_log_dir is defined before using it in check_os_fullname + - Fix empty hardware version in collected OVF config info and guest_info.json + - Fix command "newfs" issue for Freebsd 13.2 32bit + - Fix the offical repo for Pardus 23.0 + - Fix undefined error for guest_os_with_inbox_drivers in network testcases + - Correct ovt_packages for Linux guest OS with desktop + - Ignore esxi_hostname at VM creation when vcenter_hostname is not defined + - Replace install_linux_esx with linux_flavor for Photon OS autoinstall + - Update URL for downloading ConfigureRemotingForAnsible.ps1 + - Fix cloud-init GOSC failure on Ubuntu and Photon OS + - Remove cdrom ISO before running cloud-init GOSC test cases for Ubuntu OVA + - Fix Debian 12 auto installation failure + - Add parameter esxi_hostname to vm_create + - Change the boot disk to be first in boot order for ubuntu 23.04 desktop after deploy_vm + docker_image: + path: projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v3.0 + Ansible: ansible-core 2.15.4 + Python: 3.10.11 + Ansible collections: + - ansible.netcommon 5.2.0 + - ansible.posix 1.5.4 + - ansible.utils 2.11.0 + - ansible.windows 2.1.0 + - community.crypto 2.15.1 + - community.general 7.4.0 + - community.vmware 3.9.0 + - community.windows 2.0.0 + release_date: '2023-09-28' 2.3: changes: major_changes: diff --git a/docker_file/Dockerfile b/docker_file/Dockerfile index a4a1da240..c9be3c84c 100644 --- a/docker_file/Dockerfile +++ b/docker_file/Dockerfile @@ -1,6 +1,6 @@ # ansible-vsphere-gos-validation # For users launch guest OS validation test on vSphere -# version: 2.3 +# version: 3.0 # Use latest Photon OS 4.0 docker image as parent image FROM photon:4.0 @@ -9,9 +9,9 @@ WORKDIR /root/ansible-vsphere-gos-validation # Install the required packages RUN tdnf makecache && \ tdnf install -y python3 zip vim wget python3-pip \ - sshpass gawk nfs-utils iana-etc python3-lxml \ - python3-setuptools python3-jmespath python3-netaddr && \ - pip3 install wheel pycdlib pywinrm pyvmomi pypsrp + sshpass gawk nfs-utils iana-etc python3-lxml python3-setuptools \ + python3-wheel python3-jmespath python3-netaddr && \ + pip3 install pycdlib pywinrm pyvmomi pypsrp passlib # Install ansible-core (starts from Ansible 2.11) RUN pip3 install ansible-core @@ -19,7 +19,7 @@ RUN pip3 install ansible-core # Install Ansible collections # You can set https proxy if collections are failed to install from Galaxy server, e.g., # ENV HTTPS_PROXY="https://proxy.xxxx.com:xxxx" -# Ansible 2.14.0 requires the locale encoding to be UTF-8 +# Ansible 2.14.0 or later requires the locale encoding to be UTF-8 ENV LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 RUN ansible-galaxy collection install ansible.netcommon ansible.posix community.general community.vmware community.windows community.crypto diff --git a/requirements.txt b/requirements.txt index 3bce42aa1..ed054bbae 100644 --- a/requirements.txt +++ b/requirements.txt @@ -4,9 +4,11 @@ setuptools wheel jmespath PyYAML>=5.1 +lxml pycdlib netaddr pywinrm pypsrp pyvmomi +passlib ansible-core