Administradores # Rode seu próprio servidor Welley Nossa ferramenta de linha de comando instala tudo o que o Welley precisa em uma máquina Linux. Pode ser um servidor na nuvem ou o seu próprio hardware. [Ler: Início rápido: implantação mínima do Welley](https://welley.com/pt/administrators/docs/quick-start/) [Ler: Welley CLI](https://welley.com/pt/administrators/docs/cli/) [Instale o Docker Engine](https://docs.docker.com/engine/install/) Planejamos lançar o Welley como código aberto no futuro. Ainda não há data de lançamento nem licença anunciadas. ## Prepare o host, o DNS e o e-mail Estes são os requisitos iniciais do guia de início rápido. A capacidade de que você precisa depende dos seus usuários e da carga de trabalho. ### Host Linux - Ubuntu 24.04 LTS ou uma distribuição atual parecida. - Comece com 2 vCPU, 4 GB de RAM e 60 GB de disco. - Use um endereço IPv4 público fixo e um usuário não root com sudo. ### Rede - Permita conexões TCP de entrada nas portas 80 e 443 a partir da internet. Permita TCP 22 a partir da sua própria rede. - Mantenha a porta 80 livre para o desafio do certificado e para a renovação semanal do certificado. ### DNS do site - Aponte seu domínio e storage. para o endereço IP do host. - Crie os dois registros antes de instalar. A CLI verifica os registros e interrompe o processo se eles não resolverem para o host. ### SMTP e e-mail do administrador - Deixe à mão o host SMTP, o usuário, a senha e o endereço de remetente. O padrão é STARTTLS na porta 587. - Você também vai precisar de um e-mail de administrador para o primeiro login e para a recuperação de senha. ### DNS do e-mail - Configure SPF, DMARC e o DKIM que o seu provedor gera, para o domínio do endereço de remetente. - Use o valor exato de SPF do seu provedor. Incorpore-o ao registro SPF que você já tem, em vez de adicionar um segundo. - A CLI avisa se faltar SPF ou DMARC. Ela não consegue verificar o seletor DKIM do seu provedor. ## Instale o Docker Engine e o Compose Siga as instruções oficiais do Docker para a sua distribuição Linux. Depois, dê ao usuário de implantação acesso ao Docker. [Instalação do Docker Engine](https://docs.docker.com/engine/install/) ### Adicione o usuário ao grupo do Docker Troque pelo seu usuário de implantação não root. Depois de rodar este comando, saia da sessão e entre de novo. ``` sudo usermod -aG docker ``` ### Confira o Docker e o Compose Os dois comandos precisam funcionar para esse usuário. ``` docker ps docker compose version ``` ## Baixe a CLI Escolha o binário da máquina em que você vai rodar a CLI. O próprio host de implantação precisa rodar Linux. ### Linux, x86-64 ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/amd64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### Linux, ARM64 ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/arm64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### macOS, Apple silicon ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/arm64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### macOS, Intel ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/amd64" -o wlycli chmod +x wlycli ./wlycli -v ``` - Estes comandos baixam do canal estável e mostram a versão da CLI. - A versão muda a cada novo lançamento. Use a documentação mais recente da CLI na hora de instalar. ## Crie a implantação Rode este comando no host Linux que você preparou. Troque os valores de exemplo de domínio, e-mail e SMTP pelos seus. ``` ./wlycli deploy create \ -d example.com \ -e admin@example.com \ --smtp-host smtp.example.com \ --smtp-user "$MAIL_USER" \ --smtp-password "$MAIL_PASSWORD" \ --smtp-from noreply@example.com ``` | Configuração | Padrão | | --- | --- | | Diretório de instalação | ~/.welley/. O domínio de exemplo gera o nome de projeto example\_com. | | Banco de dados | PostgreSQL incluído, com os dados dentro do diretório de instalação. | | Stack | Plataforma Welley, pipeline de RAG, Nginx, Redis e PostgreSQL, com contêineres de manutenção. | | Certificados | Let’s Encrypt via Certbot, com renovação semanal. | | Mídia | Uploads e arquivos estáticos em https://storage.. | | Atualizações | Canal estável, verificado todo dia. O processo de atualização evita indisponibilidade sempre que possível. | | Serviços opcionais | A configuração mínima não adiciona banco de dados gerenciado, CDN, telemetria nem integração com o Slack. | - Antes de rodar, defina MAIL\_USER e MAIL\_PASSWORD com as suas credenciais SMTP. - O guia de início rápido exige estas seis flags. - O comando verifica o DNS, grava os arquivos da implantação, obtém um certificado com o Certbot e inicia os contêineres. - O comando deploy é um alias de deployment. ## Entre e confira o resultado A senha de administrador gerada está no log da plataforma. Mantenha essa saída em sigilo. ### Encontre a senha inicial Este nome de contêiner vale para example.com. Para o seu domínio, troque o nome do projeto. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Entrar Abra seu domínio e entre com o e-mail de administrador que você informou com -e. Troque a senha gerada logo em seguida. ### Confira os contêineres O guia de início rápido espera que você veja nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal e snoopy. ``` docker ps ``` ## Use a CLI para administrar A CLI também tem comandos para a API da plataforma. Sua conta ainda precisa das permissões para cada operação. - Antes de rodar uma operação, confira as flags atuais na ajuda do comando. - O comando login recebe a URL base da API, o e-mail e a senha. Ele salva o token de sessão que recebe de volta. - Por enquanto, o comando de login mostra o token de sessão no log de sucesso. Mantenha essa saída privada. Grupos de comandos: `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Mostrar comandos disponíveis ``` ./wlycli --help ``` ### Mostrar comandos de implantação ``` ./wlycli deployment --help ``` ### Mostrar opções de login ``` ./wlycli login --help ``` ### Mostrar opções de configuração ``` ./wlycli settings --help ``` ## Atualizações e recuperação Por padrão, uma implantação verifica atualizações estáveis todos os dias. O administrador do servidor pode gerenciar as versões na interface de administração. - Se os arquivos da sua implantação ainda estiverem válidos, mas alguns contêineres falharem, o início rápido manda executar restart, que recria os contêineres. - O create não será executado de novo enquanto o diretório do projeto ou seus contêineres ainda existirem. - A opção de exclusão forçada remove os arquivos da implantação e o banco de dados incluído. Ela não é um passo de recuperação e não preserva seus dados. - A skill deploy-server ainda usa o nome deployment update. A CLI atual tem deployment auto-update no lugar. Confira a ajuda atual da CLI antes de fazer manutenção manual. ### Recriar contêineres a partir da implantação existente ``` ./wlycli deploy restart -d example.com ``` Recria os contêineres a partir da sua configuração salva. Não exclui dados da implantação. ## Implante com um assistente de IA Se o seu assistente de IA aceita pacotes SKILL.md, baixe a nossa skill oficial deploy-server. Ela orienta uma implantação na DigitalOcean. Por enquanto, a skill cobre apenas a DigitalOcean. O início rápido da CLI também funciona com outras nuvens e com o seu próprio host Linux. ### Como usar - Extraia o pacote e carregue o diretório deploy-server da maneira como o seu assistente instala skills. - Peça ao assistente para usar $deploy-server. - A skill pede o domínio, o acesso ao DNS, a configuração de SSH, os dados de SMTP e o e-mail do administrador. - Ela pode configurar uma VM na DigitalOcean e, se você quiser, um banco de dados PostgreSQL gerenciado. Ela confirma com você os dados da implantação e o preço do banco de dados gerenciado. ### Antes de baixar - O pacote é uma cópia sem alterações da skill original. - Os exemplos de download e atualização dela estão desatualizados. Pegue a URL de download estável atual no início rápido deste site. Confira a ajuda da CLI antes da manutenção. - A skill não vem com credenciais de nuvem nem com um servidor em execução, e não podemos garantir que funcione com todos os assistentes. O pacote tem `SKILL.md`, `agents/openai.yaml` e `references/digitalocean.md`. Os dois downloads têm os mesmos arquivos. [Baixar deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Baixar deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Documentação de referência A documentação completa da CLI e os arquivos da skill de implantação. Você pode ler tudo aqui sem uma conta. - [**Welley CLI** docs/index.md](https://welley.com/pt/administrators/docs/cli/) - [**Início rápido: implantação mínima do Welley** docs/quick-start.md](https://welley.com/pt/administrators/docs/quick-start/) - [**Implantar servidor** skills/deploy-server/SKILL.md](https://welley.com/pt/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/pt/administrators/docs/deploy-server-openai-yaml/) - [**Referência da DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/pt/administrators/docs/deploy-server-digitalocean/)