paramecio2docs/docs/tutorial.md

3.8 KiB

Creando un nuevo website

Para crear un nuevo website con paramecio2 debe de usar el comando instalado paramecio2

Introduzca en su linea de comandos lo siguiente:

user@localhost: paramecio2 --help

usage: paramecio2 [-h] --path PATH [--modules MODULES] [--symlink] [--url URL] [--folder FOLDER]

A tool for create new paramecio2 sites

options:
  -h, --help         show this help message and exit
  --path PATH        The path where the paramecio site is located
  --modules MODULES  A list separated by commas with the git repos for download modules for this site
  --symlink          Set if create direct symlink to paramecio in new site
  --url URL          The http/https base url of the real proxy server. Example: https://www.exampledomain.com, default is http://localhost:5000
  --folder FOLDER    If you deploy in a subdirectory, set it, without beggining and ending slashes

El único parametro requerido es --path, que indica la carpeta donde será guardado su nuevo sitio.

Ejemplo: paramecio2 --path site

Aparecerán diversas opciones para contestar:

  • Email for site:

Con esta opción puede añadir un correo por defecto que será usado para algunas cuestiones internas de envío de emails.

  • Do you want use paramecio with MySQL database? y/n:

Esta opción es para añadir una base de datos MariaDB/MySQL al sistema.

Recuerde que MariaDB es una base de datos compatible con MySQL y es la recomendada por parte de los desarrolladores para su uso con Paramecio2.

Si se elige y(sí) aparecerán unas nuevas opciones para configurar la base de datos del nuevo website con paramecio2:

  • MySQL database server host, by default localhost:

Añada el servidor de datos mysql para el website creado con paramecio2. Por defecto es el servidor de bases de datos local.

  • MySQL database name, by default paramecio_db:

El nombre de la base de datos que se usará para paramecio2. Si no existe, el sistema intentará crearla.

  • MySQL database user, by default root:

El usuario de la base de datos, por defecto, el usuario root.

  • MySQL database password, by default "":

La contraseña de la base de datos. Por defecto, se deja en blanco.

  • Do you want create admin site? y/n:

Si elegiste usar una base de datos MySQL, podrás tener opción para crear una zona de administración, a la que se podrá añadir módulos usando flask y la aplicación wsgi admin_app.

Si todo va bien, obtendremos este mensaje final:

Created admin site...

Una vez visto ese mensaje, podremos acceder al administrador de nuestro nuevo sitio y podremos crear al usuario administrador.

Iniciando el nuevo website.

Si el path usado para el nuevo sistema paramecio2 es site, podremos entrar a una carpeta llamada así dentro del directorio donde ejecutamos el comando paramecio2.

Con flask, podemos hacer usar su entorno de desarrollo, usando el comando flask.

Entramos en site. Usando Linux por ejemplo:

cd site

Ahora ejecutamos el comando flask:

flask --app app run --debug

Debería aparecer lo siguiente:

 * Serving Flask app 'app'
 * Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:5000
Press CTRL+C to quit
 * Restarting with watchdog (inotify)
 * Debugger is active!
 * Debugger PIN: 537-905-394

Si no da error, ya tienes instalado correctamente un sitio usando Paramecio2 framework.

Creando un nuevo usuario para el administrador.

Si creaste el sitio con un administrador, podrás acceder a él en esta dirección web por defecto:

http://localhost:5000/admin

Obviamente deberás cambiar la URL a la dirección con la que configuraste Paramecio2.

Más información sobre Flask: (https://flask.palletsprojects.com/en/3.0.x/)