ONLYOFFICE Docs Developer Edition'ı AMI ile dağıtma

Giriş

Artık AWS Marketplace'te bulunan ONLYOFFICE Amazon Machine Image'ı kullanarak ONLYOFFICE Docs Developer Edition örneğini Amazon Web Services bulut altyapısında kolayca başlatabilirsiniz.

Amazon Machine Image (AMI), AWS özel bulutunda sanal sunucu olan bir örneği kolayca başlatmanıza olanak tanıyan, önceden yapılandırılmış bir şablondur.

ONLYOFFICE Docs Developer Edition AMI, web ofisinizi Linux (CentOS) üzerinde çalışan bir sanal sunucuya dağıtmak için gereken tüm bileşenleri, yani hem işletim sistemini hem yazılımın kendisini hem de bir depolama birimini içerir.

ONLYOFFICE Docs Developer Edition örneğiniz başlatıldıktan sonra ONLYOFFICE Docs'u kendi SaaS veya şirket içi çözümünüzle bütünleştirebilirsiniz. Lisans ayrıca Çevrimiçi Editörler'i çözümünüzün bir parçası olarak kendi markanız altında son kullanıcılara sunmanıza da olanak tanır.

1. Adım. Gerekli ONLYOFFICE AMI'yi seçin ve çözüme abone olun

Mevcut AWS hesabınızda oturum açın veya yeni bir hesap oluşturun ve AWS Marketplace'e gidin.

ONLYOFFICE Docs Developer Edition çözümünü bulun ve gerekli örnek türünü (250, 500 veya 1000 bağlantı için) seçin. Bağlantı, aynı anda düzenlenmek üzere açılabilecek belge içeren tarayıcı sekmelerinin sayısı demektir. İki kullanıcı tarafından açılan bir belgenin iki sekmede açıldığı için iki eşzamanlı bağlantı anlamına geldiğini unutmayın. Azami değere ulaşıldığında sonraki her belge salt okunur modda açılır.

Product Overview sayfasında yazılım işlevlerinin açıklamasını okuyabilirsiniz.

Bazı örnek parametrelerine bağlı olan fiyat ayrıntılarını tahmin etmek için Pricing sekmesine geçin:

• Gerekirse örneğin başlatılacağı Region değerini değiştirin. En yakın konumdaki bölgeyi seçmeniz önerilir. Varsayılan olarak US East (N. Virginia) seçilidir.

• Fulfillment option menüsünde yalnızca 64 bit (x86) Amazon Machine Image (AMI) seçeneği vardır.

• Software Pricing Details bölümünde yalnızca saatlik abonelik türü kullanılabilir.

  Toplam fiyat, ONLYOFFICE yazılımı ile bu yazılım çözümünü dağıtmak için kullanılan AWS altyapı hizmetlerinin ücretlerini içerir.

  not

  Ücretli AMI'lere abone olma ve diğer fiyatlandırma ayrıntıları hakkında daha fazla bilgi için AWS belgelerine bakın.

Tabloda görüntülenen EC2 Instance type değerine (örneğin t3.large) tıklarsanız örnek ayrıntılarını görebilirsiniz. EC2 örnek türü, ONLYOFFICE çözümünü dağıtmak için kullanılan sanal sunucunun donanımını belirler.

Kullanılabilen örnek türleri, seçilen ONLYOFFICE Docs Developer Edition çözümü varyantına, yani izin verilen bağlantı sayısına göre değişir.

t3.medium EC2 Instance türü ONLYOFFICE Docs Developer Edition (250 bağlantı) için kullanılır. Parametreleri şunlardır:

• Memory: 4 GB
• CPU: 2 sanal çekirdek
• Storage: yalnızca EBS
• Network: 5 Gigabit Ethernet'e kadar

t3.xlarge EC2 Instance türü ONLYOFFICE Docs Developer Edition (500 bağlantı) için kullanılır. Parametreleri şunlardır:

• Memory: 16 GB
• CPU: 4 sanal çekirdek
• Storage: yalnızca EBS
• Network: 5 Gigabit Ethernet'e kadar

t3.2xlarge EC2 Instance türü ONLYOFFICE Docs Developer Edition (1000 bağlantı) için kullanılır. Parametreleri şunlardır:

• Memory: 32 GB
• CPU: 8 sanal çekirdek
• Storage: yalnızca EBS
• Network: 5 Gigabit Ethernet'e kadar

Aşağıdaki bilgileri bulabileceğiniz Usage sekmesine geçin:

• Fulfillment Options bölümü AMI özelliklerini gösterir. ONLYOFFICE AMI, 64 bit (x86) mimarisine sahiptir.
• Template components bölümü bu ürün için kullanılan AWS hizmetlerini gösterir.
  • EC2 hizmeti, CentOS üzerinde çalışan bir sanal sunucuyu dağıtmak ve ONLYOFFICE yazılım çözümünü ona kurmak için gereken ortamı sağlar.
• Usage Instructions, örneği başlattıktan sonra ilk ONLYOFFICE yapılandırmasının nasıl yapılacağına dair kısa öneriler içerir.
• End User License Agreement, ONLYOFFICE Docs Developer Edition çözümünün sunulduğu şart ve koşulları düzenler.

Sağ üst köşedeki Continue to Subscribe düğmesine tıklayın. Subscribe to this software sayfası açılır:

AWS Customer Agreement'ı okuyun ve Accept Terms düğmesine tıklayın. Abonelik işlenirken bekleyin.

Effective date alanında 'Pending' yerine geçerli tarih görüntülendiğinde, sağ üst köşedeki Continue to Configuration düğmesine tıklayın.

2. Adım. ONLYOFFICE örneğinizi AWS bulutunda başlatın

Configure this software sayfasında sağ üst köşedeki Continue to Launch düğmesine tıklayın.

Launch this software sayfası açılır. Bu sayfada Configuration Details bilgilerini bir kez daha gözden geçirebilirsiniz.

Choose Action bölümü, örneği başlatmak için kullanmak istediğiniz yöntemi seçmenize olanak tanır. Varsayılan olarak Launch from Website seçeneği seçilidir. Örneği bu web sayfasında sunulan Launch Instance Wizard ile dağıtmak için bu seçeneği değiştirmeden bırakın.

not

Örneğinizi Amazon EC2 console üzerinden de başlatabilirsiniz. Bunun için menüden Launch through EC2 seçeneğini seçin ve Launch düğmesine tıklayın. AWS Management Console içindeki Launch Instance Wizard'a yönlendirilirsiniz. Orada bir örnek türü seçebilir, örnek ayrıntılarını yapılandırabilir, depolama alanı ve etiketler ekleyebilir ve bir güvenlik grubu yapılandırabilirsiniz. Bu kılavuz, örneği bu yöntemle başlatmayı anlatmaz.

EC2 Instance Type bölümünde yalnızca tek bir seçenek bulunur (daha önce seçtiğiniz, belirli sayıda bağlantıya izin veren ONLYOFFICE Docs Developer Edition örnek türüne bağlıdır).

VPC Settings ve Subnet Settings bölümlerinde varsayılan ayarları değiştirmeden bırakın.

Şimdi yeni bir Security group oluşturmanız ve bir Key pair üretmeniz gerekir.

Yeni bir güvenlik grubu oluşturma

Güvenlik grubu, örneğinize erişimi yalnızca bilinen IP adreslerinin erişebileceği şekilde sınırlamanıza olanak tanır.

Security Group Settings bölümünde Create New Based on Seller Settings düğmesine tıklayın.

Güvenlik grubunun adını (örneğin ONLYOFFICE) girin ve açıklamasını ekleyin.

Gerekli kuralları belirlemek için Source (IP or Group) listesini kullanın. Tek bir IP adresi veya bir IP adresi aralığı belirtebilirsiniz, örneğin 10.040.196.230/32.

Kurallar aşağıdaki bağlantı noktaları için belirlenir:

• SSH - SSH istemcisiyle sunucunuza SSH protokolü üzerinden erişmek için 22 numaralı bağlantı noktası kullanılır.
• HTTP - web ofisinize bir web tarayıcısıyla HTTP protokolü üzerinden erişmek için 80 numaralı bağlantı noktası kullanılır.
• HTTPS - web ofisinize bir web tarayıcısıyla güvenli HTTPS protokolü üzerinden erişmek için 443 numaralı bağlantı noktası kullanılır.

Hazır olduğunuzda Save düğmesine tıklayın.

Anahtar çifti üretme

Örneğinize PuTTY veya OpenSSH gibi bir SSH istemcisiyle SSH protokolü üzerinden güvenli şekilde bağlanmak için bir anahtar çifti gerekir.

Key Pair Settings bölümünde Create a key pair in EC2 bağlantısına tıklayın.

AWS Management Console yeni bir tarayıcı sekmesinde açılır.

not

Üst araç çubuğunda görüntülenen AWS Region değerinin örneği başlatmak istediğiniz bölgeyle aynı olduğunu doğrulayın.

Sağ üst köşedeki Create key pair düğmesine tıklayın. İlgili alana anahtar çiftinin adını (örneğin ONLYOFFICE) girin ve örneğinize uzaktan bağlanmak için hangi yazılımı kullanacağınıza göre dosya biçimini seçin:

• pem, OpenSSH için kullanılır
• ppk, PuTTY için kullanılır

Aşağıdaki Create key pair düğmesine tıklayın.

Genel anahtarınız AWS EC2'de saklanır. Özel anahtarınızı içeren .pem/.ppk dosyası yerel makinenize indirilir ve varsayılan Downloads klasörüne kaydedilir. Lütfen dosyayı kopyalayıp güvenli bir yerde saklayın.

AWS Marketplace'e dönün, anahtar çifti alanının sağındaki simgeyle alanı yenileyin ve listeden oluşturduğunuz anahtar çiftini seçin.

Bundan sonra Launch düğmesinin kilidi açılır. Launch düğmesine tıklayın ve örnek dağıtılırken bekleyin. Hazır olduğunda başarılı dağıtım iletisi görüntülenir.

Örnek ayrıntılarını AWS Management Console'da açmak için bu iletideki EC2 Console bağlantısına tıklayın.

Örneğin başlatıldıktan sonra tamamen çalışır hale gelmesi biraz zaman alabilir. Instance State sütununda örnek durumunun 'pending' değerinden 'running' değerine değiştiğinden emin olun ve örneğin tüm durum denetimlerinden geçtiğini doğrulayın. Bu bilgi Status Checks sütununda görüntülenir.

Ardından test örneklerini etkinleştirmek ve çözümün işlevlerini bir web tarayıcısıyla kontrol etmek için örneğinize SSH ile bağlanabilirsiniz.

3. Adım. Sunucunuza SSH ile bağlanın

Örnek çalışmaya başladığında, centos kullanıcı adını ve SSH özel anahtarınızı kullanarak ona SSH ile erişebilirsiniz.

Sanal sunucunuza SSH ile bağlanmak için ayrıca örneğin Public DNS veya IP address değerini kullanmanız gerekir.

Bunları AWS Management Console'da bulabilirsiniz. Sol menüde Instances bölümüne geçin, bölgenizi seçin (varsayılan olarak US East (N. Virginia)) ve örnek ayrıntılarını açmak için listeden ONLYOFFICE örneğinizi seçin.

Gerekli değeri panoya kopyalamak için Description sekmesinde Public DNS (IPv4) veya IPv4 Public IP değerinin solundaki simgesine tıklayın.

Windows'ta PuTTY yardımcı programını kullanabilirsiniz.

Kimlik doğrulama için parola yerine, örneği dağıtırken oluşturulan AWS özel anahtar dosyası kullanılır.

PuTTY'yi başlatın. Sol taraftaki gezinme panelinde Connection -> SSH -> Auth bölümünü açın. Authentication parameters -> Private key file for authentication bölümüne gidin, Browse düğmesine tıklayın ve yerel makinenizde saklanan .ppk dosyasının yolunu bulun.

Sol taraftaki gezinme panelinde Session bölümüne dönün. Örneğin Public DNS veya IP address değerini Host Name or IP address alanına girin, 22 numaralı bağlantı noktasının belirtildiğinden ve SSH bağlantı türünün seçili olduğundan emin olun ve Open düğmesine tıklayın.

Ardından PuTTY Security Alert penceresinde Yes düğmesine tıklayın. centos kullanıcı adını yazın ve Enter tuşuna basın.

Linux'ta OpenSSH gibi bir SSH istemcisi kullanabilirsiniz.

Özel anahtarınızı içeren ve yerel makinenizde saklanan .pem dosyasının yolunu, centos kullanıcı adını ve örneğinizin IP address veya Public DNS değerini belirtmeniz gerekir.

Terminalinize aşağıdaki komutu girin ve .pem dosya yolu ile IP Address için gerçek değerleri belirtin:

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

Sunucuya bağlanmaya devam etmek için yes yazın. Daha fazla bilgi için AWS belgelerine başvurabilirsiniz.

Çözümün işlevlerini keşfetmek için, test amacıyla yerel dosyalarınızı yüklemenize olanak tanıyan test örneğimizi etkinleştirin. Bunun için aşağıdaki komutu çalıştırın:

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

Örneği otomatik başlatmaya ekleyin:

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

4. Adım. Docs Developer Edition'a bir web tarayıcısıyla erişin

Örnek başlatıldıktan sonra, web tarayıcısının adres çubuğuna http://<public IP address>/example/ yazın ve <public IP address> yerine Amazon tarafından sağlanan genel IP adresini veya genel DNS'yi girin.

ONLYOFFICE Docs Developer Edition örnek sayfası açılır. Burada şunları yapabilirsiniz:

1. Upload file seçeneğiyle bilgisayarınızda saklanan bir dosyayı yükleyin.
2. Create new -> Document, Spreadsheet, Presentation veya Form template seçenekleriyle yeni bir boş metin belgesi, e-tablo, sunum veya form şablonu oluşturun. Örnek içerikli bir dosya oluşturmak istiyorsanız önce With sample content kutusunu işaretleyin.

Yüklenen veya oluşturulan dosya, düzenleme yeteneklerini test edebilmeniz için ilgili ONLYOFFICE Çevrimiçi Editörü ile yeni bir tarayıcı sekmesinde açılır.

Dosya ayrıca ONLYOFFICE Docs Developer Edition örnek sayfasındaki Your documents listesinde de görünür.

Ortak düzenleme yeteneklerini denetlemek istiyorsanız, Username listesinden başka bir test kullanıcısı seçin ve ardından aynı belgeyi yeni bir tarayıcı sekmesinde açmak için Your documents listesinde ona tıklayın.

ONLYOFFICE Docs'u kendi web uygulamanızla bütünleştirmek için API Belgeleri'ne başvurabilirsiniz.