Administratorzy # Uruchom własny serwer Welley Nasze narzędzie wiersza poleceń instaluje wszystko, czego potrzebuje Welley, na jednej maszynie z Linuksem. Może to być serwer w chmurze, a także twój własny sprzęt. [Przeczytaj: Szybki start: minimalne wdrożenie Welley](https://welley.com/pl/administrators/docs/quick-start/) [Przeczytaj: Welley CLI](https://welley.com/pl/administrators/docs/cli/) [Zainstaluj Docker Engine](https://docs.docker.com/engine/install/) Planujemy w przyszłości udostępnić Welley jako oprogramowanie open source. Nie ogłosiliśmy jeszcze daty wydania ani licencji. ## Przygotuj hosta, DNS i e-mail To wymagania początkowe z przewodnika szybkiego startu. Ile mocy potrzebujesz, zależy od użytkowników i obciążenia. ### Host z Linuksem - Ubuntu 24.04 LTS albo podobna aktualna dystrybucja. - Zacznij od 2 vCPU, 4 GB RAM i 60 GB dysku. - Użyj stałego publicznego adresu IPv4 i użytkownika innego niż root, z uprawnieniami sudo. ### Sieć - Zezwól na ruch przychodzący TCP 80 i 443 z internetu. Zezwól na TCP 22 z własnej sieci. - Zostaw port 80 wolny dla wyzwania certyfikatu i cotygodniowego odnawiania certyfikatu. ### DNS strony - Wskaż swoją domenę i storage. na adres IP hosta. - Utwórz oba rekordy przed instalacją. CLI je sprawdza i zatrzymuje się, jeśli nie wskazują na hosta. ### SMTP i e-mail administratora - Przygotuj host SMTP, użytkownika, hasło i adres nadawcy. Domyślnie używany jest STARTTLS na porcie 587. - Potrzebujesz też adresu e-mail administratora do pierwszego logowania i odzyskiwania hasła. ### DNS dla e-maila - Skonfiguruj SPF, DMARC i DKIM generowany przez twojego dostawcę dla domeny adresu nadawcy. - Użyj dokładnej wartości SPF od dostawcy. Połącz ją z istniejącym rekordem SPF zamiast dodawać drugi. - CLI ostrzega, jeśli brakuje SPF lub DMARC. Nie może sprawdzić selektora DKIM twojego dostawcy. ## Zainstaluj Docker Engine i Compose Postępuj według oficjalnej instrukcji Dockera dla swojej dystrybucji Linuksa. Potem daj użytkownikowi wdrożenia dostęp do Dockera. [Instalacja Docker Engine](https://docs.docker.com/engine/install/) ### Dodaj użytkownika do grupy Docker Zastąp swoim użytkownikiem wdrożenia innym niż root. Po uruchomieniu tego polecenia wyloguj się i zaloguj ponownie. ``` sudo usermod -aG docker ``` ### Sprawdź Docker i Compose Oba polecenia muszą działać dla tego użytkownika. ``` docker ps docker compose version ``` ## Pobierz CLI Wybierz plik binarny dla maszyny, na której będziesz uruchamiać CLI. Sam host wdrożenia musi działać na Linuksie. ### 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 ``` - Te polecenia pobierają pliki ze stabilnego kanału i pokazują wersję CLI. - Wersja zmienia się z każdym nowym wydaniem. Podczas instalacji korzystaj z najnowszej dokumentacji CLI. ## Utwórz wdrożenie Uruchom to polecenie na przygotowanym hoście z Linuksem. Zastąp przykładową domenę, e-mail i wartości SMTP własnymi. ``` ./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 ``` | Ustawienie | Wartość domyślna | | --- | --- | | Katalog instalacji | ~/.welley/. Przykładowa domena daje nazwę projektu example\_com. | | Baza danych | Dołączony PostgreSQL, z danymi w katalogu instalacji. | | Stos | Platforma Welley, potok RAG, Nginx, Redis i PostgreSQL, z kontenerami do konserwacji. | | Certyfikaty | Let’s Encrypt przez Certbot, z cotygodniowym odnawianiem. | | Multimedia | Przesłane i statyczne pliki pod adresem https://storage.. | | Aktualizacje | Stabilny kanał, sprawdzany codziennie. Proces aktualizacji w miarę możliwości unika przestojów. | | Usługi opcjonalne | Minimalna konfiguracja nie dodaje zarządzanej bazy danych, CDN, telemetrii ani integracji ze Slackiem. | - Zanim je uruchomisz, ustaw MAIL\_USER i MAIL\_PASSWORD na swoje dane logowania SMTP. - Przewodnik szybkiego startu wymaga tych sześciu flag. - Polecenie sprawdza DNS, zapisuje pliki wdrożenia, pobiera certyfikat przez Certbot i uruchamia kontenery. - Polecenie deploy jest aliasem polecenia deployment. ## Zaloguj się i sprawdź wynik Wygenerowane hasło administratora znajdziesz w logu platformy. Nie udostępniaj tego wyniku. ### Znajdź hasło początkowe Ta nazwa kontenera dotyczy example.com. Dla własnej domeny zmień nazwę projektu. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Zaloguj się Otwórz swoją domenę i zaloguj się adresem e-mail administratora, podanym we fladze -e. Od razu zmień wygenerowane hasło. ### Sprawdź kontenery Przewodnik szybkiego startu oczekuje, że zobaczysz nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal i snoopy. ``` docker ps ``` ## Używaj CLI do administracji CLI ma też polecenia dla API platformy. Twoje konto nadal potrzebuje uprawnień do każdej operacji. - Zanim uruchomisz operację, sprawdź jej aktualne flagi w pomocy polecenia. - Polecenie login przyjmuje bazowy adres URL API, e-mail i hasło. Zapisuje otrzymany token sesji. - Obecnie polecenie logowania wypisuje token sesji w logu po udanym zalogowaniu. Nie pokazuj tych danych nikomu. Grupy poleceń: `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Pokaż dostępne polecenia ``` ./wlycli --help ``` ### Pokaż polecenia wdrożenia ``` ./wlycli deployment --help ``` ### Pokaż opcje logowania ``` ./wlycli login --help ``` ### Pokaż opcje ustawień ``` ./wlycli settings --help ``` ## Aktualizacje i odzyskiwanie Domyślnie wdrożenie codziennie sprawdza, czy są stabilne aktualizacje. Administrator serwera może zarządzać wydaniami w interfejsie administracyjnym. - Jeśli pliki wdrożenia są nadal poprawne, ale niektóre kontenery nie działają, szybki start zaleca uruchomienie polecenia restart, które tworzy kontenery na nowo. - Polecenie create nie uruchomi się ponownie, dopóki istnieje katalog projektu lub jego kontenery. - Opcja force-delete usuwa pliki wdrożenia i dołączoną bazę danych. To nie jest krok odzyskiwania i nie zachowuje twoich danych. - Umiejętność deploy-server nadal używa nazwy deployment update. Obecne CLI ma zamiast tego deployment auto-update. Zanim zrobisz konserwację ręcznie, sprawdź aktualną pomoc CLI. ### Utwórz kontenery od nowa na podstawie istniejącego wdrożenia ``` ./wlycli deploy restart -d example.com ``` Tworzy kontenery od nowa na podstawie zapisanej konfiguracji. Nie usuwa danych wdrożenia. ## Wdrożenie z asystentem AI Jeśli twój asystent AI obsługuje pakiety SKILL.md, pobierz naszą oficjalną umiejętność deploy-server. Prowadzi przez wdrożenie na DigitalOcean. Na razie umiejętność obejmuje tylko DigitalOcean. Szybki start w CLI działa też z innymi chmurami i z twoim własnym hostem z Linuksem. ### Jak z tego korzystać - Rozpakuj pakiet i wczytaj katalog deploy-server tak, jak twój asystent instaluje umiejętności. - Poproś asystenta, żeby użył $deploy-server. - Umiejętność zapyta cię o domenę, dostęp do DNS, konfigurację SSH, dane SMTP i adres e-mail administratora. - Może założyć maszynę wirtualną DigitalOcean i, jeśli chcesz, zarządzaną bazę danych PostgreSQL. Prosi cię o potwierdzenie danych wdrożenia i ceny zarządzanej bazy danych. ### Zanim pobierzesz - Pakiet jest niezmienioną kopią oryginalnej umiejętności. - Jego przykłady pobierania i aktualizacji są nieaktualne. Aktualny adres URL do pobrania stabilnej wersji znajdziesz w szybkim starcie na tej stronie. Przed konserwacją sprawdź pomoc CLI. - Umiejętność nie zawiera danych dostępowych do chmury ani działającego serwera i nie możemy zagwarantować, że działa z każdym asystentem. Pakiet zawiera `SKILL.md`, `agents/openai.yaml` i `references/digitalocean.md`. Obie wersje do pobrania zawierają te same pliki. [Pobierz deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Pobierz deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Dokumentacja Pełna dokumentacja CLI i pliki umiejętności wdrożenia. Możesz je przeczytać tutaj bez konta. - [**Welley CLI** docs/index.md](https://welley.com/pl/administrators/docs/cli/) - [**Szybki start: minimalne wdrożenie Welley** docs/quick-start.md](https://welley.com/pl/administrators/docs/quick-start/) - [**Wdrożenie serwera** skills/deploy-server/SKILL.md](https://welley.com/pl/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/pl/administrators/docs/deploy-server-openai-yaml/) - [**Dokumentacja DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/pl/administrators/docs/deploy-server-digitalocean/)