d49df794f7
This is the Ruby version CONSUL uses now. Thanks to that, we no longer need to install an old version of libssl-dev for Ubuntu 18.04. We could probably simplify the documentation using: ```bash rbenv install `cat .ruby_version` ``` However, this would require downloading consul before installing Ruby, which could be harder to document.
169 lines
3.5 KiB
Markdown
169 lines
3.5 KiB
Markdown
## Configuration for development and test environments (Debian GNU/Linux 9.8)
|
|
|
|
## Superuser
|
|
|
|
Note that 'sudo' is not installed by default in Debian. It's possible to install and configure it, you can find information [here](https://wiki.debian.org/sudo). But we don't recommend it cause you may have other problems. We recommend running the following commands as a superuser, so make sure the very first command you run is:
|
|
|
|
```
|
|
su
|
|
```
|
|
|
|
|
|
> For [Vagrant](/en/installation/vagrant.md) run:
|
|
> ```
|
|
> sudo su -
|
|
> ```
|
|
|
|
## System update
|
|
|
|
Run a general system update:
|
|
|
|
```bash
|
|
apt-get update
|
|
```
|
|
|
|
## Git
|
|
|
|
Git is officially maintained in Debian:
|
|
|
|
```
|
|
apt-get install git
|
|
```
|
|
|
|
## Curl
|
|
|
|
Curl is officially maintained in Debian:
|
|
|
|
```
|
|
apt-get install curl
|
|
```
|
|
|
|
## Ruby
|
|
|
|
Ruby versions packaged in official repositories are not suitable to work with consul, so we'll have to install it manually.
|
|
|
|
The preferred method is via rvm:
|
|
|
|
```
|
|
command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
|
|
command curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -
|
|
curl -L https://get.rvm.io | bash -s stable
|
|
```
|
|
|
|
then add rvm script source to user's bash (/root/.bashrc)
|
|
|
|
```
|
|
[[ -s /usr/local/rvm/scripts/rvm ]] && source /usr/local/rvm/scripts/rvm
|
|
```
|
|
|
|
and finally, reload .bashrc to be able to run RVM
|
|
|
|
```
|
|
source /root/.bashrc
|
|
```
|
|
|
|
with all this, you are suppose to be able to install a ruby version from rvm, as for example version 2.4.9:
|
|
|
|
```
|
|
rvm install 2.4.9
|
|
```
|
|
|
|
## Bundler
|
|
|
|
Install it with
|
|
|
|
```
|
|
gem install rubygems-bundler
|
|
```
|
|
|
|
## Node.js
|
|
|
|
To compile the assets, you'll need a JavaScript runtime. Node.js is the preferred option. As with Ruby, we don't recommend installing Node from your distro's repositories.
|
|
|
|
To install it, you can use [n](https://github.com/tj/n)
|
|
|
|
Run the following command on your terminal:
|
|
|
|
```
|
|
curl -L https://git.io/n-install | bash -s -- -y lts
|
|
```
|
|
|
|
And it will install the latest LTS (Long Term Support) Node version on your `$HOME` folder automatically (This makes use of [n-install](https://github.com/mklement0/n-install))
|
|
|
|
Reload .bashrc to be able to run node
|
|
|
|
```
|
|
source /root/.bashrc
|
|
```
|
|
|
|
Check it's correctly installed by running:
|
|
|
|
```
|
|
node -v
|
|
```
|
|
|
|
## PostgreSQL (>=9.4)
|
|
|
|
PostgreSQL version 9.4 is not official in debian 9.
|
|
|
|
So you have to add a repository, the official postgresql works fine.
|
|
|
|
Add the repository to apt, for example creating file */etc/apt/sources.list.d/pgdg.list* with:
|
|
|
|
```
|
|
deb http://security.debian.org/debian-security jessie/updates main
|
|
```
|
|
|
|
afterwards you'll have to download the key, and install it, by:
|
|
|
|
```
|
|
wget https://www.postgresql.org/media/keys/ACCC4CF8.asc
|
|
apt-key add ACCC4CF8.asc
|
|
```
|
|
|
|
and install postgresql
|
|
|
|
```
|
|
apt-get update
|
|
apt-get install postgresql-9.4 postgresql-server-dev-9.4 postgresql-contrib-9.4
|
|
```
|
|
|
|
You also need to configure a user for your database. As an example, we'll choose the username "consul":
|
|
|
|
```
|
|
su - postgres
|
|
|
|
createuser consul --createdb --superuser --pwprompt
|
|
|
|
exit
|
|
```
|
|
|
|
## Imagemagick
|
|
|
|
Install Imagemagick:
|
|
|
|
```bash
|
|
apt-get install imagemagick
|
|
```
|
|
|
|
## ChromeDriver
|
|
|
|
To run E2E integration tests, we use Selenium along with Headless Chrome.
|
|
|
|
To get it working, install the chromedriver package:
|
|
|
|
```bash
|
|
apt-get install chromedriver
|
|
ln -s /usr/lib/chromedriver /usr/local/bin/
|
|
```
|
|
|
|
Make sure it's working as expected by running the following command:
|
|
|
|
```bash
|
|
chromedriver --version
|
|
```
|
|
|
|
You should receive an output with the latest version of ChromeDriver. If that's the case, you're good to go!
|
|
|
|
> Now you're ready to go get Consul [installed](local_installation.md)!!
|