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
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
- 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
- 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
-
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.