Bereitstellen von ONLYOFFICE Docs Developer Edition mit AMI

Melden Sie sich bei Ihrem bestehenden AWS-Konto an oder registrieren Sie sich für ein neues und öffnen Sie den AWS Marketplace.

Suchen Sie nach der Lösung ONLYOFFICE Docs Developer Edition und wählen Sie den erforderlichen Instanztyp aus – für 250, 500 oder 1000 Verbindungen. Verbindungen bedeuten die Anzahl der Browser-Tabs mit Dokumenten, die gleichzeitig zur Bearbeitung geöffnet werden können. Beachten Sie, dass ein von zwei Benutzern geöffnetes Dokument zwei gleichzeitige Verbindungen bedeutet, da es in zwei Registerkarten geöffnet wird. Wenn Sie das Limit erreichen, wird jedes nächste Dokument im schreibgeschützten Modus geöffnet.

Auf der Seite Product Overview können Sie die Beschreibung der Softwarefunktionen lesen.

Wechseln Sie zur Registerkarte Pricing, um Preisdetails zu schätzen, die von einigen Instanzparametern abhängen:

• Ändern Sie bei Bedarf die Region, in der die Instanz gestartet wird. Es wird empfohlen, eine Region mit dem nächstgelegenen Standort auszuwählen. US East (N. Virginia) ist standardmäßig ausgewählt.
• Im Optionsmenü Fulfillment option ist nur die 64-Bit (x86) Amazon Machine Image (AMI)-Option verfügbar.
• Wählen Sie im Abschnitt Software Pricing Details den Abonnementtyp Hourly oder Annual aus.

  Der Gesamtpreis beinhaltet Gebühren für die ONLYOFFICE-Software und für die AWS-Infrastrukturdienste, die zur Bereitstellung dieser Softwarelösung verwendet werden.

  Weitere Informationen zum Abonnieren von kostenpflichtigen AMIs und anderen Preisinformationen finden Sie in der AWS-Dokumentation.

Wenn Sie auf den in der Tabelle angezeigten EC2 Instance type klicken (z. B., t3.large), können Sie die Instanzdetails sehen. Der EC2-Instanz-Typ bestimmt die Hardware des virtuellen Servers, der zum Bereitstellen der ONLYOFFICE-Lösung verwendet wird.

Die verfügbaren Instanztypen unterscheiden sich je nach ausgewählter Variante der ONLYOFFICE Docs Developer Edition-Lösung, d. h. je nach Anzahl der Benutzer.

Der EC2-Instanz-Typ t3.medium wird für ONLYOFFICE Docs Developer Edition (250 Verbindungen) verwendet. Er hat die folgenden Parameter:

• Hauptspeicher: 4 GB
• CPU: 2 virtuelle Kerne
• Speicher: Nur EBS
• Netzwerk: Bis zu 5 Gigabit Ethernet

Der EC2-Instanz-Typ t3.xlarge wird für ONLYOFFICE Docs Developer Edition (500 Verbindungen) verwendet. Er hat die folgenden Parameter:

• Hauptspeicher: 16 GB
• CPU: 4 virtuelle Kerne
• Speicher: Nur EBS
• Netzwerk: Bis zu 5 Gigabit Ethernet

Der EC2-Instanz-Typ t3.2xlarge wird für ONLYOFFICE Docs Developer Edition (1000 Verbindungen) verwendet. Er hat die folgenden Parameter:

• Hauptspeicher: 32 GB
• CPU: 8 virtuelle Kerne
• Speicher: Nur EBS
• Netzwerk: Bis zu 5 Gigabit Ethernet

Wechseln Sie zur Registerkarte Usage, wo Sie die folgenden Informationen finden:

• Der Abschnitt Fulfillment Options zeigt die AMI-Merkmale an. Das ONLYOFFICE AMI hat die 64-Bit (x86) Architektur.
• Der Abschnitt Template components zeigt die AWS-Dienste an, die für dieses Produkt verwendet werden.
  • Der EC2-Dienst bietet die erforderliche Umgebung, um einen virtuellen Server bereitzustellen, der unter CentOS ausgeführt wird, und die ONLYOFFICE-Softwarelösung darauf zu installieren.
• Der Abschnitt Usage Instructions enthält kurze Empfehlungen zur Erstkonfiguration von ONLYOFFICE nach dem Start der Instanz.
• Die Endbenutzer-Lizenzvereinbarung (End User License Agreement) regelt die Bedingungen, zu denen die ONLYOFFICE Docs Developer Edition-Lösung bereitgestellt wird.

Klicken Sie oben rechts auf die Schaltfläche Continue to Subscribe. Die Seite Subscribe to this software wird geöffnet:

Lesen Sie die AWS-Kundenvereinbarung (AWS Customer Agreement) und klicken Sie auf die Schaltfläche Accept Terms. Warten Sie, während das Abonnement verarbeitet wird.

Wenn das aktuelle Datum im Feld Effective date anstelle von "Pending" angezeigt wird, klicken Sie oben rechts auf die Schaltfläche Continue to Configuration.

Klicken Sie auf der Seite Configure this software oben rechts auf die Schaltfläche Continue to Launch.

Die Seite Launch this software wird geöffnet. Auf dieser Seite können Sie die Configuration Details noch einmal überprüfen.

Im Abschnitt Choose Action können Sie die Methode auswählen, die Sie zum Starten der Instanz verwenden möchten. Die Option Launch from Website (Von Webseite starten) ist standardmäßig ausgewählt. Lassen Sie es unverändert, um die Instanz mit dem auf dieser Webseite bereitgestellten Assistenten zum Starten von Instanzen (Launch Instance Wizard) bereitzustellen.

Im Abschnitt EC2 Instance Type ist die einzige Option verfügbar (abhängig vom zuvor ausgewählten Instanztyp von ONLYOFFICE Docs Developer Edition mit einer bestimmten Anzahl von Verbindungen).

Behalten Sie in den Abschnitten VPC Settings und Subnet Settings die Standardeinstellungen bei.

Jetzt müssen Sie eine neue Sicherheitsgruppe (Security group) erstellen und ein Schlüsselpaar (Key pair) generieren.

Neue Sicherheitsgruppe erstellen

Eine Sicherheitsgruppe ermöglicht es, den Zugriff auf Ihre Instanz einzuschränken, sodass nur bekannte IP-Adressen darauf zugreifen können.

Klicken Sie im Abschnitt Security Group Settings auf die Schaltfläche Create New Based on Seller Settings.

Geben Sie den Namen der Sicherheitsgruppe ein (z.B., ONLYOFFICE) und fügen Sie ihre Beschreibung hinzu.

Verwenden Sie die Liste Source (IP or Group), um die erforderlichen Regeln festzulegen. Sie können eine einzelne IP-Adresse oder einen IP-Adressbereich angeben, z.B. 10.040.196.230/32.

Die Regeln sind für die folgenden Ports festgelegt:

• SSH - Port 22 wird verwendet, um mit einem SSH-Client über das SSH-Protokoll auf Ihren Server zuzugreifen.
• HTTP - port 80 is used to access your web office via a web browser over the HTTP protocol. Port 80 wird verwendet, um über einen Webbrowser über das HTTP-Protokoll auf Ihr WebOffice zuzugreifen.
• HTTPS - Port 443 wird verwendet, um über einen Webbrowser über das sichere HTTPS-Protokoll auf Ihr WebOffice zuzugreifen.

Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Save.

Schlüsselpaar generieren

Für eine sichere Verbindung zu Ihrer Instanz über das SSH-Protokoll mit einem SSH-Client wie PuTTY oder OpenSSH.

Klicken Sie im Abschnitt Key Pair Settings auf den Link Create a key pair in EC2.

Die AWS Management Console wird in einem neuen Browsertab geöffnet.

Klicken Sie oben rechts auf die Schaltfläche Create key pair. Geben Sie den Namen des Schlüsselpaars (z. B., ONLYOFFICE) in das entsprechende Feld ein und wählen Sie das Dateiformat aus, je nachdem, mit welcher Software Sie sich mit Ihrer Instanz verbinden möchten:

• pem wird für OpenSSH verwendet
• ppk wird für PuTTY verwendet

Klicken Sie unten auf die Schaltfläche Create key pair.

Ihr öffentlicher Schlüssel wird in AWS EC2 gespeichert. Die .pem/.ppk-Datei, die Ihren privaten Schlüssel enthält, wird auf Ihren lokalen Computer heruntergeladen und im Standardordner Downloads gespeichert. Bitte kopieren und an einem sicheren Ort aufbewahren.

Kehren Sie zum AWS Marketplace zurück, aktualisieren Sie das Schlüsselpaarfeld mithilfe des Symbols rechts davon und wählen Sie das erstellte Schlüsselpaar aus der Liste aus.

Danach wird die Schaltfläche Launch entsperrt. Klicken Sie auf die Schaltfläche Launch und warten Sie, während die Instanz bereitgestellt wird. Wenn Sie fertig sind, wird die Meldung über die erfolgreiche Bereitstellung angezeigt.

Klicken Sie in dieser Nachricht auf den Link zure EC2 Console, um die Instanzdetails in der AWS Management Console zu öffnen.

Es kann einige Zeit dauern, bis die Instanz nach dem Start vollständig funktionsfähig ist. Überprüfen Sie, dass sich der Instanzstatus in der Spalte Instance State von "pending" zu "running" geändert hat und überprüfen Sie, ob die Instanz alle Statusprüfungen bestanden hat. Diese Informationen werden in der Spalte Status Checks angezeigt.

Anschließend können Sie sich über einen Webbrowser oder per SSH mit Ihrer Instanz verbinden.

Sobald die Instanz ausgeführt wird, können Sie über SSH mit dem Benutzernamen centos und Ihrem privaten SSH-Schlüssel darauf zugreifen.

Um über einen Webbrowser auf Ihr Portal zuzugreifen, können Sie das öffentliche DNS oder die IP-Adresse der Instanz verwenden.

Sie finden sie in der AWS Management Console. Wechseln Sie im linken Menü zum Abschnitt Instances, wählen Sie Ihre Region (standardmäßig (US East (N. Virginia) und wählen Sie Ihre ONLYOFFICE-Instanz in der Liste aus, um die Instanzdetails zu öffnen.

Klicken Sie auf dem Tab Description auf das Symbol links neben der öffentlichen IPv4-DNS- (Public IPv4 DNS) oder öffentlichen IPv4-Adresse (Public IPv4), um den erforderlichen Wert in die Zwischenablage zu kopieren.

Unter Windows können Sie das Dienstprogramm PuTTY verwenden.

Die private AWS-Schlüsseldatei, die beim Bereitstellen der Instanz generiert wird, wird zur Authentifizierung anstelle eines Kennworts verwendet.

Starten Sie PuTTY. Öffnen Sie im linken Navigationsbereich den Abschnitt Connection -> SSH -> Auth. Gehen Sie zum Abschnitt Authentication parameters -> Private key file for authentication, klicken Sie auf die Schaltfläche Browse und suchen Sie den Pfad zur .ppk-Datei, die auf Ihrem lokalen Computer gespeichert ist.

Kehren Sie im linken Navigationsbereich zum Abschnitt Session zurück. Geben Sie das öffentliche DNS oder die IP-Adresse der Instanz in das Feld Host Name or IP address ein, stellen Sie sicher, dass Port 22 angegeben und der SSH-Verbindungstyp ausgewählt ist, und klicken Sie auf die Schaltfläche Open.

Klicken Sie dann im Fenster PuTTY Security Alert auf Yes. Geben Sie den Benutzernamen centos ein und drücken Sie die Eingabetaste.

Unter Linux können Sie einen SSH-Client wie OpenSSH verwenden.

Sie müssen einen Pfad zur .pem-Datei mit Ihrem auf Ihrem lokalen Computer gespeicherten privaten Schlüssel, den centos-Benutzernamen und die IP-Adresse Ihrer Instanz oder das öffentliche DNS angeben.

Geben Sie den folgenden Befehl in Ihr Terminal ein und geben Sie die tatsächlichen Werte für den .pem-Dateipfad und die IP-Adresse an:

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

Geben Sie yes ein, um die Verbindung zum Server fortzusetzen. Weitere Informationen finden Sie in der AWS-Dokumentation.

Um die Lösungsfunktionalität zu erkunden, aktivieren Sie unser Testbeispiel, mit dem Sie Ihre lokalen Dateien zum Testen hochladen können. Führen Sie dazu den folgenden Befehl aus:

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

Fügen Sie das Beispiel zum Autostart hinzu:

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

Geben Sie nach dem Start des Tests http://<public IP address>/example/ in die Adressleiste eines Webbrowsers ein und ersetzen Sie <public IP address> durch die öffentliche IP-Adresse oder das öffentliche DNS, das von Amazon bereitgestellt wird.

Die Testseite der Docs Developer Edition wird geöffnet. Hier können Sie:

1. Laden Sie mit der Option Datei hochladen eine auf Ihrem PC gespeicherte Datei hoch.
2. Erstellen Sie mit den Optionen Dokument erstellen, Tabelle erstellen oder Präsentation erstellen ein neues leeres Textdokument, eine Tabelle oder eine Präsentation. Wenn Sie eine Datei mit Beispielinhalt erstellen möchten, aktivieren Sie zuerst das Kontrollkästchen Create a file filled with sample content.

Die hochgeladene oder erstellte Datei wird in einem neuen Browser-Tab mit dem entsprechenden ONLYOFFICE Online Editor geöffnet, damit Sie die Bearbeitungsfunktionen testen können.

Die Datei wird auch in der Liste Ihre Dokumente auf der Docs Developer Edition-Beispielseite angezeigt.

Wenn Sie die Co-Editing-Funktionen testen möchten, wählen Sie einen anderen Testbenutzer aus der Liste Benutzername aus und klicken Sie dann in der Liste Ihre Dokumente auf dasselbe Dokument, um es in einem neuen Browsertab zu öffnen.

Informationen zur Integration von ONLYOFFICE Docs in Ihre eigene Webanwendung finden Sie in der API-Dokumentation https://api.onlyoffice.com/editors/basic