Google Git
Sign in
chromium / external / github.com / luci / luci-go / 842c196920ca287e07fdc52378a812b306870776
commit842c196920ca287e07fdc52378a812b306870776[log] [tgz]
authorvadimsh <vadimsh@chromium.org>Wed May 24 01:06:48 2017
committerCommit bot <commit-bot@chromium.org>Wed May 24 01:06:48 2017
tree8b942d1479413d763187016cddbd26b4c62b7358
parent2dc055c583df335f62536db98bcffd3afb739795 [diff]
Introduce luci-go components version metric.

A large chunk of luci-go library is used as a common GAE runtime for many LUCI
and Chrome Infra apps. It becomes hard to track what apps are outdated and need
to be redeployed.

This CL makes each individual GAE process report 'luci/components/version'
metric with semantic version of the luci-go GAE library, so we can precisely see
what is currently running in production.

The code is a bit more general to eventually allow reporting versions of other
optional components (like Tumble and pRPC server runtime).

R=iannucci@chromium.org, dnj@chromium.org
BUG=

Review-Url: https://codereview.chromium.org/2870293002
3 files changed
tree: 8b942d1479413d763187016cddbd26b4c62b7358
  1. appengine/
  2. buildbucket/
  3. cipd/
  4. client/
  5. common/
  6. deploytool/
  7. dm/
  8. examples/
  9. grpc/
  10. hardcoded/
  11. infra/
  12. logdog/
  13. luci_config/
  14. lucictx/
  15. milo/
  16. scheduler/
  17. scripts/
  18. server/
  19. swarming/
  20. tokenserver/
  21. tools/
  22. tumble/
  23. vpython/
  24. web/
  25. .travis.yml
  26. AUTHORS
  27. codereview.settings
  28. CONTRIBUTORS
  29. LICENSE
  30. luci-deploy.cfg
  31. pre-commit-go.yml
  32. PRESUBMIT.py
  33. README.md
  34. WATCHLISTS
README.md

luci-go: LUCI services and tools in Go

GoDoc Build Status Coverage Status

Installing

go get -u github.com/luci/luci-go/client/cmd/...
go get -u github.com/luci/luci-go/server/cmd/...

Code layout

  • /appengine/... contains AppEngine server code. It imports packages from /common/... and /server/....
  • /client/... contains all client code.
  • /common/... contains code and structures shared between all of /appengine/..., /client/... and /server/...; for example, the structures used by the server APIs. These are inherently APIs.
  • /deploytool/... contains the LUCI cloud services deployment tool.
  • /logdog/... contains LogDog client and server code, as well as APIs, protobufs, and support libraries.
  • /server/... contains standalone server code. Its packages are reusable by /appengine/....
  • /tools/... contains support tools used by other LUCI components.

Versioning

  • Branch go1 contains the stable code.
  • Branch master constains the latest code.

Contributing

  • Sign the Google CLA.
  • Make sure your user.email and user.name are configured in git config.
  • Install test-only packages: go get -u -t github.com/luci/luci-go/client/...
  • Install the pcg git hook: go get -u github.com/maruel/pre-commit-go/cmd/... && pcg

Run the following to setup the code review tool and create your first review:

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git $HOME/src/depot_tools
export PATH="$PATH:$HOME/src/depot_tools"
cd $GOROOT/github.com/luci/luci-go
git checkout -b work origin/master

# hack hack

git commit -a -m "This is awesome\nR=joe@example.com"
# This will ask for your Google Account credentials.
git cl upload -s
# Wait for LGTM over email.
# Check the commit queue box in codereview website.
# Wait for the change to be tested and landed automatically.

Use git cl help and git cl help <cmd> for more details.