Chrome Status Dashboard
Перейти к файлу
Daniel Smith 5ec636bcb6
Script to run all tests (#2329)
* Update package.json

* Update package.json
2022-10-14 15:36:21 +02:00
.devcontainer Add setup instructions for Devcontainer on Mac (#2327) 2022-10-12 12:44:40 -07:00
.github Remove autolinker dependency (#2175) 2022-08-26 15:30:35 -07:00
api Use new Activity entities to display comments (#2321) 2022-10-12 13:02:35 +02:00
customtags Run 2to3 to detect py2 to py3 changes (#1551) 2021-09-22 18:23:14 -07:00
data Remove people who are no longer at Google. 2022-02-11 07:02:38 -08:00
framework Some introductory type hinting and refactoring (#2319) 2022-10-12 09:16:36 +02:00
internals Fix prepublication earliest-beta calculation. (#2328) 2022-10-13 10:23:58 -07:00
pages Remove ability to update feature_type field (#2320) 2022-10-12 09:16:54 +02:00
scripts Add Redis to notifier production setup (#2258) 2022-09-20 09:55:24 -07:00
static Add Show all button (#2308) 2022-10-13 15:22:20 -07:00
templates Add a period to full-sentence bullet. (#2306) 2022-10-07 13:29:50 -07:00
.babelrc Using rollup for components (#679) 2019-11-11 14:32:32 -08:00
.coveragerc Update test coverage commands and configs (#2225) 2022-09-09 17:48:02 -04:00
.editorconfig Adds eslint. Fixes #350 (#351) 2016-07-19 15:19:06 -07:00
.eslintignore WIP 2019-05-22 11:13:09 -07:00
.eslintrc Using rollup for components (#679) 2019-11-11 14:32:32 -08:00
.gcloudignore Replace django templates for email with jinja2 templates (#2276) 2022-09-28 12:44:32 -04:00
.gitignore Update test coverage commands and configs (#2225) 2022-09-09 17:48:02 -04:00
CODE_OF_CONDUCT.md Add code of conduct to project. 2020-07-31 12:19:13 -07:00
LICENSE Apache2 license 2016-07-08 13:09:02 -07:00
README.md Add devcontainer configuration (#2266) 2022-09-26 08:51:04 -04:00
app.staging.yaml Create Redis staging setup (#2211) 2022-09-12 13:56:50 -07:00
app.yaml Setup Redis in production (#2242) 2022-09-14 16:55:44 -07:00
appengine_config.py Avoid needing to run py2 on workstations. (#1734) 2022-02-15 13:31:27 -08:00
config.rb Init commit of chromium feature dashboard 2013-03-07 10:29:38 -08:00
cron.yaml Move most entities to single migration script (#2325) 2022-10-13 09:09:53 +02:00
developer-documentation.md Update dev doc about reseting the Datastore locally (#2223) 2022-09-08 22:41:31 -04:00
dispatch.yaml Send and receive emails in py3 using GAE legacy libraries (#1923) 2022-06-10 14:56:40 -07:00
gulpfile.babel.js turn off mangle names (#2049) 2022-07-20 09:42:20 -07:00
hack_components.py Add the new crbug `Privacy>NavTracking` component. (#2277) 2022-09-28 10:24:27 -07:00
index.yaml Indexes for new entities (#2298) 2022-10-05 09:40:22 -07:00
main.py Move most entities to single migration script (#2325) 2022-10-13 09:09:53 +02:00
main_test.py Launch the SPA (#2224) 2022-09-13 14:54:32 -04:00
notifier.staging.yaml Add Redis to notifier production setup (#2258) 2022-09-20 09:55:24 -07:00
notifier.yaml Add Redis to notifier production setup (#2258) 2022-09-20 09:55:24 -07:00
package-lock.json npm: bump @babel/preset-env from 7.19.3 to 7.19.4 (#2316) 2022-10-11 09:19:22 -07:00
package.json Script to run all tests (#2329) 2022-10-14 15:36:21 +02:00
queue.yaml HTML emails to feature owners 2017-08-06 19:24:18 -07:00
requirements.dev.txt Be explicit about using python3.9. (#1983) 2022-06-28 08:12:44 -07:00
requirements.txt Create Redis staging setup (#2211) 2022-09-12 13:56:50 -07:00
settings.py Replace django templates for email with jinja2 templates (#2276) 2022-09-28 12:44:32 -04:00
testing_config.py Send and receive emails in py3 using GAE legacy libraries (#1923) 2022-06-10 14:56:40 -07:00

README.md

Chrome Platform Status

Mission

chromestatus.com is the official tool used for for tracking feature launches in Blink (the browser engine that powers Chrome and many other web browsers). This tool guides feature owners through our launch process and serves as a primary source for developer information that then ripples throughout the web developer ecosystem.

Get the code

For a one-click setup that leverages devcontainers, check out the devcontainer README. Otherwise, to continue setting up locally:

git clone https://github.com/GoogleChrome/chromium-dashboard

Installation

  1. Install gcloud and needed components:
    1. Before you begin, make sure that you have a java JRE (version 8 or greater) installed. JRE is required to use the DataStore Emulator.
    2. Google App Engine SDK for Python. Make sure to select Python 3.
    3. gcloud init
    4. gcloud components install cloud-datastore-emulator
    5. gcloud components install beta
  2. Install other developer tools commands
    1. node and npm.
    2. Gulp: npm install --global gulp-cli
    3. Python virtual environment: sudo apt install python3.9-venv
  3. We recommend using an older node version, e.g. node 12
    1. Use node -v to check the default node version
    2. nvm use 12 to switch to node 12
  4. cd chromium-dashboard
  5. Install JS an python dependencies: npm run setup
    1. Note: Whenever we make changes to package.json or requirements.txt, you will need to run npm run clean-setup.

If you encounter any error during the installation process, the section Notes (later in this README.md) may help.

Developing

To start the main server and the notifier backend, run:

npm start

Then visit http://localhost:8080/.

To start front end code watching (sass, js lint check, babel, minify files), run

npm run watch

To run lint & lit-analyzer:

npm run lint

To run unit tests:

npm test

This will start a local datastore emulator, run unit tests, and then shut down the emulator.

There are some developing information in developer-documentation.md.

Notes

  • If you get an error saying No module named protobuf or No module named six or No module named enum , try installing them locally with pip install six enum34 protobuf.

  • When installing the GAE SDK, make sure to get the version for python 3.

  • If you run the server locally, and then you are disconnected from your terminial window, the jobs might remain running which will prevent you from starting the server again. To work around this, use npm run stop-emulator; npm stop. Or, use ps aux | grep gunicorn and/or ps aux | grep emulator, then use the unix kill -9 command to terminate those jobs.

  • If you need to test or debug anything to do with dependencies, you can get a clean start by running npm run clean-setup.

  • Occasionally, the Google Cloud CLI will requires an update, which will cause a failure when trying to run the development server with npm start. An unrelated error message Failed to connect to localhost port 15606 after 0 ms: Connection refused will appear. Running the gcloud components update command will update as needed and resolve this issue.

Chromestatus currently gets the list of Blink components from the file hack_components.py.

Visit http://localhost:8080/admin/blink/populate_blink to see the list of Blink component owners.

Debugging / settings

settings.py contains a list of globals for debugging and running the site locally.

Deploying

If you have uncommited local changes, the appengine version name will end with -tainted. It is OK to test on staging with tainted versions, but everything should be committed (and thus not tainted) before staging a version that can later be pushed to prod.

Note you need to have admin privileges on the cr-status-staging and cr-status cloud projects to be able to deploy the site.

Run the npm target:

npm run staging

Open the Google Developer Console for the staging site and flip to the new version by selecting from the list and clicking MIGRATE TRAFFIC. Make sure to do this for both the 'default' service as well as for the 'notifier' service.

Alternatively, run npm run staging-rc to upload the same code to a version named rc for "Release candidate". This is the only version that you can test using Google Sign-In at https://rc-dot-cr-status-staging.appspot.com.

If manual testing on the staging server looks good, then repeat the same steps to deploy to prod:

npm run deploy

Open the Google Developer Console for the production site

The production site should only have versions that match versions on staging.

LICENSE

Copyright (c) 2013-2022 Google Inc. All rights reserved.

Apache2 License.

Analytics