Vorgabe für MediaWiki-Artikel bei xinux.net: Unterschied zwischen den Versionen

Aus Xinux Wiki
Zur Navigation springen Zur Suche springen
 
(19 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
−
= Stilvorgabe für technische MediaWiki-Anleitungen auf xinux.net =
+
= Rclone: Daten synchronisieren mit Nextcloud =
  
−
Diese Vorgabe beschreibt den gewünschten Formatierungsstil für alle technischen Anleitungen im Wiki xinux.net. Sie dient als verbindliche Grundlage für die Ausgabe von Konfigurationsanleitungen, insbesondere im Bereich Linux-Server, Netzwerkinfrastruktur und Security.
+
Diese Anleitung beschreibt ein einfaches Rclone-Setup zur Synchronisierung von Daten mit einer Nextcloud-Instanz per WebDAV.
  
−
= Grundprinzipien =
+
= Passwort verschlüsseln =
 +
Rclone speichert Passwörter nicht im Klartext. Verwende den Befehl, um dein Passwort zu verschlüsseln.
 +
*rclone obscure 'DEIN-PASSWORT'
 +
Die Ausgabe (z. B. d3fOb5cuR3…) ist ein verschlüsselter String, den du im nächsten Schritt verwendest.
  
−
;Alle Inhalte werden vollständig innerhalb eines MediaWiki-Codeblocks geliefert 
+
= Remote anlegen =
−
;Die Formatierung folgt strikt dem MediaWiki-Syntaxstandard 
+
Erstellt eine neue Rclone-Remote-Verbindung, die direkt auf den Benutzer-Root-Ordner in Nextcloud verweist.
−
;Der Stil ist nüchtern, technisch, übersichtlich und ohne ablenkende Formatierungen gehalten
+
*rclone config create nextcloud webdav url https://cloud.xinux.net/remote.php/dav/files/thomas.will/ vendor nextcloud user thomas.will pass 'HIER-DIE-OBSCURE-AUSGABE'
  
−
= Überschriften =
+
= Verbindung testen =
 +
Überprüfe, ob die Verbindung erfolgreich hergestellt wurde, indem du eine Liste der Ordner in deinem Nextcloud-Root-Verzeichnis anzeigst.
 +
*rclone lsd nextcloud:
 +
Updating certificates in /etc/ssl/certs...
 +
1 added, 0 removed; done.
  
−
;Hauptüberschriften beginnen mit einem Gleichheitszeichen (=) 
+
= Daten hochladen =
−
;Unterüberschriften können mit mehreren Gleichheitszeichen erstellt werden (==, === usw.) 
+
Nutze den copy-Befehl, um eine Datei hochzuladen. Die Optionen -P und die --retries-Parameter sorgen für einen robusten und zuverlässigen Upload.
−
;Keine Nummerierung in Überschriften 
+
*rclone copy waf.ova nextcloud:xinux/vms/ovas/ -P --retries 10 --retries-sleep 10s --low-level-retries 20
−
;Jede Überschrift wird direkt darunter ohne Leerzeile fortgesetzt
+
**nextcloud:: Der Name der zuvor erstellten Remote-Verbindung.
 +
**xinux/vms/ovas/: Der Zielordner in deiner Nextcloud. Rclone erstellt diesen Ordner, falls er noch nicht existiert.
  
−
= Aufzählungen und Befehle =
+
= Weitere nützliche Befehle =
−
 
+
*'''Synchronisieren:''' rclone sync synchronisiert ein Verzeichnis. Daten, die in der Quelle nicht mehr existieren, werden im Ziel gelöscht.
−
;Jeder Befehl beginnt mit einem Stern (*), ohne zusätzliche Zeichen oder Erklärungen davor 
 
−
;Kommentare, Ausgaben oder Erklärungen können eingerückt in der nächsten Zeile folgen 
 
−
;Shell-Prompts (z. B. $, #) werden nicht verwendet 
 
−
;Die drei einfachen Apostrophe (''') dienen ausschließlich der Formatierung von Befehlen in erklärendem Kontext – nicht innerhalb von <pre>-Blöcken
 
−
 
 
−
Beispiel:
 
−
*mkdir -p /etc/ssl/mail.int 
 
−
*cp ca.crt /usr/local/share/ca-certificates/
 
−
 
 
−
= Konfigurationsdateien =
 
−
 
 
−
;Wenn Konfigurationen ergänzt werden, beginnt die Anweisung mit:
 
−
*vi /pfad/zur/datei
 
−
;Darunter folgt ein <pre>-Block mit dem tatsächlichen Inhalt 
 
−
;Innerhalb von <pre> keine Sternchen, keine Hochkommas, kein Prompt – nur Klartext 
 
−
 
 
−
Beispiel:
 
−
*vi /etc/postfix/main.cf
 
−
<pre>
 
−
smtpd_tls_cert_file = /etc/ssl/mail.int/server.crt
 
−
smtpd_tls_key_file = /etc/ssl/mail.int/server.key
 
−
</pre>
 
−
 
 
−
= Systemausgaben =
 
−
 
 
−
;Ausgaben von Befehlen (z. B. bei update-ca-certificates) können direkt unter dem Befehl angegeben werden
 
−
;Sie werden nicht hervorgehoben, nur eingerückt als Plaintext 
 
−
 
 
−
Beispiel:
 
−
*update-ca-certificates
 
−
Updating certificates in /etc/ssl/certs...
 
−
1 added, 0 removed; done.
 
−
 
 
−
= Ziel =
 
−
 
 
−
;Der Stil dient der maximalen Klarheit, Kopierbarkeit und Praxistauglichkeit 
 
−
;Er soll es ermöglichen, dass Leser die Schritte ohne jede Interpretation 1:1 umsetzen können 
 
−
;Alle Anleitungen sollen in sich geschlossen und vollständig sein 
 
−
;Jede Antwort zu einem Artikel wird ausschließlich in einem vollständigen Codeblock geliefert
 

Aktuelle Version vom 28. August 2025, 21:21 Uhr

Rclone: Daten synchronisieren mit Nextcloud

Diese Anleitung beschreibt ein einfaches Rclone-Setup zur Synchronisierung von Daten mit einer Nextcloud-Instanz per WebDAV.

Passwort verschlüsseln

Rclone speichert Passwörter nicht im Klartext. Verwende den Befehl, um dein Passwort zu verschlüsseln.

  • rclone obscure 'DEIN-PASSWORT'

Die Ausgabe (z. B. d3fOb5cuR3…) ist ein verschlüsselter String, den du im nächsten Schritt verwendest.

Remote anlegen

Erstellt eine neue Rclone-Remote-Verbindung, die direkt auf den Benutzer-Root-Ordner in Nextcloud verweist.

Verbindung testen

Überprüfe, ob die Verbindung erfolgreich hergestellt wurde, indem du eine Liste der Ordner in deinem Nextcloud-Root-Verzeichnis anzeigst.

  • rclone lsd nextcloud:

Updating certificates in /etc/ssl/certs... 1 added, 0 removed; done.

Daten hochladen

Nutze den copy-Befehl, um eine Datei hochzuladen. Die Optionen -P und die --retries-Parameter sorgen für einen robusten und zuverlässigen Upload.

  • rclone copy waf.ova nextcloud:xinux/vms/ovas/ -P --retries 10 --retries-sleep 10s --low-level-retries 20
    • nextcloud:: Der Name der zuvor erstellten Remote-Verbindung.
    • xinux/vms/ovas/: Der Zielordner in deiner Nextcloud. Rclone erstellt diesen Ordner, falls er noch nicht existiert.

Weitere nützliche Befehle

  • Synchronisieren: rclone sync synchronisiert ein Verzeichnis. Daten, die in der Quelle nicht mehr existieren, werden im Ziel gelöscht.
Abgerufen von „http://wiki.ixheim.de/index.php?title=Vorgabe_für_MediaWiki-Artikel_bei_xinux.net&oldid=64520“