Ylläpitäjät # Pyöritä omaa Welley-palvelinta Komentoriviohjelmamme asentaa kaiken, mitä Welley tarvitsee, yhdelle Linux-koneelle. Pilvipalvelin käy, ja niin käy oma laitteistokin. [Lue: Pikaopas: Welleyn minimiasennus](https://welley.com/fi/administrators/docs/quick-start/) [Lue: Welley CLI](https://welley.com/fi/administrators/docs/cli/) [Asenna Docker Engine](https://docs.docker.com/engine/install/) Aiomme julkaista Welleyn avoimena lähdekoodina tulevaisuudessa. Julkaisupäivää tai lisenssiä ei ole vielä ilmoitettu. ## Valmistele isäntäkone, DNS ja sähköposti Nämä ovat pikaoppaan lähtövaatimukset. Tarvitsemasi kapasiteetti riippuu käyttäjistäsi ja kuormastasi. ### Linux-isäntäkone - Ubuntu 24.04 LTS tai vastaava nykyinen jakelu. - Aloita kokoonpanolla, jossa on 2 vCPU:ta, 4 GB RAM-muistia ja 60 GB levytilaa. - Käytä kiinteää julkista IPv4-osoitetta ja muuta kuin root-käyttäjää, jolla on sudo. ### Verkko - Salli saapuva liikenne internetistä TCP-portteihin 80 ja 443. Salli TCP-portti 22 omasta verkostasi. - Pidä portti 80 vapaana varmenteen haasteelle ja viikoittaiselle varmenteen uusinnalle. ### Sivuston DNS - Osoita verkkotunnuksesi ja storage. isäntäkoneen IP-osoitteeseen. - Luo molemmat tietueet ennen asennusta. CLI tarkistaa ne ja pysähtyy, jos ne eivät osoita isäntäkoneeseen. ### SMTP ja ylläpitäjän sähköposti - Pidä valmiina SMTP-palvelin, käyttäjä, salasana ja lähettäjäosoite. Oletus on STARTTLS portissa 587. - Tarvitset myös ylläpitäjän sähköpostiosoitteen ensimmäistä kirjautumista ja salasanan palautusta varten. ### Sähköpostin DNS - Määritä SPF, DMARC ja palveluntarjoajasi luoma DKIM lähettäjäosoitteen verkkotunnukselle. - Käytä palveluntarjoajasi antamaa SPF-arvoa täsmälleen sellaisenaan. Yhdistä se olemassa olevaan SPF-tietueeseesi sen sijaan, että lisäisit toisen. - CLI varoittaa, jos SPF tai DMARC puuttuu. Se ei voi tarkistaa palveluntarjoajasi DKIM-valitsinta. ## Asenna Docker Engine ja Compose Noudata Dockerin virallisia ohjeita omalle Linux-jakelullesi. Anna sen jälkeen käyttöönottokäyttäjällesi pääsy Dockeriin. [Docker Enginen asennus](https://docs.docker.com/engine/install/) ### Lisää käyttäjä Docker-ryhmään Korvaa käyttöönottoon käyttämälläsi ei-root-käyttäjällä. Kun olet ajanut tämän komennon, kirjaudu ulos ja takaisin sisään. ``` sudo usermod -aG docker ``` ### Tarkista Docker ja Compose Molempien komentojen täytyy toimia kyseiselle käyttäjälle. ``` docker ps docker compose version ``` ## Lataa CLI Valitse binääri koneelle, jolla ajat CLI:tä. Käyttöönoton isäntäkoneessa täytyy kuitenkin olla Linux. ### 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 ``` - Nämä komennot lataavat vakaasta kanavasta ja näyttävät CLI:n version. - Versio muuttuu jokaisen uuden julkaisun myötä. Käytä asennuksessa uusinta CLI-dokumentaatiota. ## Luo käyttöönotto Aja tämä komento valmistelemallasi Linux-isäntäkoneella. Korvaa esimerkin verkkotunnus, sähköposti ja SMTP-arvot omillasi. ``` ./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 ``` | Asetus | Oletus | | --- | --- | | Asennushakemisto | ~/.welley/. Esimerkin verkkotunnuksesta syntyy projektin nimi example\_com. | | Tietokanta | Mukana tuleva PostgreSQL, jonka data on asennushakemiston alla. | | Ohjelmistopino | Welley-alusta, RAG-putki, Nginx, Redis ja PostgreSQL sekä huoltokontit. | | Varmenteet | Let’s Encrypt Certbotin kautta, viikoittainen uusinta. | | Media | Lataukset ja staattiset tiedostot osoitteessa https://storage.. | | Päivitykset | Vakaa kanava, tarkistetaan päivittäin. Päivitysprosessi välttää käyttökatkoja, kun se on mahdollista. | | Valinnaiset palvelut | Minimiasennus ei lisää hallinnoitua tietokantaa, CDN:ää, telemetriaa tai Slack-integraatiota. | - Ennen kuin ajat sen, aseta MAIL\_USER ja MAIL\_PASSWORD SMTP-tunnuksiisi. - Pikaopas vaatii nämä kuusi lippua. - Komento tarkistaa DNS:n, kirjoittaa käyttöönoton tiedostot, hakee varmenteen Certbotilla ja käynnistää kontit. - Komento deploy on alias komennolle deployment. ## Kirjaudu sisään ja tarkista tulos Luotu ylläpitäjän salasana on alustan lokissa. Pidä tuo tuloste yksityisenä. ### Etsi alkusalasana Tämä kontin nimi koskee verkkotunnusta example.com. Jos käytät omaa verkkotunnustasi, vaihda projektin nimi. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Kirjaudu sisään Avaa verkkotunnuksesi ja kirjaudu sisään ylläpitäjän sähköpostilla, jonka annoit valitsimella -e. Vaihda luotu salasana heti. ### Tarkista kontit Pikaopas odottaa näkevänsä nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal ja snoopy. ``` docker ps ``` ## Käytä CLI:tä ylläpitoon CLI:ssä on myös komentoja alustan API:lle. Tililläsi täytyy silti olla oikeudet jokaiseen operaatioon. - Tarkista operaation nykyiset liput komennon ohjeesta ennen sen ajamista. - Komento login ottaa API:n perus-URL:n, sähköpostin ja salasanan. Se tallentaa saamansa istuntotokenin. - Tällä hetkellä login-komento tulostaa istuntotunnisteen onnistumislokiin. Pidä tuloste yksityisenä. Komentoryhmät: `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Näytä käytettävissä olevat komennot ``` ./wlycli --help ``` ### Näytä käyttöönoton komennot ``` ./wlycli deployment --help ``` ### Näytä kirjautumisvaihtoehdot ``` ./wlycli login --help ``` ### Näytä asetusvaihtoehdot ``` ./wlycli settings --help ``` ## Päivitykset ja palautus Oletuksena käyttöönotto tarkistaa joka päivä, onko vakaita päivityksiä saatavilla. Palvelimen ylläpitäjä voi hallita versioita hallintakäyttöliittymässä. - Jos käyttöönoton tiedostot ovat edelleen kunnossa mutta jotkin kontit eivät toimi, pikaopas neuvoo ajamaan restart-komennon, joka luo kontit uudelleen. - Create-komentoa ei voi ajaa uudelleen niin kauan kuin projektihakemisto tai sen kontit ovat vielä olemassa. - Pakotettu poisto -asetus poistaa käyttöönoton tiedostot ja mukana tulevan tietokannan. Se ei ole palautustoimi, eikä se säilytä tietojasi. - Deploy-server-skill käyttää edelleen nimeä deployment update. Nykyisessä CLI:ssä on sen sijaan deployment auto-update. Tarkista nykyisen CLI:n ohje, ennen kuin teet huoltoa käsin. ### Luo kontit uudelleen olemassa olevasta käyttöönotosta ``` ./wlycli deploy restart -d example.com ``` Luo kontit uudelleen tallennetun kokoonpanosi pohjalta. Se ei poista käyttöönoton tietoja. ## Käyttöönotto tekoälyavustajalla Jos tekoälyavustajasi tukee SKILL.md-paketteja, lataa virallinen deploy-server-skill. Se opastaa DigitalOcean-käyttöönotossa. Toistaiseksi skill kattaa vain DigitalOceanin. CLI:n pikaopas toimii myös muiden pilvipalvelujen ja oman Linux-isäntäsi kanssa. ### Näin sitä käytetään - Pura paketti ja lataa deploy-server-hakemisto tavalla, jolla avustajasi asentaa skillejä. - Pyydä avustajaa käyttämään skilliä $deploy-server. - Skill kysyy sinulta verkkotunnuksen, DNS-käyttöoikeudet, SSH-asetukset, SMTP-tiedot ja ylläpitäjän sähköpostiosoitteen. - Se voi pystyttää DigitalOcean-virtuaalikoneen ja halutessasi hallinnoidun PostgreSQL-tietokannan. Se varmistaa sinulta käyttöönoton tiedot ja hallinnoidun tietokannan hinnan. ### Ennen latausta - Paketti on muuttumaton kopio alkuperäisestä skillistä. - Sen lataus- ja päivitysesimerkit ovat vanhentuneita. Hae nykyisen vakaan version latausosoite tämän sivuston pikaoppaasta. Tarkista CLI:n ohje ennen huoltoa. - Skillin mukana ei tule pilvipalvelun tunnuksia eikä käynnissä olevaa palvelinta, emmekä voi luvata, että se toimii jokaisen avustajan kanssa. Paketissa on `SKILL.md`, `agents/openai.yaml` ja `references/digitalocean.md`. Molemmat lataukset sisältävät samat tiedostot. [Lataa deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Lataa deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Viiteasiakirjat Täydet CLI-ohjeet ja käyttöönoton skill-tiedostot. Voit lukea ne täällä ilman tiliä. - [**Welley CLI** docs/index.md](https://welley.com/fi/administrators/docs/cli/) - [**Pikaopas: Welleyn minimiasennus** docs/quick-start.md](https://welley.com/fi/administrators/docs/quick-start/) - [**Palvelimen käyttöönotto** skills/deploy-server/SKILL.md](https://welley.com/fi/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/fi/administrators/docs/deploy-server-openai-yaml/) - [**DigitalOcean-ohjeet** skills/deploy-server/references/digitalocean.md](https://welley.com/fi/administrators/docs/deploy-server-digitalocean/)