Tutorial PostgreSQL con Docker

Levantar una base de datos con Docker es la manera más rápida de tener un entorno de programación listo para empezar a programar en un PC doméstico, sin realizar instalaciones que dejen restos de archivos y configuraciones a lo largo de todo el disco duro, simplificando enormemente los entornos de desarrollo y producción.

¿Y cómo se hace? Pues de forma resumida, Docker es una plataforma de código abierto en forma de máquina virtual que gestiona y ejecuta contenedores que empaquetan aplicaciones. What? Veamos el detalle…

Qué es Docker

Docker es un servicio de virtualización de aplicaciones dentro de unos denominados contenedores. Esto permite que las aplicaciones se ejecuten independientemente del host que los alberga. Cuando una aplicación está virtualizada su puesta en marcha por orquestadores que monitorizan el estado de las aplicaciones y la carga que soportan, fácilmente pueden levantar o apagar instancias en la nube para tolerar altas cargas de trabajo.

Docker está disponible sin coste, para las principales plataformas de escritorio y es una de las herramientas básicas de todo programador moderno. Si quieres ampliar tus conocimientos acerca del uso de ésta revisa nuestro tutorial de Docker.

Requisitos para Postgres con Docker

Si eres usuario de Windows o Mac necesitarás tener instalado Docker Desktop en tu pc o portátil y éste debe tener cierta capacidad y potencia. Por otro lado, en el caso de que seas usuario de Windows, deberás tener la versión Professional para poder instalar Docker. Si no es así, visita el tutorial de instalación de ubuntu, el mejor sistema operativo para programar totalmente gratis y Open Source. Si eres usuario de Ubuntu o Debian asegúrate de tener en tu sistema Docker Compose también explicado en el tutorial de instalación de Docker.

Instalar Postgres con Docker

Para arrancar una base de datos Postgres con docker el proceso no puede ser más sencillo. Basta que cojamos la plantilla del fichero de configuración de Docker Compose que dejamos a continuación e invoques al comando que realizará todo el proceso.

version: '2'
services:
    postgres:
        image: 'postgres:latest'
        restart: always
        volumes:
        - './postgres_data:/var/lib/postgresql/data'
        environment:
        - POSTGRES_PASSWORD=secure_pass_here
        ports:
        - '5432:5432'

Guarda el fichero en local con el nombre docker-compose.yml en un directorio denominado <homeusuario>/docker/postgres si estás en Unix, o \docker\postgres si estás en Windows. La configuración **guarda los datos en el subdirectorio ./postgresdata** de forma permanentemente, puesto que si no, en cada reinicio del contenedor se perderían las bases de datos alojadas. Luego, posiciónate con un terminal de comandos en el mismo directorio que el fichero y ejecuta:

docker-compose up -d

El sistema, primero descargará la imagen de los repositorios públicos de Docker al ver que no está disponible localmente y luego procederá al arranque y a la apertura del puerto indicado en el fichero de configuración. La opción -d indica a Docker que se ejecute el servicio en segundo plano. A partir de ese momento, utiliza tu interfaz gráfico preferido para conectar a la base de datos. Si no tienes ninguno puedes adquirir el cliente gratuito y multi base de datos DBeaver.

Verificar que el servicio PostgreSQL está activo

Para verificar que el servicio está activo y el contenedor ejecutándose de forma normal, pruebe de ejecutar el siguiente comando de docker que muestra los contenedores en funcionamiento:

docker ps

Deberá aparecer al menos una entrada correspondiente al contenedor MySQL en estado activo como se muestra a continuación:

CONTAINER ID  IMAGE        COMMAND                  CREATED        STATUS       PORTS                   NAMES
327fd50443a7  postgres:8   "docker-entrypoint.s…"   29 hours ago   Up 6 hours   0.0.0.0:5432->5432/tcp  docker_postgres_1

De ser así, puede continuar con el resto de actividades, puesto que como se indica en el fragmento de texto anterior, el contenedor se encuentra ejecutándose (status up) y escuchando en el puerto 5432.

Conectar PostgreSQL con DBeaver

Si tenemos el cliente SQL DBeaver, una vez arrancado el contenedor, podremos conectarnos con este cliente multi plataforma ingresando los siguientes datos:

Seleccionar nueva conexión para PostgreSQL
Server host: localhost
Port: 5432
User name: postgres
Password: secure_pass_here

A continuación darle «Probar conexión» y si todo ha ido bien, «Finalizar». A partir de ese momento el cliente gráfico SQL podrá abrir una conexión con el contenedor mientras éste esté en ejecución.

Si no tienes mucha experiencia en el manejo de bases de datos como Postgre SQL te recomendamos que realices una lectura del tutorial de SQL para principiantes.

Crear usuario PostgreSQL

La creación de un usuario, diferente al administrador de sistemas (postgres), es un paso importante, ya que si cometemos un error ejecutando sentencias SQL o si la aplicación hace lo que no esperamos, no se vea afectado más allá del alcance que pueda tener este usuario. Para ello se suele crear siempre un usuario por cada base de datos que almacena el sistema gestor PostgreSQL. Así todas las aplicaciones podrán funcionar de forma aislada sin interferir unas con otras. Esta manera de actuar es la más recomendada.

Para crear un usuario en PostgreSQL necesitamos saber el nombre de usuario, la contraseña y la IP desde la que estará permitido su acceso (o si se debe dejar abierto desde cualquier dirección). Una vez tengamos claros estos parámetros, abriremos una conexión desde la forma que más nos guste y ejecutaremos la siguiente sentencia:

create user pepito with encrypted password 'pepitoPass';

Debe cambiarse el nombre de usuario y clave por los correspondientes en cada caso.

Cambiar contraseña en PostgreSQL

Para cambiar la clave de un usuario en PostgreSQL:

ALTER USER pepito WITH PASSWORD 'securePepitoPass';

Borrar un usuario en PostgreSQL

Borrar un usuario no se puede deshacer, en todo caso, si nos hemos equivocado podremos crear de nuevo el mismo usuario. De hacerlo así ni la base de datos ni los permisos que tuviera se verían afectados.

drop user pepito;

Crear base de datos PostgreSQL

La creación de una base de datos en PostgreSQL es una de las operaciones más sencillas de realizar, sólo requiere el nombre de la base de datos:

create database pepito_app;

Dar permisos a un usuario en PostgreSQL

Una vez creado el usuario y la base de datos dentro del contenedor que ejecuta el sistema gestor SQL el siguiente paso es otorgar permisos al usuario sobre dicha base de datos. Hay toda una gama amplia de permisos que pueden tener los usuarios, para afinar con mucha precisión qué puede hacer cada uno de ellos y que estará prohibido. Esta granularidad ofrece mucho control y seguridad sobre los datos que se almacenan. Por ejemplo, algunos de los permisos que se usan con frecuencia son:

• ALL, otorga todos los permisos sobre la base de datos
• ALTER, permite modificar tablas, secuencias, etc…
• CREATE, permite crear tablas, secuencias, etc…
• DROP, permite borrar tablas, secuencias, etc…
• DELETE, permite borrar registros en tablas
• INSERT, permite insertar registros tablas
• UPDATE, permite actualizar registros en tablas
• SELECT, permite consultar tablas, secuencias, etc…

En la mayoría de las ocasiones, si tenemos un usuario por base de datos, será suficiente con dar el permiso ALL, o como mínimo los necesarios para manejar los registros de la base de datos. Sea como fuere, para dar permisos a un usuario sobre una base de datos deberíamos escribir la siguiente sentencia SQL:

grant all privileges on database pepito_app to pepito;

Esta sentencia asigna todos los permisos sobre todos los objetos de la base de datos pepito_app. A partir de ese momento el usuario podrá crear, modificar o borrar objetos como tablas, secuencias, etc.. Y también operar con las tablas y los registros que contienen pudiendo insertar, actualizar, consultar y borrar las filas que contienen.

Revocar permisos a un usuario en PostgreSQL

La eliminación de permisos sobre un usuario se hace de forma análoga a la dotación de acceso, pero en este caso se usa la palabra clave revoke de la siguiente manera:

revoke all privileges on database pepito_app from pepito;

Borrar base de datos en PostgreSQL

Si la creación es una de las operaciones más sencillas de realizar, el borrado será similar:

drop database pepito_app;

Todas las tablas, secuencias, índices y datos de la base de datos se eliminarán de forma permanente e irrevocable del sistema gestor. ¡Asegúrate de que introduces el nombre correcto de la base de datos!

Docker simplifica la creación de entornos de desarrollo. ¿Quieres empezar rápidamente? Descubre cómo en Arteco Consulting, SL. Visita nuestra web y accede a nuestro tutorial de Docker para dominar esta herramienta imprescindible. ¡Comienza tu viaje de programación hoy mismo!