Amministratori

Gestisci il tuo server Welley

Il nostro strumento da riga di comando installa tutto ciò che serve a Welley su una sola macchina Linux. Puoi usare un server nel cloud o il tuo hardware.

Leggi: Guida rapida: installazione minima di Welley Leggi: Welley CLI Installa Docker Engine

In futuro prevediamo di rilasciare Welley come open source. Per ora non sono state annunciate né una data di rilascio né una licenza.

Prepara host, DNS ed email

Questi sono i requisiti di partenza della guida rapida. La capacità che ti serve dipende dai tuoi utenti e dal carico di lavoro.

Host Linux

Ubuntu 24.04 LTS, o una distribuzione attuale simile.
Parti con 2 vCPU, 4 GB di RAM e 60 GB di disco.
Usa un indirizzo IPv4 pubblico fisso e un utente non root con sudo.

Rete

Consenti il traffico TCP in ingresso sulle porte 80 e 443 da internet. Consenti la porta TCP 22 dalla tua rete.
Tieni libera la porta 80 per la verifica del certificato e per il rinnovo settimanale del certificato.

DNS del sito

Fai puntare il tuo dominio e storage.<domain> all'indirizzo IP dell'host.
Crea entrambi i record prima di installare. La CLI li controlla e si ferma se non risolvono verso l'host.

SMTP ed email dell'amministratore

Tieni pronti host SMTP, utente, password e indirizzo del mittente. Il valore predefinito è STARTTLS sulla porta 587.
Ti serve anche un'email dell'amministratore per il primo accesso e per il recupero della password.

DNS per le email

Configura SPF, DMARC e il DKIM che genera il tuo provider, per il dominio dell'indirizzo del mittente.
Usa il valore SPF esatto del tuo provider. Uniscilo al record SPF che hai già, invece di aggiungerne un secondo.
La CLI ti avvisa se mancano SPF o DMARC. Non può controllare il selettore DKIM del tuo provider.

Installa Docker Engine e Compose

Segui le istruzioni ufficiali di Docker per la tua distribuzione Linux. Poi dai accesso a Docker all'utente che usi per il deployment.

Installazione di Docker Engine

Aggiungi l'utente al gruppo Docker

Sostituisci <user> con il tuo utente di deployment non root. Dopo aver eseguito questo comando, esci e rientra.

sudo usermod -aG docker <user>

Controlla Docker e Compose

Entrambi i comandi devono funzionare per quell'utente.

docker ps
docker compose version

Scarica la CLI

Scegli il binario per la macchina su cui eseguirai la CLI. L'host del deployment deve comunque essere 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

Questi comandi scaricano dal canale stabile e mostrano la versione della CLI.
La versione cambia a ogni nuovo rilascio. Quando installi, usa la documentazione più recente della CLI.

Crea il deployment

Esegui questo comando sull'host Linux che hai preparato. Sostituisci i valori di esempio di dominio, email e SMTP con i tuoi.

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

Impostazione	Predefinito
Cartella di installazione	~/.welley/<project>. Il dominio di esempio produce il nome di progetto example_com.
Database	PostgreSQL incluso, con i dati nella cartella di installazione.
Stack	Piattaforma Welley, pipeline RAG, Nginx, Redis e PostgreSQL, con container di manutenzione.
Certificati	Let’s Encrypt tramite Certbot, con rinnovo settimanale.
Media	Caricamenti e file statici su https://storage.<domain>.
Aggiornamenti	Canale stabile, controllato ogni giorno. Il processo di aggiornamento evita i tempi di inattività dove possibile.
Servizi opzionali	La configurazione minima non aggiunge un database gestito, una CDN, telemetria o l'integrazione con Slack.

Prima di eseguirlo, imposta MAIL_USER e MAIL_PASSWORD con le tue credenziali SMTP.
La guida rapida richiede questi sei flag.
Il comando controlla il DNS, scrive i file del deployment, ottiene un certificato con Certbot e avvia i container.
Il comando deploy è un alias di deployment.

La password dell'amministratore generata si trova nel log della piattaforma. Tieni privato quell'output.

Trova la password iniziale

Questo nome di container vale per example.com. Per il tuo dominio, cambia il nome del progetto.

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

Accedi

Apri il tuo dominio e accedi con l'email dell'amministratore che hai indicato con -e. Cambia subito la password generata.

Controlla i container

La guida rapida si aspetta di vedere nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal e snoopy.

docker ps

Usa la CLI per l'amministrazione

La CLI ha anche comandi per l'API della piattaforma. Il tuo account deve comunque avere i permessi per ogni operazione.

Prima di eseguire un'operazione, controlla i flag attuali nella guida del comando.
Il comando login richiede l'URL di base dell'API, l'email e la password. Salva il token di sessione che riceve.
Al momento il comando login stampa il token di sessione nel log di successo. Tieni privato quell'output.

Gruppi di comandi: accounts, posts, apps, emojis, feeds, reports, rules, settings.

Mostra i comandi disponibili

./wlycli --help

Mostra i comandi di deployment

./wlycli deployment --help

Mostra le opzioni di accesso

./wlycli login --help

Mostra le opzioni delle impostazioni

./wlycli settings --help

Aggiornamenti e ripristino

Per impostazione predefinita, un deployment cerca ogni giorno gli aggiornamenti stabili. L'amministratore del server può gestire le versioni nell'interfaccia di amministrazione.

Se i file del tuo deployment sono ancora validi ma alcuni container non funzionano, la guida rapida dice di eseguire restart, che ricrea i container.
Il comando create non verrà eseguito di nuovo finché la directory del progetto o i suoi container esistono ancora.
L'opzione di eliminazione forzata rimuove i file del deployment e il database incluso. Non è un passaggio di ripristino e non conserva i tuoi dati.
La skill deploy-server usa ancora il nome deployment update. La CLI attuale ha invece deployment auto-update. Controlla la guida della CLI attuale prima di fare manutenzione a mano.

Ricrea i container dal deployment esistente

./wlycli deploy restart -d example.com

Ricrea i container a partire dalla configurazione salvata. Non elimina i dati del deployment.

Fai il deployment con un assistente AI

Se il tuo assistente AI supporta i pacchetti SKILL.md, scarica la nostra skill ufficiale deploy-server. Ti guida in un deployment su DigitalOcean.

Per ora la skill copre solo DigitalOcean. La guida rapida della CLI funziona anche con altri cloud e con un tuo host Linux.

Come si usa

Estrai il pacchetto e carica la directory deploy-server nel modo in cui il tuo assistente installa le skill.
Chiedi all'assistente di usare $deploy-server.
La skill ti chiede il dominio, l'accesso al DNS, la configurazione SSH, i dettagli SMTP e l'email dell'amministratore.
Può configurare una VM DigitalOcean e, se ne vuoi uno, un database PostgreSQL gestito. Conferma con te i dati del deployment e il prezzo del database gestito.

Prima di scaricare

Il pacchetto è una copia identica della skill originale.
I suoi esempi di download e aggiornamento sono obsoleti. Prendi l'URL di download stabile attuale dalla guida rapida di questo sito. Controlla la guida della CLI prima della manutenzione.
La skill non include credenziali cloud né un server in funzione, e non possiamo garantire che funzioni con ogni assistente.

Il pacchetto contiene SKILL.md, agents/openai.yaml e references/digitalocean.md. Entrambi i download hanno gli stessi file.

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

Documentazione di riferimento

La documentazione completa della CLI e i file della skill di deployment. Puoi leggerli qui senza un account.