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 Číst: Welley CLI Nainstalujte Docker Engine

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.<domain> 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

Přidejte uživatele do skupiny Docker

Nahraďte <user> 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 <user>

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/<project>. 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.<domain>.
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.

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)Stáhnout deploy-server.skill (10,7 KB)

Referenční dokumentace

Úplná dokumentace CLI a soubory skillu pro nasazení. Můžete si je tady přečíst bez účtu.