Clone this repo:
  1. 1463cce [milo] Reduce tree status spacing in console header. by Erik Staab · 21 hours ago master
  2. f0ebec4 [Machine Database] Update datacenters to match the config by smut · 22 hours ago
  3. 06568d0 [milo] Make console loading more parallel by Ryan Tseng · 22 hours ago
  4. 460f1af gerrit: Minimal Gerrit client by Petr Hosek · 2 days ago
  5. 9367cca [Machine Database] Require datacenter, rack, and switch name uniqueness by smut · 2 days ago

luci-go: LUCI services and tools in Go

GoDoc Build Status Coverage Status

Installing

go get -u go.chromium.org/luci/client/cmd/...
go get -u go.chromium.org/luci/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 go.chromium.org/luci/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/go.chromium.org/luci
git checkout -b work origin/master

# hack hack
git commit -a -m "This is awesome"

# We use Gerrit for code review. Visit
# https://chromium-review.googlesource.com/new-password
# and follow instructions.

git cl upload -s -r john.doe@example.com
# This will upload your change to Gerrit and ask john.doe for review.
# Wait for approval and submit your code through Commit Queue.
# Commit queue will test your change on multiple platforms and land it
# automatically.

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