Správcovia

Spustite si vlastný server Welley

Náš nástroj príkazového riadka nainštaluje všetko, čo Welley potrebuje, na jeden stroj s Linuxom. Funguje cloudový server aj váš vlastný hardvér.

Čítať: Rýchly štart: minimálne nasadenie Welley Čítať: Welley CLI Nainštalujte Docker Engine

V budúcnosti plánujeme vydať Welley ako open source. Dátum vydania ani licencia zatiaľ neboli oznámené.

Pripravte hostiteľa, DNS a e-mail

Toto sú východiskové požiadavky z príručky rýchleho štartu. Aká kapacita bude potrebná, závisí od vašich používateľov a záťaže.

Hostiteľ s Linuxom

Ubuntu 24.04 LTS alebo podobná aktuálna distribúcia.
Začnite s 2 vCPU, 4 GB RAM a 60 GB disku.
Použite pevnú verejnú adresu IPv4 a používateľa bez práv root so sudo.

Sieť

Povoľte prichádzajúce TCP 80 a 443 z internetu. Povoľte TCP 22 z vlastnej siete.
Port 80 nechajte voľný pre overenie certifikátu a týždennú obnovu certifikátu.

DNS stránky

Nasmerujte svoju doménu a storage.<domain> na IP adresu hostiteľa.
Oba záznamy vytvorte pred inštaláciou. CLI ich skontroluje a zastaví sa, ak sa nepreložia na hostiteľa.

SMTP a e-mail správcu

Pripravte si SMTP hostiteľa, používateľa, heslo a adresu odosielateľa. Predvolené je STARTTLS na porte 587.
Budete potrebovať aj e-mail správcu pre prvé prihlásenie a obnovu hesla.

DNS pre e-mail

Nastavte SPF, DMARC a DKIM, ktorý vygeneruje váš poskytovateľ, pre doménu adresy odosielateľa.
Použite presnú hodnotu SPF od svojho poskytovateľa. Zlúčte ju s existujúcim záznamom SPF namiesto pridania druhého.
CLI vás upozorní, ak SPF alebo DMARC chýba. Selektor DKIM vášho poskytovateľa skontrolovať nevie.

Nainštalujte Docker Engine a Compose

Postupujte podľa oficiálnych pokynov Dockeru pre vašu distribúciu Linuxu. Potom dajte používateľovi nasadenia prístup k Dockeru.

Inštalácia Docker Engine

Pridajte používateľa do skupiny Docker

Nahraďte <user> svojím používateľom nasadenia bez práv root. Po spustení tohto príkazu sa odhláste a znova prihláste.

sudo usermod -aG docker <user>

Skontrolujte Docker a Compose

Oba príkazy musia pre tohto používateľa fungovať.

docker ps
docker compose version

Stiahnite CLI

Vyberte binárny súbor pre stroj, na ktorom budete CLI spúšťať. Samotný hostiteľ nasadenia musí bežať na Linuxe.

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

Tieto príkazy sťahujú zo stabilného kanála a zobrazia verziu CLI.
Verzia sa mení s každým novým vydaním. Pri inštalácii použite najnovšiu dokumentáciu CLI.

Vytvorte nasadenie

Spustite tento príkaz na pripravenom hostiteľovi s Linuxom. Vzorovú doménu, e-mail a hodnoty SMTP nahraďte vlastný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

Nastavenie	Predvolené
Inštalačný adresár	~/.welley/<project>. Vzorová doména vytvorí názov projektu example_com.
Databáza	Súčasťou je PostgreSQL, dáta sú v inštalačnom adresári.
Zostava	Platforma Welley, RAG pipeline, Nginx, Redis a PostgreSQL, spolu s údržbovými kontajnermi.
Certifikáty	Let’s Encrypt cez Certbot s týždennou obnovou.
Médiá	Nahrané a statické súbory na https://storage.<domain>.
Aktualizácie	Stabilný kanál, kontrolovaný denne. Proces aktualizácie sa podľa možnosti vyhýba výpadkom.
Voliteľné služby	Minimálne nastavenie nepridáva spravovanú databázu, CDN, telemetriu ani integráciu so Slackom.

Skôr než ho spustíte, nastavte MAIL_USER a MAIL_PASSWORD na svoje prihlasovacie údaje SMTP.
Rýchly štart vyžaduje týchto šesť prepínačov.
Príkaz skontroluje DNS, zapíše súbory nasadenia, získa certifikát cez Certbot a spustí kontajnery.
Príkaz deploy je alias pre deployment.

Vygenerované heslo správcu je v logu platformy. Tento výstup nezdieľajte.

Nájdite úvodné heslo

Tento názov kontajnera platí pre example.com. Pre vlastnú doménu zmeňte názov projektu.

docker logs example_com-platform-blue-1 | grep "Auto-init complete"

Prihláste sa

Otvorte svoju doménu a prihláste sa e-mailom správcu, ktorý ste zadali cez -e. Vygenerované heslo hneď zmeňte.

Skontrolujte kontajnery

Rýchly štart očakáva, že uvidíte nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal a snoopy.

docker ps

Správa cez CLI

CLI má aj príkazy pre API platformy. Váš účet stále potrebuje oprávnenia pre každú operáciu.

Skôr než operáciu spustíte, skontrolujte jej aktuálne prepínače v pomocníkovi príkazu.
Príkaz login berie základnú URL API, e-mail a heslo. Uloží token relácie, ktorý dostane späť.
Príkaz na prihlásenie momentálne vypisuje token relácie do záznamu o úspešnom prihlásení. Tento výstup udržujte v súkromí.

Skupiny príkazov: accounts, posts, apps, emojis, feeds, reports, rules, settings.

Zobraziť dostupné príkazy

./wlycli --help

Zobraziť príkazy na nasadenie

./wlycli deployment --help

Zobraziť možnosti prihlásenia

./wlycli login --help

Zobraziť možnosti nastavení

./wlycli settings --help

Aktualizácie a obnova

Nasadenie predvolene každý deň kontroluje, či sú dostupné stabilné aktualizácie. Správca servera môže vydania spravovať v administrátorskom rozhraní.

Ak sú súbory vášho nasadenia stále platné, ale niektoré kontajnery zlyhávajú, rýchly štart odporúča spustiť restart, ktorý kontajnery znova vytvorí.
Príkaz create sa znova nespustí, kým existuje adresár projektu alebo jeho kontajnery.
Voľba force-delete odstráni súbory nasadenia a priloženú databázu. Nie je to krok na obnovu a vaše dáta nezachová.
Skill deploy-server stále používa názov deployment update. Aktuálne CLI má namiesto toho deployment auto-update. Skôr než budete robiť údržbu ručne, pozrite si aktuálnu pomoc CLI.

Znova vytvoriť kontajnery z existujúceho nasadenia

./wlycli deploy restart -d example.com

Znova vytvorí kontajnery z vašej uloženej konfigurácie. Dáta nasadenia nemaže.

Nasadenie pomocou AI asistenta

Ak váš AI asistent podporuje balíky SKILL.md, stiahnite si náš oficiálny skill deploy-server. Prevedie vás nasadením na DigitalOcean.

Skill zatiaľ pokrýva iba DigitalOcean. Rýchly štart pre CLI funguje aj s inými cloudmi a s vaším vlastným hostiteľom s Linuxom.

Ako to používať

Rozbaľte balík a načítajte adresár deploy-server tak, ako váš asistent inštaluje skilly.
Povedzte asistentovi, aby použil $deploy-server.
Skill sa vás opýta na doménu, prístup k DNS, nastavenie SSH, údaje o SMTP a e-mail správcu.
Vie nastaviť virtuálny stroj na DigitalOcean a, ak chcete, aj spravovanú databázu PostgreSQL. Vstupy nasadenia a cenu spravovanej databázy s vami potvrdí.

Pred stiahnutím

Balík je nezmenená kópia pôvodného skillu.
Jeho príklady sťahovania a aktualizácie sú zastarané. Aktuálnu stabilnú adresu na stiahnutie nájdete v rýchlom štarte na tomto webe. Pred údržbou si pozrite pomoc CLI.
Skill neobsahuje prístupové údaje do cloudu ani bežiaci server a nemôžeme zaručiť, že funguje s každým asistentom.

Balík obsahuje SKILL.md, agents/openai.yaml a references/digitalocean.md. Obe verzie na stiahnutie obsahujú rovnaké súbory.

Stiahnuť deploy-server.zip (10,7 KB)Stiahnuť deploy-server.skill (10,7 KB)

Referenčná dokumentácia

Úplná dokumentácia CLI a súbory skillu na nasadenie. Môžete si ich tu prečítať bez účtu.