Správci # Provozujte vlastní server Welley Náš nástroj pro příkazovou řádku nainstaluje vše, co Welley potřebuje, na jeden stroj s Linuxem. Může to být cloudový server i váš vlastní hardware. [Číst: Rychlý start: minimální nasazení Welley](https://welley.com/cs/administrators/docs/quick-start/) [Číst: Welley CLI](https://welley.com/cs/administrators/docs/cli/) [Nainstalujte Docker Engine](https://docs.docker.com/engine/install/) V budoucnu plánujeme vydat Welley jako open source. Datum vydání ani licence zatím nebyly oznámeny. ## Připravte hostitele, DNS a e-mail Toto jsou výchozí požadavky z rychlého startu. Jakou kapacitu potřebujete, záleží na počtu uživatelů a na zátěži. ### Hostitel s Linuxem - Ubuntu 24.04 LTS nebo podobná aktuální distribuce. - Začněte se 2 vCPU, 4 GB RAM a 60 GB disku. - Použijte pevnou veřejnou adresu IPv4 a uživatele bez práv roota s oprávněním pro sudo. ### Síť - Povolte příchozí TCP 80 a 443 z internetu. Povolte TCP 22 z vlastní sítě. - Nechte port 80 volný pro ověření certifikátu a pro týdenní obnovu certifikátu. ### DNS webu - Nasměrujte svou doménu a storage. na IP adresu hostitele. - Vytvořte oba záznamy před instalací. CLI je zkontroluje a zastaví se, pokud se nepřekládají na adresu hostitele. ### SMTP a e-mail správce - Připravte si SMTP hostitele, uživatele, heslo a adresu odesílatele. Výchozí je STARTTLS na portu 587. - Budete také potřebovat e-mail správce pro první přihlášení a pro obnovu hesla. ### DNS pro e-mail - Nastavte SPF, DMARC a DKIM, který váš poskytovatel vygeneruje, pro doménu adresy odesílatele. - Použijte přesnou hodnotu SPF od svého poskytovatele. Slučte ji se stávajícím záznamem SPF a nepřidávejte druhý. - CLI vás upozorní, když SPF nebo DMARC chybí. Selektor DKIM vašeho poskytovatele ověřit nedokáže. ## Nainstalujte Docker Engine a Compose Postupujte podle oficiálních pokynů Dockeru pro svou distribuci Linuxu. Potom dejte uživateli, který nasazení provádí, přístup k Dockeru. [Instalace Docker Engine](https://docs.docker.com/engine/install/) ### Přidejte uživatele do skupiny Docker Nahraďte svým uživatelem pro nasazení bez práv root. Po spuštění tohoto příkazu se odhlaste a znovu přihlaste. ``` sudo usermod -aG docker ``` ### Ověřte Docker a Compose Oba příkazy musí pro tohoto uživatele fungovat. ``` docker ps docker compose version ``` ## Stažení CLI Vyberte binárku pro stroj, na kterém budete CLI spouštět. Samotný hostitel nasazení musí běžet na Linuxu. ### 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 ``` - Tyto příkazy stáhnou CLI ze stabilního kanálu a zobrazí jeho verzi. - Verze se s každým novým vydáním mění. Při instalaci použijte nejnovější dokumentaci CLI. ## Vytvoření nasazení Spusťte tento příkaz na hostiteli s Linuxem, kterého jste připravili. Ukázkovou doménu, e-mail a hodnoty SMTP nahraďte svými. ``` ./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 ``` | Nastavení | Výchozí | | --- | --- | | Instalační adresář | ~/.welley/. Z ukázkové domény vznikne název projektu example\_com. | | Databáze | Přibalený PostgreSQL, data jsou v instalačním adresáři. | | Komponenty | Platforma Welley, RAG pipeline, Nginx, Redis a PostgreSQL, spolu s kontejnery pro údržbu. | | Certifikáty | Let’s Encrypt přes Certbot, s týdenní obnovou. | | Média | Nahrané a statické soubory na https://storage.. | | Aktualizace | Stabilní kanál, kontrolovaný denně. Proces aktualizace se pokud možno vyhne výpadku. | | Volitelné služby | Minimální nastavení nepřidává spravovanou databázi, CDN, telemetrii ani integraci se Slackem. | - Před spuštěním nastavte MAIL\_USER a MAIL\_PASSWORD na své přihlašovací údaje k SMTP. - Rychlý start vyžaduje těchto šest přepínačů. - Příkaz zkontroluje DNS, zapíše soubory nasazení, získá certifikát přes Certbot a spustí kontejnery. - Příkaz deploy je alias pro deployment. ## Přihlaste se a zkontrolujte výsledek Vygenerované heslo správce je v logu platformy. Tento výstup nikomu neukazujte. ### Najděte počáteční heslo Tento název kontejneru platí pro example.com. Pro vlastní doménu změňte název projektu. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Přihlášení Otevřete svou doménu a přihlaste se e-mailem správce, který jste zadali přes -e. Vygenerované heslo hned změňte. ### Zkontrolujte kontejnery Rychlý start očekává, že uvidíte nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal a snoopy. ``` docker ps ``` ## Správa pomocí CLI CLI má také příkazy pro API platformy. Váš účet pro každou operaci stále potřebuje příslušná oprávnění. - Než operaci spustíte, zkontrolujte její aktuální přepínače v nápovědě příkazu. - Příkaz login přijímá základní URL API, e-mail a heslo. Token relace, který dostane zpět, uloží. - Momentálně příkaz login vypisuje token relace do protokolu o úspěšném přihlášení. Tento výstup uchovejte v soukromí. Skupiny příkazů: `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Zobrazit dostupné příkazy ``` ./wlycli --help ``` ### Zobrazit příkazy pro nasazení ``` ./wlycli deployment --help ``` ### Zobrazit možnosti přihlášení ``` ./wlycli login --help ``` ### Zobrazit možnosti nastavení ``` ./wlycli settings --help ``` ## Aktualizace a obnova Ve výchozím nastavení nasazení každý den kontroluje stabilní aktualizace. Správce serveru může verze spravovat v administračním rozhraní. - Pokud jsou soubory vašeho nasazení stále platné, ale některé kontejnery selhávají, rychlý start doporučuje spustit restart, který kontejnery znovu vytvoří. - Příkaz create se znovu nespustí, dokud existuje adresář projektu nebo jeho kontejnery. - Volba force-delete odstraní soubory nasazení i přibalenou databázi. Není to krok k obnově a vaše data nezachová. - Skill deploy-server stále používá název deployment update. Aktuální CLI má místo něj deployment auto-update. Než budete provádět údržbu ručně, zkontrolujte aktuální nápovědu CLI. ### Znovu vytvořit kontejnery ze stávajícího nasazení ``` ./wlycli deploy restart -d example.com ``` Znovu vytvoří kontejnery z vaší uložené konfigurace. Data nasazení nesmaže. ## Nasazení pomocí AI asistenta Pokud váš AI asistent podporuje balíčky SKILL.md, stáhněte si náš oficiální skill deploy-server. Provede vás nasazením na DigitalOcean. Skill zatím pokrývá jen DigitalOcean. Rychlý start v CLI funguje i s jinými cloudy a s vaším vlastním linuxovým hostitelem. ### Jak to používat - Rozbalte balíček a načtěte adresář deploy-server tak, jak váš asistent instaluje skilly. - Požádejte asistenta, aby použil $deploy-server. - Skill se vás zeptá na doménu, přístup k DNS, nastavení SSH, údaje k SMTP a e-mail správce. - Umí nastavit virtuální stroj na DigitalOcean a, pokud chcete, i spravovanou databázi PostgreSQL. Vstupy nasazení a cenu spravované databáze s vámi potvrdí. ### Před stažením - Balíček je nezměněná kopie původního skillu. - Jeho příklady stahování a aktualizace jsou zastaralé. Aktuální URL pro stažení stabilní verze najdete v rychlém startu na tomto webu. Před údržbou zkontrolujte nápovědu CLI. - Skill neobsahuje přístupové údaje ke cloudu ani běžící server a nemůžeme zaručit, že funguje s každým asistentem. Balíček obsahuje `SKILL.md`, `agents/openai.yaml` a `references/digitalocean.md`. Obě varianty ke stažení obsahují stejné soubory. [Stáhnout deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Stáhnout deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Referenční dokumentace Úplná dokumentace CLI a soubory skillu pro nasazení. Můžete si je tady přečíst bez účtu. - [**Welley CLI** docs/index.md](https://welley.com/cs/administrators/docs/cli/) - [**Rychlý start: minimální nasazení Welley** docs/quick-start.md](https://welley.com/cs/administrators/docs/quick-start/) - [**Nasazení serveru** skills/deploy-server/SKILL.md](https://welley.com/cs/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/cs/administrators/docs/deploy-server-openai-yaml/) - [**Referenční informace k DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/cs/administrators/docs/deploy-server-digitalocean/)