Línea de Comandos
La interfaz de línea de comandos de Netuno es la herramienta principal para gestionar tu entorno de desarrollo. A través de ella, puedes consultar información del sistema, gestionar aplicaciones y configurar el servidor de forma rápida.
Requisitos previos
- Terminal: Debes tener un terminal (Símbolo del sistema, PowerShell o Bash) abierto en la carpeta raíz donde se instaló Netuno.
Estos son los comandos iniciales para verificar si tu entorno está listo para usar.
| OPCIÓN | DESCRIPCIÓN |
|---|---|
help | Permite visualizar todos los comandos disponibles en Netuno. |
version | Permite visualizar la versión actual de Netuno. |
Listar comandos disponibles
Si tienes dudas sobre qué operaciones puedes realizar, usa el comando de ayuda. Devolverá una lista completa de funciones.
./netuno help
Ver la versión de Netuno
Es fundamental saber qué versión estás utilizando para garantizar la compatibilidad con scripts y módulos específicos.
./netuno version
Instalar
Antes de comenzar el desarrollo, es necesario instalar el motor de Netuno en tu entorno. Para más información, accede a nuestra página de Instalación.
Esta sección detalla los parámetros que se pueden utilizar durante el proceso de instalación para automatizar u optimizar el proceso.
| OPCIÓN | DESCRIPCIÓN |
|---|---|
checksum | Actualiza el código de verificación (checksum) de todos los archivos del paquete instalado. |
force | Fuerza la sustitución de todos los archivos, aunque existan cambios locales. |
graal=true/false | Define el uso de GraalVM para obtener un mayor rendimiento en la ejecución de las aplicaciones. |
path=[Directorio] | Define manualmente la ruta (carpeta) donde se instalará Netuno. |
remove | Elimina completamente todos los archivos relacionados con Netuno del sistema. |
version=[versión] | Selecciona una versión específica para instalar. Usa la más reciente para la versión de desarrollo. |
yes | Responde automáticamente "SÍ" a todas las confirmaciones, ignorando los avisos sobre pérdida de datos. |
Ejemplo de cómo actualizar el checksum:
./netuno install checksum
Ejemplo de cómo forzar la sustitución de los cambios locales:
./netuno install force
Ejemplo de cómo desactivar GraalVM:
./netuno install graal=false
GraalVM está activa por defecto y se descarga automáticamente durante la instalación de Netuno.
Ejemplo de cómo definir la ruta de instalación:
./netuno install path ='directorioNetuno'
Ejemplo de cómo eliminar todas las carpetas de Netuno:
./netuno install remove
Ejemplo de cómo seleccionar la versión de Netuno que debe instalarse:
./netuno install version='latest'
Ejemplo de cómo responder SÍ a todas las preguntas:
./netuno install yes
Servidor
Después de completar la instalación, inicia el servidor para comenzar a desarrollar tus aplicaciones.
Para iniciar el servidor con la configuración predeterminada, ejecuta el comando siguiente en la carpeta raíz de Netuno:
./netuno server
Por defecto, el servidor utiliza el puerto 9000. En cuanto el terminal indique que el sistema está listo, podrás acceder al panel de gestión a través del enlace: http://localhost:9000/
Esta sección detalla los parámetros que se pueden utilizar durante el proceso de inicio del servidor.
| OPCIÓN | DESCRIPCIÓN |
|---|---|
app=[nombre_de_la_aplicación] | Define específicamente qué aplicación debe iniciarse |
host=[IP/nombre del host] | Permite cambiar el nombre del host de Netuno |
launch=true/false | Define si Netuno debe abrir automáticamente el navegador |
npm | Ejecuta el comando 'npm watch' automáticamente para compilar el frontend de la app en tiempo real |
port=[número] | Define el puerto de inicio del servidor |
secret=[contraseña] | Define una contraseña de seguridad para permitir el acceso a la gestión remota del servidor |
web=[carpeta] | Cambia la carpeta raíz predefinida del proyecto (web home) |
Por defecto, Netuno utiliza la carpeta 'webapp' para almacenar todos los archivos esenciales para su funcionamiento.
Atención al cambiar el directorio: Si utilizas el parámetro web=[carpeta] para cambiar el nombre de la carpeta raíz, recuerda que también debes renombrar físicamente la carpeta en tu sistema de archivos. El comando solo indica al código de Netuno dónde buscar los archivos, no renombra carpetas automáticamente.
Ejemplo de cómo iniciar el servidor de una aplicación específica:
./netuno server app=miapp
Ejemplo de cómo cambiar el nombre del host:
./netuno server host=localhost
Ejemplo de cómo definir si Netuno inicializa el navegador automáticamente:
./netuno server launch=false
Por defecto, Netuno abre el navegador e inicializa el enlace http://localhost:9000.
Ejemplo de cómo ejecutar npm para construir automáticamente el frontend
./netuno server npm
Ejemplo de cómo cambiar el puerto:
./netuno server port=10000
Ejemplo de cómo definir una contraseña para acceder a la gestión remota del servidor:
./netuno server secret='c#ntr@s3ñ@'
Ejemplo de cómo cambiar la carpeta predeterminada de la web:
./netuno server web=webapp
Licencia
Para comenzar el desarrollo con Netuno, es necesario registrar tu entorno.
Para gestionar tu licencia, utiliza el comando base:
./netuno license
Actualmente, Netuno ofrece tres modalidades de licencia: Community, Standard y Enterprise.
Esta sección detalla las acciones disponibles para configurar o consultar tu licencia.
| OPCIÓN | DESCRIPCIÓN |
|---|---|
create , change | Inicia el proceso para crear una nueva licencia o cambiar la actual |
key | Muestra la clave de licencia activa en tu entorno |
mail=[tu@correo.com] | Define la dirección de correo electrónico asociada a la cuenta de la licencia |
type=[community/standard/enterprise] | Define el tipo de licencia |
Ejemplo de cómo crear una licencia:
./netuno license create
Ejemplo de cómo visualizar la clave de la licencia:
./netuno license key
Ejemplo de cómo definir tu correo electrónico y tipo de licencia:
./netuno license mail='correo@gmail.com' type='community'
Aplicación
Con el servidor configurado y la licencia activa, puedes ampliar tu ecosistema creando nuevas soluciones.
./netuno app
Los archivos generados se organizarán automáticamente dentro de la estructura de carpetas de Netuno.
Para acceder o editar los archivos de tu aplicación, navega por la siguiente ruta desde la raíz del sistema: webapp / apps / [nombre_de_tu_aplicación]
Estructura de Carpetas
-
webapp: Es la carpeta raíz que contiene todos los archivos esenciales para el funcionamiento de Netuno.
-
apps: Carpeta específica donde se almacenan todas las aplicaciones desarrolladas o en demostración.
-
[nombre_de_tu_aplicación]: La carpeta exclusiva de la aplicación que acabas de crear.
Por defecto, Netuno tiene una aplicación de demostración que se muestra cuando se inicia el servidor Netuno.
| OPCIÓN | DESCRIPCIÓN |
|---|---|
database=[nombre_de_la_base_de_datos] | Define el nombre de la base de datos |
engine=[nombre] | Define el tipo de base de datos |
host=[dirección] | Define la dirección de la base de datos. |
language=[idioma] | Define el idioma de la aplicación |
locale=[idioma] | Define el idioma local de la aplicación |
name=[nombre] | Permite crear una aplicación o reconstruir una aplicación existente |
password=[contraseña] | Define una contraseña para la base de datos |
port=[número] | Define el puerto de la base de datos |
username=[nombre] | Define el nombre de usuario de la base de datos |
Ejemplo de cómo definir el nombre de la base de datos:
./netuno app database=empleado
El nombre de la base de datos puede contener números y letras; si el nombre tiene más de una palabra, debe separarse con "_", de la siguiente manera.
Ejemplo: empleado_db
Ejemplo de cómo definir el tipo de base de datos:
./netuno app engine=pg
Existen los siguientes tipos de base de datos:
- PostgreSQL - pg
- MariaDB - mariadb
- Microsoft SQL Server - mssql
- H2 Database - h2
Ejemplo de cómo definir la dirección del servidor de base de datos:
./netuno app host=localhost
Ejemplo de cómo definir el idioma y la configuración regional:
./netuno app language=es_ES locale=es_ES
Existen los siguientes idiomas:
- Portugués - pt_PT
- Brasileño - pt_BR
- Inglés - en_US
- Español - es_ES
Ejemplo de cómo crear una aplicación o reconstruir una aplicación existente:
./netuno app name=demostracion
Ejemplo de cómo definir la contraseña de la base de datos:
./netuno app password=secreto
Ejemplo de cómo definir el puerto de la base de datos:
./netuno app port=5432
Por defecto, los puertos corresponden a:
- PostgreSql - 5432
- MariaDB -3306
- Microsoft SQL Server - 1433
Ejemplo de cómo definir el nombre de usuario de la base de datos:
./netuno username=root