tree: bf24c80c0a7464398c30fc29986269160ccdbde6 [path history] [tgz]
  1. analysis_service/
  2. chromite/
  3. chromiumos/
  4. config/
  5. cycler/
  6. device/
  7. docs/
  8. lab/
  9. lab_platform/
  10. manufacturing/
  11. partners/
  12. project_mgmt/
  13. prototype/
  14. satlabrpcserver/
  15. tast/
  16. test/
  17. test_platform/
  18. testplans/
  19. uprev/
  20. README.md
src/README.md

proto/src

This folder contains the protobuf source files for the Chromite Build API and Recipes implementations.

Making changes

Before commiting any changes to this repo, make sure to run generate.sh one directory up.

Directories:

chromite/api

This is the core API definitions, including all of the services and most of the messages.

The build_api.proto contains service and method options that define some of the implementation details. Specifically, the service options define the controller module that implements the methods, and optionally enforces whether or not the methods should run in the chroot. The method options allow overriding the default function name for the implementation, and overriding the service-level chroot setting.

  • Service
    • module - Required
    • service_chroot_assert - Recommended
  • Method
    • implementation_name - Optional
    • method_chroot_assert - Optional

These options are all implementation details that should not affect consumers of the endpoints, but are important details for anyone implementing endpoints.

chromiumos

This folder contains more widely shared proto files.

test_platform

This folder contains definitions of the cros_test_platform API, as well as internal protos used for communication between cros_test_platform components.

uprev

This folder contains protos used for communication between uprev recipes and their components.

device

testplans

cycler

Cycler protos: go/cros-gs-lifecycler

bot_scaling

RoboCrop protos: go/robocrop