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](https://welley.com/it/administrators/docs/quick-start/) [Leggi: Welley CLI](https://welley.com/it/administrators/docs/cli/) [Installa Docker Engine](https://docs.docker.com/engine/install/) 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. 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](https://docs.docker.com/engine/install/) ### Aggiungi l'utente al gruppo Docker Sostituisci con il tuo utente di deployment non root. Dopo aver eseguito questo comando, esci e rientra. ``` sudo usermod -aG docker ``` ### 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/. 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.. | | 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. ## Accedi e controlla il risultato 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)](https://welley.com/downloads/deploy-server.zip) [Scarica deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Documentazione di riferimento La documentazione completa della CLI e i file della skill di deployment. Puoi leggerli qui senza un account. - [**Welley CLI** docs/index.md](https://welley.com/it/administrators/docs/cli/) - [**Guida rapida: installazione minima di Welley** docs/quick-start.md](https://welley.com/it/administrators/docs/quick-start/) - [**Deploy del server** skills/deploy-server/SKILL.md](https://welley.com/it/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/it/administrators/docs/deploy-server-openai-yaml/) - [**Riferimento DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/it/administrators/docs/deploy-server-digitalocean/)