Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- tachtler:gitlab_archlinux_-_restore [2024/03/23 09:28] – [Voraussetzungen] klaus
+++ tachtler:gitlab_archlinux_-_restore [2024/03/23 18:24] (aktuell) – [GitLab: Dienste/Daemons starten] klaus
@@ Zeile 9: / Zeile 9: @@
 | Installation          | [[https://wiki.archlinux.org/title/PostgreSQL]]\\ [[https://wiki.archlinux.org/title/Redis]]\\ [[https://wiki.archlinux.org/title/GitLab]] |
 | Restore Dokumentation | [[https://docs.gitlab.com/ee/administration/backup_restore/restore_gitlab.html]] |
 Ab hier werden ''root''-Rechte zur Ausführung der nachfolgenden Befehle benötigt. Um der Benutzer ''root'' zu werden, geben Sie bitte nachfolgenden Befehl ein:
@@ Zeile 21: / Zeile 20: @@
 **__Als grobe Richtlinie gilt__**:
-Wenn eine Architektur mit **__weniger__ als 100 GB Daten** Verwendung findet, sind die nachfolgenden drei Schritte für ein erfolgreiches Backup ausreichend:
+Wenn eine Architektur mit **__weniger__ als 100 GB Daten** Verwendung findet, sind die nachfolgenden drei Schritte für ein erfolgreiches Restore ausreichend:
   - **Restore-Befehl ausführen**.
   - Objektspeicher wiederherstellen, falls zutreffend.
@@ Zeile 50: / Zeile 49: @@
   * Ein erstelltes **Backup** der **__gleichen__ Version** von [[https://gitlab.com/|GitLab]]
     * siehe auch den internen Link: [[tachtler:gitlab_archlinux_-_backup|GitLab ArchLinux - Backup]]
+===== GitLab: Dienste/Daemons stoppen =====
+Nachdem [[https://gitlab.com/|GitLab]] wahrscheinlich bereits lauffähig gestartet wurde, ist es erforderlich [[https://gitlab.com/|GitLab]] zu stoppen.
+Da ein **systemd**-Target - hier in diesem Fall **''gitlab.target''** nicht einfach gestoppt werden kann, ist es sinnvoll sich den Inhalt von **''gitlab.target''** mit nachfolgendem Befehl anzeigen zu lassen:
+<code>
+# systemctl cat gitlab.target
+# /usr/lib/systemd/system/gitlab.target
+[Unit]
+Description=GitLab - Self Hosted Git Management
+Requires=gitlab-puma.service gitlab-workhorse.service
+Wants=gitlab-sidekiq.service gitlab-backup.timer gitlab-gitaly.service gitlab-mailroom.service
+[Install]
+WantedBy=multi-user.target
+</code>
+Hier sind alle Dienste/Daemons welche ebenfalls mittels **systemd** gestartet werden aus dem **''gitlab.target''** in den Bereichen
+  * ''Requires''
+  * ''Wants''
+aufgelistet
+Diese können dann mit nachfolgendem Befehl gestoppt werden:
+<code>
+# systemctl stop gitlab-puma.service gitlab-workhorse.service gitlab-sidekiq.service gitlab-backup.timer gitlab-gitaly.service gitlab-mailroom.service
+</code>
+===== GitLab: Restore-Befehl =====
+Nachfolgende Befehle führen ein Restore aus einem Backup von [[https://gitlab.com/|GitLab]] durch.
+Eine Auflistung mittels des **Backup-Befehls** erstellten **Backup-Datei**, kann mit nachfolgendem Befehl durchgeführt werden und sollte eine Datei in etwa wie die nachfolgende zum Vorschein bringen:
+<code>
+# ls -l /var/lib/gitlab/backups
+total 644
+-rw------- 1 gitlab gitlab 174080 Mar 23 07:59 1711175567_2024_03_23_16.9.2_gitlab_backup_manual.tar
+-rw------- 1 gitlab gitlab 481280 Mar 23 07:32 1711175567_2024_03_23_16.9.2_gitlab_backup.tar
+</code>
+:!: **ACHTUNG** - **Hier ist die vom Backup-Befehl erstellte Datei zu berücksichtigen!**
+Damit alle Daten wiederhergestellt werden, ist es jedoch erforderlich, das der Dienst/Daemon
+  * **''gitlab-gitaly.service''**
+läuft, was mit nachfolgendem Befehl realisiert werden kann:
+<code>
+# systemctl start gitlab-gitaly.service
+</code>
+:!: **ACHTUNG** - **Der Dienst/Daemon ''gitlab-gitaly.service'' __muss zwingend gestartet sein__ !!!**
+Mit nachfolgendem Befehl **__muss__ zwingend** in das Verzeichnis ''/usr/share/webapps/gitlab'' gewechselt werden:
+<code>
+# cd /usr/share/webapps/gitlab
+</code>
+Der nachfolgende Befehl, führt dann den **Restore** von [[https://gitlab.com/|GitLab]] aus:
+<code>
+# sudo -u gitlab $(cat environment | xargs) bundle exec rake gitlab:backup:restore RAILS_ENV=production BACKUP=1711175567_2024_03_23_16.9.2
+</code>
+:!: **ACHTUNG** -
+  * **__keine__ Angabe des Pfades zur Sicherungsdatei**
+  * **__keine__ Angabe von ''_gitlab_backup.tar'' !!!**
+<code>
+# sudo -u gitlab $(cat environment | xargs) bundle exec rake gitlab:backup:restore RAILS_ENV=production BACKUP=1711175567_2024_03_23_16.9.2
+-03-23 16:27:29 +0100 -- Unpacking backup ...
+-03-23 16:27:29 +0100 -- Unpacking backup ... done
+-03-23 16:27:29 +0100 -- Restoring database ...
+-03-23 16:27:29 +0100 -- Be sure to stop Puma, Sidekiq, and any other process that
+connects to the database before proceeding. For Omnibus
+installs, see the following link for more information:
+https://gitlab.tachtler.net/help/raketasks/backup_restore.html#restore-for-omnibus-gitlab-installations
+Before restoring the database, we will remove all existing
+tables to avoid future upgrade problems. Be aware that if you have
+custom tables in the GitLab database these tables and all data will be
+removed.
+Do you want to continue (yes/no)? yes
+Removing all tables. Press `Ctrl-C` within 5 seconds to abort
+-03-23 16:27:39 +0100 -- Cleaning the database ...
+-03-23 16:27:41 +0100 -- done
+Restoring PostgreSQL database gitlabhq_production ... SET
+SET
+SET
+SET
+SET
+ set_config
+------------
+(1 row)
+SET
+SET
+SET
+SET
+ALTER TABLE
+...
+DROP TRIGGER
+...
+DROP INDEX
+...
+ALTER TABLE
+...
+DROP SEQUENCE
+DROP TABLE
+...
+DROP FUNCTION
+...
+DROP TABLE
+...
+CREATE SCHEMA
+ALTER SCHEMA
+COMMENT
+CREATE SCHEMA
+ALTER SCHEMA
+COMMENT
+CREATE EXTENSION
+COMMENT
+CREATE EXTENSION
+COMMENT
+CREATE FUNCTION
+ALTER FUNCTION
+CREATE FUNCTION
+ALTER FUNCTION
+CREATE FUNCTION
+ALTER FUNCTION
+SET
+SET
+...
+CREATE TABLE
+ALTER TABLE
+CREATE FUNCTION
+...
+CREATE SEQUENCE
+ALTER SEQUENCE
+ALTER SEQUENCE
+...
+COPY 0
+COPY 16
+COPY 0
+...
+ setval
+--------
+(1 row)
+...
+ALTER TABLE
+...
+CREATE INDEX
+...
+ALTER INDEX
+...
+CREATE TRIGGER
+...
+ALTER TABLE
+[DONE]
+Source backup for the database ci doesn't exist. Skipping the task
+-03-23 16:27:55 +0100 -- Restoring database ... done
+-03-23 16:27:55 +0100 -- Restoring repositories ...
+-03-23 16:27:55 +0100 -- Restoring repositories ... done
+-03-23 16:27:55 +0100 -- Restoring uploads ...
+-03-23 16:27:55 +0100 -- Restoring uploads ... done
+-03-23 16:27:55 +0100 -- Restoring builds ...
+-03-23 16:27:55 +0100 -- Restoring builds ... done
+-03-23 16:27:55 +0100 -- Restoring artifacts ...
+-03-23 16:27:55 +0100 -- Restoring artifacts ... done
+-03-23 16:27:55 +0100 -- Restoring pages ...
+-03-23 16:27:55 +0100 -- Restoring pages ... done
+-03-23 16:27:55 +0100 -- Restoring lfs objects ...
+-03-23 16:27:55 +0100 -- Restoring lfs objects ... done
+-03-23 16:27:55 +0100 -- Restoring terraform states ...
+-03-23 16:27:55 +0100 -- Restoring terraform states ... done
+-03-23 16:27:55 +0100 -- Restoring packages ...
+-03-23 16:27:55 +0100 -- Restoring packages ... done
+-03-23 16:27:55 +0100 -- Restoring ci secure files ...
+-03-23 16:27:55 +0100 -- Restoring ci secure files ... done
+This task will now rebuild the authorized_keys file.
+You will lose any data stored in the authorized_keys file.
+Do you want to continue (yes/no)? yes
+-03-23 16:28:04 +0100 -- Deleting tar staging files ...
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/backup_information.yml
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/db
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/uploads.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/builds.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/artifacts.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/pages.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/lfs.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/terraform_state.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/packages.tar.gz
+-03-23 16:28:04 +0100 -- Cleaning up /var/lib/gitlab/backups/ci_secure_files.tar.gz
+-03-23 16:28:04 +0100 -- Deleting tar staging files ... done
+-03-23 16:28:04 +0100 -- Deleting backups/tmp ...
+-03-23 16:28:04 +0100 -- Deleting backups/tmp ... done
+-03-23 16:28:04 +0100 -- Warning: Your gitlab.rb and gitlab-secrets.json files contain sensitive data
+and are not included in this backup. You will need to restore these files manually.
+-03-23 16:28:04 +0100 -- Restore task is done.
+-03-23 16:28:04 +0100 -- Deleting backup and restore PID file ... done
+</code>
+:!: **HINWEIS** - **Die nachfolgende Warnung, kann __ignoriert__ werden, da dies nur für eine __Omnibus__ Installation relevant ist!**
+  * <code>2024-03-23 16:28:04 +0100 -- Warning: Your gitlab.rb and gitlab-secrets.json files contain sensitive data
+and are not included in this backup. You will need to restore these files manually.</code>
+===== GitLab: Dienste/Daemons starten =====
+Mit nachfolgendem Befehl wird [[https://gitlab.com/|GitLab]] wieder gestartet.
+Dieser **systemd**-Start beinhaltet auch den Start alle anderen benötigten Komponenten bzw. Dienste/Daemons von [[https://gitlab.com/|GitLab]].
+<code>
+# systemctl start gitlab.target
+</code>
+Eine Überprüfung, ob der Start des Ziel/Target erfolgreich war, kann mit nachfolgendem Befehl überprüft werden:
+<code>
+● gitlab.target - GitLab - Self Hosted Git Management
+     Loaded: loaded (/usr/lib/systemd/system/gitlab.target; enabled; preset: disabled)
+     Active: active since Fri 2024-03-22 09:34:35 CET; 30min ago
+Mar 22 09:34:35 server systemd[1]: Reached target GitLab - Self Hosted Git Management.
+</code>