Skip to content

Latest commit

 

History

History
84 lines (53 loc) · 3.01 KB

dev-setup.md

File metadata and controls

84 lines (53 loc) · 3.01 KB

Dev Setup

Requirements

ODH requires the following to run:

Additional tooling

Development

  1. Clone the repository
    git clone https://github.com/opendatahub-io/odh-dashboard
  2. Within the repo context, install project dependencies
    cd odh-dashboard && npm install

Build project

npm run build

Serve development content

This is the default context for running a local UI. Make sure you build the project using the instructions above prior to running the command below.

Note: You must be logged-in with oc before you can start the backend.

Note: The CLI logged-in user will need to be a cluster-admin level user on the cluster to mimic the Dashboard Service Account level of permissions. You could also bind the cluster role to your user as we do with the service account binding.

npm run start

For in-depth local run guidance review the contribution guidelines.

Testing

Run the tests.

npm run test

Run storybook a11y tests and interaction tests.

npm run storybook
npm run test:storybook

For in-depth testing guidance review the contribution guidelines

Deploying the ODH Dashbard

Official Image Builds

odh-dashboard images are automatically built and pushed to quay.io after every commit to the main branch. The image tag name format for each image is main-<COMMIT SHORT HASH>.

Example: The main branch is updated with commit f76e3952834f453b1d085e8627f9c17297c2f64c. The CI system will automatically build an odh-dashboard image based on that code and push the new image to odh-dashboard:main-f76e395 and updated odh-dashboard:main to point to the same image hash.

The nightly tag is a floating tag that is updated nightly and points to the most recent main-<HASH> commit from the previous day.

Deploy using kustomize

The manifests folder contains a kustomize manifest that can be used with kustomize build.

Deploy using a kfdef

Note: This flow is deprecated, deploy v2 Operator with their custom CR.

The manifests/kfdef folder contains an example kfdef to deploy ODH Dashboard with the Notebook Controller backend is located in odh-dashboard-kfnbc-test.yaml.