Distribuire ONLYOFFICE Docs su DigitalOcean

Introduzione

Ora puoi facilmente distribuire la versione Docker di ONLYOFFICE Docs nell'infrastruttura cloud di DigitalOcean utilizzando un'app a un clic fornita nel DigitalOcean Marketplace.

L'app a un clic è un'immagine che include tutti i componenti preconfigurati necessari per distribuire gli editor online di ONLYOFFICE su un server DigitalOcean che esegue il sistema operativo Ubuntu:

• Servizio Docker,
• ONLYOFFICE Docs.

Una volta avviato il tuo droplet ONLYOFFICE Docs, puoi integrare ONLYOFFICE Docs con una delle piattaforme di archiviazione cloud, come Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub, Plone, Nuxeo ecc.

Passo 1. Crea il tuo droplet in DigitalOcean

Accedi al tuo account DigitalOcean e vai al Marketplace di DigitalOcean.

Trova ONLYOFFICE Docs nella categoria Business Apps, passa il mouse sull'app e fai clic sul pulsante "Create Droplet" che appare. In alternativa, puoi aprire la pagina dei dettagli del droplet e fare clic sul pulsante "Create ONLYOFFICE Docs Droplet".

Nella sezione Choose a plan, seleziona il piano che desideri utilizzare o lascia quello predefinito. Il piano Basic che fornisce 8 GB di RAM e 4 CPU è sufficiente per eseguire ONLYOFFICE Docs.

Facoltativamente, puoi impostare altri parametri del droplet.

• Aggiungi archiviazione a blocchi se necessario. L'archiviazione a blocchi ti consente di aggiungere volumi di archiviazione indipendenti che possono essere spostati da un droplet all'altro all'interno della stessa regione.
• Cambia la regione del datacenter, se necessario. Si consiglia di selezionare la regione più vicina.
• Per impostazione predefinita, il tuo droplet sarà disponibile tramite l'indirizzo IP pubblico. Se scegli una rete VPC, il droplet sarà in grado di comunicare tramite indirizzo IP privato solo con altre risorse nella stessa rete VPC. Sarà inaccessibile da Internet pubblico.
• Controlla alcune opzioni aggiuntive, se necessario: abilita il networking IPv6, fornisci dati utente, o abilita il monitoraggio del droplet.

Nella sezione Authentication, seleziona il tipo di autenticazione che verrà utilizzato per accedere al tuo droplet. Puoi specificare una password root o aggiungere una chiave pubblica SSH.

Crea una password root per accedere al droplet (l'autenticazione tramite password è un metodo meno sicuro rispetto all'uso delle chiavi SSH). La password deve soddisfare i seguenti requisiti:

• Almeno 8 caratteri
• Deve contenere almeno 1 carattere maiuscolo (i primi e gli ultimi caratteri non contano)
• Deve contenere almeno 1 numero
• Non può terminare con un numero o un carattere speciale

Conserva la tua password in un luogo sicuro. Non riceverai alcun messaggio email contenente i dettagli del tuo droplet e la password.

Utilizzare le chiavi SSH è un modo più sicuro per accedere al tuo droplet creato rispetto all'uso di una password. In questo caso, l'autenticazione tramite password sarà disabilitata per impostazione predefinita. Se desideri connetterti al tuo server utilizzando una chiave SSH anziché una password, aggiungi una nuova chiave pubblica SSH o utilizza una chiave precedentemente aggiunta. La chiave privata deve essere memorizzata sul tuo computer locale. Per saperne di più su come creare coppie di chiavi SSH e aggiungere la chiave pubblica a un droplet, puoi fare riferimento alla documentazione di DigitalOcean.

• Se necessario, puoi cambiare il numero di droplet creati, cambiare un hostname predefinito che verrà utilizzato per identificare il droplet all'interno del Pannello di Controllo di DigitalOcean, aggiungere tag o scegliere un progetto a cui assegnare il droplet, se hai più progetti.
• Abilita i backup del tuo droplet se desideri eseguire backup automatici del droplet su base settimanale. I backup costano il 20% del prezzo del droplet.

Fai clic sul pulsante "Create Droplet" e attendi mentre il droplet viene creato. Il droplet appena creato verrà visualizzato nel Pannello di Controllo di DigitalOcean.

L'IP del server è visualizzato accanto al nome host del droplet. Se passi il mouse sopra l'indirizzo IP, appare l'opzione Copia. Fai clic per copiare l'indirizzo IP.

Passo 2. Connettiti al tuo server via SSH per completare l'installazione

Su Windows, puoi utilizzare l'utilità PuTTY.

Inserisci l'indirizzo IP del droplet, assicurati che la porta 22 sia specificata e che il tipo di connessione SSH sia selezionato.

Se hai aggiunto una chiave pubblica SSH durante la creazione del droplet, specifica il percorso della tua chiave privata corrispondente memorizzata sul tuo computer locale nella sezione Connection → SSH → Auth.

Fai clic sul pulsante Open. Poi fai clic su Yes nella finestra di PuTTY Security Alert.

• Se hai selezionato l'autenticazione tramite password durante la creazione del droplet, usa root come login e inserisci la tua password root specificata durante la creazione del droplet.
• Se hai aggiunto una chiave SSH, verrai autenticato utilizzando la tua chiave privata.

Su Linux, puoi utilizzare un client SSH come OpenSSH. Inserisci ssh root@your_droplet_ip nel tuo terminale e digita yes per continuare a connetterti al server.

• Se non hai aggiunto chiavi SSH, ti verrà chiesta la password specificata durante la creazione del droplet.
• Se hai più chiavi SSH, potresti dover specificare il percorso della tua chiave privata: ssh -i /path/to/private/key root@your_droplet_ip Verrai autenticato utilizzando la tua chiave privata.

Attendi mentre il processo di installazione viene completato. Durante questo processo, il container Docker onlyoffice-document-server verrà avviato automaticamente.

Per esplorare la funzionalità della soluzione, abilita il nostro esempio di test, che ti permetterà di caricare i tuoi file locali per il test. Per farlo, esegui il seguente comando:

sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example

Aggiungi l'esempio all'avvio automatico:

sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Passo 3. Accedi a ONLYOFFICE Docs tramite un browser web

Una volta avviato l'esempio, inserisci http:// + <indirizzo IP del tuo droplet>/example/ nella barra degli indirizzi di un browser web.

Si apre la pagina dell'esempio di ONLYOFFICE Docs. Qui puoi:

1. Carica un file memorizzato sul tuo PC utilizzando l'opzione Carica file.
2. Crea un nuovo documento di testo vuoto, foglio di calcolo, presentazione o modello di modulo utilizzando le opzioni Crea nuovo → Documento, Foglio di calcolo, Presentazione o Modello di modulo. Se desideri creare un file con un contenuto di esempio, seleziona prima la casella Con contenuto di esempio.

Il file caricato o creato si aprirà in una nuova scheda del browser con il corrispondente Editor Online ONLYOFFICE in modo da poter testare le capacità di modifica.

Il file apparirà anche nell'elenco I tuoi documenti nella pagina di esempio di ONLYOFFICE Docs.

Se desideri verificare le capacità di co-editing, seleziona un altro utente di test dall'elenco Nome utente e poi clicca sullo stesso documento nell'elenco I tuoi documenti per aprirlo in una nuova scheda del browser.

Per integrare ONLYOFFICE Docs con la tua applicazione web, puoi fare riferimento alla Documentazione API.