Poderia a documentação de instalação abordar mais situações?

Tenho certeza de que estas instruções funcionam bem para aqueles que usam servidores em nuvem dedicados ao propósito de hospedar apenas o Discourse.

Mas pode haver um número bastante grande de pessoas que desejam instalá-lo em hosts que já executam servidores web e de e-mail (e entendem as desvantagens de desempenho declaradas).

Percebo que existe uma categoria de “documentação” aqui, onde pelo menos parte dessas informações pode ser encontrada. Mas usar um fórum de discussão como plataforma de documentação não é ideal - por razões que espero serem óbvias.

Se eu enviasse um documento de instalação modificado para o repositório (ou seja, instruções que ainda assumem Docker e cobrem servidores em nuvem como estão, mas também atendem a casos com configurações existentes de Nginx ou Apache) isso seria aceito? Isso significaria algumas modificações no INSTALL-cloud.md existente para torná-lo legível.

Existe documentação. É só que você precisa entender tanto o Discourse quanto como os proxies reversos funcionam.

Configurar o Discourse em um servidor com sites Apache existentes

Usar o Nginx Proxy Manager para gerenciar vários sites com o Discourse

Eu pensei que havia outro para nginx, mas não consegui encontrá-lo na caixa de pesquisa do link.

Concordo que há documentação. Só que ela não está em um formato adequado (ou não é detectável, como você mostrou) em comparação com a forma como é apresentada no repositório do GH.

Olá @gilgongo, você já deu uma olhada em Documentation - Discourse Meta?

Até certo ponto, a documentação disponível representa o escopo limitado do suporte gratuito que podemos oferecer aqui.

Um VPS novo na DigitalOcean é uma quantidade conhecida. Essa abordagem nos permite fornecer etapas fáceis de seguir e que quase garantem uma instalação funcional no final.

Não podemos realmente levar em conta todas as outras configurações de servidor compartilhado, implantação local e instalação de hobby.

Se você quiser aprender como instalar o Discourse, a boa notícia é que os custos de um droplet na DigitalOcean são proporcionais. Um VPS de US$ 6 custará apenas US$ 0,20 por dia para manter como referência conhecida enquanto você tenta instalar o Discourse em um ambiente mais complexo.

2 curtidas

Eu olhei a seção de documentação - na verdade, eu me refiro a ela na minha postagem acima.

Mas eu não quero causar problemas. Eu aceito que você não pode atender a todos os ambientes (mesmo que você esteja usando o Docker “roda em qualquer lugar”). Eu estava apenas curioso.

1 curtida

4 posts foram divididos em um novo tópico: Documentação em um fórum de discussão

5 posts foram mesclados em um tópico existente: Documentação em um fórum de discussão

Desculpe, não fui claro: por “enviar” quis dizer um pull request para o repositório onde este reside, não postar nos fóruns.

Suponho que as razões pelas quais as discussões não são ideais para a documentação sejam as mesmas razões para o plugin “discourse docs”, que parece abordar todas essas razões muito bem.

(Como aparte, nada disso tem relevância para a pergunta original que postei, o que acho que demonstra perfeitamente o problema que eu estava querendo abordar! Hora da ironia.)

1 curtida

Entendi desde o início. Minha resposta (e eu não tenho controle sobre nenhum repositório oficial do Discourse) é “não”. A solução recomendada é extremamente simples e tem o mínimo de variáveis possível. Ela foi projetada para funcionar para pessoas que nunca usaram a linha de comando. Assim que você começa a colocar um proxy reverso “simples” na frente das coisas, as maneiras como alguém pode quebrar as coisas explodem exponencialmente.

Não se trata apenas de descompactar (ou extrair) mais um diretório PHP e adicionar outro arquivo a hosts-enabled. Você precisa saber o que é um proxy reverso, entender algo sobre portas, ou talvez nomes de host do docker, e sobre como configurar https, e definir force_https no contêiner, e adicionar alguma mágica para fazer o IP real passar pelo proxy reverso. É difícil o suficiente que você não quer que qualquer pessoa que não entenda pelo menos a maior parte disso de antemão o encontre por engano e depois se pergunte por que não está funcionando.

Entendi desde o início. Minha resposta (e eu não tenho controle sobre nenhum repositório oficial do Discourse) é “não”.

Haha, eu não estava respondendo a você! Isso fica cada vez mais confuso à medida que avançamos, sinto muito.

Olha, vamos deixar isso pra lá. Talvez alguém possa apagar todo o tópico. Eu não deveria ter levantado nada disso em nome daqueles que não podem instalar o Discourse da maneira suportada.

1 curtida