Add prerequisites install link, and test suite section

This commit is contained in:
Bertocq
2017-08-18 23:07:11 +02:00
parent b1583b2227
commit 633ce693f3
2 changed files with 36 additions and 16 deletions

View File

@@ -1,37 +1,47 @@
# Local installation # Local installation
Before installing Consul and having it up and running make sure you have [Ruby 2.3.2](https://www.ruby-lang.org/en/news/2016/11/15/ruby-2-3-2-released/) installed in your local environment. Before installing Consul and having it up and running make sure you all [prerequisites](prerequisites) installed.
1. First, clone the [Consul Github repository](https://github.com/consul/consul/): 1. First, clone the [Consul Github repository](https://github.com/consul/consul/):
``` ```bash
git clone https://github.com/consul/consul.git git clone https://github.com/consul/consul.git
``` ```
2. Go to the project folder and install the gems stack using [Bundler](http://bundler.io/): 2. Go to the project folder and install the gems stack using [Bundler](http://bundler.io/):
```
```bash
cd consul cd consul
bundle install bundle install
``` ```
3. Copy the environment example configuration files inside new readable ones: 3. Copy the environment example configuration files inside new readable ones:
``` ```bash
cp config/database.yml.example config/database.yml cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml cp config/secrets.yml.example config/secrets.yml
``` ```
4. Run the following [Rake tasks](https://github.com/ruby/rake) to fill your local database with the minimum data to run the application: And setup database credentials with your `consul` user in your new `database.yml` file.
``` 4. Run the following [Rake tasks](https://github.com/ruby/rake) to create and fill your local database with the minimum data to run the application:
```bash
bin/rake db:create
bin/rake db:setup bin/rake db:setup
bin/rake db:dev_seed bin/rake db:dev_seed
RAILS_ENV=test rake db:setup RAILS_ENV=test bin/rake db:setup
``` ```
5. Now you have all set, run the application: 5. Check everything is fine by running the test suite (beware it takes some long minutes):
```bash
bundle exec rspec
``` ```
6. Now you have all set, run the application:
```bash
rails s rails s
``` ```

View File

@@ -1,37 +1,47 @@
# Instalación local # Instalación local
Antes de instalar Consul y empezar a usarlo asegúrate de tener [Ruby 2.3.2](https://www.ruby-lang.org/en/news/2016/11/15/ruby-2-3-2-released/) instalado en tu entorno local. Antes de comenzar a instalar Consul, comprueba que tengas todos los [prerrequisitos](prerequisites) correctamente instalados.
1. Primero, clona el [repositorio de Consul en Github](https://github.com/consul/consul/): 1. Primero, clona el [repositorio de Consul en Github](https://github.com/consul/consul/):
``` ```bash
git clone https://github.com/consul/consul.git git clone https://github.com/consul/consul.git
``` ```
2. Ve a la carpeta del proyecto e instala las gemas requeridas usando [Bundler](http://bundler.io/): 2. Ve a la carpeta del proyecto e instala las gemas requeridas usando [Bundler](http://bundler.io/):
```
```bash
cd consul cd consul
bundle install bundle install
``` ```
3. Copia los archivos de configuración de ejemplo del entorno dentro de unos nuevos válidos: 3. Copia los archivos de configuración de ejemplo del entorno dentro de unos nuevos válidos:
``` ```bash
cp config/database.yml.example config/database.yml cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml cp config/secrets.yml.example config/secrets.yml
``` ```
4. Ejecuta las siguientes [tareas Rake](https://github.com/ruby/rake) para rellenar tu base de datos local con el mínimo de información necesaria para que la aplicación funcione correctamente: Y configura los de tu usuario de base de datos `consul` en `database.yml`
``` 4. Ejecuta las siguientes [tareas Rake](https://github.com/ruby/rake) para crear y rellenar tu base de datos local con el mínimo de información necesaria para que la aplicación funcione correctamente:
```bash
bin/rake db:create
bin/rake db:setup bin/rake db:setup
bin/rake db:dev_seed bin/rake db:dev_seed
RAILS_ENV=test rake db:setup RAILS_ENV=test bin/rake db:setup
``` ```
5. Ahora que ya está todo listo puedes ejecutar la aplicación: 5. Comprueba que todo funciona correctamente lanzando la suite de tests (ten en cuenta que tardará unos cuantos minutos):
```bash
bundle exec rspec
``` ```
6. Ahora que ya está todo listo puedes ejecutar la aplicación:
```bash
rails s rails s
``` ```