Merge pull request #144 from vshn/extend/forgejo-docs

Add forgejo backup and restore docs

Author: ThisIsntTheWay

docs/modules/ROOT/nav.adoc

@@ -13,7 +13,10 @@
 
 .Forgejo
 * xref:vshn-managed/forgejo/index.adoc[On cloudscale.ch]
+** xref:vshn-managed/forgejo/backup.adoc[Backup]
 ** xref:vshn-managed/forgejo/create.adoc[Creation]
+** xref:vshn-managed/forgejo/maintenance.adoc[]
+** xref:vshn-managed/forgejo/restore.adoc[Restore]
 
 .Kafka
 * xref:exoscale-dbaas/kafka/index.adoc[On Exoscale]

docs/modules/ROOT/pages/vshn-managed/forgejo/backup.adoc

@@ -0,0 +1,23 @@
+= Backups
+
+Backups are enabled by default. The Forgejo instance will be backed up daily at a randomly chosen time between 22:00 and 4:00.
+
+You can specify a different backup time and interval using the following backup configuration:
+
+[source,yaml]
+----
+apiVersion: vshn.appcat.vshn.io/v1
+kind: VSHNForgejo
+metadata:
+  name: forgejo-app1-prod
+  namespace: <your-namespace>
+spec:
+  parameters:
+    ...
+    backup:
+      schedule: 0 22 * * * <1>
+    ...
+----
+<1> The schedules for your backups.
+
+NOTE: The backup relies on `forgejo dump` which collects all the data into a single archive, including the database.

docs/modules/ROOT/pages/vshn-managed/forgejo/maintenance.adoc

@@ -0,0 +1,22 @@
+= Scheduled Maintenance
+
+By default, there will be a security maintenance on Tuesday night (Central Europe Time).
+
+The day and time can be adjusted as described below. Times are in the CET time zone.
+
+.Nexcloud instance with custom maintenance
+[source,yaml]
+----
+apiVersion: vshn.appcat.vshn.io/v1
+kind: VSHNForgejo
+metadata:
+  name: forgejo-app1-prod
+  namespace: prod-app
+spec:
+  parameters:
+    maintenance:
+      dayOfWeek: wednesday # <1>
+      timeOfDay: '23:30:00' # <2>
+----
+<1> The day when the maintenance should take place
+<2> The time when the maintenance should be started

docs/modules/ROOT/pages/vshn-managed/forgejo/restore.adoc

@@ -0,0 +1,4 @@
+= Restores
+
+Self-service restores aren't implemented yet.
+If you need to restore Forgejo please contact our mailto:[email protected][Support].