Distribuire ONLYOFFICE Docs Enterprise Edition utilizzando AMI

Introduzione

Ora puoi facilmente avviare l'istanza di ONLYOFFICE Docs Enterprise Edition nell'infrastruttura cloud di Amazon Web Services utilizzando l'ONLYOFFICE Amazon Machine Image disponibile su AWS Marketplace.

L'Amazon Machine Image (AMI) è un modello preconfigurato che consente di avviare facilmente un'istanza, che è un server virtuale nel cloud privato di AWS.

L'ONLYOFFICE Docs Enterprise Edition AMI include tutti i componenti necessari - sia il sistema operativo che il software stesso, oltre a un volume di archiviazione - per distribuire il tuo ufficio web su un server virtuale in esecuzione su Linux (CentOS).

Una volta avviata la tua istanza di ONLYOFFICE Docs Enterprise Edition, puoi integrare ONLYOFFICE Docs con una delle piattaforme di sincronizzazione e condivisione file, come Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub, ecc.

Passo 1. Scegli l'AMI di ONLYOFFICE necessario e iscriviti alla soluzione

Accedi al tuo account AWS esistente o registrati per uno nuovo e vai su AWS Marketplace.

Trova la soluzione ONLYOFFICE Docs Enterprise Edition e scegli il tipo di istanza necessario – per 50, 100, 200 o 400 connessioni. Le connessioni indicano il numero di schede del browser con documenti che possono essere aperte per la modifica contemporaneamente. Nota che un documento aperto da due utenti significa due connessioni simultanee, poiché è aperto in due schede. Quando raggiungi il limite, ogni documento successivo si apre in modalità di sola lettura.

Nella pagina Panoramica del prodotto, puoi leggere la descrizione delle funzioni del software.

Passa alla scheda Prezzi per stimare i dettagli dei prezzi che dipendono da alcuni parametri dell'istanza:

• Cambia la Regione in cui verrà avviata l'istanza, se necessario. Si consiglia di selezionare una regione con la posizione più vicina. US East (N. Virginia) è selezionata di default.
• Nel menu Opzione di adempimento, è disponibile solo l'opzione Amazon Machine Image (AMI) a 64 bit (x86).
• Nella sezione Dettagli dei prezzi del software, scegli il tipo di abbonamento Orario o Annuale.

  Il prezzo totale include le spese per il software ONLYOFFICE e per i servizi infrastrutturali AWS utilizzati per distribuire questa soluzione software.

  Nota: per saperne di più sull'abbonamento alle AMI a pagamento e altri dettagli sui prezzi, consulta la documentazione AWS.

Se fai clic sul tipo di istanza EC2 visualizzato nella tabella (ad esempio, t3.large), puoi vedere i dettagli dell'istanza. Il tipo di istanza EC2 determina l'hardware del server virtuale utilizzato per distribuire la soluzione ONLYOFFICE.

I tipi di istanza disponibili differiscono a seconda della variante selezionata della soluzione ONLYOFFICE Docs Enterprise Edition, cioè sul numero di connessioni consentite.

Il tipo di istanza EC2 t3.small è utilizzato per ONLYOFFICE Docs Enterprise Edition (50 connessioni). Ha i seguenti parametri:

• Memoria: 2 GB
• CPU: 2 core virtuali
• Archiviazione: Solo EBS
• Rete: Fino a 5 Gigabit Ethernet

Il tipo di istanza EC2 t3.medium è utilizzato per ONLYOFFICE Docs Enterprise Edition (100 connessioni). Ha i seguenti parametri:

• Memoria: 4 GB
• CPU: 2 core virtuali
• Archiviazione: Solo EBS
• Rete: Fino a 5 Gigabit Ethernet

Il tipo di istanza EC2 t3.xlarge è utilizzato per ONLYOFFICE Docs Enterprise Edition (200 connessioni). Ha i seguenti parametri:

• Memoria: 16 GB
• CPU: 4 core virtuali
• Archiviazione: Solo EBS
• Rete: Fino a 5 Gigabit Ethernet

Il tipo di istanza EC2 t3.2xlarge è utilizzato per ONLYOFFICE Docs Enterprise Edition (400 connessioni). Ha i seguenti parametri:

• Memoria: 32 GB
• CPU: 8 core virtuali
• Archiviazione: Solo EBS
• Rete: Fino a 5 Gigabit Ethernet

Passa alla scheda Utilizzo, dove puoi trovare le seguenti informazioni:

• La sezione Opzioni di adempimento mostra le caratteristiche dell'AMI. L'AMI di ONLYOFFICE ha l'architettura a 64 bit (x86).
• La sezione Componenti del modello mostra i servizi AWS utilizzati per questo prodotto.
  • Il servizio EC2 fornisce l'ambiente necessario per distribuire un server virtuale in esecuzione su CentOS e installare la soluzione software ONLYOFFICE su di esso.
• Istruzioni per l'uso contengono brevi raccomandazioni su come eseguire la configurazione iniziale di ONLYOFFICE dopo l'avvio dell'istanza.
• Contratto di licenza per l'utente finale regola i termini e le condizioni in base alle quali viene fornita la soluzione ONLYOFFICE Docs Enterprise Edition.

Fai clic sul pulsante Continua per iscriverti nell'angolo in alto a destra. Si apre la pagina Iscriviti a questo software:

Leggi l'Accordo cliente AWS e fai clic sul pulsante Accetta i termini. Attendi mentre l'iscrizione viene elaborata.

Quando la data corrente viene visualizzata nel campo Data effettiva invece di 'In sospeso', fai clic sul pulsante Continua per la configurazione nell'angolo in alto a destra.

Passo 2. Avvia la tua istanza di ONLYOFFICE nel cloud AWS

Nella pagina Configura questo software

nella pagina, fai clic sul pulsante Continua per avviare nell'angolo in alto a destra.

Si apre la pagina Avvia questo software. In questa pagina, puoi rivedere nuovamente i Dettagli di configurazione.

La sezione Scegli azione consente di selezionare il metodo che desideri utilizzare per avviare l'istanza. L'opzione Avvia dal sito web è selezionata per impostazione predefinita. Lascia invariato per distribuire l'istanza utilizzando il Wizard di avvio dell'istanza fornito in questa pagina web.

Nella sezione Tipo di istanza EC2, è disponibile solo un'opzione (dipende dal tipo di istanza ONLYOFFICE Docs Enterprise Edition precedentemente selezionato con un certo numero di connessioni consentite).

Nelle sezioni Impostazioni VPC e Impostazioni subnet, lascia le impostazioni predefinite.

Ora devi creare un nuovo Gruppo di sicurezza e generare una Coppia di chiavi.

Crea un nuovo gruppo di sicurezza

Un gruppo di sicurezza consente di limitare l'accesso alla tua istanza in modo che solo gli indirizzi IP conosciuti possano accedervi.

Nella sezione Impostazioni del gruppo di sicurezza, fai clic sul pulsante Crea nuovo basato sulle impostazioni del venditore.

Inserisci il nome del gruppo di sicurezza (ad esempio, ONLYOFFICE) e aggiungi la sua descrizione.

Usa l'elenco Fonte (IP o Gruppo) per impostare le regole necessarie. Puoi specificare un singolo indirizzo IP o un intervallo di indirizzi IP, ad esempio 10.040.196.230/32.

Le regole sono specificate per le seguenti porte:

• SSH - la porta 22 è utilizzata per accedere al tuo server utilizzando un client SSH tramite il protocollo SSH.
• HTTP - la porta 80 è utilizzata per accedere al tuo ufficio web tramite un browser web tramite il protocollo HTTP.
• HTTPS - la porta 443 è utilizzata per accedere al tuo ufficio web tramite un browser web tramite il protocollo sicuro HTTPS.

Quando sei pronto, fai clic sul pulsante Salva.

Genera una coppia di chiavi

È necessaria una coppia di chiavi per connettersi in modo sicuro alla tua istanza tramite il protocollo SSH utilizzando un client SSH come PuTTY o OpenSSH.

Nella sezione Impostazioni della coppia di chiavi, fai clic sul link Crea una coppia di chiavi in EC2.

La Console di gestione AWS si aprirà in una nuova scheda del browser.

Fai clic sul pulsante Crea coppia di chiavi nell'angolo in alto a destra. Inserisci il nome della coppia di chiavi (ad esempio, ONLYOFFICE) nel campo corrispondente e seleziona il formato del file a seconda del software che desideri utilizzare per connetterti alla tua istanza da remoto:

• pem è utilizzato per OpenSSH
• ppk è utilizzato per PuTTY

Fai clic sul pulsante Crea coppia di chiavi qui sotto.

La tua chiave pubblica verrà memorizzata in AWS EC2. Il file .pem/.ppk che contiene la tua chiave privata verrà scaricato sul tuo computer locale e memorizzato nella cartella predefinita Download. Si prega di copiarlo e conservarlo in un luogo sicuro.

Ritorna al Marketplace AWS, aggiorna il campo della coppia di chiavi utilizzando l'icona a destra di esso e seleziona la coppia di chiavi creata dall'elenco.

Dopo di ciò, il pulsante Avvia diventa sbloccato. Fai clic sul Avvia pulsante e attendi mentre l'istanza viene distribuita. Quando pronta, appare il messaggio di distribuzione avvenuta con successo.

Fai clic sul link Console EC2 in questo messaggio per aprire i dettagli dell'istanza nella Console di gestione AWS.

Può richiedere del tempo affinché l'istanza diventi completamente funzionale dopo che l'hai avviata. Assicurati che lo stato dell'istanza sia cambiato da 'pending' a 'running' nella colonna Stato dell'istanza, e verifica che l'istanza abbia superato tutti i controlli di stato. Queste informazioni sono visualizzate nella colonna Controlli di stato.

Quindi puoi connetterti alla tua istanza tramite SSH per abilitare esempi di test e verificare la funzionalità della soluzione tramite un browser web.

Passo 3. Connettiti al tuo server tramite SSH

Una volta che l'istanza è in esecuzione, puoi accedervi tramite SSH utilizzando il nome utente centos e la tua chiave privata SSH.

Per connetterti al tuo server virtuale tramite SSH, avrai anche bisogno di utilizzare il DNS pubblico o l'indirizzo IP dell'istanza.

Possono essere trovati nella Console di gestione AWS. Passa alla sezione Istanza nel menu a sinistra, scegli la tua regione (US East (N. Virginia) per impostazione predefinita) e seleziona la tua istanza ONLYOFFICE nell'elenco per aprire i dettagli dell'istanza.

Fai clic sull'icona a sinistra del DNS pubblico IPv4 o dell'indirizzo pubblico IPv4 nella scheda Descrizione per copiare il valore necessario negli appunti.

Su Windows, puoi utilizzare l'utilità PuTTY.

Il file chiave privata AWS generato durante il deployment dell'istanza viene utilizzato per l'autenticazione al posto di una password.

Avvia PuTTY. Nel pannello di navigazione a sinistra, apri la sezione Connection -> SSH -> Auth. Vai alla sezione Authentication parameters -> Private key file for authentication, clicca sul pulsante Browse e trova il percorso del file .ppk memorizzato sul tuo computer locale.

Ritorna alla sezione Session nel pannello di navigazione a sinistra. Inserisci il Public DNS o l'indirizzo IP dell'istanza nel campo Host Name or IP address, assicurati che la porta 22 sia specificata e che il tipo di connessione SSH sia selezionato, quindi clicca sul pulsante Open.

Quindi clicca su Yes nella finestra PuTTY Security Alert. Digita il nome utente centos e premi Enter.

Su Linux, puoi utilizzare un client SSH come OpenSSH.

Dovrai specificare un percorso per il file .pem con la tua chiave privata memorizzata sul tuo computer locale, il nome utente centos e l'indirizzo IP o il Public DNS della tua istanza.

Inserisci il seguente comando nel tuo terminale, specificando i valori effettivi per il percorso del file .pem e l'indirizzo IP:

ssh -i /path/onlyoffice.pem centos@your_instance_ip

Digita yes per continuare a connetterti al server. Per maggiori informazioni, puoi fare riferimento alla documentazione AWS.

Per esplorare la funzionalità della soluzione, abilita il nostro esempio di test, che ti permetterà di caricare i tuoi file locali per i 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 4. Accedi alla tua Docs Enterprise Edition tramite un browser web

Una volta avviato l'esempio, inserisci http://<indirizzo IP pubblico>/example/ nella barra degli indirizzi di un browser web, sostituendo <indirizzo IP pubblico> con l'indirizzo IP pubblico o il DNS pubblico fornito da Amazon.

Si apre la pagina di esempio di ONLYOFFICE Docs Enterprise Edition. Qui puoi:

1. Caricare un file memorizzato sul tuo PC utilizzando l'opzione Upload file.
2. Creare un nuovo documento di testo vuoto, foglio di calcolo, presentazione o modello di modulo utilizzando le opzioni Create new -> Document, Spreadsheet, Presentation, o Form template. Se desideri creare un file con un contenuto di esempio, seleziona prima la casella With sample content.

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

Il file apparirà anche nell'elenco Your documents nella pagina di esempio di ONLYOFFICE Docs Enterprise Edition.

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

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