Cloud Migration Web UI

Daniel Vincze 38c27121f8 Merge pull request #761 from smiclea/optional-props 3 rokov pred
.github 265079fa84 Add GitHub Workflow action for code validation 3 rokov pred
.storybook 4a7432971b Add unit tests 4 rokov pred
.vscode 3dc8fa6372 Revamp the entire source code style and formatting 3 rokov pred
private 16bf1eb6fb Add Jest unit testing framework 4 rokov pred
public 2c6427f7d1 Move typing system from 'flow' to 'typescript' 5 rokov pred
server ba1c4912a9 Add Oracle PCA X9-2 Logos and Configuration 3 rokov pred
src 370cc1e5a8 Support optional properties in BM server object 3 rokov pred
tests 4a7432971b Add unit tests 4 rokov pred
.dockerignore 2c6427f7d1 Move typing system from 'flow' to 'typescript' 5 rokov pred
.editorconfig 0d39a85837 Coriolis with Atomic design implementation 8 rokov pred
.eslintrc.js 3dc8fa6372 Revamp the entire source code style and formatting 3 rokov pred
.gitignore d7380b0e59 Show Setup page when launching for the first time 4 rokov pred
.prettierrc 3dc8fa6372 Revamp the entire source code style and formatting 3 rokov pred
Dockerfile 46e204a1df Upgrade eslint to the latest version 4 rokov pred
LICENSE 0d39a85837 Coriolis with Atomic design implementation 8 rokov pred
README.md f23a4b843f Fix missing images in `README.md` 3 rokov pred
babel.config.js faccd2bdc3 Apply the new code style changes to root files 3 rokov pred
config.ts ba1c4912a9 Add Oracle PCA X9-2 Logos and Configuration 3 rokov pred
cypress.json 32b0c10d24 Increased requestTimeout to 10s 7 rokov pred
jest.config.ts faccd2bdc3 Apply the new code style changes to root files 3 rokov pred
package.json 84c4d9eebc Bump jszip from 3.7.1 to 3.8.0 3 rokov pred
tsconfig.json 4a7432971b Add unit tests 4 rokov pred
ui-mod-sample.json 257c052529 Add ability to set services URLs using MOD_JSON 6 rokov pred
webpack.common.js faccd2bdc3 Apply the new code style changes to root files 3 rokov pred
webpack.dev.js faccd2bdc3 Apply the new code style changes to root files 3 rokov pred
webpack.prod.js faccd2bdc3 Apply the new code style changes to root files 3 rokov pred
yarn.lock 84c4d9eebc Bump jszip from 3.7.1 to 3.8.0 3 rokov pred

README.md

Coriolis Web

Web GUI for coriolis

Build and Test

Install instructions

  • node and yarn are required
  • clone repo
  • run yarn install or yarn install --production to install packages and dependencies for development or production mode
  • set CORIOLIS_URL environment variable

Build instructions

  • run yarn build
  • run yarn start to start the server

Your server will be running at http://localhost:3000/ (the port is configurable through PORT environment variable)

Testing

  • unit tests can be run using yarn test
  • run yarn test-release to check for Typescript and ESLint errors, to run the unit tests and to build and start a production build.

Development mode

  • set env. variable NODE_ENV='development'
  • run yarn client-dev to start local development server (starts on port 3001)
  • run yarn server-dev to start the express server in development mode

To debug the client code using VS Code, simply run the project's launch configuration from the 'Run' menu (Ctrl+Shift+D). The last 2 yarn ... commands must be running in the background.

To debug the Node server using VS Code, run yarn server-debug instead of yarn server-dev.

You can view some of the UIs components in the Storybook by running yarn storybook

Modding

The UI can be modded externally using a .json modding file. A sample is available in the repo ui-mod-sample.json.

The path to the .json mod file needs to be set in MOD_JSON environment variable (ex.: MOD_JSON=/usr/ui-mod.json).

Any provider logos can be replaced using local logo images. The local image file paths need to be absolute.

You can specify one logo, in which case it will be scaled to all sizes. You can also specify logos for just a couple of the sizes, in which case the closest size to the one required will be used. Open ui-mod-sample.json for more details.

Any option from config.ts can be modified by adding the config field to the ui-mod-sample.json file.

Environment variables

All environment variables can be set in a .env file created in the root directory.

The following is the list of environment variables and their default values:

NODE_ENV='production'
CORIOLIS_URL='<your-coriolis-url>'
MOD_JSON='<path-to-json>'
CA_FINGERPRINT='<path to CA fingerprint file used by metal hub agent>'