Cómo montar un servidor Postgres-PostGIS con Docker en Windows

A día de hoy son varios los cursos que estoy dando dentro de la oferta formativa de Geoinnova en los que se tratan temas vinculados con PostGIS, la extensión geográfica de PostgreSQL. Los temas van desde aspectos básicos de bases de datos relacionales con PostgreSQL hasta prácticas avanzadas usando la extensión de redes pgRouting.

Dependiendo del sistema de operativo de los alumnos, hay veces en las que tenemos que usar distintas versiones de la base de datos y/o de sus extensiones geográficas. Esto lleva a que se planteen dudas técnicas como por ejemplo la de instalar la extensión de pgRouting para equipos Mac o la de tener habilitados varios servidores de bases de datos.

Motivado por un pasado tuit desde la cuenta de Twitter de pgRouting donde se comentaba que se iba a mantener la imagen oficial de a extensión de redes para Docker, he pensado que sería interesante hacer una guía sobre cómo instalar Docker y añadir una imagen/contenedor que permita usar distintas versiones de Postgres y de sus extensiones geográficas.

Llevo tiempo usando con Docker en mi equipo con contenedores para PostgreSQL/PostGIS, Geoserver, nginx o Odoo y tras repasar la documentación del repositorio, me pareció lo suficientemente completa para animar al que le tenga curiosodad adentrarse en el mundo de la “dockerizanción”.

Aunque trabajo con Linux, en esta ocasión la instalación de Docker será para Windows ya que es el sistema operativo que más suelen usar mis alumnos.

Pero… ¿qué es Docker?

No se me ocurre una mejor descripción que la que usé hace algo más de una año en la entrada A vueltas con Docker que hice en Medium cuando empecé a usar Docker.

“La idea detrás de Docker es crear contenedores ligeros y portables para que las aplicaciones software puedan ejecutarse en cualquier máquina con Docker instalado.”

La definición está sacada de una charla Nacho Álvarez de Redsys.

Instalación de Docker para Windows

Para la instalación de Docker en Windows simplemente he siguido los pasos de la guía Get started with Docker for Window dispobible en la documentación oficial.

Pensando de nuevos en mis alumnos, existe también una entrada para instalar Docker en Mac

• Descargamos Docker Desktop for Windows desde la siguiente dirección web e instalamos en el equipo.
• Podemos comprobar que todo se ha instalado correctamente abriendo la consola de comandos y ejecutando docker -version.

Al instalar Docker Desktop for Windows podremos seguir un breve tutorial que instala un contenedor demo y otras configuraciones. En principio no vamos a seguir el tutorial y pasamos directamente a montar nuestra imagen de PostgreSQL usando comandos en terminal. Estos pasos serviran para cualquier sistema operativo.

Instalado una imagen de Docker

Una imagen de Docker es una especie de plantilla, una captura del estado de un contenedor. Podríamos decir que una imagen es como un snapshot de una máquina virtual, pero mucho más ligero.

Vamos a crear una imagen con el comando run en nuestro equipo con un Potsgres 11, PosGIS 2.5 y pgRouting 2.6.3.

La imagen se llamar a postgres11_25_263, va a usar el puerto 5435 para conectarse a la base de datos y la contraseña será postgres.

docker run --name postgres11_25_263 -p 5435:5432 -e POSTGRES_PASSWORD=postgres pgrouting/pgrouting:11-2.5-2.6.3 

Si intentamos instalar la imagen en Windows nos saldrá un error indicando que esta imagen no puede crearse ya que está basada en Linux.

Para poder usar la imagen accedemos al menú de Docker Desktop y cambiamo el cliente de Docker con la opción Switch to Linux containers…

Ahora podremos ejecutar la instalación sin problema.

Usando contenedores

Los contenedores son instancias en ejecución de una imagen de Docker. Son los que ejecutan nuestra aplicación con todos los recursos necesarios integrados. El concepto de contenedor es como si restauramos una máquina virtual a partir de una instantanea.

Esta opción es mi preferida ya que puedes definir en un archivo la configuración de la instalación. El repositorio de Github de pgRouting están los archivos para instalar los contenedores según las versiones más recientes.

Para poder usarlos, podemos descargar directamente el repositorio en formaro zip o mejor clonarlo usando Git.

Si vamos a usar Git (previamente instaladao en nuestro equipo) ejecutamos:

git clone https://github.com/pgRouting/docker-pgrouting.git

El paso siguiente será acceder a la carpeta de la versión que queramos instalar. Ahora vamos a montar un Postgres 12, con PostGIS 3 y la última versión de pgRouting.

Accedemos a la carpeta correspondiente y localizamos el archivo docker-compose.yml para editarlo.

La única modificación que vamos a realizar es cambiar el número del puerto que se usará en el contenedor (5433). Esto lo haremos porque ya tenemos ocupado el puerto por defecto con una instalación local.

Para terminar debemos abrir de nueva un terminar de comandos, acceder a la carpeta y lazar nuestro contonedor con docker compose up

Conexiones a nuestros servidores con pgAdmin4.

La imagen y el contendor Docker que hemos usado son accesibles desde la ip 127.1.0.0 o localhost. La imagen usa el puerto 5435 y el contendor el 5433.

Si usamos la interfaz gráfica de pgAdmin vamos ahora a conectarnos nuestros dos nuevos servidores de datos.

En la siguiente captura está el ejemplo de la conexión al servidor del contendor.

Los pasos siguientes serán los de la creación de nuestra base de datos Postgres y los de añadir las extensiones geográficas PostGIS y pgRoutinng.