Começando com Ferramentas de Desenvolvimento

Este guia ajuda você a implantar e configurar um servidor de Ferramentas de Desenvolvimento no ServerPrism. Você aprenderá como solicitar seu servidor, entender o processo de primeira inicialização e começar a configurar a ferramenta escolhida.

Como solicitar no ServerPrism

1. Selecione um plano: Escolha um plano com pelo menos 2 GB de RAM. Para projetos maiores ou mais usuários, considere 4 GB ou mais, até 16 GB. Você pode fazer upgrade do seu plano posteriormente no painel do cliente ServerPrism.
2. Escolha uma região: Selecione o local do data center mais próximo de você ou de seus usuários principais para obter o melhor desempenho.
3. Escolha seu runtime: Durante o processo de pedido, selecione a ferramenta de desenvolvimento específica que deseja instalar (por exemplo, Code-Server, Forgejo, Gitea). Ela será instalada automaticamente.
4. Implantar: Conclua seu pedido, e seu servidor começará a ser provisionado.

Primeira inicialização

Após a implantação, seu servidor iniciará automaticamente. O processo de inicialização inicial instala todos os componentes necessários para a ferramenta de desenvolvimento escolhida. Você pode monitorar o progresso na aba Console do painel ServerPrism.

Seu servidor estará pronto quando você vir uma saída indicando que o serviço foi iniciado com sucesso, muitas vezes mostrando uma porta de escuta ou uma mensagem de sucesso específica da ferramenta (por exemplo, "Server started", "Listening on port XXXX").

Conectando / convidando jogadores

Os métodos de conexão variam dependendo da ferramenta que você escolheu:

• Code-Server, Forgejo, Gitea, Haste-Server, LanguageTool, Reposilite: Essas ferramentas são geralmente acessadas por meio de um navegador da web. O endereço IP e a porta do seu servidor serão exibidos no painel ServerPrism na aba Network. Para facilitar o acesso, você pode anexar um subdomínio gratuito do seu painel de cliente ServerPrism.
  • Exemplo de URL: http://your_server_ip:port ou http://your-subdomain.serverprism.me:port
• Code-Server: Certifique-se de anotar qualquer senha gerada na saída do console durante a primeira inicialização, pois ela é necessária para acessar sua instância do VS Code no navegador.

Noções básicas de configuração

A maioria das configurações iniciais pode ser feita através da interface web da ferramenta escolhida, uma vez que esteja em execução. Para configurações de nível de servidor ou variáveis de ambiente, use o painel ServerPrism.

Etapas de Configuração Geral:

1. Acesse a Interface Web: Navegue até o IP e a porta do seu servidor em um navegador da web.
2. Configuração Inicial: Siga as instruções na tela para a configuração inicial, como criar um usuário administrador, definir um título do site ou configurar o armazenamento.

Notas de Configuração Específicas da Ferramenta:

• Code-Server: A senha inicial pode ser impressa no console na primeira inicialização. Você pode frequentemente alterá-la ou configurar a autenticação via variáveis de ambiente na aba Startup do painel ServerPrism (por exemplo, PASSWORD=yournewsecurepassword).
• Forgejo / Gitea: Durante a configuração web inicial, você configurará o banco de dados, o usuário administrador e o caminho raiz do repositório. Certifique-se de que as configurações do banco de dados correspondam ao padrão (geralmente SQLite para simplicidade, ou externo se você o configurar).
• Haste-Server: Os arquivos de configuração geralmente estão localizados no diretório do servidor (por exemplo, config.js). Você pode editá-los usando o File Manager do painel ServerPrism ou via SFTP. As configurações comuns incluem o backend de armazenamento (sistema de arquivos ou Redis) e a porta.
• LanguageTool: A configuração é frequentemente feita via server.cfg ou parâmetros de inicialização. Verifique a aba Startup no painel ServerPrism para as variáveis disponíveis para personalizar memória, modelos de linguagem ou porta.
• Reposilite: A configuração é principalmente tratada por reposilite.yml no diretório de trabalho do servidor. Use o File Manager para configurar usuários, repositórios e configurações de segurança.

Muitas ferramentas permitem ajustar as configurações via Startup Variables no painel ServerPrism. Verifique a aba Startup para as opções disponíveis específicas do seu runtime selecionado.

Problemas comuns

• "Site não pode ser alcançado" ou conexão recusada:
  • Verifique o status do servidor: Certifique-se de que seu servidor esteja em execução no painel ServerPrism.
  • Firewall: O ServerPrism lida automaticamente com as regras básicas de firewall para o seu serviço. Se você modificou algo manualmente ou está usando uma porta não padrão, certifique-se de que ela esteja aberta.
  • Incompatibilidade de porta: Verifique se você está usando a porta correta listada na aba Network do painel ServerPrism.
• Senha do Code-Server perdida: Se você esquecer a senha do Code-Server, muitas vezes pode redefini-la definindo uma nova variável de ambiente PASSWORD na aba Startup do seu painel ServerPrism e reiniciando o servidor.
• Avisos de espaço em disco (Forgejo/Gitea): Se você hospedar muitos repositórios, pode eventualmente ficar com pouco espaço em disco. Você pode fazer upgrade do seu plano de servidor no painel do cliente ServerPrism para obter mais armazenamento.
• Desempenho lento:
  • RAM: Se sua ferramenta estiver funcionando lentamente, especialmente sob carga, você pode precisar de mais RAM. Você pode fazer upgrade do seu plano de servidor no painel do cliente ServerPrism.
  • Configuração: Revise a documentação específica da sua ferramenta para otimização de desempenho (por exemplo, otimização de banco de dados para Forgejo/Gitea, configurações de JVM para LanguageTool/Reposilite).

Se você encontrar problemas persistentes, colete o ID do seu servidor e os logs relevantes da aba Console e abra um ticket de suporte em https://serverprism.com/tickets.

Próximas etapas

Uma vez que sua ferramenta de desenvolvimento esteja em execução, você pode explorar mais personalizações:

• Integrações: A maioria das ferramentas oferece integrações com outros serviços (por exemplo, Git hooks para Forgejo/Gitea, extensões para Code-Server).
• Troca de Runtime: Se você decidir que uma ferramenta de desenvolvimento diferente atenderia melhor às suas necessidades, você pode trocar de runtime diretamente na aba Startup do seu painel ServerPrism. Isso permite instalar uma ferramenta diferente sem precisar solicitar um novo servidor.
• Backup: Faça backup regularmente de quaisquer dados críticos, especialmente para soluções de hospedagem de código como Forgejo e Gitea. Você pode baixar arquivos via SFTP ou o File Manager do ServerPrism.