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
-
Der Main-Branch des Entwicklungsportal-Repositorys wird via CI nach https://docs.fitko.de ausgeliefert. -
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