Implantando o ONLYOFFICE Docs no DigitalOcean

Introdução

Agora você pode implantar facilmente a versão Docker do ONLYOFFICE Docs na infraestrutura de nuvem da DigitalOcean utilizando o aplicativo 1-Click (um clique) fornecido no DigitalOcean Marketplace.

O aplicativo 1-Click é uma imagem que inclui todos os componentes pré-configurados necessários para implantar os editores online do ONLYOFFICE em um servidor DigitalOcean executando o sistema operacional Ubuntu:

• Serviço do Docker,
• ONLYOFFICE Docs.

Assim que o seu Droplet do ONLYOFFICE Docs for inicializado, você poderá integrar o ONLYOFFICE Docs com uma das plataformas de armazenamento em nuvem, como Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub, Plone, Nuxeo, entre outras.

Etapa 1. Crie o seu Droplet na DigitalOcean

Faça o login na sua conta da DigitalOcean e navegue até o Marketplace da DigitalOcean.

Busque por ONLYOFFICE Docs na categoria Business Apps, passe o cursor sobre o aplicativo e clique no botão ‘Create Droplet’ que aparecerá. Alternativamente, você pode abrir a página de detalhes do Droplet e clicar no botão ‘Create ONLYOFFICE Docs Droplet’.

Na seção Choose a plan (Escolha um plano), selecione o plano que deseja usar ou mantenha o padrão. O plano Basic, que fornece 8 GB de RAM e 4 CPUs, é suficiente para executar o ONLYOFFICE Docs.

Opcionalmente, você pode configurar outros parâmetros do Droplet.

• Adicione armazenamento em bloco (Block Storage), se necessário. O armazenamento em bloco permite adicionar volumes de armazenamento independentes, que podem ser movidos de um Droplet para outro dentro da mesma região.
• Altere a região do datacenter, se necessário. Recomenda-se selecionar a região geograficamente mais próxima.
• Por padrão, o seu Droplet estará acessível via IP público. Se você escolher uma rede VPC, o Droplet se comunicará via IP privado somente com outros recursos na mesma rede VPC. Ele ficará inacessível pela internet pública.
• Marque algumas opções adicionais, se necessário: habilite a rede IPv6, forneça User Data ou habilite o monitoramento do Droplet.

Na seção Authentication (Autenticação), selecione o tipo de autenticação que será utilizado para acessar o seu Droplet. Você pode definir uma senha root ou adicionar uma chave SSH pública.

Crie uma senha root para acessar o Droplet (a autenticação via senha é menos segura do que o uso de chaves SSH). A senha precisa cumprir os seguintes requisitos:

• Pelo menos 8 caracteres
• Deve conter ao menos 1 letra maiúscula (o primeiro e o último caracteres não contam)
• Deve conter ao menos 1 número
• Não pode terminar com um número ou um caractere especial

Guarde sua senha em um local seguro. Você não receberá nenhum e-mail com os detalhes do seu Droplet e a senha.

O uso de chaves SSH é uma forma mais segura de acessar o Droplet criado do que o uso de uma senha. Nesse caso, a autenticação por senha será desabilitada por padrão. Se você quiser se conectar ao servidor usando uma chave SSH em vez de uma senha, adicione uma nova chave SSH pública ou use uma adicionada anteriormente. A chave privada deve estar armazenada na sua máquina local. Para saber mais sobre como criar pares de chaves SSH e adicionar a chave pública a um Droplet, consulte a documentação da DigitalOcean.

• Se necessário, você pode alterar a quantidade de Droplets criados, alterar o hostname padrão que será usado para identificar o Droplet no Painel de Controle da DigitalOcean, adicionar Tags ou escolher um projeto ao qual vincular o Droplet, caso tenha vários projetos.
• Habilite os backups do Droplet se quiser realizar backups automáticos semanais. Os backups custam 20% do valor do Droplet.

Clique no botão ‘Create Droplet’ e aguarde enquanto o Droplet é criado. O novo Droplet será exibido no Painel de Controle da DigitalOcean.

O IP do servidor é exibido ao lado do hostname do Droplet. Se você passar o mouse sobre o endereço IP, a opção Copy aparecerá. Clique nela para copiar o endereço IP.

Etapa 2. Conecte-se ao seu servidor via SSH para concluir a instalação

No Windows, você pode utilizar o utilitário PuTTY.

Insira o endereço IP do Droplet, certifique-se de que a porta 22 esteja especificada e que o tipo de conexão SSH esteja selecionado.

Caso tenha adicionado uma chave SSH pública ao criar o Droplet, especifique o caminho para a chave privada correspondente armazenada na sua máquina local na seção Connection -> SSH -> Auth.

Clique no botão Open. Em seguida, clique em Yes na janela PuTTY Security Alert.

• Se você selecionou a autenticação por senha ao criar o Droplet, utilize root como login e insira a senha root definida durante a criação do Droplet.
• Se você adicionou uma chave SSH, será autenticado com a sua chave privada.

No Linux, você pode utilizar um cliente SSH como o OpenSSH. Digite ssh root@your_droplet_ip no terminal e digite yes para continuar a conexão com o servidor.

• Se não adicionou chaves SSH, será solicitada a senha definida durante a criação do Droplet.
• Se você tiver várias chaves SSH, talvez precise especificar o caminho para a sua chave privada: ssh -i /path/to/private/key root@your_droplet_ip Você será autenticado com a sua chave privada.

Aguarde enquanto o processo de instalação é concluído. Durante este processo, o contêiner Docker onlyoffice-document-server será iniciado automaticamente.

Para explorar a funcionalidade da solução, ative o nosso exemplo de teste, que permitirá fazer upload dos seus arquivos locais para teste. Para isso, execute o seguinte comando:

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

Adicione o exemplo à inicialização automática:

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

Etapa 3. Acesse o ONLYOFFICE Docs via navegador

Assim que o exemplo for iniciado, digite http:// + <your droplet IP address>/example/ na barra de endereços do navegador.

A página de exemplo do ONLYOFFICE Docs será aberta. Aqui você pode:

1. Fazer upload de um arquivo armazenado no seu PC usando a opção Upload file.
2. Criar um novo documento de texto, planilha, apresentação ou modelo de formulário em branco usando as opções Create new -> Document, Spreadsheet, Presentation ou Form template. Se quiser criar um arquivo com conteúdo de exemplo, marque primeiro a caixa With sample content (Com conteúdo de exemplo).

O arquivo enviado ou criado será aberto em uma nova aba do navegador com o ONLYOFFICE Online Editor correspondente, para que você possa testar os recursos de edição.

O arquivo também aparecerá na lista Your documents na página de exemplo do ONLYOFFICE Docs.

Se quiser testar os recursos de coedição, selecione outro usuário de teste na lista Username e clique no mesmo documento na lista Your documents para abri-lo em uma nova aba do navegador.

Para integrar o ONLYOFFICE Docs ao seu próprio aplicativo web, consulte a Documentação da API.