Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
testing:xfce-test [2020/08/29 22:55] – [Running xfce-test] kevinbowen | testing:xfce-test [2020/08/30 05:11] – kevinbowen |
---|
| ~~NOTOC~~ |
| |
====== Xfce-Test Docker Container Quick Start Guide ====== | ====== Xfce-Test Docker Container Quick Start Guide ====== |
| |
If you want to test the current state of Xfce 4.16, you can look at [[https://github.com/schuellerf/xfce-test|xfce-test]], a [[https://hub.docker.com/r/schuellerf/xfce-test|Docker image]] by Florian Schueller which allow you to test git master and to run [[https://github.com/behave/behave|Behave]] (behaviour-driven development). | If you want to test the current state of Xfce 4.16, you can look at [[https://github.com/schuellerf/xfce-test|xfce-test]], a [[https://hub.docker.com/r/schuellerf/xfce-test|Docker image]] by Florian Schueller, which allows you to test git master and to run automated [[https://github.com/behave/behave|Behave]] (behaviour-driven development) test scripts. |
| |
| |
* **[[#Stopping xfce-test|Stopping xfce-test]]** | * **[[#Stopping xfce-test|Stopping xfce-test]]** |
* **[[#Uninstalling xfce-test|Uninstalling xfce-test]]** | * **[[#Uninstalling xfce-test|Uninstalling xfce-test]]** |
| * **[[#Reporting Bugs|Reporting Bugs]]** |
| |
[[https://github.com/schuellerf/xfce-test|Xfce Test]] is a Docker/Xephyr environment for testing the latest builds of Xfce. | [[https://github.com/schuellerf/xfce-test|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. | **Note:** The installation, management, and troubleshooting of Docker or Xephyr(the X11 display server) is beyond the scope of this guide. |
| |
| For a tutorial on using Docker, see [[https://docs.docker.com/get-started/|Getting Started]] and [[https://docs.docker.com/engine/install/linux-postinstall/|Docker Post-installation steps for Linux]] |
| |
| --- |
{{https://raw.githubusercontent.com/schuellerf/xfce-test/master/main_screenshot.png?900}} | {{https://raw.githubusercontent.com/schuellerf/xfce-test/master/main_screenshot.png?900}} |
| |
* 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 | * 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'' ) | * Download the docker container ( ''sudo ./xfce-test pull'' ) |
| * If you are having permissions issues, take a look at the [[https://docs.docker.com/engine/install/linux-postinstall/|Post-installation steps for Linux]] and the instructions for running Docker as a non-root user. |
* 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). | * 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). |
| |
It is beyond the scope of this document enumerate the function of all of these options. It is recommended to look at the [[https://github.com/schuellerf/xfce-test#readme|xfce-test README]] as well as the scripts provided in the repository. | It is beyond the scope of this document enumerate the function of all of these options. It is recommended to look at the [[https://github.com/schuellerf/xfce-test#readme|xfce-test README]] as well as the scripts provided in the repository. |
| |
To simply run the container from the command line, use the command: ( ''./xfce-test start'' ) | To simply run the container from the command line, use the command: ''./xfce-test start'' |
| |
Below is an abbreviated example of the expected output: | Below is an abbreviated example of the expected output: |
</code> | </code> |
| |
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. | If all goes well, a graphical Xephyr window will open and a new desktop environment 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. |
| |
[[|Back to Top]] | [[|Back to Top]] |
* Note: you may not want to remove some of these packages if they weren't installed during the xfce-test installation | * 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'' ) | * Remove dependencies ( ''sudo apt autoremove'' ) |
| |
| ---- |
| |
| ===== Reporting Bugs ===== |
| |
| If, while running the xfce-test, you encounter and Xfce bug, please see the [[https://docs.xfce.org/contribute/bugs/start|Reporting Bugs]] page for details on reporting bugs and gathering additional information for developers. |
| |
| If you encounter a bug that is related to the running of the actual xfce-test container, please see [[https://github.com/schuellerf/xfce-test/issues|xfce-test issues]] to file a bug report. |
| |
| |
[[|Back to Top]] | [[|Back to Top]] |
---- | ---- |
| [[ :start:|Return to Main Wiki page]] |
| |
| [[ https://docs.xfce.org/contribute/start#bug_reporting_and_testing|Return to Contribute page]] |
| |
| |