Implementacija ONLYOFFICE Docs Developer izdanja koristeći AMI

Uvod

Sada možete lako pokrenuti instancu ONLYOFFICE Docs Developer Edition u oblaku Amazon Web Services koristeći ONLYOFFICE Amazon Machine Image dostupnu na AWS Marketplace.

Amazon Machine Image (AMI) je unapred konfigurisani šablon koji omogućava lako pokretanje instance, što je virtuelni server u privatnom oblaku AWS.

ONLYOFFICE Docs Developer Edition AMI uključuje sve potrebne komponente - kako operativni sistem, tako i sam softver, kao i skladišni volumen - za postavljanje vašeg web kancelarijskog paketa na virtuelnom serveru koji radi pod Linuxom (CentOS).

Kada vaša instanca ONLYOFFICE Docs Developer Edition bude pokrenuta, možete integrisati ONLYOFFICE Docs sa vašim SaaS ili lokalnim rešenjem. Licenca takođe omogućava da krajnjim korisnicima pružite Online Editors kao deo vašeg rešenja pod vašim brendom.

Korak 1. Izaberite potrebni ONLYOFFICE AMI i pretplatite se na rešenje

Prijavite se na svoj postojeći AWS nalog ili se registrujte za novi i idite na AWS Marketplace.

Pronađite ONLYOFFICE Docs Developer Edition rešenje i izaberite potrebni tip instance – za 250, 500 ili 1000 konekcija. Konekcije znače broj kartica u pregledaču sa dokumentima koje mogu biti otvorene za uređivanje u isto vreme. Imajte na umu da jedan dokument otvoren od strane dva korisnika znači dve istovremene konekcije, jer je otvoren u dve kartice. Kada se dostigne maksimalna vrednost, svaki sledeći dokument će se otvoriti u režimu samo za čitanje.

Na stranici Pregled proizvoda možete pročitati opis funkcija softvera.

Prebacite se na karticu Cene da procenite detalje cena koji zavise od nekih parametara instance:

• Promenite Region gde će instanca biti pokrenuta, ako je potrebno. Preporučuje se da izaberete region sa najbližom lokacijom. US East (N. Virginia) je podrazumevano izabran.
• U meniju Opcija ispunjenja dostupna je samo opcija 64-bitne (x86) Amazon Machine Image (AMI).
• U odeljku Detalji o cenama softvera dostupna je opcija pretplate po satu.

  Ukupna cena uključuje troškove za ONLYOFFICE softver i za AWS infrastrukturne usluge korišćene za postavljanje ovog softverskog rešenja.

  Napomena: za više informacija o pretplati na plaćene AMI-je i druge detalje o cenama, molimo vas da pogledate AWS dokumentaciju.

Ako kliknete na EC2 tip instance prikazan u tabeli (npr. t3.large), možete videti detalje instance. EC2 tip instance određuje hardver virtuelnog servera korišćenog za postavljanje ONLYOFFICE rešenja.

Dostupni tipovi instance se razlikuju u zavisnosti od izabrane varijante ONLYOFFICE Docs Developer Edition rešenja, tj. broja dozvoljenih konekcija.

t3.medium EC2 tip instance se koristi za ONLYOFFICE Docs Developer Edition (250 konekcija). Ima sledeće parametre:

• Memorija: 4 GB
• CPU: 2 virtuelna jezgra
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

t3.xlarge EC2 tip instance se koristi za ONLYOFFICE Docs Developer Edition (500 konekcija). Ima sledeće parametre:

• Memorija: 16 GB
• CPU: 4 virtuelna jezgra
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

t3.2xlarge EC2 tip instance se koristi za ONLYOFFICE Docs Developer Edition (1000 konekcija). Ima sledeće parametre:

• Memorija: 32 GB
• CPU: 8 virtuelnih jezgara
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

Prebacite se na karticu Upotreba gde možete pronaći sledeće informacije:

• Odeljak Opcije ispunjenja prikazuje karakteristike AMI-ja. ONLYOFFICE AMI ima 64-bitnu (x86) arhitekturu.
• Odeljak Komponente šablona prikazuje AWS usluge koje se koriste za ovaj proizvod.
  • EC2 usluga pruža okruženje potrebno za postavljanje virtuelnog servera koji radi pod CentOS-om i instaliranje ONLYOFFICE softverskog rešenja na njega.
• Uputstva za upotrebu sadrže kratke preporuke o tome kako obaviti početnu konfiguraciju ONLYOFFICE nakon pokretanja instance.
• Ugovor o licenci za krajnjeg korisnika reguliše uslove pod kojima se pruža ONLYOFFICE Docs Developer Edition rešenje.

Kliknite na dugme Nastavi na pretplatu u gornjem desnom uglu. Otvoriće se stranica Pretplata na ovaj softver:

Pročitajte AWS Ugovor sa korisnikom i kliknite na dugme Prihvati uslove. Sačekajte dok se pretplata obrađuje.

Kada se trenutni datum prikaže u polju Datum stupanja na snagu umesto 'Na čekanju', kliknite na dugme Nastavi na konfiguraciju u gornjem desnom uglu.

Korak 2. Pokrenite vašu ONLYOFFICE instancu u AWS oblaku

Na stranici Konfiguriši ovaj softver, kliknite na dugme Nastavi na pokretanje u gornjem desnom uglu.

Otvara se stranica Pokreni ovaj softver. Na ovoj stranici možete ponovo pregledati Detalje konfiguracije.

U odeljku Izaberite akciju možete odabrati metod koji želite koristiti za pokretanje instance. Opcija Pokreni sa web sajta je podrazumevano izabrana. Ostavite je nepromenjenom da biste implementirali instancu koristeći Čarobnjak za pokretanje instance dostupan na ovoj web stranici.

U odeljku EC2 Tip instance dostupna je samo jedna opcija (zavisi od prethodno izabranog tipa instance ONLYOFFICE Docs Developer Edition sa određenim brojem dozvoljenih konekcija).

U odeljcima VPC Podešavanja i Subnet Podešavanja, ostavite podrazumevana podešavanja.

Sada treba da kreirate novu Sigurnosnu grupu i generišete Par ključeva.

Kreirajte novu sigurnosnu grupu

Sigurnosna grupa omogućava ograničavanje pristupa vašoj instanci tako da joj mogu pristupiti samo poznate IP adrese.

U odeljku Podešavanja sigurnosne grupe, kliknite na dugme Kreiraj novu na osnovu podešavanja prodavca.

Unesite ime sigurnosne grupe (na primer, ONLYOFFICE) i dodajte njen opis.

Koristite listu Izvor (IP ili Grupa) da postavite potrebna pravila. Možete navesti jednu IP adresu ili opseg IP adresa, npr. 10.040.196.230/32.

Pravila su određena za sledeće portove:

• SSH - port 22 se koristi za pristup vašem serveru koristeći SSH klijent preko SSH protokola.
• HTTP - port 80 se koristi za pristup vašoj web kancelariji putem web pretraživača preko HTTP protokola.
• HTTPS - port 443 se koristi za pristup vašoj web kancelariji putem web pretraživača preko sigurnog HTTPS protokola.

Kada budete spremni, kliknite na dugme Sačuvaj.

Generišite par ključeva

Par ključeva je potreban za sigurno povezivanje sa vašom instancom putem SSH protokola koristeći SSH klijent kao što su PuTTY ili OpenSSH.

U odeljku Podešavanja para ključeva, kliknite na link Kreiraj par ključeva u EC2.

AWS Management Console će se otvoriti u novoj kartici pretraživača.

Kliknite na dugme Kreiraj par ključeva u gornjem desnom uglu. Unesite ime para ključeva (npr. ONLYOFFICE) u odgovarajuće polje i izaberite format datoteke u zavisnosti od softvera koji želite koristiti za daljinsko povezivanje sa vašom instancom:

• pem se koristi za OpenSSH
• ppk se koristi za PuTTY

Kliknite na dugme Kreiraj par ključeva ispod.

Vaš javni ključ će biti sačuvan u AWS EC2. Datoteka .pem/.ppk koja sadrži vaš privatni ključ će biti preuzeta na vaš lokalni računar i sačuvana u podrazumevanom folderu Preuzimanja. Molimo vas da je kopirate i sačuvate na sigurnom mestu.

Vratite se na AWS Marketplace, osvežite polje za par ključeva koristeći ikonu desno od njega i izaberite kreirani par ključeva sa liste.

Nakon toga, dugme Pokreni postaje otključano. Kliknite na Pokreni dugme i sačekajte dok se instanca ne implementira. Kada bude spremna, pojaviće se poruka o uspešnoj implementaciji.

Kliknite na link EC2 Console u ovoj poruci da otvorite detalje instance u AWS Management Console.

Može potrajati neko vreme dok instanca ne postane potpuno funkcionalna nakon što je pokrenete. Uverite se da se status instance promenio iz 'pending' u 'running' u koloni Status instance, i proverite da li je instanca prošla sve provere statusa. Ove informacije su prikazane u koloni Provere statusa.

Zatim se možete povezati sa svojom instancom putem SSH da omogućite test primere i proverite funkcionalnost rešenja putem web pretraživača.

Korak 3. Povežite se sa svojim serverom putem SSH

Kada instanca bude pokrenuta, možete joj pristupiti putem SSH koristeći korisničko ime centos i vaš SSH privatni ključ.

Da biste se povezali sa svojim virtuelnim serverom putem SSH, takođe ćete morati koristiti Javni DNS ili IP adresu instance.

Oni se mogu pronaći u AWS Management Console. Prebacite se na odeljak Instance u levom meniju, izaberite svoju regiju (US East (N. Virginia) podrazumevano) i izaberite svoju ONLYOFFICE instancu na listi da otvorite detalje instance.

Kliknite na ikonu levo od Javni DNS (IPv4) ili IPv4 Javni IP na kartici Opis da kopirate potrebnu vrednost u međuspremnik.

Na Windows-u, možete koristiti alat PuTTY.

Privatni ključ AWS generisan prilikom postavljanja instance koristi se za autentifikaciju umesto lozinke.

Pokrenite PuTTY. Na levoj strani navigacionog panela, otvorite sekciju Connection -> SSH -> Auth. Idite na sekciju Authentication parameters -> Private key file for authentication, kliknite na dugme Browse i pronađite putanju do .ppk datoteke koja je sačuvana na vašem lokalnom računaru.

Vratite se na sekciju Session u levoj strani navigacionog panela. Unesite Public DNS ili IP adresu instance u polje Host Name or IP address, uverite se da je port 22 naveden i da je tip veze SSH izabran, i kliknite na dugme Open.

Zatim kliknite na Yes u prozoru PuTTY Security Alert. Unesite korisničko ime centos i pritisnite Enter.

Na Linux-u, možete koristiti SSH klijent kao što je OpenSSH.

Trebaće vam da navedete putanju do .pem datoteke sa vašim privatnim ključem sačuvanim na vašem lokalnom računaru, korisničko ime centos i vašu instancu IP adresu ili Public DNS.

Unesite sledeću komandu u vaš terminal, navodeći stvarne vrednosti za putanju .pem datoteke i IP adresu:

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

Unesite yes da nastavite povezivanje sa serverom. Za više informacija, možete se obratiti AWS dokumentaciji.

Da biste istražili funkcionalnost rešenja, omogućite naš test primer, koji će vam omogućiti da otpremite vaše lokalne datoteke za testiranje. Da biste to učinili, izvršite sledeću komandu:

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

Dodajte primer u automatsko pokretanje:

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

Korak 4. Pristupite svom Docs Developer Edition putem web pregledača

Kada se primer pokrene, unesite http://<javna IP adresa>/example/ u adresnu traku web pregledača, zamenjujući <javna IP adresa> sa javnom IP adresom ili javnim DNS-om koji pruža Amazon.

Otvara se stranica primera ONLYOFFICE Docs Developer Edition. Ovde možete:

1. Otpremiti datoteku sačuvanu na vašem računaru koristeći opciju Upload file.
2. Kreirati novi prazan tekstualni dokument, tabelu, prezentaciju ili šablon forme koristeći opcije Create new -> Document, Spreadsheet, Presentation, ili Form template. Ako želite da kreirate datoteku sa uzorkom sadržaja, prvo označite polje With sample content.

Otpremeljena ili kreirana datoteka će se otvoriti u novoj kartici pregledača sa odgovarajućim ONLYOFFICE Online Editor kako biste mogli testirati mogućnosti uređivanja.

Datoteka će se takođe pojaviti na listi Your documents na stranici primera ONLYOFFICE Docs Developer Edition.

Ako želite da proverite mogućnosti zajedničkog uređivanja, izaberite drugog test korisnika sa liste Username i zatim kliknite na isti dokument na listi Your documents da biste ga otvorili u novoj kartici pregledača.

Da biste integrisali ONLYOFFICE Docs sa vašom web aplikacijom, možete se obratiti API dokumentaciji.