Clone this repo:

Branches

  1. 3a10949 Update doc for test setup scripts by Xiang Ji · 9 days ago main
  2. 633ce57 Fixed failing unit test cases by Eswaran Krishnamoorthy · 9 days ago
  3. 0378947 Read asset configuration from poros api by Eswaran Krishnamoorthy · 11 days ago
  4. ac0864a Update Linux builder's ubuntu machine version to 18.04 by Xiang Ji · 4 weeks ago
  5. 488ecc3 Update CELab go env to 1.18 to align with gLinux local golang verion by Xiang Ji · 4 weeks ago

Chrome Enterprise Lab

Chrome Enterprise Lab is a set of tools for building enterprise experimental labs quickly and easily. The labs so built can be used for system level end-to-end testing of Google Chrome/Chromium. These system tests are required to avoid enteprise regression under some complex enterprise software & networking configurations, such as Microsoft Active Directory.

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.16.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.

    >> cd tmp
    >> wget https://github.com/protocolbuffers/protobuf/releases/download/v3.14.0/protoc-3.14.0-linux-x86_64.zip
    >> unzip protoc-3.14.0-linux-x86_64.zip -d protoc
    >> sudo cp protoc/bin/protoc /usr/local/bin/protoc
    >> sudo chmod 751 /usr/local/bin/protoc
    >> cp protoc/
    >> sudo mv include/* /usr/local/include/
    >> rm -rf protoc3 protoc-3.14.0-linux-x86_64.zip
    
  • absl-py: This Python package is used by tests. Install it by running pip install absl-py.

Get The Source

  1. Setting GO environment variables by adding below lines into ~/.bashrc file

    export GOPATH=$HOME/go
    export GOBIN=$GOPATH/bin
    export PATH=$PATH:$GOBIN
    
  2. 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
    

Build It

  1. Use the build script:

    python build.py build
    

    If you see an error message like google/protobuf/descriptor.proto: File not found, see the protoc prerequisites (specifically the includes step).

  2. Also make sure that all unit tests for the Go source files are passing.

    python build.py test
    

Contributing

See CONTRIBUTING.

Release

The CELab deployment binary and its Python test framework is uploaded into CIPD as a package.

Here are the general steps to release the package.

  1. After the code review, merge in the change
  2. Wait for windows CI build finished (https://ci.chromium.org/p/celab/g/Main%20Console/console)
  3. Run upload_to_cipd with the link to binaries in the CI build (instructions here: https://chromium.googlesource.com/enterprise/cel/+/refs/heads/main/scripts/cipd)
  4. (Optional) Check the output of that command and update the infra version in the .vpython file for your app