文件列表:

os_tests/ (0, 2023-12-21)
os_tests/__init__.py (21, 2023-12-21)
os_tests/cfg/ (0, 2023-12-21)
os_tests/cfg/alicloud.yaml (1172, 2023-12-21)
os_tests/cfg/aws.yaml (2062, 2023-12-21)
os_tests/cfg/google.yaml (386, 2023-12-21)
os_tests/cfg/libvirt.yaml (365, 2023-12-21)
os_tests/cfg/nutanix.yaml (958, 2023-12-21)
os_tests/cfg/openshift.yaml (380, 2023-12-21)
os_tests/cfg/openstack.yaml (1080, 2023-12-21)
os_tests/cfg/os-tests.yaml (1206, 2023-12-21)
os_tests/data/ (0, 2023-12-21)
os_tests/data/azure/ (0, 2023-12-21)
os_tests/data/azure/05_logging.cfg (2069, 2023-12-21)
os_tests/data/azure/06_logging_override.cfg (56, 2023-12-21)
os_tests/data/azure/66-azure-storage.rules (1636, 2023-12-21)
os_tests/data/azure/68-azure-sriov-nm-unmanaged.rules (278, 2023-12-21)
os_tests/data/azure/91-azure_datasource.cfg (77, 2023-12-21)
os_tests/data/azure/99-azure-product-uuid.rules (342, 2023-12-21)
os_tests/data/azure/authconfig (482, 2023-12-21)
os_tests/data/azure/chrony.conf_rhel7 (1100, 2023-12-21)
os_tests/data/azure/chrony.conf_rhel8 (1082, 2023-12-21)
os_tests/data/azure/cloud.cfg_rhel7 (1231, 2023-12-21)
os_tests/data/azure/cloud.cfg_rhel8 (1257, 2023-12-21)
os_tests/data/azure/fingerprint-auth_rhel7 (702, 2023-12-21)
os_tests/data/azure/fingerprint-auth_rhel8 (700, 2023-12-21)
os_tests/data/azure/grub_rhel7 (462, 2023-12-21)
os_tests/data/azure/grub_rhel8 (316, 2023-12-21)
os_tests/data/azure/grub_rhel9 (238, 2023-12-21)
os_tests/data/azure/nss.config (451, 2023-12-21)
os_tests/data/azure/password-auth_rhel7 (1033, 2023-12-21)
os_tests/data/azure/password-auth_rhel8 (759, 2023-12-21)
os_tests/data/azure/pkglist_rhel7 (6588, 2023-12-21)
os_tests/data/azure/pkglist_rhel8 (7562, 2023-12-21)
os_tests/data/azure/postlogin_rhel7 (330, 2023-12-21)
... ...

# os-tests ## Introduction os-tests is a lightweight, portable and customer focus tests collection for Linux OS. ## Installation ### Install from pypi `# pip install os-tests` Note: please install [paramiko](https://pypi.org/project/paramiko/) if run os-tests in server-client mode. There is a known pynacl issue while installing paramiko on RHEL-8.6. Please install earlier pynacl version (1.4.0) instead. ### Install from the source code repo directly ```bash # pip install git+https://github.com/virt-s1/os-tests.git@master ``` ### Build wheel locally and install it ```bash # git clone https://github.com/virt-s1/os-tests.git # cd os-tests # python3 setup.py sdist bdist_wheel # pip install -U dist/os_tests-0.0.3-py3-none-any.whl ``` note: the default bin path is "/usr/local/bin" if not in virtual environment. ### Public new wheels on [pypi](https://pypi.org/project/os-tests/) (maintainer use only) `# python3 -m twine upload dist/*` ## Run test ### os-tests supports 3 working modes #### Mode 1 - run on single node Install and run tests inside the RHEL system directly, fewer cases than Mode 2 and 3, lacking of tests requiring reboot system and instance control access. `# os-tests` or `# python3 -m unittest -v os_tests.os_tests_run` #### Mode 2 - run on existing systems remotely Require ssh user, key/password and IP to access existing RHEL system, all tests are done remotely, can do lifecyle, kdump test, but without device hotplug capability and other tests require instance access. `# os-tests --host --user --keyfile --result -p ` #### Mode 3 - os-tests provision test system by itself Require cloud/platform account to provision remote system self, can do full test with control of instance. Eg. device hotplug, snapshot creation, send nmi events...... Note: supports alicloud, aws, gcp, openstack, libvirt, nutanix, openshift, openstack for now. Other platforms are in todo list. The config template is under cfg dir. `# os-tests -p cloudinit --user ec2-user --keyfile /home/virtqe_s1.pem --platform_profile aws_env.yaml` ### More options - [advanced tips](https://github.com/virt-s1/os-tests/blob/master/os_tests/docs/os-tests_advanced_tips.md) #### List all supported cases only without run `# os-tests -l` #### Filter case name with keywords ltp and virtwhat `# os-tests -l -p ltp,virtwhat` #### Filter case name with keywords ltp and skip test_ltp_ipsec_icmp `# os-tests -l -p ltp -s test_ltp_ipsec_icmp` ### Run all cases in one file `# os-tests -p test_general_check` #### Run a single case in one file `# os-tests -p test_change_clocksource` ### All installed files and dirs You can list all installed files via `pip show -f os-tests` simply. ```bash os_tests ├── cfg ->configration files ├── data ->data files for log checking ├── libs ->libs including resource(vm, disk, network)/func definenation ├── templates ->template for generating html,xml report ├── tests ->all tests files location └── utils ->3rd party utils, ltp, blktests and others ``` ### Recommended pkgs in test system os-tests will try to install required pkgs from default repo during run, but it would be better to have them if no repo is provided. List RHEL only because CentOS Stream and Fedora usually have public repo available. **RHEL-7**: install,automake,autoconf,sysstat,gcc,unzip,wget,quota,bzip2,iperf3,pciutils,fio,psmisc,expect,ntpdate,perf,nvme-cli,pciutils,fio,git,tar,nfs-utils,libvirt,qemu-kvm,kernel-debug,python3,dracut-fips,podman,strace,sos **RHEL-8**: make,automake,autoconf,sysstat,gcc,unzip,wget,quota,bzip2,iperf3,pciutils,fio,psmisc,expect,perf,nvme-cli,pciutils,fio,php-cli,php-xml,php-json,libaio-devel,blktrace,fio,nvme-cli,git,tar,nfs-utils,libvirt,qemu-kvm,kernel-debug,python3,dracut-fips,podman,xdp-tools,openssl-devel,strace,sos,acpid,mokutil,kernel-modules-extra,iproute-tc **RHEL-9**: make,automake,autoconf,sysstat,gcc,unzip,wget,quota,bzip2,iperf3,pciutils,fio,psmisc,expect,perf,nvme-cli,pciutils,fio,libaio-devel,blktrace,fio,nvme-cli,git,tar,nfs-utils,libvirt,qemu-kvm,python3,dracut-fips,kernel-debug,python3-pip,hostname,podman,xdp-tools,openssl-devel,glibc-all-langpacks,strace,sos,acpid,mokutil,kernel-modules-extra,iproute-tc ### The log file The suite saves the summary to sum.html and sum.log under "/tmp/os_tests_result/" by default. The test debug log files are saved in "/tmp/os_tests_result/attachments" following case name. You can change "results_dir" in "cfg/os-tests.yaml" to save log to other place or pass as command option. Below is an example: ```bash # os-tests -p test_change_clocksource Run in mode: is_listcase:False pattern: test_change_clocksource test_change_clocksource (os_tests.tests.test_general_test.TestGeneralTest) ... ok ---------------------------------------------------------------------- summary in html: /tmp/os_tests_result/sum.html summary in text: /tmp/os_tests_result/sum.log ---------------------------------------------------------------------- Ran 1 test in 0.383s OK # ls -l /tmp/os_tests_result/debug/ total 8 -rw-r--r--. 1 root root 5472 Mar 30 16:44 os_tests.tests.test_general_test.TestGeneralTest.test_change_clocksource.debug ``` ### Recommend test matrix to catch potential issues - run in normal kernel, it is the most used scenario - run in debug kernel with 'kmemleak=on'([docs](https://github.com/virt-s1/os-tests/blob/master/os_tests/docs/os-tests_advanced_tips.md)) - run in fips enabled kernel ([docs](https://github.com/virt-s1/os-tests/blob/master/os_tests/docs/os-tests_advanced_tips.md)) - run in remote-client mode to cover lifecycle cases ### Third-party utils Pre-compiled tools are shipped under 'utils' directory with os-tests because not all systems can reach github. - ltp x86_64: https://github.com/liangxiao1/rpmbuild_specs/releases/latest/download/ltp-master.x86_64.rpm - ltp aarch64: https://github.com/liangxiao1/rpmbuild_specs/releases/latest/download/ltp-master.aarch64.rpm - blktests x86_64: https://github.com/liangxiao1/rpmbuild_specs/releases/latest/download/blktests-master.x86_64.rpm - blktests aarch64:https://github.com/liangxiao1/rpmbuild_specs/releases/latest/download/blktests-master.aarch64.rpm ### Contribution You are welcome to create pull request or raise issue. New case from real customer scenario or rhbz is preferred. Developing tool VS code is recommended with [refnow](https://marketplace.visualstudio.com/items?itemName=FrankLiang.refnow) plugin which ships the newest case doc template. If adding case, please verify case doc before pushing. ```bash $ os-tests --verifydoc -p ``` To dump cases doc to yaml file. ```bash $ os-tests -p --dumpdoc /tmp/cases.yaml ```

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：