Technical Documentation
Return to Main Documentation
SPANISH - version 2.2
SPANISH - version 2.2
  • Introducción
  • Primeros pasos
    • Crea tu fork
    • Configura tu fork
    • Mantén tu fork actualizado
    • Comunicación
  • Instalación
    • Instalación local
      • Prerrequisitos
      • Ubuntu Linux
      • Debian Linux
      • macOS
      • Windows
      • Vagrant
      • Docker
    • Servidores de producción y pruebas
      • Instalador
      • Crear usuario
      • Generación de claves SSH
      • Instalación manual (no recomendada)
      • Digital Ocean
      • Heroku
      • Configuración del servidor de correo
    • Configuración básica
    • Documentación y guías de usuario
  • Personalización
    • Introducción
    • Traducciones y textos
    • Imágenes
    • Estilos con CSS
    • JavaScript
    • Modelos
    • Controladores
    • Vistas y HTML
    • Componentes
    • Otras clases de Ruby (GraphQL, lib, mailers, builders)
    • Gemas
    • Configuración de la aplicación
    • Rutas
    • Tests
  • Funcionalidades Técnicas
    • OAuth
    • GraphQL
    • Recomendaciones de debates y propuestas
    • Configurar conexión con el Censo
    • Local Census
    • Multitenancy
    • Traducciones de contenido de usuario
  • Proyecto Open Source
    • Código de conducta
    • Contribuciones
    • Licencia
    • Open source forks y modificaciones
Powered by GitBook
On this page
  • Prerrequisitos
  • macOS
  • Linux
  • Windows
  • Instalación
  • Arranque de Consul Democracy en desarrollo
  • Ejecutar tests con RSpec
  • Resolución de problemas
  1. Instalación
  2. Instalación local

Docker

PreviousVagrantNextServidores de producción y pruebas

Last updated 7 months ago

Prerrequisitos

Debes tener instalados Docker y Docker Compose en tu ordenador. El proceso de instalación depende de tu sistema operativo.

macOS

Puedes seguir la .

O, si tienes instalado , puedes ejecutar:

brew install docker
brew install docker-compose
brew install --cask docker
open -a docker

La aplicación de Docker te pedirá darle permisos e introducir tu contraseña.

Linux

  1. Instala Docker y Docker Compose. Por ejemplo, en Ubuntu 22.04:

sudo apt-get install docker.io docker-compose-v2

Windows

La documentación oficial de Docker incluye una página con instrucciones para . En esa página, descarga Docker Desktop para Windows y ejecútalo.

Instalación

Clona el repositorio en tu ordenador y entra en el directorio:

git clone https://github.com/consuldemocracy/consuldemocracy.git
cd consuldemocracy

A continuación, crea los ficheros de config/secrets.yml y config/database.yml basados en los ficheros de ejemplo:

cp config/secrets.yml.example config/secrets.yml
cp config/database-docker.yml.example config/database.yml

Ahora genera la imagen con:

POSTGRES_PASSWORD=password docker-compose build

Y crea los contenedores:

POSTGRES_PASSWORD=password docker-compose create

Por último, crea la base de datos e introduce datos de prueba:

POSTGRES_PASSWORD=password docker-compose run app rake db:create db:migrate
POSTGRES_PASSWORD=password docker-compose run app rake db:dev_seed

Arranque de Consul Democracy en desarrollo

Una vez instalada, puedes lanzar la aplicación con:

POSTGRES_PASSWORD=password docker-compose up

Adicionalmente, si quieres lanzar por ejemplo la consola de rails:

POSTGRES_PASSWORD=password docker-compose run app rails console

Para verificar que los contenedores están ejecutándose usa:

docker ps

Deberías obtener algo similar a:

CONTAINER ID   IMAGE                 COMMAND                  CREATED          STATUS          PORTS      NAMES
603ec83b78a6   consuldemocracy-app   "./docker-entrypoint…"   23 seconds ago   Up 22 seconds              consuldemocracy-app-run-afb6d68e2d99
d57fdd9637d6   postgres:13.16        "docker-entrypoint.s…"   50 minutes ago   Up 22 seconds   5432/tcp   consuldemocracy-database-1

Ejecutar tests con RSpec

En primer lugar, prepara la base de datos para el entorno de test:

POSTGRES_PASSWORD=password docker-compose run app bundle exec rake db:test:prepare

Ahora puedes ejecutar tests usando RSpec. Por ejemplo, para ejecutar los tests del modelo "proposal":

POSTGRES_PASSWORD=password docker-compose run app bundle exec rspec spec/models/proposal_spec.rb

Los tests de sistema también funcionan sin que tengas que realizar ninguna configuración adicional, si bien la primera vez que se ejecutan pueden fallar mientras la herramienta que ejecuta los tests descarga una versión adecuada de Chromedriver (que se necesita para ejecutarlos), y solamente puedes ejecutar el modo "headless" (con un navegador ejecutándose en segundo plano), que por otro lado en cualquier caso es el modo que utilizarías más del 95% del tiempo. Por ejemplo, para ejecutar los tests de la página de inicio:

POSTGRES_PASSWORD=password docker-compose run app bundle exec rspec spec/system/welcome_spec.rb

Resolución de problemas

  1. Quita todas las imágenes de Consul Democracy:

docker-compose down --rmi all -v --remove-orphans
  1. Quita todos los contenedores de Consul Democracy:

docker-compose rm -f -s -v
  1. Verifica si todavía hay algún contenedor:

docker ps -a
  1. En caso afirmativo, elimina cada uno de forma manual:

docker container rm <container_id>

Y podrás acceder a la aplicación desde tu navegador visitando .

Consul Democracy incluye más de 6000 tests que comprueban la manera en que se comporta la aplicación. Si bien recomendamos que para que use un sistema de integración continua para ejecutar todos los tests y comprobar que los últimos cambios no rompen nada, durante el desarrollo probablemente quieras ejecutar tests relacionados con el código en el que estás trabajando.

Ejecuta los siguientes comandos en el directorio de Consul Democracy para borrar todas las imágenes y contenedores anteriores del Docker de Consul Democracy. Luego, comienza de nuevo con el de Docker.

guía oficial de Docker
homebrew
instalar Docker Desktop en Windows
http://localhost:3000
configures tu "fork"
proceso de instalación