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 Lue: Welley CLI Asenna Docker Engine

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

Lisää käyttäjä Docker-ryhmään

Korvaa <user> 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 <user>

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

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

Viiteasiakirjat

Täydet CLI-ohjeet ja käyttöönoton skill-tiedostot. Voit lukea ne täällä ilman tiliä.