Fill in all sections demarcated in <> brackets and then delete this. Send to g/chromeos-, g/chromeos-peng-sies, platform project leads, and g/cros-boxster-announce.

Configuration for will now be managed on a per-project basis with the goal of enabling autonomous and flexible partner contributions and clearer API boundaries. Once we receive acknowledgement from project owners, the migration CL will be submitted within 2 to 3 business days

Starlark -- a Python-like configuration-management language -- will be used to generate Protocol Buffer configuration payloads in and model.yaml will be deleted from . A few resources to get started:

Changes will be made in the following repos:

  • : Contains Starlark files, generated protobuf payloads, and backwards-compatible JSON payloads.
  • : sets CROS_WORKON_PROJECT to . model.yaml is deleted.

We understand that getting used to the new configuration management ecosystem may take some time, and are committed to providing the best experience possible for partners and Googlers. Please contact the project TAM/SIE for issues and feedback, which will be relayed in timely fashion.

Frequently Asked Questions

  1. Why are we doing this migration?

Configuration data for ChromeOS hardware, firmware, and software has been spread across multiple data silos and formats. This has made the effects of configuration changes confusing and inhibited analytics that could drive project planning and infrastructure. This migration will provide a coherent and clear API ecosystem.

Benefits include:

  • Clearer API boundaries to manage builds and hardware.
  • Enable autonomous partner config contributions, enforced via CQ coverage.
  • Allow partners to develop proprietary features without leaking IP.
  • Final generated config payloads are checked in allowing for clear behavior and diffing.
  • Improved analytics on hardware and software characteristics.
  1. Will I need to change my ChromeOS platform code?

No. For the time being, the protobuf payloads will be translated backwards into JSON payloads conforming to cros_config_schema.yaml. From the platform point-of-view, the configuration will not change.

  1. Will this break my builds?

No. During the migration, we will ensure that configuration generated by the new repos is the same as the configuration generated by model.yaml. Standard CQ coverage will apply to the migration CLs and stakeholders will be added as reviewers. Migration will be done in a single submission that can be reverted.

  1. How will I cherry pick changes to branches?

If your project has not yet created branches, you will only need to cherry pick changes to the generated payloads in the new config repos. If your project has created branches, you will need to cherry pick the ebuild change to read the new config repos as well. The Boxster team will be available to assist in the cherry pick process.