Prerequisites

本页面说明了如何设置环境使用ClusterFuzz.

• Requirements
• Getting the code
• Installing prerequisites
  • Google Cloud SDK
  • Log in to your Google Cloud account
  • Python programming language
  • Go programming language
  • Other dependencies
• Loading pipenv

Requirements

ClusterFuzz的许多功能依赖于Google Cloud Platform 服务, 但它同样可以无须这些依赖在本地运行起来作为测试用途. 更多细节请查阅Architecture page了解.

注意: 本地开发环境仅支持Linux平台.

Getting the code

运行以下命令克隆ClusterFuzz到你的计算机上:

git clone https://github.com/google/clusterfuzz
cd clusterfuzz
git pull

出于稳定性考虑, 我们建议您使用代码的最新发行版本(而非master分支). 您可以使用以下命令切换到特定版本:

git checkout tags/vX.Y.Z

其中 X.Y.Z 是具体到发布版本(比如, 1.0.1).

Installing prerequisites

Google Cloud SDK

遵循在线说明安装Google Cloud SDK.

Log in to your Google Cloud account

注意: 如果您在本地运行ClusterFuzz, 那么这部分内容不是”必需”的.

如果您打算在生产环境中设置ClusterFuzz, 则应使用gcloud工具对您的帐户进行身份验证:

gcloud auth application-default login
gcloud auth login

Python programming language

下载 Python 3.7并安装. 如果已经安装好了Python, 则可以通过运行python --version来验证版本.

我们建议使用官方仓库中的python源码进行构建, 因为它会安装所需的python头文件和pip. 否则, 请确保明确安装了它们.

Go programming language

Install the Go programming language.

Other dependencies

我们提供了一个脚本, 用于在Linux和macOS上安装所有其他的开发依赖项.

我们支持的系统包括有:

• Ubuntu (14.04, 16.04, 17.10, 18.04, 18.10)
• Debian 8 (jessie) 或更高版本
• 安装有homebrew的macOS最新版本(实验性)

要安装依赖项, 请运行以下脚本:

local/install_deps.bash

Loading pipenv

在运行完local/install_deps.bash脚本之后, 通过运行以下命令激活pipenv:

pipenv shell

该命令会载入所有到Python依赖到当前到环境中去.

您可以运行以下命令验证环境是否配置成功.

python butler.py --help