Déployer ONLYOFFICE Docs Développeur utilisant AMI

Introduction

Maintenant vous pouvez facilement lancer l'instance ONLYOFFICE Docs Édition Développeur dans le cloud Amazon Web Services à partir d'une ONLYOFFICE Amazon Machine Image disponible sur AWS Marketplace.

Amazon Machine Image (AMI) est un modèle qui contient une configuration logicielle permettant de démarrer une instance qui est un serveur virtuel dans le cloud privé AWS.

ONLYOFFICE Docs Édition Développeur AMI comporte tous les éléments nécessaires: le logicielle, le système d'exploitation et le volume de stockage pour déployer un office en ligne sur un serveur virtuel sous Linux (CentOS).s

Une fois votre instance ONLYOFFICE Docs Édition Développeur lancée, vous pouvez intégrer ONLYOFFICE Docs dans votre solution SaaS ou une solution basé sur le serveur. La licence vous aussi permet de fournir des éditeurs en ligne aux utilisateurs finaux dans le cadre de votre solution sous votre propre marque.

Étape 1. Choisir une instance ONLYOFFICE AMI et l'option d'abonnement

Connectez-vous à votre compte AWS ou créez un nouveau compte et passez à AWS Marketplace.

Trouvez la solution ONLYOFFICE Docs Édition Développeur et choisissez l'instance appropriée pour 250, 500, 200 ou 1000 connexions. Le nombre de connexions est le nombre d'onglets qu'on peut ouvrir à la fois pour éditer des documents. Veuillez noter que les deux utilisateurs qui ont ouvert le même document sont deux connexions simultanées puisque le document est ouvert dans deux onglets. Une fois la limite maximale atteinte, tous les documents ultérieurs seront ouverts en lecture seule.

Sur la page Product Overview (Aperçu du produit), vous découvrez les principales fonctionnalités du logiciel.

Passez à l'onglet Pricing (Tarification) pour estimer les détails de tarification qui dépendent de certains paramètres de l'instance:

• Changez le Région où vous allez démarrer l'instance, le cas échéant. Il est recommandé de choisir la région la plus proche. US East (N. Virginia) est l'option par défaut.
• Dans le menu Fulfillment option (Options d'exécution), 64-bit (x86) Amazon Machine Image (AMI) est l'inique option disponible.
• Dans la section Software Pricing Details (Détails de tarification du logiciel), sélectionnez le type d'abonnement Hourly (À l'heure) ou Annual (Annuel).

  Le prix total comprend les frais d'utilisation du logiciel ONLYOFFICE et de l'infrastructure AWS pour déploiement la solution du logiciel.

  Remarque: pour en savoir plus sur l'abonnement aux instance payées AMI et les options de tarification, veuillez consulter la documentation AWS.

Si vous cliquez sur EC2 Instance type (Type de l'instance EC2) dans le tableau (par exemple, t3.large), vous verrez les détails de l'instance. Le type d'instance EC2 détermine essentiellement les capacités matérielles du serveur virtuel que vous allez utiliser pour déployer la solution ONLYOFFICE.

Les types d'instances disponibles correspondent à la variante de solution ONLYOFFICE Docs Édition Développeur sélectionnée, c-à-d au nombre de connexions autorisées.

Le type d'instance EC2 t3.medium est utilisé pour ONLYOFFICE Docs Édition Développeur (250 connexions). Ses paramètres sont comme suit:

• Mémoire: 4 Go
• CPU: 2 cœurs virtuels
• Stockage: EBS uniquement
• Bande passante réseau: Jusqu'à 5 Gbit Ethernet

Le type d'instance EC2 t3.xlarge est utilisé pour ONLYOFFICE Docs Édition Développeur (500 connexions). Ses paramètres sont comme suit:

• Mémoire: 16 Go
• CPU: 4 cœurs virtuels
• Stockage: EBS uniquement
• Bande passante réseau: Jusqu'à 5 Gbit Ethernet

Le type d'instance EC2 t3.2xlarge est utilisé pour ONLYOFFICE Docs Édition Développeur (1000 connexions). Ses paramètres sont comme suit:

• Mémoire: 32 Go
• CPU: 8 cœurs virtuels
• Stockage: EBS uniquement
• Bande passante réseau: Jusqu'à 5 Gbit Ethernet

Passez à l'onglet Usage pour afficher les renseignements suivants:

• La section Fulfillment Options affiche les caractéristiques AMI. ONLYOFFICE AMI possède une architecture 64-bit (x86).
• La section Template components (Composant de modèle) affiche les services AWS qui sont utilisés pour ce produit.
  • Le service EC2 propose un environnent de déploiement du serveur virtuel sous CentOS et installation du logiciel ONLYOFFICE.
• Usage Instructions (Instructions d'utilisation) contiennent de courtes instructions sur la configuration initiale de la solution ONLYOFFICE lors du lancement.
• End User License Agreement (Contrat de Licence Utilisateur Final) régit les conditions d'utilisation de la solution ONLYOFFICE Docs Édition Développeur.

Cliquez sur Continue to Subscribe (Continuer pour vous abonner) dans le coin supérieur droit. La page Subscribe to this software (S'abonner à ce logiciel) s'affiche:

Veuillez lire l'accord AWS Customer Agreement (Contrat client AWS) et cliquez sur Accept Terms (Accepter les conditions). Attendez que le traitement de l'abonnement soit terminé.

Lorsque la date actuelle s'affiche dans le champ Effective date (Date d'effet) au lieu de 'Pending' (En attente), cliquez sur Continue to Configuration (Continuer à configurer) dans le coin supérieur droite.

Étape 2. Démarrer votre instance ONLYOFFICE dans le cloud AWS

Sur la page Configure this software (Configurer ce logiciel), cliquez sur Continue to Launch (Continuer à démarrer) dans le coin supérieur droite.

La page Launch this software (Démarrer ce logiciel) s'affiche: Sur cette page, vous pouvez encore une fois réviser tous le détails Configuration Details (Détails de configuration).

Dans la section Choose Action (Choisir une action), vous pouvez sélectionner le méthode de lancement de l'instance. L'option par défaut est Launch from Website (Démarrer à partir de). Laissez-la telle quelle pour déployer l'instance à l'aide de l'assistant de lancement d'instance rendu disponible sur cette page.

Il y a une seule option disponible dans la section EC2 Instance Type (en fonction du type d'instance ONLYOFFICE Docs Édition Développeur et le nombre de connexions autorisées déjà sélectionnée).

Laissez les paramètres par défaut dans les sections VPC Settings (Paramètres VPC) et Subnet Settings (Paramètres sous-réseau).

Il vous faut créer un nouveau Groupe de sécurité et générer une Paire de clés.

Créer un nouveau tableau croisé dynamique

Le groupe de sécurité permet de limiter l'accès à votre instance pour autoriser l'accès uniquement aux adresses IP connues.

Dans la section Security Group Settings (Paramètres de groupe de sécurité ), cliquez sur Create New Based on Seller Settings (Créer de nouveaux paramètres basés sur vendeur).

Saisissez le nom et la description du groupe de sécurité (par exemple, ONLYOFFICE).

Utilisez la liste Source (IP ou Groupe) pour créer des règles appropriées. Vous pouvez indiquer une seule adresse IP ou une plage d'adresses IP, par exemple, 10.040.196.230/32.

Il faut créer les règles sur les ports suivants:

• SSH - port 22 est utilisé pour accéder au serveur avec un client SSH via le protocole SSH.
• HTTP - port 80 est utilisé pour accéder à votre office en ligne via un navigateur Internet avec le protocole HTTP.
• HTTPS - port 443 est utilisé pour accéder à votre office en ligne via un navigateur Internet avec le protocole sécurisé HTTPS.

Une fois que vous avez terminé, cliquez sur Enregistrer.

Générer une paire de clés

Une paire de clés est un ensemble d'autorisations de sécurité lors de la connexion à votre instance via le protocole SSH avec un client SSH tel que PuTTY ou OpenSSH.

Dans la section Key Pair Settings, (Paramètres d'une paire de clés) cliquez sur Create a key pair in EC2 (Créer une paire de clés dans EC2).

La Console de gestion AWS s'ouvrira dans un nouvel onglet de navigateur.

Cliquez sur Create key pair (Créer une paire de clés) dans le coin supérieur droit. Saisissez le nom de la paire de clés (par exemple, ONLYOFFICE) dans le champ approprié et sélectionnez le format du fichier en fonction du logiciel que vous allez utiliser pour vous connecter à distance:

• pem est utilisé pour OpenSSH
• ppk est utilisé pour PuTTY

Cliquez sur le bouton Create key pair (Créer une paire de clés) au-dessous.

La clé publique sera stockée dans AWS EC2. Le fichier .pem/.ppk contenant votre clé privée sera téléchargé sur votre machine locale dans le dossier Téléchargements par défaut. Veuillez copier ce fichier et gardez-le dans un endroit sécurisé.

Revenez à AWS Marketplace, actualisez la paire de clés en utilisant l'icône à droite et sélectionnez la paire de clés dans la liste.

Après quoi, le bouton Launch (Démarrer) devient actif. Cliquez sur Launch (Démarrer) et attendez que l'instance soit déployée. Une fois terminé, le message de déploiement avec succès apparaît.

Cliquez sur EC2 Console dans ce message pour accéder aux détails d'instance sur la Console de gestion AWS.

Cela peut prendre un certain temps pour que l'instance devienne complètement fonctionnelle. Vérifiez que le statut de l'instance a évolué de 'pending' (en attente) à 'running' (en exécution) dans la colonne Instance State (État d'instance) et que le statut d'instance a été inspecté. Cette information est disponible dans la colonne Status Checks (Vérification du statut).

Ensuite vous pouvez vous connecter à votre instance en SSH pour activer des exemples à tester et vérifier le bon fonctionnement de la solution via un navigateur Internet.

Étape 3. Se connecter au serveur en SSH

Lors du démarrage de l'instance, vous pouvez accéder à celle-ci via SSH en utilisant le nom d'utilisateur centos et votre clé privée SSH.

Pour vous connecter à votre serveur virtuel SSH, il faut utiliser DNS Public ou Adresse IP de l'instance.

On peut les trouver sur Console de gestion AWS. Passez à la section Instances dans le menu gauche, choisissez votre région (US East (N. Virginia) par défaut) et sélectionnez l'instance ONLYOFFICE dans la liste et ouvrez les détails de l'instance.

Cliquez sur l'icône à gauche de Public DNS (IPv4) ou IPv4 Public IP dans l'onglet Description pour copier la valeur nécessaire dans le presse-papiers.

Sur Windows, vous pouvez utiliser l'outil PuTTY.

Le fichier avec la clé privée AWS le fichier qui a été généré au cours de déploiement est utilisé pour l'authentification au lieu de mot de passe.

Lancez PuTTY. Sur le panneau de navigation gauche, accéder à le section Connection -> SSH -> Auth. Passez à Authentication parameters -> Private key file for authentication (Paramètres d'authentification -> Fichier de clé privée d'authentification), cliquez sur Browse (Parcourir) et trouvez le chemin d'accès au fichier .ppk stocké sur votre machine locale.

Revenez à Session sur le panneau de navigation gauche. Saisissez l'instance Public DNS (DNS public) ou IP address (Adresse IP) dans le champ Host Name ou IP address (Nom d'hôte ou Adresse IP), assurez-vous d'indiquer le port 22 et le type de connexion SSH et cliquez sur Open (Ouvrir).

Ensuite, cliquez sur Yes ( Oui) dans la fenêtre PuTTY Security Alert (Alerte de sécurité PuTTY). Saisissez le nom d'utilisateur centos et appuyez sur Entrée.

Sur Linux, vous pouvez utilisez un client SSH tel que OpenSSH.

Il vous faut d'indiquer le chemin d'accès au le fichier .pem avec votre clé privée qui est stocké sur votre machine locale, le nom de l'utilisateur centos et IP address à votre instance ou Public DNS.

Saisissez la commande suivante dans votre terminal et spécifiez des valeurs actuelles pour le chemin d'accès du fichier .pem et Adresse IP:

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

Tapez yes pour poursuivre la connexion au serveur. Pour en savoir plus, veuillez consulter la documentation AWS.

Pour explorer les fonctionnalités, activez notre modèle d'essai permettant de télécharger des fichiers locaux pour tester. Pour ce faire, exécutez la commande suivante:

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

Ajoutez l'exemple au démarrage automatique:

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

Étape 4. Accéder à votre Édition Développeur de Docs depuis un navigateur

Lors du démarrage de l'exemple, saisissez http://<public IP address>/example/ dans la barre d'adresse du navigateur et remplacez <public IP address> par l'adresse IP publique ou DNS public fourni par Amazon.

Un exemple de la page ONLYOFFICE Docs Édition Développeur s'affiche. Ici, vous pouvez:

1. Télécharger un fichier stocké sur votre ordinateur en utilisant l'option Upload file (Télécharger fichier).
2. Créer un nouveau document texte, un classeur ou une présentation vierge en utilisant des options Créer -> Document, Classeur; Présentation ou Modèle de formulaire. Si vous souhaitez créer un fichier avec un modèle de données échantillon, il faut activer Create a file filled with sample content (Créer un fichier à partir de modèle de données échantillon).

Le fichier que vous avez téléchargé ou créé s'ouvrira dans un nouvel onglet à l'aide de l'éditeur en ligne ONLYOFFICE approprié pour essayer les fonctionnalités d'édition.

Le fichier s'affiche aussi dans la liste Vos documents sur l'exemple de la page ONLYOFFICE Docs Édition Développeur.

Si vous souhaitez essayer les fonctionnalités d'édition collaborative, sélectionnez encore un utilisateur d'essai dans la liste Nom d'utilisateur et cliquez sur le même document dans la liste Vos documents pour l'ouvrir dans un nouvel onglet.

Pour intégrer ONLYOFFICE Docs dans votre application web, veuillez consulter la Documentation API.