Clone this repo:

Branches

  1. 6dc80c6 Generalize --cel_ctl to --test_py_args. by Mathieu Binette · 5 days ago master
  2. be964fa Fix mini_installer.exe detection on Linux. by Mathieu Binette · 8 days ago
  3. 069cda4 Add a DiskSizeGb field to our NestedVM proto. by Mathieu Binette · 13 days ago
  4. 521c149 Add RemovePolicy API by Xiang Ji · 2 weeks ago
  5. 86cab60 Add enterprise test for ExtensionInsallWhitelist policy by Xiang Ji · 3 weeks ago

Chrome Enterprise Lab

Chrome Enterprise Lab is an inaccurately named set of tools for building enterprise labs quickly and easily. The labs so built can be used for system level end-to-end testing of Google Chrome/Chromium.

Have a peek at the Design document.

Also have a peek at the Code of Conduct.

Most of the code is in Go. See Guide to code to get a head start on the code in this repository.

Building

Prerequisites

  • Go: Download Go from the Go download page. This project requires Go 1.9.4 or later. The build will fail with prior versions.

  • Depot Tools: Used for managing the checkout and the contributor workflow.

  • Protocol Buffers Compiler: Protocol buffers are used extensively for wranging all the data that needs to be shuttled around. Run protoc --version to check the protoc version. The protoc version should be at least 3.5.1. If protoc is not installed, or if the version is less than 3.5.1, download it from https://github.com/protocolbuffers/protobuf/releases.

    Remember that you need to copy the contents of the include directory of the zip file into /usr/local/include/ as well, i.e.

    sudo cp -r <unzipped_protoc_release>/include /usr/local
    
    sudo chmod -R a+rX /usr/local/include/
    
  • Dep : Used for Go depedency management. This can be installed automatically by running ./build.py deps --install from the root of the source tree.

  • Go support for Protocol Buffers : This can be installed automatically by running ./build.py deps --install from the root of the source tree.

  • absl-py: This Python package is used by tests. Install it by running pip install absl-py.

Get The Source

There are two ways to get the source. One is to use managed deps, and the other is to use plain go get. The latter workflow doesn't quite work yet due to this repository not being integrated with go.chromium.org. So this page only mentions the managed dependency workflow.

  1. Clone this repository:

    Assumes that $GOPATH is a single path and not a : delimited list.

    mkdir -p ${GOPATH}/src/chromium.googlesource.com/enterprise
    cd ${GOPATH}/src/chromium.googlesource.com/enterprise
    git clone https://chromium.googlesource.com/enterprise/cel
    cd cel
    
  2. Get the dependencies:

    python build.py deps --install
    

Build It

  1. Use the build script:

    python build.py build
    
  2. Also make sure the tests pass.

    python build.py test
    

Contributing

See CONTRIBUTING.