A medida que JavaScript se convirtió en uno de los lenguajes de programación más populares para crear aplicaciones web, muchos de nuestros clientes han llegado a amar el lenguaje.
Pero para crear aplicaciones escalables de navegador y servidor, a menudo quieren usar Node.js.
Este entorno multiplataforma de código abierto de Rockstar permite el rápido desarrollo de aplicaciones, lo que conduce a una alta productividad y, por lo tanto, a una implementación más rápida.
Web Hosting Magic ofrece alojamiento web escalable y seguro, a menudo descrito por nuestros clientes como "una gran alternativa a VPS “.
Nuestro Selector de Node.js le permite a usted, como desarrollador de JavaScript, tener el espacio web y los recursos necesarios para su aplicación y, al mismo tiempo, minimizar los dolores de cabeza relacionados con la administración de aplicaciones.
Cómo instalar una aplicación Node.js mediante el selector de Node.js
Selector de Node.js es un componente de CloudLinux que permite a cada usuario crear fácilmente aplicaciones Node.js, elegir la versión de Node.js y otros parámetros para las aplicaciones según sus necesidades.
Con una interfaz de usuario amigable, une todas las funciones en un solo lugar y lo hace muy conveniente de administrar.
Al momento de escribir esto, nuestro Selector de Node.js admite las versiones 11.x, 12.x, 14.x de Node.js y otras versiones posteriores.
El Selector de Node.js tiene muchas ventajas sobre la implementación manual.
Permite que varias aplicaciones diferentes se ejecuten con el mismo usuario, a las que se accede desde la "Configuración de la aplicación Node.js ” en su cuenta de cPanel.
El pasajero de Phusion se usa para traspasos de aplicaciones, por lo que no necesitará configurar ningún redireccionamiento .htaccess para decirle al servidor web que reenvíe al puerto de la aplicación.
Con Node.js Selector, todo esto se maneja por usted.
Para comenzar, vaya a cPanel → Sección de software → Seleccione la versión de Node.js .
Se mostrará la página Aplicaciones web y verá varias columnas en la lista.
URI de la aplicación:URI de la aplicación que incluye el dominio.
- Directorio raíz de la aplicación:directorio raíz de la aplicación relativo a la casa del usuario.
- Modo:puede ser producción o desarrollo.
- Estado:iniciado/detenido:muestra si una aplicación se está ejecutando o no y la versión de la aplicación.
- Acciones:permite iniciar, reiniciar, detener, editar y eliminar una aplicación en particular.
Cree una cuenta de cPanel
Antes de que pueda acceder y usar cPanel para sus implementaciones de Node.js, debe tener una cuenta de cPanel.
Para crear una cuenta de cPanel, visite https://dashboard.webhostingmagic.com/cart.php?gid=1 y seleccione un paquete de alojamiento.
Nuestro sistema lo guiará a través del proceso que le llevará menos de 5 minutos obtener sus inicios de sesión de cPanel.
Cómo crear una aplicación Node.js
Antes de que pueda configurar su aplicación Node.js, deberá llevar esa aplicación a su servidor cPanel.
Simplemente puede usar SFTP para cargar una copia de su aplicación a su servidor.
O también puede usar el soporte Git nativo de cPanel para clonar el repositorio en su servidor e implementarlo desde allí.
El siguiente ejemplo usó el soporte Git nativo de cPanel para clonar la aplicación en el servidor y luego implementarla.
Clonar la aplicación
- Inicie sesión en cPanel.
- En el panel Archivos, verá la interfaz de terminal de cPanel (cPanel – Inicio – Avanzado – Terminal).
- Haz clic en él para ver dónde puedes crear un repositorio Git.
- Ahora regrese a Github y clone con HTTPS usando la URL web. Para mantener seguros los datos de su aplicación, asegúrese de no clonar ni cargar en la carpeta public_html, ya que esto hace que el código sea potencialmente accesible desde la web. Nuestro sistema se esfuerza por mantener sus datos seguros y, durante la implementación, no es un requisito que los datos de su aplicación sean de acceso público.
Clonación a un servidor cPanel desde un repositorio Github privado
Los repositorios privados requieren acceso SSH, debe realizar pasos adicionales para clonar un repositorio remoto alojado de forma privada.
Puede usar la interfaz de Terminal de cPanel (cPanel – Inicio – Avanzado – Terminal) para acceder a la línea de comandos desde la interfaz de cPanel.
Generar una clave SSH
Si aún no ha configurado uno, ejecute el siguiente comando para generar una clave SSH:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
En este ejemplo, “nombre de usuario ” representa el nombre de usuario de la cuenta de cPanel y “example.com ” representa el nombre de dominio.
Después de ejecutar este comando, el sistema le pedirá que ingrese una frase de contraseña.
No ingrese una frase de contraseña.
Presione Entrar para continuar.
Verifique que la clave esté disponible
Para confirmar que la clave existe y está en la ubicación correcta, ejecute el siguiente comando:
cat ~/.ssh/id_rsa.pub
Registrar nuestra clave SSH con el host de repositorio privado
Para registrar una clave SSH con GitHub, realice los siguientes pasos:
- Inicie sesión en su cuenta de GitHub.
- Navega a tu repositorio privado.
- En la esquina superior derecha de la página, haga clic en Configuración. Aparecerá una nueva página.
- En el menú del lado izquierdo, haga clic en Implementar claves. Aparecerá una nueva página.
- En la esquina superior derecha de la página, haga clic en Agregar clave de implementación. Aparecerá una nueva página.
- Ingrese los datos de su clave SSH:
- En el cuadro de texto Título, ingrese un nombre para mostrar para la clave.
- En el cuadro de texto Clave, pegue la clave SSH completa.
Si desea enviar código desde su cuenta de cPanel a su cuenta de GitHub, seleccione "Permitir acceso de escritura ” casilla de verificación.
Si no selecciona esta casilla de verificación, solo puede implementar cambios desde su repositorio de GitHub al repositorio alojado en cPanel.
- Haga clic en Agregar clave.
Tenga en cuenta que algunos hosts de repositorio no le permiten configurar el acceso de escritura para sus claves de acceso.
Para obtener información sobre cómo registrar su clave SSH con otro host de repositorio privado (Bitbucket, GitLab, etc.), consulte el sitio web o la documentación de ese host.
Pruebe la clave SSH
Para probar su clave SSH, ejecute el siguiente comando.
ssh -T [email protected]
donde "example.com" representa el host del repositorio privado, por ejemplo, ssh -T [email protected].
Clonar el repositorio a cPanel
Para clonar el repositorio, ejecute el siguiente comando en la cuenta de cPanel, donde “git clone [email protected]:$name/private-repo.git ” representa la URL de clonación del repositorio privado:
git clone [email protected]:$name/private-repo.git
Si ve "Error:el protocolo de enlace WebSocket falló en... ” cuando acceda a la interfaz de Terminal de cPanel (cPanel – Inicio – Avanzado – Terminal), vuelva a verificar su conexión.
Si está usando una VPN, desconéctese y use su conexión a Internet normal.
Una vez que haga clic en "Crear ” esto lo llevará de regreso a la página del repositorio que muestra la ruta completa de la aplicación que se está implementando.
Esta página es importante, así que guarde esa ruta para usarla más adelante.
Para recapitular:
- Seleccione una versión de Node.js.
- Seleccione "Desarrollo" o "Producción" para el modo de aplicación.
- Seleccione la raíz de la aplicación. Tiene que ser una dirección física de su aplicación en un servidor que se corresponda con su URI.
- Seleccione la URL de la aplicación. Este es un enlace HTTPS a su aplicación.
- Complete el formulario para apuntar al archivo de inicio de la aplicación. También puede agregar variables de entorno adicionales haciendo clic en "Agregar variable".
- Haga clic en Crear.
… una explicación más detallada.
Configuración de la aplicación Node.js
Con los archivos de la aplicación en su lugar en el servidor, está listo para configurar Node.js para iniciar esa aplicación desde la web.
Desde cPanel en la misma cuenta en "Software ", seleccione "Configurar la aplicación Node.js ”.
En esta pantalla de configuración, seleccionará "Crear aplicación ” para mostrar las opciones para elegir la versión de Node.js, así como si usar un Desarrollo o Producción entorno.
El desarrollo generalmente tiene diferentes enlaces de aplicación en el código de la aplicación, dependiendo de cómo se establezca esta variable de entorno.
Como regla general, Producción tendrá más niveles de almacenamiento en caché, así como un registro mínimo.
Por lo tanto, para un conjunto de entornos de desarrollo, puede esperar lo contrario, con menos niveles de almacenamiento en caché de aplicaciones y un registro más detallado y salida de mensajes de error.
Un ejemplo típico sería donde, si se trata de un entorno de producción, es posible que solo vea una página de error.
En desarrollo, es posible que vea un seguimiento de pila completo en un error de aplicación que le permite averiguar exactamente dónde ocurrió el error dentro del código.
Dado que las aplicaciones de Node.js, en general, dependen de varias variables de entorno, puede agregarlas usando el botón “Agregar variable ” cerca de la parte inferior derecha de la página.
La variable de producción o desarrollo de Node.js ya está configurada por separado en la sección superior usando el "Modo de aplicación ”, por lo que no es necesario configurarlo nuevamente en la sección Variables de entorno.
Este mismo menú es donde puede seleccionar la versión de Node.js que le gustaría usar, así como el archivo de inicio de la aplicación.
Esto podría ser index.js , aplicación.js, o cualquier número de variaciones; depende de la aplicación.
Una vez que haya guardado su aplicación, deberá resolver las dependencias de su paquete.
El administrador de paquetes NPM hace esto automáticamente en función del archivo package.json empaquetado con la aplicación, por lo que todo lo que debe hacer aquí es hacer clic en el botón "Instalar NPM".
En este punto, necesitará que su dominio se resuelva en una dirección IP, o el script de instalación tendrá un error.
Si está utilizando un subdominio, asegúrese de que se haya creado y de que haya agregado todos los registros relevantes a su DNS.
Puede confirmar esto simplemente ejecutando:
$ dig sub-domain.com
NPM leerá el contenido del archivo package.json e instalará los paquetes necesarios en un entorno virtual específico para la aplicación.
Si está familiarizado con la línea de comandos, puede seguir las instrucciones en la parte superior de la página para obtener acceso a los comandos "npm" y "nodo" para realizar cambios adicionales manualmente, lo que permite una gran cantidad de personalización.
Implementación de aplicaciones Node.js
En este punto, tendrá su aplicación configurada y los módulos de Node.js instalados, por lo que estará listo para iniciar la aplicación.
Nuestros sistemas cPanel lo hacen muy fácil.
En la misma página donde configuró su aplicación, haga clic en "Ejecutar JS Script ”
Esto ejecutará el archivo de inicio de la aplicación que definió anteriormente durante la instalación.
Como las aplicaciones Node.js tienen varias opciones diferentes, esto puede mostrar otro menú con diferentes opciones para seleccionar dependiendo de la aplicación que esté ejecutando.
En general, deberá seleccionar la opción "Iniciar ” opción siguiente.
Finalmente, puede seleccionar la opción “Abrir ” opción para visitar su página, y ver su aplicación!
Cómo iniciar una aplicación Node.js
Para iniciar una aplicación detenida, haga lo siguiente:
Haga clic en Inicio en la columna Acciones en una fila de aplicación detenida.
Cuando se completa la acción, un ícono de Inicio cambia al ícono Detener.
Cómo detener una aplicación Node.js
Para detener una aplicación iniciada, haga lo siguiente:
Haz clic en Detener icono en la columna Acciones en una fila de aplicación iniciada.
Cuando se completa la acción, un ícono Detener cambia al ícono Iniciar.
Cómo iniciar una aplicación Node.js
Para reiniciar la aplicación, haga lo siguiente:
Haz clic en Reiniciar icono en la columna Acciones en una fila de aplicación iniciada.
La fila actual se bloqueará y se desbloqueará cuando se complete el proceso.
Cómo eliminar una aplicación Node.js
Para eliminar la aplicación, haga lo siguiente:
Haga clic en el ícono "Papelera" en la columna Acciones en una fila de aplicación en particular.
en la confirmación, haga clic en Aceptar para comenzar a eliminar o en Cancelar para cerrar la ventana emergente.
Cuando se complete la acción, se eliminará una aplicación de la tabla Aplicaciones web y se mostrará una ventana emergente de confirmación.
Cómo editar su aplicación Node.js
Para editar la aplicación haga lo siguiente:
Haga clic en el ícono del Lápiz en la columna Acciones en una fila de aplicación en particular.
Se abrirá una pestaña de aplicación.
Por el momento, puedes:
reinicie la aplicación:haga clic en Reiniciar botón.
- detenga Node.js:haga clic en el botón Detener Node.js.
- ejecutar secuencia de comandos JavaScript:haga clic en el botón Ejecutar secuencia de comandos JS para ejecutar un comando especificado en la sección de secuencias de comandos del archivo package.json. Especifique el nombre de la secuencia de comandos para ejecutar más cualquier parámetro y luego haga clic en Aceptar.
- eliminar aplicación:haga clic en el botón Eliminar y confirme la acción en una ventana emergente.
- cambie la versión de Node.js:elija la versión de Node.js en un menú desplegable.
- cambiar el modo de aplicación:elija el modo de aplicación de un menú desplegable. Los modos disponibles son Producción y Desarrollo.
especifique la raíz de la aplicación:especifique en un campo una dirección física para la aplicación en un servidor que se corresponda con su URI. - especifique la URL de la aplicación:especifique en un campo un enlace HTTP/HTTPS a la aplicación.
- especifique el archivo de inicio de la aplicación:especifique como archivo NAME.js.
- ejecutar el comando de instalación de npm y hacer clic en el botón Ejecutar instalación de npm para instalar los paquetes descritos en el archivo package.json.
- añadir variables de entorno:haga clic en Añadir variable y especifique un nombre y un valor.
Cómo depurar errores en su aplicación Node.js
Las directivas como PassengerFriendlyErrorPages y PassengerAppEnv están disponibles para su uso desde un archivo .htaccess.
Esto permite a los usuarios de cPanel depurar una aplicación Node.js durante el desarrollo.
Por ejemplo, si agrega una de las siguientes líneas al archivo .htaccess en la página de la aplicación y hay un error, verá el error en la lista:
PassengerAppEnv development
o
PassengerFriendlyErrorPages on