baseapp - Create a simple way to securely serve applications.

This structure should be secure by default, easy to use, and provide
good defaults that are common for all of our applications.

baseapp also provides the --local, --port, and --prom_port flags
so their usage and documentation are consistent.

Bug: skia:
Change-Id: Ib5a9b98ba3e209f8eb2efa3b2f967704d7ac89af
Reviewed-on: https://skia-review.googlesource.com/c/180281
Commit-Queue: Joe Gregorio <jcgregorio@google.com>
Reviewed-by: Ravi Mistry <rmistry@google.com>
6 files changed
tree: 9ea0b2676d91a608880843ed47a91f3fea08bba9
  1. am/
  2. android_compile/
  3. android_ingest/
  4. android_stats/
  5. appengine_scripts/
  6. autoroll/
  7. bash/
  8. blamer/
  9. chromeextensions/
  10. cmd/
  11. comments/
  12. common-sk/
  13. contestk/
  14. cq_watcher/
  15. ct/
  16. ct_pixel_diff/
  17. datahopper/
  18. debugger/
  19. debugger-assets/
  20. docker/
  21. docserverk/
  22. ds/
  23. fiddlek/
  24. fuzzer/
  25. get_service_account/
  26. git_cookie_authdaemon/
  27. go/
  28. gold-client/
  29. golden/
  30. grafana/
  31. html-template-minifier/
  32. infra/
  33. infra-sk/
  34. jsdoc/
  35. jsfiddle/
  36. kube/
  37. leasing/
  38. logmetrics/
  39. make/
  40. monitoring/
  41. named-fiddles/
  42. notifier/
  43. pdfium/
  44. perdiff/
  45. perf/
  46. power/
  47. prober/
  48. proberk/
  49. prometheus/
  50. promk/
  51. proxy/
  52. pulld/
  53. push/
  54. res/
  55. scripts/
  56. sheriff_emails/
  57. skfe/
  58. skolo/
  59. skottie/
  60. status/
  61. task_driver/
  62. task_scheduler/
  63. tools/
  64. tracedb/
  65. webtools/
  66. .gitattributes
  67. .gitignore
  68. build_infra_prod.sh
  69. codereview.settings
  70. DATASTORE.md
  71. DEPS
  72. launch.md
  73. LICENSE
  74. Makefile
  75. PRESUBMIT.py
  76. PRIVACY_POLICY.md
  77. README.md
  78. run_unittests
  79. run_unittests.go
  80. STYLEGUIDE.md
  81. whitespace.txt
README.md

Skia-Buildbot Repository

This repo contains infrastructure code for Skia.

Getting the Source Code

The main source code repository is a Git repository hosted at https://skia.googlesource.com/buildbot. Although it is possible to check out this repository directly with git clone or using gclient fetch, it is preferred to use go get so that the code is arranged correctly for Go. If this is your first time working on Go code, read about the GOPATH environment variable. Make sure that $GOPATH/bin comes before /usr/bin in your PATH. If you have GOPATH set, run:

$ go get -u -t go.skia.org/infra/...

This fetches the repository into your $GOPATH directory along with all the Go dependencies. Note: go.skia.org is a custom import path and will only work if used like the examples here.

Install Node.js (not as root) and add the bin dir to your path. Optionally run npm install npm -g, as suggested by the npm getting started doc.

Install other dependencies:

$ sudo apt-get install python-django
$ go get -u github.com/kisielk/errcheck \
  golang.org/x/tools/cmd/goimports \
  go.chromium.org/luci/client/cmd/isolate
$ npm install -g polylint bower

Build from GOPATH:

$ cd $GOPATH/src/go.skia.org/infra/
$ make all

Generated Code

Some code is generated using go generate with external binaries. First, install the version of protoc referenced in the asset creation script and ensure it is on your PATH before other versions of protoc.

Install the necessary go packages:

$ go get -u \
  github.com/golang/protobuf/protoc-gen-go \
  golang.org/x/tools/cmd/stringer \
  google.golang.org/grpc

To generate code run in this directory:

$ go generate ./...

Database Setup for Testing

Tests which use the database package's testutils require you to have a MySQL instance running with a database named “sk_testing” and users called “readwrite” and “test_root” with appropriate permissions for sk_testing. The ‘setup_test_db’ script in ‘go/database’ is included for convenience in setting up this test database and user.

Go tests require a local installation of MySQL. For a Debian based distro:

$ sudo apt-get install mysql-client mysql-server

Leave the root password blank.

Then, to set up local versions of the production databases:

$ cd $GOPATH/src/go.skia.org/infra/go/database
$ ./setup_test_db

Running unit tests

Install Cloud SDK.

The installed python-django version must be >= 1.7. Run the following to update:

$ sudo pip install Django --upgrade

Use this command to run the presubmit tests:

$ ./run_unittests --small