|
1 | | -# Project for Guest OS Validation test on vSphere using Ansible |
| 1 | +# Guest OS Validation on vSphere using Ansible |
2 | 2 |
|
3 | 3 | ## Getting Started |
4 | 4 |
|
5 | 5 | ### Prerequisites |
6 | 6 | 1. Install Ansible on your control machine, please refer to [Installing Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) |
7 | 7 | 2. Install required Python libraries in requirements.txt |
| 8 | +``` |
| 9 | +$ pip install -r requirements.txt |
| 10 | +``` |
8 | 11 | 3. Install required Ansible collections in requirements.yml |
| 12 | +``` |
| 13 | +$ ansible-galaxy install -r requirements.yml |
| 14 | +``` |
9 | 15 | 4. Log in to local control machine as root or a user in sudoers |
10 | 16 |
|
11 | 17 | ### Steps to Launch Testing |
|
19 | 25 | # For Linux testing: |
20 | 26 | # you can use below command to use the default variables file "vars/test.yml", |
21 | 27 | # default test case list file "linux/gosv_testcase_list.yml" |
22 | | - ansible-playbook main.yml |
| 28 | + $ ansible-playbook main.yml |
23 | 29 |
|
24 | 30 | # For Linux or Windows testing: |
25 | 31 | # you can use below command to set the path of a customized variables file and |
26 | 32 | # test case list file |
27 | | - ansible-playbook main.yml -e "testing_vars_file=/path_to/test.yml testing_testcase_file=/path_to/gosv_testcase_list.yml" |
| 33 | + $ ansible-playbook main.yml -e "testing_vars_file=/path_to/test.yml testing_testcase_file=/path_to/gosv_testcase_list.yml" |
28 | 34 | ``` |
| 35 | +5. New folder for log files and files collected in test cases are created for current test run, |
| 36 | +e.g., "logs/test-vm/2021-07-06-09-27-51/", |
| 37 | +find test case results in "results.log", failed tasks in "failed_tasks.log", testing debug log in "full_debug.log". |
29 | 38 |
|
30 | 39 | ### Catalog |
31 | 40 | * main.yml: Main playbook for Guest OS validation test |
32 | 41 | * ansible.cfg: User customized Ansible configuration file |
33 | 42 | * autoinstall: Folder for guest OS unattend install configuration files |
34 | 43 | * common: Folder for common tasks called in test cases |
35 | | -* docs: Folder for guide files |
| 44 | +* docs: Folder for guide file and known issues |
36 | 45 | * env_setup: Folder for playbooks or tasks which to prepare or cleanup testing environment |
37 | 46 | * linux: Folder for playbooks to test Linux guest OS |
38 | | -* Windows: Folder for playbooks to test Windows guest OS |
| 47 | +* windows: Folder for playbooks to test Windows guest OS |
39 | 48 | * plugin: Folder for plugin scripts |
40 | 49 | * tools: Folder for 3rd-party tools used in test cases |
41 | 50 | * vars: Folder for variable files used in testing |
42 | | -* logs: Folder generated by default for files collected and logs generated in test run |
| 51 | +* changelogs: Folder for changelog of each release |
43 | 52 |
|
44 | 53 | ### Supported Testing Scenarios |
45 | 54 | This project supports below scenarios for end-to-end guest OS validation testing |
@@ -71,12 +80,17 @@ This project supports below scenarios for end-to-end guest OS validation testing |
71 | 80 | | Windows Server SAC releases | :heavy_check_mark: | | :heavy_check_mark: | |
72 | 81 |
|
73 | 82 | ### Docker images |
74 | | -* Release v1.0 or the latest: |
75 | | -``` |
76 | | -# docker pull projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v1.0 |
77 | | -or |
78 | | -# docker pull projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:latest |
| 83 | +* Latest (Release v1.1): |
| 84 | + * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:latest |
| 85 | +* Release v1.1: |
| 86 | + * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v1.1 |
| 87 | +* Release v1.0: |
| 88 | + * projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v1.0 |
79 | 89 |
|
80 | | -# docker run -it --privileged projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:v1.0 |
| 90 | +Launch testing using Docker image |
| 91 | +1. Execute below commands in your machine |
| 92 | +``` |
| 93 | +$ docker pull projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:latest |
| 94 | +$ docker run -it --privileged projects.registry.vmware.com/gos_cert/ansible-vsphere-gos-validation:latest |
81 | 95 | ``` |
82 | | -Then launch testing in container using the steps in this section [Steps to Launch Testing](#steps-to-launch-testing) |
| 96 | +2. Launch testing in the started container following the steps in this section [Steps to Launch Testing](#steps-to-launch-testing) |
0 commit comments