Implantando o ONLYOFFICE Docs Enterprise Edition usando AMI

Introdução

Agora você pode lançar facilmente a instância do ONLYOFFICE Docs Enterprise Edition na infraestrutura de nuvem do Amazon Web Services usando a ONLYOFFICE Amazon Machine Image disponível no AWS Marketplace.

A Amazon Machine Image (AMI) é um modelo pré-configurado que permite lançar facilmente uma instância, que é um servidor virtual na nuvem privada da AWS.

A AMI do ONLYOFFICE Docs Enterprise Edition inclui todos os componentes necessários - tanto o sistema operacional quanto o próprio software, bem como um volume de armazenamento - para implantar seu escritório web em um servidor virtual rodando sob Linux (CentOS).

Assim que sua instância do ONLYOFFICE Docs Enterprise Edition for lançada, você poderá integrar o ONLYOFFICE Docs com uma das plataformas de sincronização e compartilhamento de arquivos, como Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub etc.

Passo 1. Escolha a AMI do ONLYOFFICE necessária e assine a solução

Faça login na sua conta AWS existente ou cadastre-se para uma nova e vá para o AWS Marketplace.

Encontre a solução ONLYOFFICE Docs Enterprise Edition e escolha o tipo de instância necessário – para 50, 100, 200 ou 400 conexões. Conexões significam o número de abas do navegador com documentos que podem ser abertas para edição ao mesmo tempo. Observe que um documento aberto por dois usuários significa duas conexões simultâneas, pois é aberto em duas abas. Quando você atinge o limite, cada próximo documento abre no modo de apenas leitura.

Na página Product Overview (Visão geral do produto), você pode ler a descrição das funções do software.

Mude para a aba Pricing (Preços) para estimar os detalhes de preços que dependem de alguns parâmetros da instância:

Altere a Region (Região) onde a instância será lançada, se necessário. Recomenda-se selecionar a região com a localização mais próxima. US East (N. Virginia) é selecionada por padrão.
No menu Fulfillment option (Opção de atendimento), apenas a opção Amazon Machine Image (AMI) de 64 bits (x86) está disponível.
Na seção Software Pricing Details (Detalhes de Preços do Software), escolha o tipo de assinatura por Hora ou Anual.
O preço total inclui taxas pelo software ONLYOFFICE e pelos serviços de infraestrutura da AWS usados para implantar esta solução de software.

Nota: para saber mais sobre a assinatura de AMIs pagas e outros detalhes de preços, consulte a documentação da AWS.

Se você clicar no EC2 Instance type (Tipo de instância EC2) exibido na tabela (por exemplo, t3.large), poderá ver os detalhes da instância. O tipo de instância EC2 determina o hardware do servidor virtual usado para implantar a solução ONLYOFFICE.

Os tipos de instâncias disponíveis variam dependendo da variante selecionada da solução ONLYOFFICE Docs Enterprise Edition, ou seja, do número de conexões permitidas.

O tipo de instância EC2 t3.small é usado para o ONLYOFFICE Docs Enterprise Edition (50 conexões). Ele possui os seguintes parâmetros:

Memória: 2 GB
CPU: 2 núcleos virtuais
Armazenamento: Apenas EBS
Rede: Até 5 Gigabit Ethernet

O tipo de instância EC2 t3.medium é usado para o ONLYOFFICE Docs Enterprise Edition (100 conexões). Ele possui os seguintes parâmetros:

Memória: 4 GB
CPU: 2 núcleos virtuais
Armazenamento: Apenas EBS
Rede: Até 5 Gigabit Ethernet

O tipo de instância EC2 t3.xlarge é usado para o ONLYOFFICE Docs Enterprise Edition (200 conexões). Ele possui os seguintes parâmetros:

Memória: 16 GB
CPU: 4 núcleos virtuais
Armazenamento: Apenas EBS
Rede: Até 5 Gigabit Ethernet

O tipo de instância EC2 t3.2xlarge é usado para o ONLYOFFICE Docs Enterprise Edition (400 conexões). Ele possui os seguintes parâmetros:

Memória: 32 GB
CPU: 8 núcleos virtuais
Armazenamento: Apenas EBS
Rede: Até 5 Gigabit Ethernet

Mude para a aba Usage (Uso), onde você encontrará as seguintes informações:

A seção Fulfillment Options exibe as características da AMI. A AMI do ONLYOFFICE tem arquitetura de 64 bits (x86).
A seção Template components exibe os serviços da AWS que são usados para este produto.
- O serviço EC2 fornece o ambiente necessário para implantar um servidor virtual rodando sob CentOS e instalar a solução de software ONLYOFFICE nele.
Usage Instructions (Instruções de Uso) contêm recomendações breves sobre como realizar a configuração inicial do ONLYOFFICE após o lançamento da instância.
End User License Agreement (Contrato de Licença de Usuário Final) regula os termos e condições sob os quais a solução ONLYOFFICE Docs Enterprise Edition é fornecida.

Clique no botão Continue to Subscribe no canto superior direito. A página Subscribe to this software abre:

Leia o AWS Customer Agreement e clique no botão Accept Terms. Aguarde enquanto a assinatura é processada.

Quando a data atual for exibida no campo Effective date em vez de 'Pending', clique no botão Continue to Configuration no canto superior direito.

Passo 2. Lance sua instância ONLYOFFICE na nuvem AWS

Na página Configure this software, clique no botão Continue to Launch no canto superior direito.

A página Launch this software abre. Nesta página, você pode revisar os Configuration Details (Detalhes da Configuração) mais uma vez.

A seção Choose Action permite selecionar o método que deseja usar para lançar a instância. A opção Launch from Website é selecionada por padrão. Deixe-a inalterada para implantar a instância usando o Launch Instance Wizard fornecido nesta página web.

Nota: você também pode lançar sua instância através do console do Amazon EC2. Para fazer isso, selecione a opção Launch through EC2 no menu e clique no botão Launch. Você será redirecionado para o Launch Instance Wizard no seu AWS Management Console onde poderá selecionar um tipo de instância, configurar detalhes, adicionar armazenamento, tags e configurar um grupo de segurança. Este guia não descreve tal método de lançamento.

Na seção EC2 Instance Type, apenas uma opção está disponível (depende do tipo de instância ONLYOFFICE Docs Enterprise Edition selecionado anteriormente com o número de conexões permitido).

Nas seções VPC Settings e Subnet Settings, mantenha as configurações padrão.

Agora você precisa criar um novo Security group (Grupo de segurança) e gerar um Key pair (Par de chaves).

Criar um novo grupo de segurança

Um grupo de segurança permite limitar o acesso à sua instância para que apenas endereços IP conhecidos possam acessá-la.

Na seção Security Group Settings, clique no botão Create New Based on Seller Settings.

Insira o nome do grupo de segurança (por exemplo, ONLYOFFICE) e adicione sua descrição.

Use a lista Source (IP or Group) para definir as regras necessárias. Você pode especificar um único endereço IP ou uma faixa de endereços IP, ex: 10.040.196.230/32.

As regras são especificadas para as seguintes portas:

SSH - a porta 22 é usada para acessar seu servidor usando um cliente SSH através do protocolo SSH.
HTTP - a porta 80 é usada para acessar seu escritório web via navegador através do protocolo HTTP.
HTTPS - a porta 443 é usada para acessar seu escritório web via navegador através do protocolo seguro HTTPS.

Quando estiver pronto, clique no botão Save.

Gerar um par de chaves

Um par de chaves é necessário para se conectar de forma segura à sua instância via protocolo SSH usando um cliente SSH como PuTTY ou OpenSSH.

Na seção Key Pair Settings, clique no link Create a key pair in EC2.

O AWS Management Console abrirá em uma nova aba do navegador.

Verifique se a Região AWS exibida na barra de ferramentas superior é a mesma onde você deseja lançar a instância.

Clique no botão Create key pair no canto superior direito. Insira o nome do par de chaves (ex: ONLYOFFICE) no campo correspondente e selecione o formato do arquivo dependendo de qual software você deseja usar para se conectar remotamente:

pem é usado para o OpenSSH
ppk é usado para o PuTTY

Clique no botão Create key pair abaixo.

Sua chave pública será armazenada no AWS EC2. O arquivo .pem/.ppk que contém sua chave privada será baixado para sua máquina local e armazenado na pasta padrão de Downloads. Por favor, copie-o e guarde-o em um local seguro.

Retorne ao AWS Marketplace, atualize o campo do par de chaves usando o ícone à direita e selecione o par de chaves criado na lista.

Depois disso, o botão Launch torna-se habilitado. Clique no botão Launch e aguarde enquanto a instância está sendo implantada. Quando estiver pronta, a mensagem sobre a implantação bem-sucedida aparecerá.

Clique no link EC2 Console nesta mensagem para abrir os detalhes da instância no AWS Management Console.

Pode levar algum tempo para que a instância torne-se completamente funcional após o lançamento. Certifique-se de que o status da instância mudou de 'pending' para 'running' na coluna Instance State, e verifique se a instância passou em todos os testes de status na coluna Status Checks.

Então você poderá se conectar à sua instância via SSH para habilitar os exemplos de teste e verificar a funcionalidade da solução via navegador.

Passo 3. Conecte-se ao seu servidor via SSH

Uma vez que a instância estiver rodando, você pode acessá-la via SSH usando o nome de usuário centos e sua chave privada SSH.

Para se conectar ao seu servidor virtual via SSH, você também precisará usar o DNS público ou Endereço IP da instância.

Eles podem ser encontrados no AWS Management Console. Vá para a seção Instances no menu à esquerda, escolha sua região (US East (N. Virginia) por padrão) e selecione sua instância ONLYOFFICE na lista para abrir os detalhes.

Clique no ícone Copy icon à esquerda do Public IPv4 DNS ou do Public IPv4 address na aba Description para copiar o valor necessário para a área de transferência.

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

O arquivo de chave privada da AWS gerado durante a implantação da instância é usado para autenticação em vez de uma senha.

Inicie o PuTTY. No painel de navegação esquerdo, abra a seção Connection -> SSH -> Auth. Vá para a seção Authentication parameters -> Private key file for authentication, clique no botão Browse e encontre o caminho para o arquivo .ppk armazenado na sua máquina local.

Retorne à seção Session no painel de navegação esquerdo. Insira o DNS público ou Endereço IP da instância no campo Host Name or IP address, certifique-se de que a porta 22 esteja especificada e que o tipo de conexão SSH esteja selecionado, e clique no botão Open.

Em seguida, clique em Yes na janela PuTTY Security Alert. Digite o nome de usuário centos e pressione Enter.

No Linux, você pode usar um cliente SSH como o OpenSSH.

Você precisará especificar o caminho para o arquivo .pem com sua chave privada armazenada na sua máquina local, o nome de usuário centos e o IP address ou Public DNS da sua instância.

Insira o seguinte comando no seu terminal, especificando os valores reais para o caminho do arquivo .pem e o Endereço IP:

ssh -i /caminho/onlyoffice.pem centos@seu_ip_da_instancia

Digite yes para continuar a conexão com o servidor. Para mais informações, você pode consultar a documentação da AWS.

Para explorar a funcionalidade da solução, habilite nosso exemplo de teste, que permitirá carregar 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

Passo 4. Acesse seu Docs Enterprise Edition via navegador web

Assim que o exemplo for iniciado, digite http://<endereço IP público>/example/ na barra de endereços de um navegador, substituindo <endereço IP público> pelo endereço IP público ou DNS público fornecido pela Amazon.

Acessar Enterprise Edition via navegador

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

Carregar um arquivo armazenado no seu PC usando a opção Upload file (Carregar arquivo).
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ê deseja criar um arquivo com conteúdo de exemplo, primeiro marque a caixa With sample content.

O arquivo carregado ou criado abrirá em uma nova aba do navegador com o correspondente ONLYOFFICE Online Editor para que você possa testar as capacidades de edição.

O arquivo também aparecerá na lista Your documents (Seus documentos) na página de exemplo do ONLYOFFICE Docs Enterprise Edition.

Se você deseja testar as capacidades 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 com sua própria aplicação web, você pode consultar a Documentação da API.