J'écris une courte documentation pour les admins des forums Discourse que j'ai aidé à configurer. Est-ce que j'oublie quelque chose ?

[Canapin (Coin-coin le Canapin)]

J’ai configuré des forums Discourse pour plusieurs amis/associations. J’aimerais qu’ils soient plus autonomes dans l’administration, de sorte que j’aie moins de chances d’intervenir moi-même.

Ils utilisent Discourse en tant qu’utilisateurs et co-administrateurs depuis des mois, voire des années. Ce ne sont pas des « nouveaux administrateurs », mais ils manquent de connaissances approfondies sur la façon de maintenir Discourse au quotidien (au-delà des bases de la modération) et sur ce qu’il faut savoir en tant qu’administrateur, et en cas de problèmes techniques, car j’étais toujours là pour m’occuper de ces choses.

Je serai toujours disponible à l’avenir, mais l’objectif est de leur permettre de suivre et de résoudre eux-mêmes les problèmes les plus courants.

Voici ce que j’ai écrit jusqu’à présent (traduit automatiquement en anglais car mon texte sera rédigé en français, donc ne faites pas attention si certaines phrases sont étranges) :

---

Mises à jour

Via l’interface web

Effectuez les mises à jour lorsqu’un smiley rouge mécontent apparaît dans le panneau d’administration (cela signifie qu’une mise à jour importante doit être appliquée).
Les mises à jour se font via :
https://tonforum.fr/admin/upgrade

Elles se font parfois en deux étapes : vous devez d’abord mettre à jour « Docker_Manager » avant de pouvoir mettre à jour le reste :

Via la ligne de commande

Parfois, une mise à jour doit être effectuée via la ligne de commande (la page d’administration de Discourse l’indiquera explicitement si nécessaire).

1. Connectez-vous au serveur via SSH
2. Reconstruisez le forum (une reconstruction met toujours à jour Discourse) en utilisant la commande suivante :

3. /var/discourse/launcher rebuild app
   

4. De temps en temps, une fois que vous avez confirmé que le forum fonctionne correctement, il peut être utile de supprimer les images Docker inutilisées (restes des mises à jour précédentes) pour libérer de l’espace disque :

   /var/discourse/launcher cleanup
   

Emplacement des fichiers importants sur le serveur

app.yml

Contient la configuration du serveur et la liste des plugins installés. Très utile si vous avez besoin de migrer le forum vers un autre serveur ou d’appliquer certaines configurations (par exemple, déplacer les téléchargements et les sauvegardes vers un autre disque). Il est situé ici :

/var/discourse/containers/app.yml

mail-receiver.yml

Contient la configuration du logiciel qui permet de recevoir les réponses par e-mail et de les publier sur le forum. Il est situé ici :

/var/discourse/containers/mail-receiver.yml

Sauvegardes (Backups)

Les fichiers de sauvegarde sont stockés ici :

/var/discourse/shared/standalone/backups/default

Pages importantes dans l’administration du forum

Quelques pages qui peuvent être utiles

Thèmes et composants

Ils incluent le CSS et le HTML personnalisés :

https://tonforum.fr/admin/config/customize/themes

Journaux (Logs)

E-mail

Utile pour le débogage :

https://tonforum.fr/admin/email-logs

Actions du personnel (Staff actions)

Très utile. Il conserve un enregistrement de (presque) toutes les modifications des paramètres du site et des autres actions effectuées par les modérateurs et les administrateurs.

https://tonforum.fr/admin/logs/staff_action_logs

Journaux d’erreurs (Error logs)

Peut fournir des indices lorsqu’un problème n’est pas évident :

https://tonforum.fr/logs/

Sauvegardes (Backups)

Pour modifier la fréquence des sauvegardes et le nombre maximal de sauvegardes, les visualiser ou les télécharger :

https://tonforum.fr/admin/backups

Ressources

https://meta.discourse.org
Support officiel. N’hésitez pas à y publier ; les membres de la communauté et les développeurs sont généralement très serviables.

---

Voyez-vous des choses qui pourraient être ajoutées/supprimées ? Je pense que je peux supprimer la partie /logs/, car elle est très, très rarement utile. Je ne suis même pas sûr d’y avoir trouvé des informations utiles en de nombreuses années d’administration de quelques instances.

[Ed_S]

Quelques points que je voudrais clarifier.

L’un est, au moment d’essayer une mise à jour via l’interface web, sachez que la mise à jour peut échouer et que votre forum peut être hors service. Soyez prêt.

L’autre est, si votre hôte devient inaccessible ou corrompu, vous aurez besoin des fichiers de sauvegarde et des fichiers yml. Vous devrez les avoir déjà mis en lieu sûr sur un système séparé.

Pour combiner les deux : faites toujours une sauvegarde et téléchargez la sauvegarde avant d’essayer une mise à jour.

[Heliosurge (Dan DeMontmorency)]

Bonjour Ed, points très valables. Un membre a créé un script pour sauvegarder sur un autre système il y a quelque temps, si je me souviens bien. Il faudra faire une recherche et vérifier.

Voici un extrait du message initial. Canapin a une bonne réponse avec un lien vers la sauvegarde sur Google Drive/Dropbox également.

@Lhc_fl

Récemment, une amie a rencontré le problème du fournisseur de VPS qui a soudainement cessé ses activités sans préavis. Malheureusement, pour des raisons de coût, elle a choisi un fournisseur de niche - un qui n’offrait même pas de téléchargement de données. Le pire est qu’elle n’a même pas l’habitude de télécharger régulièrement des sauvegardes. Du jour au lendemain, son site a disparu, ainsi que toutes les données qu’il contenait.

Choquée par cela, j’ai écrit un script Powershell qui téléchargera automatiquement les sauvegardes de votre serveur sur votre ordinateur local régulièrement sans avoir à acheter de services de stockage d’objets supplémentaires ou à dépenser un centime pour d’autres choses. Tout ce dont vous avez besoin est un ordinateur Windows que vous utilisez régulièrement (et qui dispose de beaucoup d’espace disque) et qui est connecté à Internet.

Le script supprimera automatiquement les sauvegardes datant de plus de 5 jours. Vous pouvez définir l’intervalle de sauvegarde automatique et l’ancienneté de la sauvegarde conservée localement en fonction de vos besoins.

$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Starting Discourse backup download task..."
Write-Output '------------------------'
Write-Output "Fetching the latest backup file..."
Write-Output ''

while ($true) {

    $filename = ''

    while ($true) {
        try {
            Write-Output "> ssh -p $ssh_port $ssh_address 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'"
            Write-Output ''
            $filename = ssh -p $ssh_port "$ssh_address" 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'
            break
        }
        catch {
            $filename = ''
    
            Write-Output "Failed to fetch... Here is the log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Do you want to re-fetch? (y/N)"
            if ($answer -ne 'y') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Error: Failed to fetch file name $filename"
        Write-Output ''
        $answer = Read-Host 'Retry?(y/N)'
  
        if ($answer -eq 'y') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Latest backup: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename already exists. Do you want to download it again?(y/N)"
            Write-Output ''
            if ($answer -ne 'y') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Start downloading..."
            Write-Output ''
            
            while ($true) {
                try {
                    Write-Output "scp -p $ssh_port ${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename .\\backups\\"
                    Write-Output ''

                    scp -p $ssh_port "${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename" .\\backups\\
                    
                    Write-Output "Download completed"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download failed >_<... The following is the log:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Download again? (y/N)"
                    Write-Output ''
                    if ($answer -ne 'y') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Start trying to clean old backup files..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Delete old backup file $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "An error occurred while deleting old backup file $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Cleaned $count old backup files"
            Write-Output ''
        }
        else {
            Write-Output 'No old backup files need to clean up'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}

Enregistrez ce script sous scriptname.ps1 dans le chemin où vous souhaitez télécharger la sauvegarde. Essayez « Exécuter avec Powershell ». Si cela réussit, vous pouvez passer à l’étape suivante.

Pour planifier une tâche

1. Recherchez « Tâches planifiées ».
2. Double-cliquez sur Ajouter une tâche planifiée. L’Assistant Tâche planifiée apparaît.
3. Cliquez sur Suivant, puis cliquez sur Parcourir. La boîte de dialogue Sélectionner un programme à planifier apparaît.
4. Naviguez jusqu’au script que vous avez créé, cliquez dessus, puis sur Ouvrir. Vous revenez à l’Assistant Tâche planifiée.
5. Fournissez un nom pour la tâche, ou conservez celui par défaut, qui est le nom du fichier, spécifiez la fréquence d’exécution du script, puis cliquez sur Suivant.
6. Spécifiez l’heure et la date de début (si vous avez spécifié Quotidien, Hebdomadaire, Mensuel, etc.) et la récurrence, puis cliquez sur Suivant. Cet élément doit correspondre au cycle de sauvegarde automatique de votre discourse
7. Saisissez le nom d’utilisateur et le mot de passe du compte qui exécutera le script, puis cliquez sur Suivant.
8. Si vous souhaitez configurer des propriétés avancées, cochez la case, puis cliquez sur Terminer.

@Canapin avec l’application de reconstruction du lanceur, ne doit-elle pas être exécutée comme

./launcher r build app

C’est juste la façon dont j’ai l’habitude de l’exécuter à partir d’autres documents ici sur le site. Comme j’ai appris, il y a souvent plusieurs façons de faire les choses. Lol

Bonne rédaction, pratique.