Skip to content

Commit 997eccb

Browse files
authored
Update README file (#93)
* update README file Signed-off-by: dianew <[email protected]>
1 parent 49e0734 commit 997eccb

File tree

1 file changed

+27
-13
lines changed

1 file changed

+27
-13
lines changed

README.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
1-
# Project for Guest OS Validation test on vSphere using Ansible
1+
# Guest OS Validation on vSphere using Ansible
22

33
## Getting Started
44

55
### Prerequisites
66
1. Install Ansible on your control machine, please refer to [Installing Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html)
77
2. Install required Python libraries in requirements.txt
8+
```
9+
$ pip install -r requirements.txt
10+
```
811
3. Install required Ansible collections in requirements.yml
12+
```
13+
$ ansible-galaxy install -r requirements.yml
14+
```
915
4. Log in to local control machine as root or a user in sudoers
1016

1117
### Steps to Launch Testing
@@ -19,27 +25,30 @@
1925
# For Linux testing:
2026
# you can use below command to use the default variables file "vars/test.yml",
2127
# default test case list file "linux/gosv_testcase_list.yml"
22-
ansible-playbook main.yml
28+
$ ansible-playbook main.yml
2329
2430
# For Linux or Windows testing:
2531
# you can use below command to set the path of a customized variables file and
2632
# 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"
2834
```
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".
2938

3039
### Catalog
3140
* main.yml: Main playbook for Guest OS validation test
3241
* ansible.cfg: User customized Ansible configuration file
3342
* autoinstall: Folder for guest OS unattend install configuration files
3443
* common: Folder for common tasks called in test cases
35-
* docs: Folder for guide files
44+
* docs: Folder for guide file and known issues
3645
* env_setup: Folder for playbooks or tasks which to prepare or cleanup testing environment
3746
* 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
3948
* plugin: Folder for plugin scripts
4049
* tools: Folder for 3rd-party tools used in test cases
4150
* 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
4352

4453
### Supported Testing Scenarios
4554
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
7180
| Windows Server SAC releases | :heavy_check_mark: | | :heavy_check_mark: |
7281

7382
### 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
7989

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
8195
```
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

Comments
 (0)