Home
Workspace
Instalação
Comunidade
Docker
Instalando ONLYOFFICE Workspace Community com parâmetros adicionais de script

Este artigo foi traduzido por IA

Instalando ONLYOFFICE Workspace Community com parâmetros adicionais de script

Introdução

ONLYOFFICE Workspace Community é uma versão gratuita do sistema colaborativo desenvolvido para gerenciar documentos, projetos, relacionamento com clientes e correspondência de e-mail, tudo em um só lugar.

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

Após baixar o script de instalação do ONLYOFFICE Workspace Community, pode ser necessário executá-lo especificando alguns parâmetros adicionais, por exemplo, se você deseja instalar cada componente em uma máquina separada. Use o seguinte comando para exibir a lista de todos os parâmetros de script disponíveis:

bash workspace-install.sh -h

Você pode encontrar uma breve descrição e alguns exemplos de uso desses parâmetros abaixo.

Nome da imagem

Parâmetro	Descrição
`-ci, --communityimage`	Nome da imagem do ONLYOFFICE Community Server
`-di, --documentimage`	Nome da imagem do ONLYOFFICE Docs
`-mi, --mailimage`	Nome da imagem do ONLYOFFICE Mail
`-cpi, --controlpanelimage`	Nome da imagem do ONLYOFFICE Control Panel

Esses parâmetros podem ser usados para especificar um nome de imagem a partir do 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 workspace-install.sh -ims false -di onlyoffice/documentserver -ics true -icp true

Isso executará um contêiner a partir da imagem especificada do ONLYOFFICE Docs armazenada no repositório, bem como executará os contêineres do ONLYOFFICE Community Server e do ONLYOFFICE Control Panel.

Versão do componente

Parâmetro	Descrição
`-cv, --communityversion`	Versão do ONLYOFFICE Community Server
`-dv, --documentversion`	Versão do ONLYOFFICE Docs
`-mv, --mailversion`	Versão do ONLYOFFICE Mail
`-cpv, --controlpanelversion`	Versão do ONLYOFFICE Control Panel

Esses parâmetros podem ser usados para instalar uma certa versão do componente se, por algum motivo, você não quiser instalar a versão mais recente disponível no repositório. Por padrão, uma imagem marcada como latest é usada para executar cada contêiner de componente.

Exemplo

Abra o repositório do Docker Hub no seu navegador, selecione o componente necessário e vá para a guia Tags para visualizar todas as tags disponíveis no repositório. Especifique a versão que você deseja instalar para os componentes necessários:

bash workspace-install.sh -ics true -cv 8.9.0.150 -ids false -icp true -cpv 1.6.0.52 -ims true -md "yourdomain.com"

Isso instalará a versão 8.9.0.150 do ONLYOFFICE Community Server, a versão 1.6.0.52 do ONLYOFFICE Control Panel e a versão mais recente do ONLYOFFICE Mail, já que sua versão não foi especificada explicitamente.

IP do servidor

Parâmetro	Descrição
`-dip, --documentserverip`	Endereço IP do ONLYOFFICE Docs
`-mip, --mailserverip`	Endereço IP do ONLYOFFICE Mail
`-mdbip, --mailserverdbip`	Endereço IP do banco de dados do ONLYOFFICE Mail

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

Exemplo

bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false

Isso instalará o ONLYOFFICE Community Server com o ONLYOFFICE Control Panel e o conectará com o ONLYOFFICE Docs instalado em uma máquina diferente que possui o endereço IP 192.168.3.202.

Nome de domínio do ONLYOFFICE Mail

Parâmetro	Descrição
`-md, --maildomain`	Nome de domínio do ONLYOFFICE Mail

Este parâmetro permite especificar seu próprio nome de domínio que será usado para o ONLYOFFICE Mail.

Exemplo

bash workspace-install.sh -md "yourdomain.com"

Isso instalará todos os componentes do ONLYOFFICE Workspace Community, incluindo o ONLYOFFICE Mail com o nome de domínio yourdomain.com especificado.

Seu domínio que será usado para manter a correspondência deve ser válido e configurado para esta máquina (ou seja, deve ter o registro A apropriado nas configurações de DNS que aponta o nome de domínio para o endereço IP da máquina onde o ONLYOFFICE Mail está instalado).
No comando acima, o parâmetro "yourdomain.com" deve ser entendido como um domínio de serviço para o ONLYOFFICE Mail. Geralmente, ele é especificado no registro MX do domínio que será usado para manter a correspondência. Como regra, o "yourdomain.com" se parece com mx1.onlyoffice.com

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 instalar as versões mais recentes dos componentes necessários se os componentes correspondentes instalados na sua máquina estiverem desatualizados.

Exemplo

bash workspace-install.sh -u true

Isso consequentemente parará aqueles contêineres que precisam ser atualizados, os removerá e então executará as versões mais recentes dos componentes correspondentes do ONLYOFFICE Workspace. 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 portal devem ser capturados automaticamente.

Credenciais

Parâmetro	Descrição
`-un, --username`	nome de usuário do dockerhub
`-p, --password`	senha do dockerhub

Esses parâmetros são usados caso forneçamos a você credenciais para acessar um repositório de teste, permitindo que você execute contêineres a partir de imagens armazenadas nele.

Exemplo

bash workspace-install.sh -md "yourdomain.com" -un username -p password

Instalação de componentes

Parâmetro	Descrição	Valores	Padrão
`-ics, --installcommunityserver`	instalar ONLYOFFICE Community Server	`true\|false\|pull`	`true`
`-ids, --installdocumentserver`	instalar ONLYOFFICE Docs	`true\|false\|pull`	`true`
`-ims, --installmailserver`	instalar ONLYOFFICE Mail	`true\|false\|pull`	`true`
`-icp, --installcontrolpanel`	instalar ONLYOFFICE Control Panel	`true\|false\|pull`	`true`

Esses parâmetros permitem especificar se você 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.
Use o valor pull para baixar um componente sem instalá-lo.

Exemplo

bash workspace-install.sh -ims false

Isso instalará todos os componentes do ONLYOFFICE Workspace sem o ONLYOFFICE Mail.

bash workspace-install.sh -ics false -ids true -icp false -ims false -es true

Isso pulará a instalação do ONLYOFFICE Mail, ONLYOFFICE Community Server e ONLYOFFICE Control Panel e instalará apenas o ONLYOFFICE Docs.

Tipo de instalação

Parâmetro	Descrição	Valores	Padrão
`-it, --installation_type`	tipo de instalação	`WORKSPACE\|WORKSPACE_ENTERPRISE`	`WORKSPACE_ENTERPRISE`

Este parâmetro permite instalar a solução especificada: ONLYOFFICE Workspace ou ONLYOFFICE Workspace Enterprise Edition.

Exemplo

bash workspace-install.sh -it GROUPS

Isso instalará a solução ONLYOFFICE Workspace, que inclui os componentes ONLYOFFICE Community Server e ONLYOFFICE Control Panel.

Usando um componente como servidor externo

Parâmetro	Descrição	Valores	Padrão
`-es, --useasexternalserver`	usar como servidor externo	`true\|false`	`false`

Este parâmetro é usado caso você instale componentes em máquinas separadas.

Use o valor true ao instalar ONLYOFFICE Docs e ONLYOFFICE Mail em máquinas separadas.
Use o valor false ao instalar ONLYOFFICE Community Server junto com ONLYOFFICE Control Panel em uma máquina separada.

Exemplo

bash workspace-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true

Isso pulará a instalação do ONLYOFFICE Docs, ONLYOFFICE Community Server e ONLYOFFICE Control Panel e instalará apenas o ONLYOFFICE Mail.

bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false

Isso instalará o ONLYOFFICE Community Server com o ONLYOFFICE Control Panel e o conectará com o ONLYOFFICE Docs instalado em uma máquina diferente.

Criação de arquivo swap

Parâmetro	Descrição	Valores	Padrão
`-ms, --makeswap`	criar arquivo swap	`true\|false`	`false`

Este parâmetro permite criar um arquivo swap de 6 Gb. Por padrão, o valor true é especificado, portanto, você não precisa especificar este parâmetro ao executar o script. O arquivo swap será criado automaticamente.

Exemplo

bash workspace-install.sh -ms false

Se você já criou um arquivo swap anteriormente, pode usar este comando para não criar um arquivo swap durante a instalação.

Se você executar o script novamente sem especificar o parâmetro -ms, ele verificará se o onlyoffice_swapfile está presente. Se o arquivo swap já existir, o script não criará um arquivo swap novamente.

Servidor MySQL

Parâmetro	Descrição	Padrão
`-mysqlh, --mysqlhost`	host do servidor MySQL	`localhost`
`-mysqlprt, --mysqlport`	porta do servidor MySQL	`3306`
`-mysqlru, --mysqlrootuser`	usuário root do servidor MySQL	`root`
`-mysqlrp, --mysqlrootpassword`	senha do usuário root do servidor MySQL	`my-secret-pw`

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

Exemplo

bash workspace-install.sh -mysqlru root -mysqlrp new-secret-pw

Este comando permite definir sua própria senha para a conta root do MySQL durante a instalação do ONLYOFFICE Workspace.

Banco de dados ONLYOFFICE Community Server

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

Esses parâmetros permitem criar o banco de dados do ONLYOFFICE Community Server 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 workspace-install.sh -mysqld communitydatabase -mysqlu username -mysqlp password

Banco de dados do ONLYOFFICE Mail

Parâmetro	Descrição	Padrão
`-mysqlmd, --mysqlmaildatabase`	Nome do banco de dados do ONLYOFFICE Mail	`onlyoffice_mailserver`
`-mysqlmu, --mysqlmailuser`	Usuário do banco de dados do ONLYOFFICE Mail	`mail_admin`
`-mysqlmp, --mysqlmailpassword`	Senha do banco de dados do ONLYOFFICE Mail	`Isadmin123`

Esses parâmetros permitem criar o banco de dados do ONLYOFFICE Mail 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 workspace-install.sh -md "mx.yourdomain.com" -mysqlmd maildatabase -mysqlmu username -mysqlmp password

Porta do ONLYOFFICE Community Server

Parâmetro	Descrição	Padrão
`-cp, --communityport`	Porta do ONLYOFFICE Community Server	`80`

Este parâmetro permite alterar a porta na qual o ONLYOFFICE Community Server será executado. Por padrão, a porta 80 é usada.

Exemplo

bash workspace-install.sh -cp 8080

Configuração para core.machinekey

Parâmetro	Descrição
`-mk, --machinekey`	Configuração para a chave core.machinekey

Este parâmetro permite especificar sua própria machinekey ao instalar o ONLYOFFICE Workspace Community.

Este parâmetro é gravado no arquivo de configuração /app/onlyoffice/CommunityServer/data/.private/machinekey.

Exemplo

bash workspace-install.sh -mk yourmachinekey

Configuração para JWT secret

Parâmetro	Descrição
`-jwt, --jwtsecret`	Configuração para a chave secreta JWT

Este parâmetro permite especificar sua própria chave secreta JWT ao instalar o ONLYOFFICE Workspace Community. A chave secreta é usada para assinar o token JSON web e validar o token na solicitação ao ONLYOFFICE Docs.

Este parâmetro é gravado nos seguintes arquivos de configuração (os caminhos são especificados dentro dos contêineres):

Para Community Server - /var/www/onlyoffice/WebStudio/web.appsettings.config
Para Document Server - /etc/onlyoffice/documentserver/local.json

Exemplo

bash workspace-install.sh -jwt yoursecret