Installer ONLYOFFICE Apps Développeur à l'aide de paramètres supplémentaires du script
Introduction
ONLYOFFICE Apps Développeur est une version payante d'un hub documentaire qui vous permet de réunir les utilisateurs et les documents en un seul endroit pour stimuler la collaboration.
ONLYOFFICE Apps Développeur est distribué sous la forme d'un script d'installation automatique pour les systèmes d'exploitation Linux sur lesquels Docker est installé. Le script met en place des conteneurs Docker avec tous les composants nécessaires au bon fonctionnement d'ONLYOFFICE Apps Développeur, et il est facile à exécuter, à gérer et à mettre à jour.
Une fois le script d'installation d'ONLYOFFICE Apps Développeur téléchargé, vous devrez peut-être l'exécuter en indiquant des paramètres supplémentaires, par exemple si vous souhaitez installer chaque composant sur une machine distincte.
Utilisez la commande suivante pour afficher la liste de tous les paramètres du script Docker disponibles:
bash apps-developer-install.sh docker -h
Utilisez la commande suivante pour afficher la liste de tous les paramètres du script DEB/RPM disponibles:
bash apps-developer-install.sh package -h
Vous trouverez ci-dessous une courte description et quelques exemples d'utilisation de ces paramètres.
Lorsque vous exécutez le script avec des paramètres, vous êtes invité à choisir le mode d'installation d'ONLYOFFICE Apps. Saisissez Y et appuyez sur Entrée pour installer ONLYOFFICE Apps à l'aide de Docker. Saisissez N et appuyez sur Entrée pour installer ONLYOFFICE Apps à partir des paquets DEB/RPM.
Informations d'identification
| Paramètre | Description |
|---|---|
-reg, --registry | URL du registre docker (par ex. https://myregistry.com:5000) |
-un, --username | identifiant du registre docker |
-p, --password | mot de passe du registre docker |
Ces paramètres sont utilisés lorsque nous vous fournissons des identifiants pour accéder à un dépôt de test, afin que vous puissiez exécuter des conteneurs à partir des images qui y sont stockées.
Exemple
bash apps-developer-install.sh -reg URL -un username -p password
Type d'installation
| Paramètre | Description | Valeurs | Par défaut |
|---|---|---|---|
-it, --installationtype | type d'installation | community|developer|enterprise | developer |
Ce paramètre permet d'installer la solution indiquée: ONLYOFFICE Apps Communauté, ONLYOFFICE Apps Développeur ou ONLYOFFICE Apps Enterprise.
Exemple
bash apps-developer-install.sh -it community
Cela installe la solution ONLYOFFICE Apps Communauté.
Vérification du matériel
| Paramètre | Description | Valeurs | Par défaut |
|---|---|---|---|
-skiphc, --skiphardwarecheck | sert à ignorer la vérification du matériel | true|false | false |
Ce paramètre permet d'ignorer la vérification de la conformité du système à la configuration matérielle minimale requise.
Exemple
bash apps-developer-install.sh -skiphc true
Cela ignore la vérification du matériel.
Mise à jour des composants
| Paramètre | Description | Valeurs | Par défaut |
|---|---|---|---|
-u, --update | sert à mettre à jour les composants existants | true|false | false |
Ce paramètre permet d'installer les versions les plus récentes des composants nécessaires si les composants correspondants installés sur votre machine sont obsolètes.
Exemple
bash apps-developer-install.sh -u true
Cela arrête successivement les conteneurs à mettre à jour, les supprime, puis exécute les versions les plus récentes des composants ONLYOFFICE Apps Développeur correspondants. Si la version actuelle d'un composant correspond à la dernière version disponible, le conteneur concerné n'est pas affecté. Les composants que vous avez ignorés lors de l'installation précédente le seront également. Les données d'ONLYOFFICE Apps sont reprises automatiquement.
Mettre à jour uniquement Docs vers la version 7.2.1.34 et ignorer la mise à jour de tous les autres composants:
bash apps-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Mettre à jour uniquement ONLYOFFICE Apps vers la version 1.2.0 et ignorer la mise à jour de tous les autres composants:
bash apps-developer-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Installation des composants
| Paramètre | Description | Valeurs | Par défaut |
|---|---|---|---|
-ia, --installapps | installer ONLYOFFICE Apps | true|false | true |
-idocs, --installdocs | installer ONLYOFFICE Docs | true|false | true |
-irbt, --installrabbitmq | installer RabbitMQ | true|false | true |
-irds, --installredis | installer Redis | true|false | true |
-imysql, --installmysql | installer MySQL | true|false | true |
Ces paramètres permettent d'indiquer si vous souhaitez ou non installer un composant donné. Vous pouvez les utiliser pour installer chaque composant sur une machine distincte.
- Indiquez la valeur
truepour installer un composant. - Indiquez la valeur
falsepour ignorer l'installation d'un composant.
Exemple
bash apps-developer-install.sh -idocs false
Cela installe tous les composants ONLYOFFICE Apps Développeur sans ONLYOFFICE Docs.
bash apps-developer-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Cela ignore l'installation d'ONLYOFFICE Apps, MySQL, RabbitMQ et Redis et installe uniquement ONLYOFFICE Docs.
Version du composant
| Paramètre | Description |
|---|---|
-asv, --appsversion | Version d'ONLYOFFICE Apps |
-docsv, --docsversion | Version d'ONLYOFFICE Docs |
Ces paramètres permettent d'installer une version précise d'ONLYOFFICE Apps ou ONLYOFFICE Docs si, pour une raison quelconque, vous ne souhaitez pas installer la version la plus récente disponible dans le dépôt. Par défaut, une image portant le tag latest est utilisée pour exécuter le conteneur du composant.
Exemple
Ouvrez le dépôt Docker Hub dans votre navigateur, sélectionnez ONLYOFFICE Docs et accédez à l'onglet Tags pour afficher tous les tags disponibles dans le dépôt. Indiquez la version à installer:
bash apps-developer-install.sh -docsv 7.2.1.34
Cela installe ONLYOFFICE Apps avec ONLYOFFICE Docs 7.2.1.34.
Nom de l'image ONLYOFFICE Docs
| Paramètre | Description |
|---|---|
-docsi, --docsimage | Nom de l'image ONLYOFFICE Docs |
Ce paramètre permet d'indiquer le nom de l'image ONLYOFFICE Docs à partir de laquelle le conteneur doit démarrer. L'image indiquée doit être stockée dans notre dépôt public officiel sur Docker Hub.
Exemple
bash apps-developer-install.sh -docsi onlyoffice/documentserver-de
Cela exécute un conteneur à partir de l'image ONLYOFFICE Docs indiquée et stockée dans le dépôt.
Configuration pour les hôtes
| Paramètre | Description |
|---|---|
-ash, --appshost | Hôte ONLYOFFICE Apps |
-esh, --elastichost | Hôtes OpenSearch |
Ces paramètres permettent de connecter les composants si vous les installez sur des machines distinctes.
Exemple
bash apps-developer-install.sh -esh 192.168.3.202
Cela installe ONLYOFFICE Apps et le connecte à OpenSearch installé sur une autre machine dont l'adresse IP est 192.168.3.202.
Configuration pour core.machinekey
| Paramètre | Description |
|---|---|
-mk, --machinekey | Configuration de la clé core.machinekey |
Ce paramètre permet d'indiquer votre propre machinekey lors de l'installation d'ONLYOFFICE Apps Développeur.
Ce paramètre est écrit dans le fichier de configuration /app/onlyoffice/config/appsettings.json (le chemin est indiqué à l'intérieur du conteneur onlyoffice-studio).
Exemple
bash apps-developer-install.sh -mk yourmachinekey
Port externe d'ONLYOFFICE Apps
| Paramètre | Description | Par défaut |
|---|---|---|
-ep, --externalport | Port externe d'ONLYOFFICE Apps | 80 |
Ce paramètre permet de modifier le port sur lequel ONLYOFFICE Apps s'exécute. Par défaut, le port 80 est utilisé.
Exemple
bash apps-developer-install.sh -ep 8080
Paramètres de l'en-tête et de la clé secrète JWT
| Paramètre | Description |
|---|---|
-jh, --jwtheader | Configuration de l'en-tête JWT |
-js, --jwtsecret | Configuration de la clé secrète JWT |
Ces paramètres permettent d'indiquer l'en-tête JWT et votre propre clé secrète JWT lors de l'installation d'ONLYOFFICE Apps Développeur. L'en-tête JWT définit l'en-tête HTTP utilisé pour envoyer le JWT. La clé secrète sert à signer le jeton web JSON et à le valider lors de la requête adressée à ONLYOFFICE Docs.
Ces paramètres sont écrits dans les fichiers de configuration suivants (les chemins sont indiqués à l'intérieur des conteneurs onlyoffice-studio et onlyoffice-document-server):
- Pour ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - Pour Document Server -
/etc/onlyoffice/documentserver/local.json
Exemple
bash apps-developer-install.sh -js yoursecret
Serveur MySQL
| Paramètre | Description | Par défaut |
|---|---|---|
-mysqlrp, --mysqlrootpassword | Mot de passe root du serveur MySQL | généré automatiquement |
-mysqlh, --mysqlhost | Hôte du serveur MySQL | localhost |
-mysqlport, --mysqlport | Numéro de port du serveur MySQL | 3306 |
Si vous n'indiquez pas explicitement l'hôte et le port, les valeurs par défaut sont utilisées. Le mot de passe root est généré automatiquement si vous ne le définissez pas.
Exemple
bash apps-developer-install.sh -mysqlrp new-secret-pw
Cette commande permet de définir votre propre mot de passe pour le compte root MySQL lors de l'installation d'ONLYOFFICE Apps Développeur.
Base de données ONLYOFFICE Apps
| Paramètre | Description | Par défaut |
|---|---|---|
-mysqld, --mysqldatabase | Nom de la base de données ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | Utilisateur de la base de données ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | Mot de passe de la base de données ONLYOFFICE Apps | généré automatiquement |
Ces paramètres permettent de créer la base de données ONLYOFFICE Apps en indiquant un nom personnalisé, ainsi qu'un nom d'utilisateur et un mot de passe pour le compte disposant des autorisations de superutilisateur sur la base de données créée. Si vous n'indiquez pas explicitement le nom de la base de données, la valeur par défaut est utilisée. Si vous ne définissez pas de mot de passe, il est généré automatiquement.
Exemple
bash apps-developer-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Serveur RabbitMQ
| Paramètre | Description | Par défaut |
|---|---|---|
--rabbitmqprotocol | Protocole de connexion RabbitMQ | amqp |
--rabbitmqhost | Hôte du serveur RabbitMQ | localhost |
--rabbitmqport | Numéro de port du serveur RabbitMQ | 5672 |
--rabbitmqusername | Nom d'utilisateur RabbitMQ | - |
--rabbitmqpassword | Mot de passe de l'utilisateur RabbitMQ | - |
--rabbitmqvirtualhost | Hôte virtuel RabbitMQ | / |
Utilisez ces paramètres pour connecter ONLYOFFICE Apps à un serveur RabbitMQ déjà en cours d'exécution sur une autre machine. Ignorez l'installation de RabbitMQ avec le paramètre -irbt false, puis indiquez les paramètres de connexion de votre propre serveur. Si vous n'indiquez pas explicitement le protocole, l'hôte, le port ou l'hôte virtuel, les valeurs par défaut sont utilisées.
Exemple
bash apps-developer-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Cela installe ONLYOFFICE Apps sans RabbitMQ et le connecte au serveur RabbitMQ qui s'exécute sur l'hôte mq.example.com.
Serveur Redis
| Paramètre | Description | Par défaut |
|---|---|---|
--redishost | Hôte du serveur Redis | localhost |
--redisport | Numéro de port du serveur Redis | 6379 |
--redisusername | Nom d'utilisateur Redis, si le serveur exige une autorisation | - |
--redispassword | Mot de passe de l'utilisateur Redis, si le serveur exige une autorisation | - |
Utilisez ces paramètres pour connecter ONLYOFFICE Apps à un serveur Redis déjà en cours d'exécution sur une autre machine. Ignorez l'installation de Redis avec le paramètre -irds false, puis indiquez les paramètres de connexion de votre propre serveur. Le nom d'utilisateur et le mot de passe ne sont nécessaires que si votre serveur Redis exige une autorisation.
Exemple
bash apps-developer-install.sh -irds false --redishost redis.example.com --redispassword password
Cela installe ONLYOFFICE Apps sans Redis et le connecte au serveur Redis qui s'exécute sur l'hôte redis.example.com.
Serveur OpenSearch
| Paramètre | Description | Par défaut |
|---|---|---|
--elasticprotocol | Protocole de connexion OpenSearch | http |
--elasticport | Numéro de port du serveur OpenSearch | 9200 |
Utilisez ces paramètres avec le paramètre -esh, --elastichost décrit dans la section Configuration pour les hôtes ci-dessus pour connecter ONLYOFFICE Apps à un serveur OpenSearch qui s'exécute sur une autre machine. Si vous n'indiquez pas explicitement le protocole et le port, les valeurs par défaut sont utilisées.
Exemple
bash apps-developer-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Cela connecte ONLYOFFICE Apps au serveur OpenSearch qui s'exécute sur l'hôte search.example.com en HTTPS.
Passer en HTTPS
| Paramètre | Description |
|---|---|
-led, --letsencryptdomain | définit le domaine pour le certificat Let's Encrypt |
-lem, --letsencryptmail | définit l'adresse e-mail de l'administrateur du domaine pour le certificat Let's Encrypt |
-cf, --certfile | chemin d'accès au fichier de certificat du domaine |
-ckf, --certkeyfile | chemin d'accès au fichier de clé privée du certificat |
Ces paramètres permettent de basculer l'espace de travail en HTTPS. Ils ne peuvent être utilisés qu'avec la version Docker.
Exemple
bash apps-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Cela crée et installe automatiquement le certificat signé par l'autorité de certification letsencrypt.org sur votre serveur et redémarre le service NGINX pour que les modifications prennent effet.
bash apps-developer-install.sh docker --certfile path --certkeyfile path
Cela applique votre propre certificat SSL.