TCU-691 Guia para Instalar Universidad de Costa Rica

Tropicalización de la Tecnologı́a Django en Raspberry Pi Escuela de Ingenierı́a Eléctrica

Preparación para Django en Raspberry Pi

1. Configurando Apache2 para Django

En esta sección, rápidamente se pondrá en funcionamiento Apache en nuestra Raspberry Pi para poder usar el
software Django. Apache es un software de servidor que sirve los archivos HTML desde una computadora al
navegador web.
La primera tarea es configurar e instalar el servidor web Apache en su Raspberry Pi.

1. Antes de instalar Apache en nuestra Raspberry Pi, primero debemos asegurarnos de que la lista de
paquetes esté actualizada ejecutando los siguientes dos comandos.

Terminal $

1 sudo apt - get update

2 sudo apt - get upgrade

2. Primero, necesitaremos instalar el paquete Apache2 en nuestra Raspberry Pi. Para instalar apache2 en su
Raspberry Pi, ingrese el siguiente comando en la terminal.

Terminal $

1 sudo apt install apache2 -y

3. Con Apache2 instalado en nuestra Raspberry Pi, ahora tenemos un servidor web extremadamente básico
en funcionamiento. El servidor podrá proporcionar contenido no dinámico, como archivos HTML.
En la siguiente sección, ampliaremos este servidor web Apache básico mediante la instalación de PHP en
la Raspberry Pi.
Para verificar que Apache esté funcionando en su Raspberry Pi, puede ingresar la dirección IP de
Raspberry Pi en un navegador web. El servidor deberı́a devolver una página web con un texto simple.
Si no conoce la IP, puede ingresar el comando de nombre de host en la terminal para recuperarla.

Terminal $

1 hostname -I

4. En un navegador web, se ingresa la dirección IP de su Raspberry Pi, este deberı́a conectarse y cargar una
página como la que se muestra a continuación.

1
 Figura 1: Ejemplo de pagina Web con Apache2.

5. Además de la versión base de Apache, necesitaremos instalar algunos paquetes adicionales para que
Apache pueda comunicarse con Python.
Podemos instalar el paquete correspondiente ejecutando el siguiente comando en su Raspberry Pi.

Terminal $

1 sudo apt install libapache2 - mod - wsgi - py3

Este comando instalará la interfaz de puerta de enlace del servidor web (WSGI) para interactuar con
Python 3.

2. Configurando Python 3 para Django

Nuestro próximo paso es instalar y configurar Python 3 en su Raspberry Pi para Django. La razón de esto es
que el marco Django se ejecuta utilizando el lenguaje de programación Python.

1. Instalaremos Python, su administrador de paquetes y su software de entorno virtual ejecutando el

siguiente comando.

Terminal $

1 sudo apt install python3 python3 - venv python3 - pip

3. Configuración de Apache para Django

Con el software Apache y Python instalado en nuestra Raspberry Pi, ahora configuremos todo para ejecutar
Django. Esta configuración no funcionará todavı́a, ya que todavı́a necesitamos instalar Django.

1. Comencemos modificando el archivo de configuración predeterminado para Apache. Puede editar este
archivo usando nano ejecutando el siguiente comando.

2
 Terminal $

1 sudo nano / etc / apache2 / sites - enabled /000 - default . conf

2. Dentro de este archivo, necesitaremos agregar algunas lı́neas para decirle a Apache cómo debe manejar
nuestros archivos. En este caso, le indicaremos que use Python para interpretar los archivos dentro del
directorio. Primero busque la siguiente lı́nea de texto dentro del archivo

Find

1 </ VirtualHost >

Una vez que haya encontrado la lı́nea, agregue el siguiente texto encima de ella. Estas lı́neas son las que
configuran dónde se almacenará nuestro script y cómo se ejecutará.

Above

1 Alias / static / home / pi / pidjango / static

2 < Directory / home / pi / pidjango / static >
3 Require all granted
4 </ Directory >
5
6 < Directory / home / pi / pidjango / pidjango >
7 < Files wsgi . py >
8 Require all granted
9 </ Files >
10 </ Directory >
11
12 W S G I D a e m o n P r o c e s s django python - path =/ home / pi / pidjango python - home =/
home / pi / pidjango / djenv
13 W S G I P r o c e s s G r o up django
14 W SG IS cr i pt Al ia s / / home / pi / pidjango / pidjango / wsgi . py

En este ejemplo, supondremos una aplicación llamada “django” que se almacenará en la carpeta
“/home/pi/pidjango” en nuestra Raspberry Pi.
También configuramos el hogar de Python en la ubicación de nuestro entorno virtual, que finalmente se
almacenará en el directorio “/home/pi/pidjango/djenv”.
3. Con los detalles ingresados, puede guardar el archivo presionando CTRL + X, luego Y, y finalmente la
tecla ENTER.
4. Para que nuestros cambios de configuración surtan efecto, necesitaremos reiniciar el servicio web de
Apache.
Podemos hacerlo ejecutando el siguiente comando para usar el administrador de servicios para reiniciar
Apache.

Terminal $

1 sudo systemctl restart apache2

Instalar y ejecutar un nuevo sitio web de Django

Ahora que tenemos Apache configurado para ejecutar Django en nuestra Raspberry Pi, se procede a instalar el
software que necesitamos. La configuración de Django requiere que realicemos algunos pasos diferentes, como
crear una carpeta para que se asiente el proyecto. También haremos uso de un entorno virtual de Python. Un
entorno virtual nos permitirá instalar paquetes de Python especı́ficamente para ese entorno.

3
4. Configuración de carpetas para Django
Configuremos una carpeta para que mantengamos el marco Django en nuestra Raspberry Pi.

1. Hagamos un directorio donde almacenaremos nuestros scripts de Django y nuestro entorno virtual de
Python.
Para este tutorial, lo crearemos dentro de nuestro directorio de inicio en una carpeta llamada ”pidjango”.
También cambiaremos a nuestro directorio recién creado usando el

Terminal $

1 mkdir -p / home / pi / pidjango / static

2 cd / home / pi / pidjango

2. Dentro de este directorio, podemos comenzar creando nuestro nuevo entorno virtual de Python.

Terminal $

1 python3 -m venv djenv

Después de ejecutar este comando, ahora deberı́a tener una carpeta llamada .env”dentro del directorio
Django que creamos.
Cuando instalamos Django y cualquier paquete adicional de Python, se almacenarán dentro de esta
carpeta mientras usamos ese entorno virtual.

5. Instalación de Django en la Raspberry Pi

Con todas nuestras carpetas ahora configuradas y nuestro entorno virtual listo para Python, finalmente
podemos instalar Django.
Al final de los siguientes dos pasos, debe tener instalado Django en su entorno virtual y haber iniciado un
nuevo proyecto.

1. Con el entorno virtual creado, necesitamos usarlo como fuente. Para usar el entorno virtual como fuente,
debe ejecutar el siguiente comando:

Terminal $

1 source djenv / bin / activate

Después de ejecutar este comando, deberı́a ver ”(djenv).al comienzo de la lı́nea de comando. Esto indica
que está utilizando nuestro nuevo entorno virtual como fuente.
2. Ahora que estamos dentro de nuestro entorno virtual, instalemos el framework Django.
Como Django está disponible como un paquete de Python, ejecutemos el siguiente comando para
descargarlo.

Terminal $

1 python3 -m pip install django

Ejecutar este comando le permitirá descargar la última versión disponible de Django.

Si desea descargar una versión especı́fica del marco, agregue == seguido del número de versión.

3. Con Django instalado, ahora podemos crear un nuevo proyecto.

Podemos ejecutar el siguiente comando, siendo el último fragmento de texto el nombre del proyecto.

4
 Terminal $

1 django - admin startproject pidjango .

Esto creará todos los archivos que necesita para comenzar con Django y nos permitirá verificar que lo
hayamos configurado correctamente.

6. Permitir el acceso a su servidor Raspberry Pi Django

Antes de que podamos acceder a nuestro marco Django recién configurado en nuestra Raspberry Pi, necesitare-
mos modificar su configuración.
De forma predeterminada, Django está configurado para no permitir ningún acceso a menos que esa IP o
nombre de host especı́fico se haya agregado a la lista permitida.

1. Para permitir el acceso a través de la dirección IP de nuestra Raspberry Pi, debemos recuperarla. Puede
obtener la dirección IP local de su dispositivo usando el siguiente comando.

Terminal $

1 hostname -I

2. Vamos a editar el archivo de configuración. Estas configuraciones se almacenan dentro de un archivo

python llamado ”settings.py”.

Terminal $

1 nano / home / pi / pidjango / pidjango / settings . py

3. Dentro de este archivo, debe encontrar la siguiente lı́nea y modificarla ligeramente. Encuentra la siguiente
lı́nea.

Find $

1 ALLOWED_HOSTS = []

Reemplace con lo siguiente.

Find $

1 ALLOWED_HOSTS = [ " YOURIPADDRESS " ]

Asegúrese de reemplazar ”YOURIPADDRESSçon la dirección IP de su Raspberry Pi. Puede agregar

direcciones IP o nombres de host adicionales usando una coma para separar cada entrada. Todos estos
valores se almacenan dentro de una matriz de Python.
4. Una vez hecho esto, guarde el archivo presionando CTRL + X, luego Y, seguido de la tecla ENTER.

7. Visualización de su aplicación web Django

Ahora que tenemos Django configurado en nuestra Raspberry Pi, finalmente podemos verlo en acción.

1. En su navegador web favorito, deberá ir a la siguiente dirección. Usamos el protocolo http ya que no
hemos configurado un certificado SSL para esta conexión.

5
 Go To

1 http ://[ Y O UR PI IP A DD RE SS ]

Asegúrese de reemplazar ”YOURIPADDRESSçon la dirección IP de su Raspberry Pi.

2. Al ir a la dirección IP, deberı́a recibir la pantalla de bienvenida de Django. Esta pantalla indica que ha
ejecutado con éxito el marco Django en su Raspberry Pi.

Figura 2: Default page for Django.

Ahora puede proceder a escribir su aplicación Django. El sitio web oficial de Django proporciona un
sólido tutorial para que comiences.
https://docs.djangoproject.com/en/3.1/intro/tutorial01/