Implantando o ONLYOFFICE Docs no DigitalOcean

Introdução

Agora você pode implantar facilmente a versão Docker do ONLYOFFICE Docs na infraestrutura de nuvem DigitalOcean usando um aplicativo de um clique fornecido no DigitalOcean Marketplace.

O aplicativo de um clique é uma imagem que inclui todos os componentes pré-configurados necessários para implantar editores online ONLYOFFICE em um servidor DigitalOcean executando sob o SO Ubuntu:

Serviço Docker,
ONLYOFFICE Docs.

Uma vez que seu droplet do ONLYOFFICE Docs for iniciado, você pode integrar o ONLYOFFICE Docs com uma das plataformas de armazenamento em nuvem, como Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub, Plone, Nuxeo etc.

Etapa 1. Crie seu droplet no DigitalOcean

Faça login na sua conta DigitalOcean e vá para o Marketplace do DigitalOcean.

Encontre o ONLYOFFICE Docs na categoria Business Apps, mova o botão do mouse sobre o aplicativo e clique no botão 'Create Droplet' que aparece. 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, selecione o plano que deseja usar ou deixe 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 alguns outros parâmetros do droplet.

Adicione armazenamento em bloco, 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. É recomendável selecionar uma região com a localização mais próxima.
Por padrão, seu droplet estará disponível via endereço IP público. Se você escolher uma rede VPC, o droplet poderá se comunicar via endereço IP privado apenas com outros recursos na mesma rede VPC. Ele ficará inacessível pela internet pública.
Marque algumas opções adicionais, se necessário: habilitar rede IPv6, fornecer dados de usuário ou habilitar o monitoramento do droplet.

Na seção Authentication, selecione o tipo de autenticação que será usado para acessar seu droplet. Você pode especificar uma senha root ou adicionar uma chave SSH pública.

Crie uma senha root para acessar o droplet (a autenticação por senha é uma forma menos segura do que usar chaves SSH). A senha deve corresponder aos seguintes requisitos:

Pelo menos 8 caracteres
Deve conter pelo menos 1 caractere maiúsculo (primeiro e último caracteres não contam)
Deve conter pelo menos 1 número
Não pode terminar em um número ou caractere especial

Mantenha sua senha em um local seguro. Você não receberá mensagens de e-mail contendo os detalhes do droplet e a senha.

Usar chaves SSH é uma forma mais segura de acessar seu droplet criado do que usar uma senha. Neste caso, a autenticação por senha será desabilitada por padrão. Se você quiser se conectar ao seu 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 ser armazenada em sua máquina local. Para saber mais sobre como criar pares de chaves SSH e adicionar a chave pública a um droplet, você pode consultar a documentação do DigitalOcean.

Se necessário, você pode alterar o número de droplets criados, alterar um nome de host padrão que será usado para identificar o droplet dentro do Painel de Controle do DigitalOcean, adicionar tags ou escolher um projeto para atribuir o droplet, se você tiver vários projetos.
Habilite os backups do seu droplet se quiser realizar backups automáticos do droplet semanalmente. Os backups custam 20% do preço do droplet.

Clique no botão 'Create Droplet' e aguarde enquanto o droplet está sendo criado. O droplet recém-criado será exibido no Painel de Controle do DigitalOcean.

O IP do servidor é exibido ao lado do nome do host do droplet. Se você mover o botão do mouse sobre o endereço IP, a opção Copy aparece. 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 usar o utilitário PuTTY.

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

Se você adicionou uma chave SSH pública ao criar o droplet, especifique o caminho para sua chave privada correspondente armazenada em 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, use root como login e digite sua senha root especificada durante a criação do droplet.
Se você adicionou uma chave SSH, você será autenticado usando sua chave privada.

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

Se você não adicionou chaves SSH, será solicitada sua senha especificada durante a criação do droplet.
Se você tiver várias chaves SSH, pode precisar especificar o caminho para sua chave privada: ssh -i /caminho/para/chave/privada root@your_droplet_ip Você será autenticado usando 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, habilite nosso exemplo de teste, que permitirá que você faça upload de seus arquivos locais para teste. Para fazer 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 web

Uma vez que o exemplo seja iniciado, digite http:// + <endereço IP do seu droplet>/example/ na barra de endereços do navegador web.

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

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

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 você quiser verificar os recursos de coedição, selecione outro usuário de teste da 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 com seu próprio aplicativo web, você pode consultar a Documentação da API.