| commit | b8e48ea485d5aa004edc37ddb1d81e41392ea3dd | [log] [tgz] |
|---|---|---|
| author | Xiang Ji <jxiang@google.com> | Mon Aug 02 22:26:18 2021 |
| committer | Xiang Ji <jxiang@google.com> | Wed Aug 04 20:15:24 2021 |
| tree | fb5586d8108d2ccd1281228f361fb17a58d942b6 | |
| parent | be2d96a7a42dc154b6fbe02c7b0ca0426f253baa [diff] |
Creating go module files by go module init(tidy) Summary: 1. https://github.com/golang/go/wiki/Modules#should-i-commit-my-gosum-file-as-well-as-my-gomod-file Validation: tryjob, mac-build will be fixed in later CLs. 2. Add a note in code guide doc about the go deps deprecation Change-Id: Iddd47dc1e3e21088f557299fbbfca00349e98699 Reviewed-on: https://chromium-review.googlesource.com/c/enterprise/cel/+/3067550 Reviewed-by: Yiming Zhou <uwyiming@google.com>
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.
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.
>> 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
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.
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.
Setting GO environment variables by adding below lines into ~/.bashrc file
export GOPATH=$HOME/go export GOBIN=$GOPATH/bin export PATH=$PATH:$GOBIN
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
Get the dependencies:
python build.py deps --install
If you see an error message complaining about protoc missing, see the protoc prerequisites above.
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).
Also make sure that all unit tests for the Go source files are passing.
python build.py test
See CONTRIBUTING.
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.