Deployment MVP Entwicklungsportal [S]

Warum?

Die Entwicklungsportal-Landingpage wird aktuell nur unter https://docs-preview.fitko.dev/ deployed. Nach Fertigstellung von #347 (closed) soll die Landingpage unter https://docs.fitko.de erreichbar sein.

Relevante Links und Bemerkungen

Habe jetzt eine Lösung für das Gleichzeitige Deployment der Entwicklungsportal-Landingpage und den Docusaurus-Unterseiten gefunden: Wir erstellen zwei Verzeichnisse (/var/www/virtual/fitko/{html,docs.fitko.de}) und erstellen im Verzeichnis docs.fitko.de Symlinks für die docusaurus-Verzeichnisse. Das geht via ln -fs /var/www/virtual/fitko/html/{*,.[^.],.??*} /var/www/virtual/fitko/docs.fitko.de/

[fitko@dorado fitko]$ pwd
/var/www/virtual/fitko
[fitko@dorado fitko]$ ls docs.fitko.de
docs.fitko.de  dvdv  fim-xoev  fit-connect  index.html  payment-api  preview  pvog  standards-und-schnittstellen
[fitko@dorado fitko]$ ls html/
docs.fitko.de  dvdv  fim-xoev  fit-connect  index.html  payment-api  preview  pvog  standards-und-schnittstellen

Das Entwicklungsportal kommt dann via rsync -rLvzc4 -e 'ssh -o CheckHostIP=no' --progress --delete ./out/. $DEPLOY_SERVER:docs.fitko.de in das Verzeichnis docs.fitko.de . Dabei werden alle Symlinks gelöscht. Anschließend werden diese jedoch wieder via CI mit obigem Befehl angelegt.

Neue Lösung via .htaccess:

[fitko@dorado preview.docs.fitko.dev]$ pwd
/home/fitko/preview.docs.fitko.dev
[fitko@dorado preview.docs.fitko.dev]$ cat .htaccess
RewriteEngine on

# Serve / from /entwicklungsportal
RewriteRule ^$ /entwicklungsportal/ [L]

# If no such file/directory and does not start with /entwicklungsportal
# Serve from /entwicklungsportal
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/entwicklungsportal/
RewriteRule ^(.*)$ /entwicklungsportal/$1

# If it's a folder, redirect to entwicklungsportal/ !with! /
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^entwicklungsportal/(.*[^/])$ /$1/ [R=301]

Folgende GitLab-Projekte müssen angepasst werden:

• https://git.fitko.de/dvdv/docs/
• https://git.fitko.de/foederale-it/fim-xoev/fim-xoev-doc
• https://git.fitko.de/fit-connect/docs/
• https://git.fitko.de/foederale-it/payment-api
• https://git.fitko.de/pvog/docs
• https://git.fitko.de/ag-standards-und-schnittstellen/standards-und-schnittstellen
• https://git.fitko.de/fit-connect/docusaurus-template

Akzeptanzkriterien

1. Der Main-Branch des Entwicklungsportal-Repositorys wird via CI nach https://docs.fitko.de ausgeliefert.
2. Wie für https://docs.fitko.de/fit-connect/ soll die Möglichkeit bestehen, Feature-Branches in einer Preview-Umgebung zu testen (entweder unter docs.fitko.de/preview oder unter docs-preview.fitko.dev).

Durchführungsplan (vom Entwickler bei Storyplanung auszufüllen)

• Freigabe zum Deployment unter docs.fitko.de von PO einholen.
• ...
• ...
• Definition of Done wurde geprüft