Home
DocSpace
Instalação
Desenvolvedor
Instalando ONLYOFFICE DocSpace Developer com parâmetros adicionais de script

Este artigo foi traduzido por IA

Instalando ONLYOFFICE DocSpace Developer com parâmetros adicionais de script

Introdução

ONLYOFFICE DocSpace 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 DocSpace 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 DocSpace Developer e é fácil de executar, gerenciar e atualizar.

Após baixar o script de instalação do ONLYOFFICE DocSpace 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 docspace-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 docspace-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 DocSpace. Digite Y e pressione Enter para instalar o ONLYOFFICE DocSpace usando Docker. Digite N e pressione Enter para instalar o ONLYOFFICE DocSpace 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 docspace-developer-install.sh -reg URL -un username -p password

Tipo de instalação

Parâmetro	Descrição	Valores	Padrão
`-it, --installation_type`	tipo de instalação	`community\|developer\|enterprise`	`developer`

Este parâmetro permite que você instale a solução especificada: ONLYOFFICE DocSpace Community, ONLYOFFICE DocSpace Developer ou ONLYOFFICE DocSpace Enterprise.

Exemplo

bash docspace-developer-install.sh -it community

Isso instalará a solução ONLYOFFICE DocSpace 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 docspace-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 docspace-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 DocSpace 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 DocSpace 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 docspace-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ids false -irbt false -irds false

Atualizar apenas o DocSpace para a versão 1.2.0 e pular a atualização para todos os outros componentes:

bash docspace-developer-install.sh -u true -dsv v1.2.0 -idocs false -irbt false -irds false

Instalação de componentes

Parâmetro	Descrição	Valores	Padrão
`-ids, --installdocspace`	instalar ONLYOFFICE DocSpace	`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 true para instalar um componente.
Use o valor false para pular a instalação de um componente.

Exemplo

bash docspace-developer-install.sh -idocs false

Isso instalará todos os componentes do ONLYOFFICE DocSpace Developer sem o ONLYOFFICE Docs.

bash docspace-developer-install.sh -ids false -idocs true -imysql false -irbt false -irds false

Isso pulará a instalação do ONLYOFFICE DocSpace, MySQL, RabbitMQ e Redis e instalará apenas o ONLYOFFICE Docs.

Versão do componente

Parâmetro	Descrição
`-dsv, --docspaceversion`	versão do ONLYOFFICE DocSpace
`-docsv, --docsversion`	versão do ONLYOFFICE Docs

Esses parâmetros podem ser usados para instalar uma determinada versão do ONLYOFFICE DocSpace 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 docspace-developer-install.sh -docsv 7.2.1.34

Isso instalará o ONLYOFFICE DocSpace 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 docspace-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
`-dsh, --docspacehost`	Host do ONLYOFFICE DocSpace
`-esh, --elastichost`	Hosts do Elasticsearch

Esses parâmetros podem ser usados para conectar os componentes se você os instalar em máquinas separadas.

Exemplo

bash docspace-developer-install.sh -esh 192.168.3.202

Isso instalará o ONLYOFFICE DocSpace e o conectará com o Elasticsearch 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 DocSpace 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 docspace-developer-install.sh -mk yourmachinekey

Porta externa do ONLYOFFICE DocSpace

Parâmetro	Descrição	Padrão
`-ep, --externalport`	Porta externa do ONLYOFFICE DocSpace	`80`

Este parâmetro permite que você altere a porta na qual o ONLYOFFICE DocSpace será executado. Por padrão, a porta 80 é usada.

Exemplo

bash docspace-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 DocSpace 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 DocSpace - /app/onlyoffice/config/appsettings.json
Para Document Server - /etc/onlyoffice/documentserver/local.json

Exemplo

bash docspace-developer-install.sh -js yoursecret

Servidor MySQL

Parâmetro	Descrição	Padrão
`-mysqlrp, --mysqlrootpassword`	Senha root do servidor MySQL	`my-secret-pw`
`-mysqlh, --mysqlhost`	Host do servidor MySQL	`localhost`
`-mysqlport, --mysqlport`	Número da porta do servidor MySQL	`3306`

Se você não especificar explicitamente esses parâmetros, os valores padrão serão usados.

Exemplo

bash docspace-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 DocSpace Developer.

Banco de dados do ONLYOFFICE DocSpace

Parâmetro	Descrição	Padrão
`-mysqld, --mysqldatabase`	Nome do banco de dados do ONLYOFFICE DocSpace	`onlyoffice`
`-mysqlu, --mysqluser`	Usuário do banco de dados do ONLYOFFICE DocSpace	`onlyoffice_user`
`-mysqlp, --mysqlpassword`	Senha do banco de dados do ONLYOFFICE DocSpace	`onlyoffice_pass`

Esses parâmetros permitem que você crie o banco de dados do ONLYOFFICE DocSpace 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 esses parâmetros, os valores padrão serão usados.

Exemplo

bash docspace-developer-install.sh -mysqld docspacedatabase -mysqlu username -mysqlp password

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 portal para HTTPS. Eles podem ser usados apenas para a versão Docker.

Exemplo

bash docspace-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 docspace-developer-install.sh docker --certfile path --certkeyfile path

Isso aplicará seu próprio certificado SSL.