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
Last revisionBoth sides next revision
testing:xfce-test [2020/05/01 06:25] – [Xfce Test] resized image kevinbowentesting:xfce-test [2020/09/05 12:24] – running a branch jphilips
Line 1: Line 1:
-====== Xfce Test  ======+~~NOTOC~~ 
 + 
 +====== 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 allows you to test git master and to run automated [[https://github.com/behave/behave|Behave]] (behaviour-driven development) test scripts. 
 + 
 + 
 +  * **[[#Installation|Installation]]** 
 +  * **[[#Running xfce-test|Running xfce-test]]** 
 +  * **[[#Stopping xfce-test|Stopping 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.
  
-{{https://raw.githubusercontent.com/schuellerf/xfce-test/master/main_screenshot.png?750x600}}+**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}} 
 + 
 +[[|Back to Top]] 
 +----
  
 ===== Installation ===== ===== Installation =====
  
-  * Download https://raw.githubusercontent.com/schuellerf/xfce-test/master/xfce-test +  * Clone the xfce-test repository: ''git clone https://github.com/schuellerf/xfce-test'' 
-  * Make it executable ( ''chmod u+x xfce-test'' ) +  * Change to the repository directory and install the necessary components ( ''./xfce-test install'' ) 
-  * Download 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 it will install these packages and their dependencies, if they aren’t already installed - xserver-xephyr, docker.io, xvfb, jq, and curl - which will download ~71Mb and require 351Mb of space +  * Download the docker container ( ''./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.  
-    * It will download the container parts 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'' ( 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''
  
-===== Run =====+----
  
-  * Run it ( ''sudo ./xfce-test start'' )+===== Running xfce-test =====
  
-===== Uninstall =====+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. 
 +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''  
 + 
 +Below is an abbreviated example of the expected output: 
 + 
 +<code> 
 +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 
 +.... 
 +</code> 
 + 
 +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]] 
 +---- 
 +===== Stopping xfce-test ===== 
 + 
 +''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). 
 + 
 +---- 
 + 
 +===== Uninstalling xfce-test =====
  
   * Remove the docker container   * Remove the docker container
Line 27: Line 102:
       * 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 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.
 +
 +
 +[[|Back to Top]]
 +----
 +[[ :start:|Return to Main Wiki page]]
 +
 +[[ https://docs.xfce.org/contribute/start#bug_reporting_and_testing|Return to Contribute page]]
 +