This is a project to provide OpenAPI support inside the Ruby on Rails framework.

You need to install ruby >= 2.2.2 and run:

bundle install

export CATALOG_DATABASE_USERNAME=<<database_user>>
export CATALOG_DATABASE_PASSSWORD=<<database_password>>
or
export DATABASE_URL=postgres://pguser:pgpass@localhost/somedatabase
export MANAGEIQ_USER=admin
export MANAGEIQ_PASSWORD=smartvm
export MANAGEIQ_HOST=localhost
export MANAGEIQ_PORT=3000

If the topology inventory requires authentication (ie in dev), basic authentication is supported via these variables. They won't be read in unless :

export DEV_USERNAME=myuser
export DEV_PASSWORD=password

bin/rake db:create db:migrate
bin/rails s

Puma ignores the -p flag with bin/rails s

env PORT=4000 rails s

Example uses port 3000

bin/rails s -b 'ssl://localhost:3000?key=config/ssl/localhost.key&cert=config/ssl/localhost.crt'

To list all your routes, use:

bin/rake routes

If you want to run the catalog locally on your dev machine but access the UI on the dev cluster you would need to do the following

Install Docker in your machine

Clone the following repo to your dev machine

Insights Proxy

Follow the setup instructions in README.md

In the catalog-api repository the config directory contains a JavaScript file (spandx.config.js) which can be used with Insights Proxy to route the catalog requests to your dev machine

The Insights Proxy runs a docker container and it can be tailored using config files

You would need 2 terminals for this setup

1. Running your catalog app

Includes the RBAC_URL and `APPROVAL_URL environment variables to be able to use RBAC

You can also remove the RBAC_URL environment variable and pass in the BYPASS_RBAC environment variable instead if you want to test without RBAC

APP_NAME=catalog PATH_PREFIX=/api RBAC_URL=https://<url>/api/rbac/v1/ APPROVAL_URL=https://<url>/api/approval/v1/ TOPOLOGICAL_INVENTORY_URL=https://<url>/api/topological-inventory/v1/ SOURCES_URL=https://<url>/api/sources/v1/ DEV_USERNAME=<username> DEV_PASSWORD=<password> bin/rails s -p 5000

2. Run the insights proxy based on Linux or Mac

SPANDX_CONFIG=/path/to/catalog-api/config/spandx.config.js bash /path/to/insights-proxy/scripts/run.sh

3. Login to the Dev cluster to access the UI

   Using this URL which connects to the insights proxy running in the docker container https://ci.foo.redhat.com:1337/ansible/catalog

This project is available as open source under the terms of the Apache License 2.0.