Devops data integration repository.
Please see the seiso.io for project information and documentation.
There are two options available here. The first is a manual setup, where you install Java, MySQL, RabbitMQ and the app yourself. The other is via Vagrant.
Installation. You'll need to install the following:
- Java 8
- MySQL 5.6.x (recommend using Homebrew)
- Create the Seiso database:
create database seiso; - Create a
seisouser. It needs at least select, update and delete permissions on theseisodatabase. For a dev setup:create user 'seiso'@'localhost' identified by 'password';grant select, update, delete, insert on sesio.* to 'seiso'@'localhost'; - Create the tables by running
src/main/sql/create-tables.sql. - Insert the reference data by running
src/main/sql/insert-reference-data.sql. - If you like, insert the sample data by running
src/main/sql/insert-sample-data.sql.
- Create the Seiso database:
- RabbitMQ
- For visibility we recommend installing the RabbitMQ management plugin.
You can use Vagrant to set up your development environment, which consists of a MySQL database and a RabbitMQ message bus.
As a preliminary, you will need to install the Omnibus plugin, which will install the Chef provisioner on your VMs, then do
$ vagrant up
to create your VMs. With respect to the database VM, this creates the database and sample user automatically, and it also inserts the reference and sample data automatically.
Note that it takes a little while to create VMs, so if you want to speed things up, you can open two terminal windows and do
$ vagrant up db
in one and
$ vagrant up bus
in the other, just to parallelize the work.
Create a copy of conf-sample/application.yml and modify it as appropriate.
To run Seiso in development mode, you can place it directly in src/main/resources. The file is for the vagrant
setup, so if you installed without it you'll probably want to change the mysql port to 3306 and the Rabbit port
to 5672.
- Connect to
localhost:3306and dbseisoasrootuser - Run any patch files. Currently these two:
- Run
src/main/sql/archives/schema-p1.sql - Run
src/main/sql/schema-p2.sql
- Run
- Follow the instructions in that patch sql file (e.g. Run query:
update person set source='ldap-corp')
$ ./gradlew clean build
$ ./gradlew bootRun
Point your HTML5-enabled browser to https://localhost:8080 or whatever scheme/port combo you chose during configuration in the application.yml for base-uri. You should see a home page with a list of services. To login, look at the file in src/main/sql/README.md which has the sample data usernames and passwords.