Distribuire ONLYOFFICE Docs Developer Edition utilizzando AMI

Introduzione

Ora puoi facilmente avviare l'istanza di ONLYOFFICE Docs Developer 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, ovvero un server virtuale nel cloud privato di AWS.

L'ONLYOFFICE Docs Developer 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 che funziona sotto Linux (CentOS).

Una volta avviata la tua istanza di ONLYOFFICE Docs Developer Edition, puoi integrare ONLYOFFICE Docs con la tua soluzione SaaS o on-premises. La licenza ti consente anche di fornire Editor Online agli utenti finali come parte della tua soluzione sotto il tuo marchio.

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 Developer Edition e scegli il tipo di istanza necessario – per 250, 500 o 1000 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 si raggiunge il valore massimo, ogni documento successivo si aprirà 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. È consigliato selezionare una regione con la posizione più vicina. US East (N. Virginia) è selezionato per impostazione predefinita.
• Nel menu Opzione di adempimento, è disponibile solo l'opzione Amazon Machine Image (AMI) a 64 bit (x86).
• Nella sezione Dettagli dei prezzi del software, è disponibile il tipo di abbonamento orario.

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

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

Se fai clic sul tipo di Istanza EC2 visualizzato nella tabella (ad es., 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 Developer Edition, cioè sul numero di connessioni consentite.

Il tipo di istanza EC2 t3.medium è utilizzato per ONLYOFFICE Docs Developer Edition (250 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 Developer Edition (500 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 Developer Edition (1000 connessioni). Ha i seguenti parametri:

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

Passa alla scheda Uso 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 che funziona sotto CentOS e installare su di esso la soluzione software ONLYOFFICE.
• 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 ai quali viene fornita la soluzione ONLYOFFICE Docs Developer 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 con il 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 alla configurazione nell'angolo in alto a destra.

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

Nella pagina Configura questo software, 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. Lasciala invariata per distribuire l'istanza utilizzando il Wizard di Avvio Istanze fornito in questa pagina web.

Nella sezione Tipo di Istanza EC2, è disponibile solo un'opzione (dipende dal tipo di istanza ONLYOFFICE Docs Developer 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 indirizzi IP conosciuti possano accedervi.

Nella sezione Impostazioni Gruppo di Sicurezza, fai clic sul pulsante Crea Nuovo Basato su Impostazioni Venditore.

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

Usa l'elenco Origine (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

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

Nella sezione Impostazioni 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 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. Copialo e conservalo 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 si sblocca. Fai clic sul Avvia pulsante e attendi mentre l'istanza viene distribuita. Quando è pronta, appare il messaggio di avvenuta distribuzione.

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

Può volerci 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 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 Istanze 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 IP Pubblico IPv4 nella scheda Descrizione per copiare il valore necessario negli appunti.

Su Windows, puoi utilizzare l'utilità PuTTY.

Il file di 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 di PuTTY Security Alert. Digita il nome utente centos e premi Enter.

Su Linux, puoi utilizzare un client SSH come OpenSSH.

Dovrai specificare un percorso al 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 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 4. Accedi alla tua Docs Developer 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 della Developer Edition di ONLYOFFICE Docs. 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 nella lista Your documents nella pagina di esempio della Developer Edition di ONLYOFFICE Docs.

Se desideri verificare le capacità di co-editing, seleziona un altro utente di test dalla lista Username e poi clicca sullo stesso documento nella lista 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.