tree: 49666d389e8662cf09e36f7aad1ff19c9cdcebe1 [path history] [tgz]
  1. api/
  2. businesslogic/
  3. doc/
  4. features/
  5. framework/
  6. google/
  7. mrproto/
  8. project/
  9. redirect/
  10. schema/
  11. search/
  12. services/
  13. sitewide/
  14. static/
  15. static_src/
  16. templates/
  17. testing/
  18. third_party/
  19. tools/
  20. tracker/
  21. .babelrc
  22. .eslintrc.json
  23. .gcloudignore
  24. .gitignore
  25. .prettierrc.json
  26. .style.yapf
  27. .vpython3
  28. app.yaml
  29. codereview.settings
  30. cron.yaml
  31. dev-services.yml
  32. dispatch.yaml
  33. import_utils.py
  34. jsconfig.json
  35. karma.conf.js
  36. main.py
  37. Makefile
  38. module-api.yaml
  39. module-besearch.yaml
  40. module-latency-insensitive.yaml
  41. OWNERS
  42. package-lock.json
  43. package.json
  44. PRESUBMIT.py
  45. queue.yaml
  46. README.md
  47. registerpages.py
  48. requirements.txt
  49. settings.py
  50. test.py
  51. tsconfig.json
  52. webpack.config.js
appengine/monorail/README.md

Monorail Issue Tracker

Monorail is the Issue Tracker used by the Chromium project and other related projects. It is hosted at bugs.chromium.org.

If you wish to file a bug against Monorail itself, please do so in our self-hosting tracker. We also discuss development of Monorail at infra-dev@chromium.org.

Getting started with Monorail development

For Googlers: Monorail's codebase is open source and can be installed locally on your workstation of choice.

For local development on Linux, see Linux development instructions For local development on MacOS and Debian, see MacOs development instructions

Instructions for deploying Monorail to an existing instance or setting up a new instance are here.

See also: Common Development Problems

Testing

Python backend testing

make pytest

To run a single test:

vpython3 test.py services/test/issue_svc_test.py::IssueServiceTest::testUpdateIssues_Normal

JavaScript frontend testing

make jstest

If you want to skip the coverage for karma, run:

make karma_debug

To run only one test or a subset of tests, you can add .only to the test function you want to isolate:

// Run one test.
it.only(() => {
  ...
});

// Run a subset of tests.
describe.only(() => {
  ...
});

Just remember to remove them before you upload your CL.

Development resources

Supported browsers

Monorail supports all browsers defined in the Chrome Ops guidelines.

File a browser compatability bug here.

Frontend code practices

See: Monorail Frontend Code Practices

Monorail's design

Triage process

See: Monorail Triage Guide.

Release process

See: Monorail Deployment

User guide

For information on how to use Monorail, see the Monorail User Guide.

Setting up a new instance of Monorail

See: Creating a new Monorail instance