Project

General

Profile

Docker » History » Revision 18

Revision 17 (Benjamin Baer, 01.02.2023 16:20) → Revision 18/111 (Enis Nuredini, 15.02.2023 10:34)

h1. Docker 

 h2. Installation 

 * Server: webwork20 
 * Path: /var/docker/[user]/ 
 * Checkout git repo:  
 <pre> 
 git clone https://systemvcs.math.uzh.ch/it/typo3-docker.git 
 </pre> 
 * rename the typo3-docker folder! [user]-[instance] ex. bbaer-dev 
 * execute bootstrap.py 
 <pre> 
 cd [user]-[instance] 
 python3 bootstrap.py 
 </pre> 
 * You see a list with your links and Ports. 
 * After setup, navigate to https://webwork20:xxxx/typo3/install.php 
 !typo3_1.png! 
 * Type in your typo3 backend user and password, etc.; click continue 
 !typo3_2.png! 
 * Choose "take me straight to the backend" 
 * Login 
 * Go to extension and add fluid styled content: 
 !typo3_3.png 
 * Install latest qfq (https://qfq.io/download/?dir=releases) and uzh_cd (https://www.math.uzh.ch/repo/?dir=uzhcd/v9) 
 * Create first page: 
 !typo3_4.png! 
 !typo3_5.png! 
 !typo3_6.png! 
 * Under access, set page visible to true 
 * Add template to home (via plus): 
 !typo3_7_t1.png! 
 !typo3_7_t2.png! 
 !typo3_7_t3.png! 

 * Add page content > QFQ to home 

 !qfq_1.png! 

 <pre> 
 10.sql = SELECT "Hello world from QFQ, ", NOW() 
 </pre> 

 * Try view page on home for a first test: 
 !qfq2.png! 

 * As instructed, create a new page "Form" with pagecontent [QFQ] Form under Home and load the formEditor: 
 <pre> 
 file=_formEditor 
 </pre> 

 * Reload the page 
 !qfq3.png! 

 * Activate typo3 edit highlighting 
 !t3editor.png! 

 * Done with typo3! 

 .h2 Configuring phpstorm 

 * You need the url of the page AND the xdebug port from the installation. If you do not remember them, see config.json in your docker folder. 
 * Open PHP Storm, go to File > Settings > PHP > Debug 
 !xdebug1.png! 
 * List all of the xdebug ports of your docker containers, comma separated. REMOVE 9000, else phpstorm will still stop webwork16. 
 * Add Server: 
 !xdebug2.png! 
 ** Please give a detailed name, eg. webwork20 dev, there will be multiple deployments on the same server! 
 ** Use the port for the website, not the xdebug port! 
 ** You can already map the path of extension > /var/www/html/typo3conf/ext/qfq/ 
 ** You may not see the typo3 sources: 
 !xdebug3.png! 
 ** If you see it, map typo3_src_10.4.34 to /var/www/typo3_src (see screenshot) 
 ** If not, add additional sources to your phpstorm project, then do above: 
 !xdebug4.png! 
 *** Got to File > Settings > Directories and Add new Root Directory 
 *** Add /scratch/software/typo3 
 *** Mark typo3_src_10.4.34 as Source Folder (also extension in the qfq folder, if you haven't) 
 * Finally add a new xdebug setting: 
 !xdebug5.png! 
 !xdebug6.png! 
 ** Here you can select the server you added before 
 ** Remove webwork16 if you didn't remove port 9000, to not stop webwork16 by accident. 
 * Deployment path: 
 ** Run > Deployment > Configuration 
 !xdebug7.png! 
 !xdebug8.png!