cockpit-plugin-tests

This is a Selenium project written in Python to test the following Cockpit plugins for seapath:

• Cockpit cluster dashboard
• Cockpit cluster vm management
• Cockpit update

A configuration file is provided on the utils/ directory and contains all the global variables that can be configured.

Host IP can be configured with the HOST_X_IP environment variables.

Cqfd

cqfd is a quick and convenient way to run commands in the current directory, but within a pre-defined Docker container. cqfd is used with Xvfb to run selenium without display.

• Install cqfd

$ git clone https://github.com/savoirfairelinux/cqfd.git
$ cd cqfd
$ sudo make install

• Initialize cqfd

cqfd init

NOTE: The cluster configuration and Selenium tests use both cqfd with different docker containers. Each of them will require executing the command below once.

Configure the cluster

• Flash all the hosts with a Seapath Debian image containing Cockpit
• Clone the repository Seapath ansible and checkout on the debian-main branch
• Move or clone the cockpit-plugin-tests repository in the ansible/tests directory
• Deploy the cluster and install the 3 plugins

$ cd ansible
$ cqfd init
$ cqfd run ansible-playbook -i tests/cockpit-plugin-tests/ansible/inventory/cluster_definition.yml --skip-tags "package-install" tests/cockpit-plugin-tests/ansible/deploy_cluster_test_plugins.yml

• Deploy a VM

$ cqfd run ansible-playbook -i tests/cockpit-plugin-tests/ansible/inventory/cluster_definition.yml -i tests/cockpit-plugin-tests/ansible/inventory/vm_definition.yml playbooks/deploy_vms_cluster.yaml

• Shutdown one of the host

NOTE: to restart the host remotely, you will need the wakeonlan package and the following command:

$ wakeonlan <MAC_ADDRESS>

Run the tests with cqfd

cqfd -b <flavour_name>

List of flavours:

• all_tests
• dashboard_tests
• update_tests
• vm_management_tests

Run the tests without cqfd

This requires to install the following dependancies:

• Selenium WebDriver that can be installed whith the following command: pip install selenium.
• Firefox web browser

Two options are available to test the plugins:

• python main.py: To run all the tests
• python -m unittest tests/<Test>.py: To test a specific plugin