This is an old revision of the document!
Xfce-Test Docker Container Quick Start Guide
If you want to test the current state of Xfce 4.16, you can look at xfce-test, a Docker image by Florian Schueller which allow you to test git master and to run Behave (behaviour-driven development).
Xfce Test is a Docker/Xephyr environment for testing the latest builds of Xfce.
Note: The installation, management, and troubleshooting of Docker or Xephyr(the X11 display server) is beyond the scope of this guide.
Installation
- Clone the xfce-test repository git clone https://github.com/schuellerf/xfce-test
- Change to the repository directory and install the necessary components (
./xfce-test install
)- On Xubuntu 20.04, this will install the following packages and their dependencies, if they aren’t already present - xserver-xephyr, docker.io, xvfb, jq, and curl - which will download ~71Mb and require 351Mb of space
- Download the docker container (
sudo ./xfce-test pull
)- This will download the Docker container part of schuellerf/xfce-test which is ~1.6Gb and require ~4.4Gb of space (as of May 2020).
Running xfce-test
If xfce-test is run without any options, the xfce-test script will present output that consists of two parts. First, the various option flags that can be used to modify the starting of the script. And, secondly, a numbered menu that appears, as follows:
1) install | 7) list_local | 13) tag |
2) call | 8) screenshots | 14) XFSM_VERBOSE |
3) pull | 9) behave | 15) LANG |
4) start | 10) behavevideo | 16) LOG |
5) no-session | 11) fulltestvideo | 17) PARALLEL_BUILDS |
6) list | 12) build | 18) KEEP |
At this point the user will be prompted for an option to select.
To simply run the container from the command line, use the command: ( ./xfce-test start
)
Below is an abbreviated example of the expected output:
You are working with the container: latest Starting container: 737d49226369f23e1b25824131124eae9b34e728d1639a1f07e645da74c3b0d8 This container includes: # The OK marks if building this component in the current container was successful OK: xfce4-dev-tools: xfce-4.16pre1 OK: libxfce4util: xfce-4.16pre1-1-gea46c1a OK: xfconf: xfce-4.16pre1 OK: libxfce4ui: xfce-4.16pre1-62-g1a31ea7 OK: garcon: xfce-4.16pre1 OK: exo: xfce-4.16pre1 OK: xfce4-panel: xfce-4.16pre1 OK: thunar: xfce-4.16pre1 NOT OK: thunar-volman: xfce-4.16pre1 NOT OK: xfce4-power-manager: xfce-4.16pre1 ....
If all goes well, a graphical Xephyr window will open and will be displayed. Additionally, the command line from where the xfce-test script was started will be placed in a directory on the running Docker instance. From here, you may run provided test scripts.
Stopping xfce-test
docker stop <ContainerID>
or <ContainerName>
(ID and name can be found by running the command docker ps
)
Uninstalling xfce-test
- Remove the docker container
- Find the schuellerf/xfce-test container’s image ID (
docker images -a
) - Remove the container (
docker rmi [image’s ID]
)
- Remove the installed packages
- Remove main packages (
sudo apt remove xserver-xephyr docker.io xvfb jq curl
)- Note: you may not want to remove some of these packages if they weren't installed during the xfce-test installation
- Remove dependencies (
sudo apt autoremove
)