Instalación de Diesel y configuración de base de datos en Rust

El primer paso para conectarnos a una base de datos con cualquier lenguaje de programación es instalar los drivers o dependencias que este requiere.

Preparación del entorno para conectarse a una base

Preparemos el entorno para que Rust logre conectarse a una base de datos PostgreSQL.

Paso 1: Creación del proyecto

Comienza creando un nuevo proyecto de Rust utilizando su gestor de dependencias llamado Cargo. Con el comando cargo new , en cuestión de segundos tendrás tu proyecto iniciado.

Paso 2: Actualización de Rust

Asegúrate de tener actualizado Rust con el comando rustup update stable.

Paso 3: Instalación de PostgreSQL

Antes de la instalación de los drivers de Rust, tienes que instalar el motor de base de datos en tu computador. Si estás en Linux, utiliza el comando sudo apt install postgresql postgresql-contrib y luego sudo apt install libpq-dev

Errores frecuentes en la instalación

Paso 4: Instalación del ORM

Rust emplea un ORM denominado Diesel. Si tienes correctamente instalado PostgreSQL en tu computador, emplea el comando cargo install diesel_cli --no-default-features --features postgres para instalar y configurar el Driver para Rust.

Paso 5: Preparación del entorno de Heroku

Heroku es una plataforma como servicio potente y muy sencillo de utilizar para desplegar aplicaciones gratuitamente. Crea tu cuenta e iniciemos un nuevo proyecto haciendo clic en el botón New:

Selecciona un nombre para tu proyecto:

Una vez creado, ve a la sección de Resources y busca el add-ons: “Heroku Postgres”:

Finalmente, ve a la sección Settings -→ Config Vars y podrás copiar el URL para conectarte a tu base de datos PostgreSQL de forma remota en tu proyecto:

Paso 6: Configuración de la base de datos

Volviendo a tu proyecto, crea un archivo llamado .env para guardar tus variables de entorno. Recuerda que este archivo NO debe ser versionado en GIT. Por lo tanto, genera un archivo llamado .gitignore para no llevar un versionado del mismo.

Crea una variable de entorno con la conexión a la base de datos en Heroku:

DATABASE_URL=postgres://zstkqlzxcqzqpuo:d7e039b9082b113cffc709e1fcdb532bd12eb7ec9697c6860055442bc@ec2-55-209-104-27.compute-1.amazonaws.com:5432/d44r1pqa298s7l

Paso 7: Inicializar Diesel

Si todo ha ido bien, con el comando diesel setup podrás inicializar tu proyecto y generar las primeras migraciones de la base de datos.

NOTA: El concepto de “Migraciones” es utilizado por muchos ORM para llevar un control sobre los cambios en tu base de datos. Se crea una nueva migración cada vez que crees una nueva tabla, elimines o modifiques alguna con nuevos campos.

Luego de esta extensa preparación, tu proyecto está listo para conectarse a una base de datos remota.

---

Contribución creada por: Kevin Fiorentino.