Como instalar o ONLYOFFICE Apps Developer com parâmetros de script adicionais
Introdução
ONLYOFFICE Apps Developer é uma versão paga de um hub de documentos onde você pode conectar usuários e documentos em um só lugar para impulsionar a colaboração.
ONLYOFFICE Apps Developer é fornecido como um script de instalação automática para sistemas operacionais Linux com Docker instalado. O script configurará contêineres Docker com todos os componentes necessários para o funcionamento correto do ONLYOFFICE Apps Developer e é fácil de executar, gerenciar e atualizar.
Após baixar o script de instalação do ONLYOFFICE Apps Developer, pode ser necessário executá-lo especificando alguns parâmetros adicionais, por exemplo, se você quiser instalar cada componente em uma máquina separada.
Use o seguinte comando para exibir a lista de todos os parâmetros de script Docker disponíveis:
bash apps-developer-install.sh docker -h
Use o seguinte comando para exibir a lista de todos os parâmetros de script DEB/RPM disponíveis:
bash apps-developer-install.sh package -h
Você pode encontrar uma breve descrição e alguns exemplos de uso para esses parâmetros abaixo.
Quando você executa o script com parâmetros, será solicitado que você selecione a forma como deseja instalar o ONLYOFFICE Apps. Digite Y e pressione Enter para instalar o ONLYOFFICE Apps usando Docker. Digite N e pressione Enter para instalar o ONLYOFFICE Apps a partir de pacotes DEB/RPM.
Credenciais
| Parâmetro | Descrição |
|---|---|
-reg, --registry | URL do registro Docker (por exemplo, https://myregistry.com:5000) |
-un, --username | login do registro Docker |
-p, --password | senha do registro Docker |
Esses parâmetros são usados caso forneçamos credenciais para acessar um repositório de teste, para que você possa executar contêineres a partir de imagens armazenadas nele.
Exemplo
bash apps-developer-install.sh -reg URL -un username -p password
Tipo de instalação
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-it, --installationtype | tipo de instalação | community|developer|enterprise | developer |
Este parâmetro permite que você instale a solução especificada: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer ou ONLYOFFICE Apps Enterprise.
Exemplo
bash apps-developer-install.sh -it community
Isso instalará a solução ONLYOFFICE Apps Community.
Verificação de hardware
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-skiphc, --skiphardwarecheck | usar para pular a verificação de hardware | true|false | false |
Este parâmetro permite que você pule a verificação se o sistema atende aos requisitos mínimos de hardware.
Exemplo
bash apps-developer-install.sh -skiphc true
Isso pulará a verificação de hardware.
Atualização de componentes
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-u, --update | usar para atualizar componentes existentes | true|false | false |
Este parâmetro permite que você instale as versões mais recentes dos componentes necessários se os componentes correspondentes instalados na sua máquina estiverem desatualizados.
Exemplo
bash apps-developer-install.sh -u true
Isso irá, consequentemente, parar aqueles contêineres que precisam ser atualizados, removê-los e, em seguida, executar as versões mais recentes dos componentes correspondentes do ONLYOFFICE Apps Developer. Se a versão atual do componente coincidir com a mais recente disponível, tal contêiner não será afetado. Se você tiver pulado alguns componentes durante a instalação anterior, eles também serão pulados. Os dados do ONLYOFFICE Apps devem ser capturados automaticamente.
Atualizar apenas o Docs para a versão 7.2.1.34 e pular a atualização para todos os outros componentes:
bash apps-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Atualizar apenas o ONLYOFFICE Apps para a versão 1.2.0 e pular a atualização para todos os outros componentes:
bash apps-developer-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Instalação de componentes
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-ia, --installapps | instalar ONLYOFFICE Apps | true|false | true |
-idocs, --installdocs | instalar ONLYOFFICE Docs | true|false | true |
-irbt, --installrabbitmq | instalar RabbitMQ | true|false | true |
-irds, --installredis | instalar Redis | true|false | true |
-imysql, --installmysql | instalar MySQL | true|false | true |
Esses parâmetros permitem que você especifique se precisa instalar um determinado componente ou não. Eles podem ser usados se você quiser instalar cada componente em uma máquina separada.
- Use o valor
truepara instalar um componente; - Use o valor
falsepara pular a instalação de um componente.
Exemplo
bash apps-developer-install.sh -idocs false
Isso instalará todos os componentes do ONLYOFFICE Apps Developer sem o ONLYOFFICE Docs.
bash apps-developer-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Isso pulará a instalação do ONLYOFFICE Apps, MySQL, RabbitMQ e Redis e instalará apenas o ONLYOFFICE Docs.
Versão do componente
| Parâmetro | Descrição |
|---|---|
-asv, --appsversion | versão do ONLYOFFICE Apps |
-docsv, --docsversion | versão do ONLYOFFICE Docs |
Esses parâmetros podem ser usados para instalar uma determinada versão do ONLYOFFICE Apps ou ONLYOFFICE Docs caso, por algum motivo, você não deseje instalar a versão mais recente disponível no repositório. Por padrão, uma imagem marcada como latest é usada para executar o contêiner do componente.
Exemplo
Abra o repositório Docker Hub no seu navegador, selecione ONLYOFFICE Docs e vá para a aba Tags para visualizar todas as tags disponíveis no repositório. Especifique a versão que você deseja instalar:
bash apps-developer-install.sh -docsv 7.2.1.34
Isso instalará o ONLYOFFICE Apps com a versão 7.2.1.34 do ONLYOFFICE Docs.
Nome da imagem do ONLYOFFICE Docs
| Parâmetro | Descrição |
|---|---|
-docsi, --docsimage | Nome da imagem do ONLYOFFICE Docs |
Este parâmetro pode ser usado para especificar um nome da imagem do ONLYOFFICE Docs a partir da qual um contêiner deve ser iniciado. A imagem especificada deve estar armazenada em nosso repositório público oficial no Docker Hub.
Exemplo
bash apps-developer-install.sh -docsi onlyoffice/documentserver-de
Isso executará um contêiner a partir da imagem especificada do ONLYOFFICE Docs armazenada no repositório.
Configuração para hosts
| Parâmetro | Descrição |
|---|---|
-ash, --appshost | Host do ONLYOFFICE Apps |
-esh, --elastichost | Hosts do OpenSearch |
Esses parâmetros podem ser usados para conectar os componentes se você os instalar em máquinas separadas.
Exemplo
bash apps-developer-install.sh -esh 192.168.3.202
Isso instalará o ONLYOFFICE Apps e o conectará com o OpenSearch instalado em uma máquina diferente que possui o endereço IP 192.168.3.202.
Configuração para core.machinekey
| Parâmetro | Descrição |
|---|---|
-mk, --machinekey | Configuração para a chave core.machinekey |
Este parâmetro permite que você especifique sua própria machinekey ao instalar o ONLYOFFICE Apps Developer.
Este parâmetro é gravado no arquivo de configuração /app/onlyoffice/config/appsettings.json (o caminho é especificado dentro do contêiner onlyoffice-studio).
Exemplo
bash apps-developer-install.sh -mk yourmachinekey
Porta externa do ONLYOFFICE Apps
| Parâmetro | Descrição | Padrão |
|---|---|---|
-ep, --externalport | Porta externa do ONLYOFFICE Apps | 80 |
Este parâmetro permite que você altere a porta na qual o ONLYOFFICE Apps será executado. Por padrão, a porta 80 é usada.
Exemplo
bash apps-developer-install.sh -ep 8080
Configurações para cabeçalho e segredo JWT
| Parâmetro | Descrição |
|---|---|
-jh, --jwtheader | Configuração para o cabeçalho JWT |
-js, --jwtsecret | Configuração para a chave secreta JWT |
Esses parâmetros permitem que você especifique o cabeçalho JWT e sua própria chave secreta JWT ao instalar o ONLYOFFICE Apps Developer. O cabeçalho JWT define o cabeçalho http que será usado para enviar o JWT. A chave secreta é usada para assinar o token web JSON e validar o token na solicitação ao ONLYOFFICE Docs.
Esses parâmetros são gravados nos seguintes arquivos de configuração (os caminhos são especificados dentro dos contêineres onlyoffice-studio e onlyoffice-document-server):
- Para ONLYOFFICE Apps –
/app/onlyoffice/config/appsettings.json - Para Document Server –
/etc/onlyoffice/documentserver/local.json
Exemplo
bash apps-developer-install.sh -js yoursecret
Servidor MySQL
| Parâmetro | Descrição | Padrão |
|---|---|---|
-mysqlrp, --mysqlrootpassword | Senha root do servidor MySQL | gerado automaticamente |
-mysqlh, --mysqlhost | Host do servidor MySQL | localhost |
-mysqlport, --mysqlport | Número da porta do servidor MySQL | 3306 |
Se você não especificar explicitamente o host e a porta, os valores padrão serão usados. A senha root é gerada automaticamente se você não a definir.
Exemplo
bash apps-developer-install.sh -mysqlrp new-secret-pw
Este comando permite que você defina sua própria senha para a conta root do MySQL durante a instalação do ONLYOFFICE Apps Developer.
Banco de dados do ONLYOFFICE Apps
| Parâmetro | Descrição | Padrão |
|---|---|---|
-mysqld, --mysqldatabase | Nome do banco de dados do ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | Usuário do banco de dados do ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | Senha do banco de dados do ONLYOFFICE Apps | gerado automaticamente |
Esses parâmetros permitem que você crie o banco de dados do ONLYOFFICE Apps especificando um nome de banco de dados personalizado, bem como um nome de usuário e senha para a conta com permissões de superusuário no banco de dados criado. Se você não especificar explicitamente o nome do banco de dados, o valor padrão será usado. Se você não definir uma senha, ela será gerada automaticamente.
Exemplo
bash apps-developer-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Servidor RabbitMQ
| Parâmetro | Descrição | Padrão |
|---|---|---|
--rabbitmqprotocol | Protocolo de conexão do RabbitMQ | amqp |
--rabbitmqhost | Host do servidor RabbitMQ | localhost |
--rabbitmqport | Número da porta do servidor RabbitMQ | 5672 |
--rabbitmqusername | Nome de usuário do RabbitMQ | - |
--rabbitmqpassword | Senha do usuário do RabbitMQ | - |
--rabbitmqvirtualhost | Host virtual do RabbitMQ | / |
Use esses parâmetros para conectar o ONLYOFFICE Apps a um servidor RabbitMQ que já está em execução em outra máquina. Pule a instalação do RabbitMQ com o parâmetro -irbt false e, em seguida, especifique os parâmetros de conexão do seu próprio servidor. Se você não especificar explicitamente o protocolo, o host, a porta ou o host virtual, os valores padrão serão usados.
Exemplo
bash apps-developer-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Isso instalará o ONLYOFFICE Apps sem o RabbitMQ e o conectará ao servidor RabbitMQ em execução no host mq.example.com.
Servidor Redis
| Parâmetro | Descrição | Padrão |
|---|---|---|
--redishost | Host do servidor Redis | localhost |
--redisport | Número da porta do servidor Redis | 6379 |
--redisusername | Nome de usuário do Redis, se o servidor exigir autorização | - |
--redispassword | Senha do usuário do Redis, se o servidor exigir autorização | - |
Use esses parâmetros para conectar o ONLYOFFICE Apps a um servidor Redis que já está em execução em outra máquina. Pule a instalação do Redis com o parâmetro -irds false e, em seguida, especifique os parâmetros de conexão do seu próprio servidor. O nome de usuário e a senha só são necessários se o seu servidor Redis exigir autorização.
Exemplo
bash apps-developer-install.sh -irds false --redishost redis.example.com --redispassword password
Isso instalará o ONLYOFFICE Apps sem o Redis e o conectará ao servidor Redis em execução no host redis.example.com.
Servidor OpenSearch
| Parâmetro | Descrição | Padrão |
|---|---|---|
--elasticprotocol | Protocolo de conexão do OpenSearch | http |
--elasticport | Número da porta do servidor OpenSearch | 9200 |
Use esses parâmetros junto com o parâmetro -esh, --elastichost descrito na seção “Configuração para hosts” acima para conectar o ONLYOFFICE Apps a um servidor OpenSearch em execução em outra máquina. Se você não especificar explicitamente o protocolo e a porta, os valores padrão serão usados.
Exemplo
bash apps-developer-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Isso conectará o ONLYOFFICE Apps ao servidor OpenSearch em execução no host search.example.com por HTTPS.
Alternando para HTTPS
| Parâmetro | Descrição |
|---|---|
-led, --letsencryptdomain | define o domínio para o certificado Let's Encrypt |
-lem, --letsencryptmail | define o endereço de e-mail do administrador do domínio para o certificado Let's Encrypt |
-cf, --certfile | caminho para o arquivo de certificado do domínio |
-ckf, --certkeyfile | caminho para o arquivo de chave privada do certificado |
Esses parâmetros permitem que você altere o espaço de trabalho para HTTPS. Eles podem ser usados apenas para a versão Docker.
Exemplo
bash apps-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Isso criará e instalará automaticamente o certificado assinado pela CA do letsencrypt.org no seu servidor e reiniciará o serviço NGINX para que as alterações tenham efeito.
bash apps-developer-install.sh docker --certfile path --certkeyfile path
Isso aplicará seu próprio certificado SSL.