commit | e81ae540130933c50cdba22a81755f0e993e24cc | [log] [tgz] |
---|---|---|
author | Zach Bush <zmbush@google.com> | Wed Feb 23 20:27:53 2022 +0000 |
committer | Commit Bot <commit-bot@chromium.org> | Wed Feb 23 20:27:53 2022 +0000 |
tree | 1d6eba50506a8b994e3c4b762c81d4bfbacd3618 | |
parent | 2cbf5c47de191c843a5c1a7bbc22ba2b57452980 [diff] |
[REPORT_ALL] Re-implement REPORT_ALL aggregation This change builds on top of the work done for fxbug.dev/91520 that stores the SystemProfile in a convenient location. Bug: 87403 Bug: 87271 Bug: 91520 Change-Id: I6eb001e5f835ee702f635a2400dec40d0e156dbe Reviewed-on: https://fuchsia-review.googlesource.com/c/cobalt/+/598781 Fuchsia-Auto-Submit: Zach Bush <zmbush@google.com> Reviewed-by: Cameron Dale <camrdale@google.com> Reviewed-by: Laura Peskin <pesk@google.com> Commit-Queue: Auto-Submit <auto-submit@fuchsia-infra.iam.gserviceaccount.com>
Cobalt is a pipeline for collecting metrics data from user-owned devices in the field and producing aggregated reports.
Cobalt includes a suite of features for preserving user privacy and anonymity while giving product owners the data they need to improve their products.
The code in the Git repo at https://fuchsia.googlesource.com/cobalt is known as Cobalt Core. It contains:
In order to have a working Cobalt system you need to also have
//third_party/cobalt
.This document describes how to develop, build and test Cobalt Core independently of Fuchsia, as well as from in the Fuchsia tree.
To download just the Cobalt Core repo:
git clone https://fuchsia.googlesource.com/cobalt
cd cobalt
To download the entire Fuchsia source code, including Cobalt Core, follow the instructions. Then change into the Cobalt Core directory:
cd third_party/cobalt
./cobaltb.py setup
This command is required after a first checkout, before running any other cobaltb.py
commands, and will take a few minutes the first time. It does the following:
third_party
dir via Git submodules.sysroot
dir. This uses CIPD.If the ./cobaltb.py setup
command is run in the third_party/cobalt
checkout of Cobalt Core in a Fuchsia tree, the Git submodules may interfere with the correct functioning of Jiri to update the repos in the Fuchsia tree. If problems occur, the submodules can be removed with: ./cobaltb.py deinit
. Before running any other cobaltb.py
commands in this checkout, ./cobaltb.py setup
will need to be run again to refetch the submodules.
The Python script cobaltb.py
in the root directory is used to orchestrate building and testing Cobalt. It was already used above in ./cobaltb.py setup
.
./cobaltb.py -h
for general helpcobaltb.py <command> -h
for help on a command./cobaltb.py build
The Cobalt build uses GN and ninja.
./cobaltb.py test
This runs the tests from the currently built code (build
must be run first).
./cobaltb.py fmt
./cobaltb.py lint
See: clang-tidy for an explanation of clang-tidy configuration options.
If the Cobalt Core checkout is part of a Fuchsia tree, it can also be built using Fuchsia's tools. This can be done to test the Cobalt code changes build and function correctly in Fuchsia. However, the build/test/fmt/lint commands above should always be used before contributing a change to Cobalt Core.
fx build
In this way, the Cobalt Core and Fuchsia build systems can function correctly in parallel.
Cobalt uses the Gerrit code review tool. Although Cobalt Core is independent of Fuchsia, we do share infrastructure with Fucshia and so much of the instructions from Fuchsia's Contributing Guide apply to Cobalt Core. The main difference is that Cobalt Core does not use Jiri--it uses Git submodules instead.
Follow the instructions here.
To create a change in Gerrit do the following:
cd ~/cobalt
git checkout -b <branch_name>
git add <files>
git commit
git push origin HEAD:refs/for/main
See the Gerrit documentation for more information.
After creating a change, to upload a patch to your change, do the following:
git add <files>
--amend
option: git commit --amend
git push origin HEAD:refs/for/main