Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
testing:xfce-test [2020/08/30 05:08] – added bug reporting section kevinbowentesting:xfce-test [2020/09/06 01:00] (current) – [Installation] kevinbowen
Line 3: Line 3:
 ====== 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.
  
  
Line 26: Line 26:
 ===== Installation ===== ===== Installation =====
  
-  * Clone the xfce-test repository git clone https://github.com/schuellerf/xfce-test+  * 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'' )   * 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     * 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 ( ''./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.      * 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).
 +  * Download a different docker container branch:
 +    * List the available branches: ''sudo ./xfce-test list'' ( the list also available on [[https://hub.docker.com/r/schuellerf/xfce-test/tags?page=1&ordering=last_updated|dockerhub]] )
 +    * Download the branch by its tag name: ''sudo TAG=[tag-name] ./xfce-test pull''
  
 ---- ----
Line 75: Line 78:
  
 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. 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.
 +
 +==== Running a Branch ====
 +
 +If you have downloaded a different docker container branch by its tag name, this is the command to run it: ''sudo TAG=[tag-name] ./xfce-test start''. You can find out which branches you have installed with ''sudo ./xfce-test list_local''.
  
 [[|Back to Top]] [[|Back to Top]]
Line 80: Line 87:
 ===== Stopping xfce-test ===== ===== Stopping xfce-test =====
  
-''docker stop <ContainerID>'' or ''<ContainerName>'' (ID and name can be found by running the command ''docker ps'')+''docker stop <ContainerID>'' or ''<ContainerName>''  
 + 
 +The ID and name can be found by running the command ''docker ps'' outside the Docker container (i.e. on your local machine).
  
 ---- ----
Line 98: Line 107:
 ===== Reporting Bugs ===== ===== 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 an Xfce bug while running the xfce-test container, 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. 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.