User interface is based on Patternfly

To submit an issue, please visit https://issues.redhat.com/projects/COST/

• NodeJS v14+
• yarn 1.22+

1. Install requirements listed above.
2. Clone the repository, and open a terminal in the base of this project.
3. Run the command yarn install to install all the dependencies.

yarn build

yarn test

Produces a file used by product security for vulnerability and compliance tracking.

yarn update:manifest

Note that this approach currently supports the Insights stage-beta, stage-stable, prod-beta, and prod-stable environments.

1. Start development server

yarn start

Follow the prompts that follow.

• Do you want to use local api? no
• Which platform environment you want to use stage
• Which Chrome environment you want to use? beta

2. Open the following URL

https://stage.foo.redhat.com:1337/beta/openshift/cost-management

1. Start development server (Answer yes to run against local APIs)

yarn start

Follow the prompts that follow.

• Do you want to use local api? yes
• Which platform environment you want to use stage
• Which Chrome environment you want to use? beta

2. Open the following URL

 http://localhost:8002/beta/openshift/cost-management

Refer to the project README for prerequisites

1. Setup & run Koku API (see project README for more details)

> git clone [email protected]:project-koku/koku.git
> cd [KOKU_GIT_REPO]
> pipenv install --dev
> pipenv shell "pre-commit install"
> make docker-up-min or make docker-up-min-trino
> make create-test-customer
> make load-test-customer-data (use with docker-up-min-trino)

2. Check to see if containers are running (optional)

> docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Ports}}\t{{.Status}}"

3. Watch the Koku API logs in another terminal (optional)

> docker-compose logs -f koku-server koku-worker

4. Clean up (optional)

pipenv shell
make docker-down
make remove-db
docker system prune --all
exit

Follow the steps to run a local Koku API instance

1. Clone the Settings Frontend repository and install dependencies

> git clone https://github.com/RedHatInsights/settings-frontend.git
> cd [SETTINGS_FRONTEND_GIT_REPO]
> npm install

2. Set the following variables in your environment

> export API_PORT=8000
> export LOCAL_API="/api/cost-management/v1/"
> export KEYCLOAK_PORT=4020

3. Start development server

> npm run start:standalone:beta

4. Open the following URL

http://localhost:1337/beta/settings/applications/cost-management

• TypeScript
• React
• Redux - State Management
  • Redux-Thunk - Middleware for returning functions from actions (gives access to dispatch and getState to action)
  • typesafe-actions - Typesafe Redux
  • Selectors
• Axios - HTTP Client
• React Router
  • withRouter - Injects components with route props
  • Link
  • Route
• React I18Next - React Wrapper for i18next
• PatternFly React 4
  • Source - react-*/**
  • PRS
  • Issues

• React Devtools
  • Chrome
  • Firefox
• Redux Devtools
  • Chrome
  • Firefox
• VSCode
  • TSLint - Linting
    • In Settings add

    {
      ...
      "tslint.autoFixOnSave": true,
      ...
    }

  • Prettier - Autoformat
    • In settings add:

    {
      ...
      "[typescript]": {
        "editor.formatOnSave": true
      },
      "[typescriptreact]": {
          "editor.formatOnSave": true
      },
      ...
    }

  • Docker - Manage Docker images from VSCode