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](https://welley.com/sk/administrators/docs/quick-start/) [Čítať: Welley CLI](https://welley.com/sk/administrators/docs/cli/) [Nainštalujte Docker Engine](https://docs.docker.com/engine/install/)

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](https://docs.docker.com/engine/install/)

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

## Prihláste sa a skontrolujte výsledok

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)](https://welley.com/downloads/deploy-server.zip) [Stiahnuť deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill)

## Referenčná dokumentácia

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

-   [**Welley CLI** docs/index.md](https://welley.com/sk/administrators/docs/cli/)
-   [**Rýchly štart: minimálne nasadenie Welley** docs/quick-start.md](https://welley.com/sk/administrators/docs/quick-start/)
-   [**Nasadenie servera** skills/deploy-server/SKILL.md](https://welley.com/sk/administrators/docs/deploy-server-skill/)
-   [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/sk/administrators/docs/deploy-server-openai-yaml/)
-   [**Referencia k DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/sk/administrators/docs/deploy-server-digitalocean/)