Implementación de ONLYOFFICE Docs Developer Edition usando AMI
Introducción
Ahora puedes lanzar fácilmente la instancia de ONLYOFFICE Docs Developer Edition en la infraestructura de nube de Amazon Web Services utilizando la ONLYOFFICE Amazon Machine Image disponible en el AWS Marketplace.
La Amazon Machine Image (AMI) es una plantilla preconfigurada que permite lanzar fácilmente una instancia, que es un servidor virtual en la nube privada de AWS.
La ONLYOFFICE Docs Developer Edition AMI incluye todos los componentes necesarios: tanto el sistema operativo como el software en sí, así como un volumen de almacenamiento, para desplegar tu oficina web en un servidor virtual que funcione bajo Linux (CentOS).
Una vez que tu instancia de ONLYOFFICE Docs Developer Edition esté lanzada, puedes integrar ONLYOFFICE Docs con tu propia solución SaaS o local. La licencia también te permite proporcionar Editores en línea a los usuarios finales como parte de tu solución bajo tu marca.
Paso 1. Elige la AMI de ONLYOFFICE necesaria y suscríbete a la solución
Inicia sesión en tu cuenta existente de AWS o regístrate para obtener una nueva y ve al AWS Marketplace.
Encuentra la solución ONLYOFFICE Docs Developer Edition y elige el tipo de instancia necesario: para 250, 500 o 1000 conexiones. Las conexiones significan el número de pestañas del navegador con documentos que pueden abrirse para edición al mismo tiempo. Ten en cuenta que un documento abierto por dos usuarios significa dos conexiones simultáneas, ya que está abierto en dos pestañas. Cuando se alcanza el valor máximo, cada documento siguiente se abrirá en modo de solo lectura.
En la página de Descripción del producto, puedes leer la descripción de las funciones del software.
Cambia a la pestaña de Precios para estimar los detalles de precios que dependen de algunos parámetros de la instancia:
- Cambia la Región donde se lanzará la instancia, si es necesario. Se recomienda seleccionar una región con la ubicación más cercana. US East (N. Virginia) está seleccionada por defecto.
- En el menú de Opción de cumplimiento, solo está disponible la opción de Amazon Machine Image (AMI) de 64 bits (x86).
- En la sección de Detalles de precios del software, está disponible el tipo de suscripción por hora.
El precio total incluye cargos por el software de ONLYOFFICE y por los servicios de infraestructura de AWS utilizados para desplegar esta solución de software.
Nota: para obtener más información sobre la suscripción a AMIs de pago y otros detalles de precios, consulta la documentación de AWS.
Si haces clic en el tipo de Instancia EC2 que se muestra en la tabla (por ejemplo, t3.large), puedes ver los detalles de la instancia. El tipo de instancia EC2 determina el hardware del servidor virtual utilizado para desplegar la solución de ONLYOFFICE.
Los tipos de instancia disponibles difieren según la variante seleccionada de la solución ONLYOFFICE Docs Developer Edition, es decir, según el número de conexiones permitidas.
El tipo de instancia EC2 t3.medium se utiliza para ONLYOFFICE Docs Developer Edition (250 conexiones). Tiene los siguientes parámetros:
- Memoria: 4 GB
- CPU: 2 núcleos virtuales
- Almacenamiento: Solo EBS
- Red: Hasta 5 Gigabit Ethernet
El tipo de instancia EC2 t3.xlarge se utiliza para ONLYOFFICE Docs Developer Edition (500 conexiones). Tiene los siguientes parámetros:
- Memoria: 16 GB
- CPU: 4 núcleos virtuales
- Almacenamiento: Solo EBS
- Red: Hasta 5 Gigabit Ethernet
El tipo de instancia EC2 t3.2xlarge se utiliza para ONLYOFFICE Docs Developer Edition (1000 conexiones). Tiene los siguientes parámetros:
- Memoria: 32 GB
- CPU: 8 núcleos virtuales
- Almacenamiento: Solo EBS
- Red: Hasta 5 Gigabit Ethernet
Cambia a la pestaña de Uso donde puedes encontrar la siguiente información:
- La sección de Opciones de cumplimiento muestra las características de la AMI. La AMI de ONLYOFFICE tiene la arquitectura de 64 bits (x86).
- La sección de Componentes de la plantilla muestra los servicios de AWS que se utilizan para este producto.
- El servicio EC2 proporciona el entorno necesario para desplegar un servidor virtual que funcione bajo CentOS e instalar la solución de software de ONLYOFFICE en él.
- Instrucciones de uso contienen recomendaciones breves sobre cómo realizar la configuración inicial de ONLYOFFICE después de lanzar la instancia.
- Acuerdo de licencia de usuario final regula los términos y condiciones bajo los cuales se proporciona la solución ONLYOFFICE Docs Developer Edition.
Haz clic en el botón Continuar para suscribirse en la esquina superior derecha. Se abre la página Suscribirse a este software:
Lee el Acuerdo de Cliente de AWS y haz clic en el botón Aceptar términos. Espera mientras se procesa la suscripción.
Cuando la fecha actual se muestre en el campo de Fecha efectiva en lugar de 'Pendiente', haz clic en el botón Continuar para configurar en la esquina superior derecha.
Paso 2. Lanza tu instancia de ONLYOFFICE en la nube de AWS
En la página de Configurar este software, haz clic en el botón Continuar para lanzar en la esquina superior derecha.
Se abre la página Iniciar este software. En esta página, puede revisar los Detalles de Configuración una vez más.
La sección Elegir Acción permite seleccionar el método que desea usar para iniciar la instancia. La opción Iniciar desde el Sitio Web está seleccionada por defecto. Déjela sin cambios para desplegar la instancia usando el Asistente de Inicio de Instancia proporcionado en esta página web.
En la sección Tipo de Instancia EC2, solo está disponible una opción (depende del tipo de instancia de ONLYOFFICE Docs Developer Edition seleccionado previamente con un cierto número de conexiones permitidas).
En las secciones Configuración de VPC y Configuración de Subred, deje las configuraciones predeterminadas.
Ahora necesita crear un nuevo Grupo de Seguridad y generar un Par de Claves.
Crear un nuevo grupo de seguridad
Un grupo de seguridad permite limitar el acceso a su instancia para que solo direcciones IP conocidas puedan acceder a ella.
En la sección Configuración del Grupo de Seguridad, haga clic en el botón Crear Nuevo Basado en Configuraciones del Vendedor.
Ingrese el nombre del grupo de seguridad (por ejemplo, ONLYOFFICE) y agregue su descripción.
Utilice la lista Fuente (IP o Grupo) para establecer las reglas necesarias. Puede especificar una única dirección IP o un rango de direcciones IP, por ejemplo, 10.040.196.230/32.
Las reglas se especifican para los siguientes puertos:
- SSH - el puerto 22 se utiliza para acceder a su servidor usando un cliente SSH a través del protocolo SSH.
- HTTP - el puerto 80 se utiliza para acceder a su oficina web a través de un navegador web mediante el protocolo HTTP.
- HTTPS - el puerto 443 se utiliza para acceder a su oficina web a través de un navegador web mediante el protocolo seguro HTTPS.
Cuando esté listo, haga clic en el botón Guardar.
Generar un par de claves
Se requiere un par de claves para conectarse de manera segura a su instancia a través del protocolo SSH usando un cliente SSH como PuTTY o OpenSSH.
En la sección Configuración del Par de Claves, haga clic en el enlace Crear un par de claves en EC2.
La Consola de Administración de AWS se abrirá en una nueva pestaña del navegador.
Haga clic en el botón Crear par de claves en la esquina superior derecha. Ingrese el nombre del par de claves (por ejemplo, ONLYOFFICE) en el campo correspondiente y seleccione el formato de archivo dependiendo de qué software desea usar para conectarse a su instancia de forma remota:
pemse utiliza para OpenSSHppkse utiliza para PuTTY
Haga clic en el botón Crear par de claves a continuación.
Su clave pública se almacenará en el AWS EC2. El archivo .pem/.ppk que contiene su clave privada se descargará a su máquina local y se almacenará en la carpeta Descargas predeterminada. Por favor, cópielo y guárdelo en un lugar seguro.
Regrese al Marketplace de AWS, actualice el campo del par de claves usando el ícono a la derecha de este, y seleccione el par de claves creado de la lista.
Después de eso, el botón Iniciar se desbloquea. Haga clic en el Iniciar botón y espere mientras se despliega la instancia. Cuando esté listo, aparecerá el mensaje sobre el despliegue exitoso.
Haga clic en el enlace Consola EC2 en este mensaje para abrir los detalles de la instancia en la Consola de Administración de AWS.
Puede tomar algún tiempo para que la instancia se vuelva completamente funcional después de haberla iniciado. Asegúrese de que el estado de la instancia haya cambiado de 'pending' a 'running' en la columna Estado de la Instancia, y verifique que la instancia haya pasado todas las verificaciones de estado. Esta información se muestra en la columna Verificaciones de Estado.
Luego puede conectarse a su instancia a través de SSH para habilitar ejemplos de prueba y verificar la funcionalidad de la solución a través de un navegador web.
Paso 3. Conéctese a su servidor a través de SSH
Una vez que la instancia esté en funcionamiento, puede acceder a ella a través de SSH usando el nombre de usuario centos y su clave privada SSH.
Para conectarse a su servidor virtual a través de SSH, también necesitará usar el DNS Público o la Dirección IP de la instancia.
Se pueden encontrar en la Consola de Administración de AWS. Cambie a la sección Instancias en el menú de la izquierda, elija su región (US East (N. Virginia) por defecto) y seleccione su instancia ONLYOFFICE en la lista para abrir los detalles de la instancia.
Haga clic en el icono 
a la izquierda del DNS Público (IPv4) o IP Pública IPv4 en la pestaña Descripción para copiar el valor necesario al portapapeles.
En Windows, puedes usar la utilidad PuTTY.
El archivo de clave privada AWS generado al desplegar la instancia se utiliza para la autenticación en lugar de una contraseña.
Inicia PuTTY. En el panel de navegación de la izquierda, abre la sección Connection -> SSH -> Auth. Ve a la sección Authentication parameters -> Private key file for authentication, haz clic en el botón Browse y encuentra la ruta al archivo .ppk almacenado en tu máquina local.
Regresa a la sección Session en el panel de navegación de la izquierda. Ingresa el DNS Público o la Dirección IP de la instancia en el campo Host Name or IP address, asegúrate de que el puerto 22 esté especificado y que el tipo de conexión SSH esté seleccionado, y haz clic en el botón Open.
Luego haz clic en Yes en la ventana de PuTTY Security Alert. Escribe el nombre de usuario centos y presiona Enter.
En Linux, puedes usar un cliente SSH como OpenSSH.
Necesitarás especificar una ruta al archivo .pem con tu clave privada almacenada en tu máquina local, el nombre de usuario centos y la Dirección IP o DNS Público de tu instancia.
Ingresa el siguiente comando en tu terminal, especificando los valores reales para la ruta del archivo .pem y la Dirección IP:
ssh -i /ruta/onlyoffice.pem centos@tu_direccion_ip_instanciaEscribe yes para continuar conectándote al servidor. Para más información, puedes consultar la documentación de AWS.
Para explorar la funcionalidad de la solución, habilita nuestro ejemplo de prueba, lo que te permitirá subir tus archivos locales para probar. Para hacerlo, ejecuta el siguiente comando:
sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:exampleAñade el ejemplo al inicio automático:
sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
Paso 4. Accede a tu Docs Developer Edition a través de un navegador web
Una vez que el ejemplo esté iniciado, ingresa http://<dirección IP pública>/example/ en la barra de direcciones de un navegador web, reemplazando <dirección IP pública> con la dirección IP pública o el DNS público proporcionado por Amazon.
Se abre la página de ejemplo de ONLYOFFICE Docs Developer Edition. Aquí puedes:
- Subir un archivo almacenado en tu PC usando la opción Upload file.
- Crear un nuevo documento de texto en blanco, hoja de cálculo, presentación o plantilla de formulario usando las opciones Create new -> Document, Spreadsheet, Presentation, o Form template. Si deseas crear un archivo con contenido de muestra, primero marca la casilla With sample content.
El archivo subido o creado se abrirá en una nueva pestaña del navegador con el correspondiente Editor en línea de ONLYOFFICE para que puedas probar las capacidades de edición.
El archivo también aparecerá en la lista Your documents en la página de ejemplo de ONLYOFFICE Docs Developer Edition.
Si deseas comprobar las capacidades de coedición, selecciona otro usuario de prueba de la lista Username y luego haz clic en el mismo documento en la lista Your documents para abrirlo en una nueva pestaña del navegador.
Para integrar ONLYOFFICE Docs con tu propia aplicación web, puedes consultar la Documentación de la API.