¿Me estoy perdiendo algo en ella?

Canapin · 27 Diciembre, 2025 17:47

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’ai toujours été 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 étrangement écrites) :

Mises à jour

Via l’interface web

Exécutez les mises à jour lorsqu’il y a un smiley rouge mécontent dans le panneau d’administration (cela signifie qu’il y a une mise à jour importante à appliquer).
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 le dira explicitement si nécessaire).

Connectez-vous au serveur via SSH
Reconstruisez le forum (une reconstruction met toujours à jour Discourse) en utilisant la commande suivante :
```
/var/discourse/launcher rebuild app
```
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’avoir trouvé des informations utiles dedans en de nombreuses années d’administration de quelques instances.

Ed_S · 27 Diciembre, 2025 21:42

Un par de cosas que me gustaría dejar claras.

Una es que, en el momento de intentar una actualización a través de la interfaz web, tenga en cuenta que la actualización puede fallar y su foro puede caerse. Esté preparado.

Otra es que, si su host se vuelve inaccesible o se corrompe, necesitará los archivos de respaldo y los archivos yml. Deberá tenerlos ya guardados en un lugar seguro en un sistema separado.

Para combinar las dos: haga siempre una copia de seguridad y descargue la copia de seguridad antes de intentar una actualización.

Heliosurge · 27 Diciembre, 2025 22:58

Hola Ed, puntos muy válidos. Recuerdo que un miembro creó un script para hacer copias de seguridad en otro sistema. Tendré que buscar y comprobar.

Aquí hay un extracto de la publicación original. Canapin tiene una buena respuesta con un enlace para hacer copias de seguridad en Google Drive/Dropbox también.

Lhc_fl:

Recientemente, un amigo mío se encontró con el problema de que el proveedor de VPS cerró repentinamente sin previo aviso. Desafortunadamente, por ahorrar dinero, eligió un proveedor de nicho, uno que ni siquiera ofrecía descargas de datos. Lo que es peor es que ni siquiera tiene la costumbre de descargar copias de seguridad regularmente. De la noche a la mañana, su sitio desapareció, junto con todos los datos que contenía.

Conmocionado por esto, escribí un script de Powershell que descargará automáticamente las copias de seguridad de su servidor a su computadora local de forma regular sin tener que comprar servicios adicionales de almacenamiento de objetos ni gastar un centavo en otras cosas. Todo lo que necesita es una computadora con Windows que use regularmente (y que tenga mucho espacio en el disco duro) y que esté conectada a Internet.

El script limpiará automáticamente las copias de seguridad de hace 5 días. Puede configurar el intervalo de copia de seguridad automática y el tiempo de la copia de seguridad más antigua guardada localmente según sus necesidades.
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Iniciando la tarea de descarga de copia de seguridad de Discourse..."
Write-Output '------------------------'
Write-Output "Obteniendo el último archivo de copia de seguridad..."
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 "Fallo al obtener... Aquí está el registro:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "¿Desea volver a obtener? (s/N)"
            if ($answer -ne 's') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Error: Falló al obtener el nombre del archivo $filename"
        Write-Output ''
        $answer = Read-Host '¿Reintentar?(s/N)'
  
        if ($answer -eq 's') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Copia de seguridad más reciente: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename ya existe. ¿Desea descargarlo de nuevo?(s/N)"
            Write-Output ''
            if ($answer -ne 's') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Iniciando descarga..."
            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 "Descarga completada"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "La descarga falló >_<... El siguiente es el registro:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "¿Volver a descargar? (s/N)"
                    Write-Output ''
                    if ($answer -ne 's') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Comenzando a intentar limpiar archivos de copia de seguridad antiguos..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Eliminando archivo de copia de seguridad antiguo $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Ocurrió un error al eliminar el archivo de copia de seguridad antiguo $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Se limpiaron $count archivos de copia de seguridad antiguos"
            Write-Output ''
        }
        else {
            Write-Output 'No hay archivos de copia de seguridad antiguos que limpiar'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
Guarde el script anterior como nombre_del_script.ps1 en la ruta donde desea descargar la copia de seguridad. Pruebe “Ejecutar con Powershell”. Si tiene éxito, puede continuar con el siguiente paso.

Para programar una tarea

Busque “Tareas programadas”.

Haga doble clic en Agregar tarea programada. Aparece el Asistente para tareas programadas.

Haga clic en Siguiente y luego en Examinar. Aparece el cuadro de diálogo Seleccionar programa para programar.

Navegue hasta el script que creó, haga clic en él y luego en Abrir. Vuelve al Asistente para tareas programadas.

Proporcione un nombre para la tarea, o conserve el predeterminado, que es el nombre del archivo, especifique con qué frecuencia ejecutar el script y luego haga clic en Siguiente.

Especifique la hora y fecha de inicio (si especificó Diario, Semanal o Mensual, etc.) y recurrencia, luego haga clic en Siguiente. Este elemento debe coincidir con el ciclo de copia de seguridad automática de su discourse

Escriba el nombre de usuario y la contraseña de la cuenta que ejecutará el script y luego haga clic en Siguiente.

Si desea configurar propiedades avanzadas, seleccione la casilla de verificación y luego haga clic en Finalizar.

@Canapin con la aplicación de reconstrucción del lanzador, ¿no necesita ejecutarse como

./launcher r build app

Así es como he estado acostumbrado a ejecutarlo a partir de otros documentos aquí en el sitio. Como he aprendido, a menudo hay muchas maneras de hacer las cosas. Jaja

Buena redacción, útil.

NateDhaliwal · 28 Diciembre, 2025 00:56

Pero como harías cd /var/discourse antes de eso, ./ simplemente se referiría a ese directorio, entonces la ruta de launcher es esencialmente /var/discourse/launcher, ¿no?

Heliosurge · 28 Diciembre, 2025 03:58

No estaba al tanto de eso. Lo he estado usando según otros tutoriales sobre Discourse. Pero tiene sentido. Gracias.

Ed_S · 28 Diciembre, 2025 06:01

Me pregunto si vale la pena agregar algunos consejos de escalada. Si la persona que lee el documento no sabe cómo usar ssh en el host para investigar o solucionar problemas, ¿quién puede? Quizás un consejo sobre cómo hacer preguntas aquí en meta, quizás también un consejo sobre cómo usar ask.

Jonathan5 · 28 Diciembre, 2025 23:42

Eso es bueno saberlo. Solo sabía sobre la descarga de la copia de seguridad creada por el propio foro.

Canapin · 29 Diciembre, 2025 14:09

¡Gracias por tu ayuda!

He añadido esto al principio de mi guía:

Asegúrate de estar preparado para cualquier situación

Se recomienda encarecidamente, además de las copias de seguridad locales (guardadas en el mismo servidor que el foro), tener una copia de estas copias de seguridad en otro servidor o en la nube^[1].

También es útil guardar una copia del archivo /var/discourse/containers/app.yml en un lugar seguro^[2]. Este archivo opcional se utiliza en caso de reinstalación del foro o migración a otro servidor.

Si tienes alguna duda seria sobre algo, contáctame (canapin@gmail.com).

He añadido esto en la sección de actualización:

Antes de realizar una actualización, se recomienda encarecidamente descargar la última copia de seguridad de tu foro.

He añadido esto:

¿Qué hacer si el foro deja de funcionar?

Reconstruir el foro soluciona muchos problemas y se realiza con el mismo comando que una actualización desde la línea de comandos:
/var/discourse/launcher rebuild app
¿Qué pasa si el foro sigue sin funcionar después de una reconstrucción?

Pregúntame (canapin@gmail.com) o publica en el foro de soporte oficial.

También mencioné ask.discourse.org al final de la guía.

Recursos

https://meta.discourse.org : soporte oficial, no dudes en publicar allí; los miembros de la comunidad y los desarrolladores son muy serviciales
https://ask.discourse.com : un chatbot entrenado con datos y soporte de Discourse, sorprendentemente efectivo para responder preguntas (sí, de verdad)

Texto completo

Asegúrate de estar preparado para cualquier situación

Se recomienda encarecidamente, además de las copias de seguridad locales (guardadas en el mismo servidor que el foro), tener una copia de estas copias de seguridad en otro servidor o en la nube^[1:1].

También es útil guardar una copia del archivo /var/discourse/containers/app.yml en un lugar seguro^[2:1]. Este archivo opcional se utiliza en caso de reinstalación del foro o migración a otro servidor.

Si tienes alguna duda seria sobre algo, contáctame (canapin@gmail.com).

Actualizaciones

Antes de realizar una actualización, se recomienda encarecidamente descargar la última copia de seguridad de tu foro.

A través de la interfaz

Realiza las actualizaciones cuando aparezca una carita sonriente roja de descontento en el administrador (significa que hay una actualización importante que hacer).
Las actualizaciones se realizan a través de https://túforo.com/admin/upgrade

A veces se realizan en dos pasos: primero debes actualizar “Docker_Manager” antes de poder actualizar el resto:

A través de la línea de comandos

A veces, una actualización debe realizarse a través de la línea de comandos (la página de administración de Discourse te lo indicará si es necesario).

Conéctate al servidor a través de SSH
Reconstruye el foro (una reconstrucción siempre actualiza Discourse) usando el siguiente comando:
```
/var/discourse/launcher rebuild app
```
De vez en cuando, después de asegurarte de que el foro funciona correctamente, puede ser útil eliminar las imágenes de Docker no utilizadas (restos de actualizaciones anteriores) para liberar espacio en disco:
```
/var/discourse/launcher cleanup
```

¿Qué hacer si el foro deja de funcionar?

Reconstruir el foro soluciona muchos problemas y se realiza con el mismo comando que una actualización desde la línea de comandos:

/var/discourse/launcher rebuild app

Creo que ahora está bastante bien y que no me falta nada importante

Si instalé tu foro, tus copias de seguridad se copian automáticamente en mi Google Drive, pero idealmente en el futuro deberían guardarse en un espacio del que tú seas responsable. Hablaremos de ello algún día ↩︎ ↩︎
Contiene el nombre de usuario y la contraseña del servidor de correo, así como el correo electrónico del administrador de nivel superior (el mío, en realidad). ↩︎ ↩︎

Jonathan5 · 29 Diciembre, 2025 18:52

Si esto funciona, sería una recomendación mejor (más simple) que la versión habitual de dos líneas (que solía ser de tres, así que podemos continuar la tendencia).

merefield · 29 Diciembre, 2025 19:16

Ambos funcionan.

Si estás en el directorio ./ es necesario porque la ubicación del lanzador no está en la ruta (path).

Linux requiere que si un comando no está en la ruta, le proporciones su ruta completa para que no haya duda sobre qué archivo quisiste decir.

merefield · 29 Diciembre, 2025 19:19

Sí, pero a menudo podrías estar haciendo varias cosas, por ejemplo, una limpieza primero. En cuyo caso, cambiar de directorio primero podría resultar más breve.

Andrew_Rowe · 30 Diciembre, 2025 02:27

Estoy de acuerdo y he marcado el tema para uso futuro, gracias

Canapin · 30 Diciembre, 2025 16:17

Bueno, aquí tienes la guía completa traducida automáticamente:

Asegurarse de estar preparado para cualquier eventualidad

Se recomienda encarecidamente, además de las copias de seguridad locales (almacenadas en el mismo servidor que el foro), tener una copia de esas copias de seguridad en otro servidor o en la nube^[1].

También es útil guardar una copia del archivo /var/discourse/containers/app.yml en un lugar seguro^[2]. Este archivo opcional es útil en caso de reinstalación del foro o migración a otro servidor.

~~Si tienes alguna duda seria sobre algo, contáctame.~~

Actualizaciones

Antes de realizar una actualización, se recomienda encarecidamente descargar la última copia de seguridad de tu foro.

A través de la interfaz

Realiza las actualizaciones cuando aparezca una carita sonriente roja de descontento en el administrador (significa que hay una actualización importante que hacer).
Las actualizaciones se realizan a través de https://tonforum.fr/admin/upgrade

A veces ocurren en dos pasos: primero debes actualizar “Docker_Manager” antes de poder actualizar el resto:

A través de la línea de comandos

A veces hay que realizar una actualización a través de la línea de comandos (la página de administración de Discourse te lo indicará si es necesario).

Conéctate al servidor vía SSH
Recompila el foro (una reconstrucción siempre actualiza Discourse) usando el siguiente comando:
```
/var/discourse/launcher rebuild app
```
De vez en cuando, después de asegurarte de que el foro funciona correctamente, puede ser útil eliminar las imágenes de Docker no utilizadas (restos de actualizaciones anteriores) para liberar espacio en disco:
```
/var/discourse/launcher cleanup
```

¿Qué hacer si el foro deja de funcionar?

Recompilar el foro soluciona muchos problemas y se realiza con el mismo comando que una actualización a través de la línea de comandos:

/var/discourse/launcher rebuild app

¿Qué pasa si el foro sigue sin funcionar después de una reconstrucción?

~~Pregúntame a mí o~~ publica en el foro oficial de soporte.

Ubicación de archivos importantes en el servidor

`app.yml`

Contiene la configuración del servidor y la lista de plugins instalados. Muy útil si el foro necesita moverse a otro servidor, o para ciertas configuraciones (mover subidas y copias de seguridad a otro disco, por ejemplo). Se encuentra aquí:

/var/discourse/containers/app.yml

`mail-receiver.yml`

Contiene la configuración del software que permite recibir y publicar respuestas por correo electrónico en el foro. Se encuentra aquí:

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

Copias de seguridad

Los archivos de copia de seguridad se encuentran aquí:

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

Páginas importantes en el administrador del foro:

Páginas que pueden ser útiles

Temas y componentes

Contienen, entre otras cosas, CSS y HTML personalizados:

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

Registros (Logs)

Correo electrónico

Útil para depurar:

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

Acciones del personal

Muy útil. Mantiene un registro de (casi) todos los cambios de configuración del sitio y otras acciones de moderadores y administradores.

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

Registros de errores

Pueden dar pistas cuando hay un problema cuya causa no es obvia.

https://tonforum.fr/logs/

Copias de seguridad

Para cambiar la frecuencia y el número máximo de copias de seguridad, verlas o descargarlas:

https://tonforum.fr/admin/backups

Recursos

https://meta.discourse.org : soporte oficial, no dudes en publicar allí, los miembros y desarrolladores estarán encantados de ayudar
https://ask.discourse.com : un chatbot entrenado con el soporte y los datos de Discourse, sorprendentemente efectivo para responder preguntas (sí, de verdad)

Si instalé tu foro, tus copias de seguridad se copian automáticamente a mi Google Drive, pero idealmente en el futuro deberían guardarse en un espacio del que tú seas responsable. Ya hablaremos de ello algún día ↩︎
Contiene el identificador y la contraseña del servidor de correo, así como el correo electrónico del administrador ~~(el mío, en realidad)~~. ↩︎

Tema		Respuestas	Vistas
MKJ's Opinionated Discourse Deployment Configuration Sysadmins explanation , install	32	6732	15 Diciembre 2025
Problem when updating Discourse Forum Installation unsupported-install	20	2011	29 Junio 2023
Digital Ocean hosting: Do I need a system admin? Hosting	28	6701	14 Diciembre 2017
How to backup and restore a whole /var/discourse app folder? Installation	17	5554	19 Junio 2020
Improving import and export support Feature	29	8433	8 Octubre 2014

¿Me estoy perdiendo algo en ella?

Mises à jour

Via l’interface web

Via la ligne de commande

Emplacement des fichiers importants sur le serveur

app.yml

mail-receiver.yml

Sauvegardes (Backups)

Pages importantes dans l’administration du forum

Thèmes et composants

Journaux (Logs)

E-mail

Actions du personnel (Staff actions)

Journaux d’erreurs (Error logs)

Sauvegardes (Backups)

Ressources

Asegúrate de estar preparado para cualquier situación

¿Qué hacer si el foro deja de funcionar?

¿Qué pasa si el foro sigue sin funcionar después de una reconstrucción?

Recursos

Asegúrate de estar preparado para cualquier situación

Actualizaciones

A través de la interfaz

A través de la línea de comandos

¿Qué hacer si el foro deja de funcionar?

Asegurarse de estar preparado para cualquier eventualidad

Actualizaciones

A través de la interfaz

A través de la línea de comandos

¿Qué hacer si el foro deja de funcionar?

¿Qué pasa si el foro sigue sin funcionar después de una reconstrucción?

Ubicación de archivos importantes en el servidor

app.yml

mail-receiver.yml

Copias de seguridad

Páginas importantes en el administrador del foro:

Temas y componentes

Registros (Logs)

Correo electrónico

Acciones del personal

Registros de errores

Copias de seguridad

Recursos

Temas relacionados

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`