Recipes are a domain-specific language (embedded in Python) for specifying sequences of subprocess calls in a cross-platform and testable way.
They allow writing build flows which integrate with the rest of LUCI.
Documentation for the recipe engine (including this file!). Take a look at the user guide for some hints on how to get started. See the implementation details doc for more detailed implementation information about the recipe engine.
- User guide: hints on how to get started.
- Recipe engine module docs: documentation on the recipe modules which are available in this repo.
- Implementation details on how recipes operate.
- Sign the Google CLA.
- Make sure your
user.emailanduser.nameare configured ingit config.
Run the following to setup the code review tool and create your first review:
# Get `depot_tools` in $PATH if you don't have it
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git $HOME/src/depot_tools
export PATH="$PATH:$HOME/src/depot_tools"
# Check out the recipe engine repo
git clone https://chromium.googlesource.com/infra/luci/recipes-py $HOME/src/recipes-py
# make your change
cd $HOME/src/recipes-py
git new-branch cool_feature
# hack hack
git commit -a -m "This is awesome"
# This will ask for your Google Account credentials.
git cl upload -s -r [email protected]
# Wait for approval over email.
# Click "Submit to CQ" button or ask reviewer to do it for you.
# Wait for the change to be tested and landed automatically.
Use git cl help and git cl help <cmd> for more details.