Docker¶

• Table of contents
• Docker
• Typo3
• PhpStorm
• Tipps
• Issues
• PHPUnit Tests

Handout

[root@webwork20]

$ cd /var/docker/
$ mkdir <username>
$ cd /var/docker/<username>

# Checkout git repo - decide to if you like to use 'http' or 'ssh'. 
# You can change later, check: https://wiki.math.uzh.ch/public/Git#Change_Repo:_http_.3E_ssh

# http: you have to specify username/password for every remote GIT action.
$ git clone https://systemvcs.math.uzh.ch/it/typo3-docker.git <username_instancename>

# ssh: username/password is given automatically, login  via ssh-agent forward: ssh -A root@webwork20
$ git clone git@systemvcs.math.uzh.ch:it/typo3-docker.git <username_instancename>

# Main Branch ist Typo3 V10

# In case T3 V11 should be used
$ git checkout typo11

$ cd /var/docker/<username>/<username_instancename>

# Create docker images and prepare nginx, mariadb, pma
# execute bootstrap.py
$ python3 bootstrap.py
....
⠿ Network crose1_dev_default      Created                                                                                               0.1s
⠿ Container crose1_dev-mariadb-1  Healthy                                                                                              16.5s
⠿ Container crose1_dev-pma-1      Started                                                                                              17.0s
⠿ Container crose1_dev-nginx-1    Started                                                                                              17.2s
First time install: http://webwork20:51515/typo3/install.php
web: http://webwork20:51515
pma: http://webwork20:52195
xdebug: 53859
ssh: ssh root@webwork20 -p 58785

#-------------------------------------------------------
# Create a keepass entry in @kpdev@ under webwork20, incl. your instance password, with the above mentioned ports!
#-------------------------------------------------------

#-------------------------------------------------------
# Configure ssh passwordless access to the nginx/php docker.
# If not already done before, create a personal private/public SSH keys (in thinlinc): ssh-keygen -t ed25519
#-------------------------------------------------------

# Transfer the public SSH key from Thinlinc to the docker on webwork20.
[user@tlx] cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAA... 

# Copy/paste the key on webwork20
[root@webwork20] vim ssh/authorized_keys

# Test the password less login ... accept the new SSH hostkey.
[user@tlx] ssh root@webwork20 -p 58785

Typo3¶

• Open T3/BE: https://webwork20:xxxx/typo3/install.php

• Choose "take me straight to the backend"

• Login > extension: add a) fluid styled content, b) typo3 edit highlighting

• Install latest qfq (https://qfq.io/download/?dir=releases) and uzh_cd (https://www.math.uzh.ch/repo/?dir=uzhcd/v9)
• Create first page:

• Under access, set page visible to true
• Add template to home (via plus):
  
  
  

• Add page content > QFQ to home

10.sql = SELECT "Hello world from QFQ, ", NOW()

• Try view page on home for a first test:
  

• As instructed, create a new page "Form" with pagecontent [QFQ] Form under Home and load the formEditor:
  

  file=_formEditor
  

• Reload the page
  

• Done with typo3!

PhpStorm¶

• Replace the following ports with yours!

• You need the url of the page AND the xdebug port from the installation. If you do not remember them, check /var/docker/<username>/<username_instancename>/config.json.
• PhpStorm: File > Settings > PHP > Debug

• List all of the xdebug ports of your docker containers, comma separated. REMOVE 9000, else phpstorm will still stop webwork16.
• Add Server:

• 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:

• 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:

• 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:

• 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:
  • Tools > Deployment > Configuration

• Wenn gewuenscht kann der automatische Upload aktiviert werden:

Tipps¶

• If the FormEditor is broken and has problems to show note.gif, the baseUrl is probably not configure in QFQ setup.
• Configure correct Site entry point

Issues¶

• #15745

PHPUnit Tests¶