Estou escrevendo uma documentação curta para administradores de fóruns Discourse que ajudei a configurar. Estou esquecendo algo nela?

[Canapin (Coin-coin le Canapin)]

Configurei fóruns Discourse para vários amigos/associações. Gostaria que eles fossem mais autônomos na administração, de modo que eu tivesse menos probabilidade de intervir pessoalmente.

Eles usam o Discourse como usuários e co-administradores há meses ou anos. Eles não são “novos administradores”, mas lhes falta conhecimento aprofundado sobre como manter o Discourse diariamente (além do básico de moderação) e o que deve ser conhecido, como administrador, e em caso de problemas técnicos, pois eu sempre estive aqui para cuidar dessas coisas.

Ainda estarei disponível no futuro, mas o objetivo é permitir que eles rastreiem e resolvam as questões mais comuns por conta própria.

Aqui está o que escrevi até agora (traduzido automaticamente para o inglês porque meu texto será escrito em francês, então não se preocupe se algumas frases estiverem estranhas):

---

Atualizações

Via a interface web

Execute as atualizações quando houver um emoji de carinha triste vermelho no painel de administração (isso significa que há uma atualização importante a ser aplicada).
As atualizações são feitas via:
https://tonforum.fr/admin/upgrade

Às vezes, elas são feitas em duas etapas: você deve primeiro atualizar o “Docker_Manager” antes de poder atualizar o restante:

Via a linha de comando

Às vezes, uma atualização deve ser feita via linha de comando (a página de administração do Discourse indicará explicitamente se for necessário).

1. Conecte-se ao servidor via SSH
2. Reconstrua o fórum (uma reconstrução sempre atualiza o Discourse) usando o seguinte comando:

3. /var/discourse/launcher rebuild app
   

4. De tempos em tempos, depois de confirmar que o fórum está funcionando corretamente, pode ser útil remover imagens do Docker não utilizadas (restos de atualizações anteriores) para liberar espaço em disco:

   /var/discourse/launcher cleanup
   

Localização de arquivos importantes no servidor

app.yml

Contém a configuração do servidor e a lista de plugins instalados. Muito útil se você precisar migrar o fórum para outro servidor ou aplicar certas configurações (por exemplo, mover uploads e backups para outro disco). Ele está localizado aqui:

/var/discourse/containers/app.yml

mail-receiver.yml

Contém a configuração para o software que permite receber respostas por e-mail e publicá-las no fórum. Ele está localizado aqui:

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

Backups

Os arquivos de backup são armazenados aqui:

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

Páginas importantes na administração do fórum

Algumas páginas que podem ser úteis

Temas e componentes

Eles incluem CSS e HTML personalizados:

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

Logs

E-mail

Útil para depuração:

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

Ações da equipe

Muito útil. Ele mantém um registro de (quase) todas as alterações de configuração do site e outras ações realizadas por moderadores e administradores.

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

Logs de erro

Pode fornecer pistas quando um problema não é óbvio:

https://tonforum.fr/logs/

Backups

Para alterar a frequência de backup e o número máximo de backups, visualizá-los ou baixá-los:

https://tonforum.fr/admin/backups

Recursos

https://meta.discourse.org
Suporte oficial. Não hesite em postar lá; os membros da comunidade e os desenvolvedores geralmente são muito prestativos.

---

Você vê algo que poderia ser adicionado/removido? Acho que posso remover a parte /logs/, pois é muito, muito raramente útil. Eu nem tenho certeza se encontrei informações úteis nela em muitos anos administrando algumas instâncias.

[Ed_S]

Algumas coisas que eu gostaria de deixar claras.

Uma é, no momento de tentar uma atualização pela interface web, esteja ciente de que a atualização pode falhar e seu fórum pode ficar fora do ar. Esteja preparado.

Outra é, se o seu host se tornar inacessível ou corrompido, você precisará dos arquivos de backup e dos arquivos yml. Você precisará tê-los salvos em um local seguro em um sistema separado.

Para combinar as duas: sempre faça um backup e baixe o backup, antes de tentar uma atualização.

[Heliosurge (Dan DeMontmorency)]

Olá Ed, pontos muito válidos. Um membro há algum tempo criou um script para fazer backup em outro sistema, se bem me lembro. Precisarei pesquisar e verificar.

Aqui está um trecho da postagem original. Canapin tem uma boa resposta com um link para fazer backup no Google Drive/Dropbox também.

@Lhc_fl

Recentemente, uma amiga minha se deparou com o problema de o provedor de VPS fechar repentinamente sem aviso. Infelizmente, em prol de economizar, ela escolheu um provedor de nicho — um que nem sequer oferecia a opção de download de dados. O que é pior, ela nem tem o hábito de baixar backups regularmente. Da noite para o dia, o site dela desapareceu, juntamente com todos os dados contidos nele.

Chocada com isso, escrevi um script em Powershell que baixará automaticamente backups do seu servidor para o seu computador local regularmente, sem a necessidade de adquirir serviços adicionais de armazenamento de objetos ou gastar um centavo em outras coisas. Tudo o que você precisa é de um computador Windows que você usa regularmente (e que tenha bastante espaço em disco) e esteja conectado à Internet.

O script limpará automaticamente os backups com mais de 5 dias. Você pode definir o intervalo de backup automático e o tempo do backup mais antigo salvo localmente de acordo com suas necessidades.

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


Write-Output "Iniciando a tarefa de download de backup do Discourse..."
Write-Output '------------------------'
Write-Output "Buscando o arquivo de backup mais recente..."
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 "Falha ao buscar... Aqui está o log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Deseja buscar novamente? (s/N)"
            if ($answer -ne 's') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Erro: Falha ao buscar o nome do arquivo $filename"
        Write-Output ''
        $answer = Read-Host 'Tentar novamente?(s/N)'
  
        if ($answer -eq 's') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Backup mais recente: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename já existe. Deseja baixá-lo novamente?(s/N)"
            Write-Output ''
            if ($answer -ne 's') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Iniciando o download..."
            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 concluído"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download falhou >_<... O log a seguir:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Baixar novamente? (s/N)"
                    Write-Output ''
                    if ($answer -ne 's') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Iniciando a tentativa de limpeza de arquivos de backup antigos..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Excluindo arquivo de backup antigo $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Ocorreu um erro ao excluir o arquivo de backup antigo $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Foram limpos $count arquivos de backup antigos"
            Write-Output ''
        }
        else {
            Write-Output 'Nenhum arquivo de backup antigo precisa ser limpo'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}

Salve o script acima como nomedoscript.ps1 no caminho onde deseja baixar o backup. Tente “Executar com Powershell”. Se for bem-sucedido, você pode prosseguir para a próxima etapa.

Para agendar uma tarefa

1. Pesquise por “Agendador de Tarefas”.
2. Dê um duplo clique em Adicionar Tarefa Agendada. O Assistente para Agendamento de Tarefas é exibido.
3. Clique em Avançar e depois em Procurar. A caixa de diálogo Selecionar Programa para Agendar aparece.
4. Navegue até o script que você criou, clique nele e depois em Abrir. Você retorna ao Assistente para Agendamento de Tarefas.
5. Forneça um nome para a tarefa, ou mantenha o padrão, que é o nome do arquivo, especifique com que frequência executar o script e clique em Avançar.
6. Especifique a hora e a data de início (se você especificou Diariamente, Semanalmente, Mensalmente, etc.) e recorrência, e clique em Avançar. Este item deve corresponder ao ciclo de backup automático do seu discourse
7. Digite o nome de usuário e a senha da conta que executará o script e clique em Avançar.
8. Se desejar configurar propriedades avançadas, selecione a caixa de seleção e clique em Concluir.

@Canapin com o aplicativo de reconstrução do launcher, ele não precisa ser executado como

./launcher r build app

É assim que tenho usado para executá-lo a partir de outros documentos aqui no site. Como aprendi, muitas vezes há muitas maneiras de fazer as coisas. Lol

Ótima descrição, útil.