Skip to content

development.md

Latest commit

 

History

History
167 lines (110 loc) · 4 KB

development.md

File metadata and controls

167 lines (110 loc) · 4 KB

This document helps you get started using the Volcano code base. If you follow this guide and find a problem, please take a few minutes to update this file.

Cloning the Code

You will need to clone the main volcano repo to $GOPATH/src/volcano.sh/volcano for the below commands to work correctly.

Building the Code

To build all Volcano components for your host architecture, go to the source root and run:

make image_bins

The binaries will be generated at .../src/volcano.sh/volcano/_output/bin/linux/amd64/.

If we just run make as below:

make

Then the binaries would be generated at .../src/volcano.sh/volcano/_output/bin/.

To build a specific component for your host architecture, go to the source root and run make <component name>:

make vc-scheduler

Building Docker Images

Build the containers in your local Docker cache:

make images

To build cross-platform images:

make images DOCKER_PLATFORMS="linux/amd64,linux/arm64" BUILDX_OUTPUT_TYPE=registry IMAGE_PREFIX=[yourregistry]

Building a Specific Component

If you want to make a local change and test some component, say vc-controller-manager, you could do:

Under volcano.sh/volcano repo:

pwd

The path should be:

.../src/volcano.sh/volcano

Set up environment variables HUB and TAG:

export HUB=docker.io/yourrepo
export TAG=citadel

Make some local change to the code, then build vc-controller-manager:

make vc-controller-manager

Building the Volcano Manifests

Use the following command to build the deploy YAML files:

make generate-yaml

Cleaning Outputs

You can delete any build artifacts with:

make clean

Running Tests

Running Unit Tests

You can run all the available unit tests with:

make unit-test

Running E2E Tests

You can run all the available e2e tests with:

make vcctl
make images
make e2e

If you want to run e2e tests in an existing cluster with Volcano deployed, run the following:

export VC_BIN=<path-to-vcctl-binary> (e.g., .../src/volcano.sh/volcano/_output/bin/)
KUBECONFIG=${KUBECONFIG} go test ./test/e2e

Auto-Formatting Source Code

You can automatically format the source code to follow our conventions by going to the top of the repo and entering:

./hack/update-gofmt.sh

Running the Verification

You can run all the verification we require on your local repo by going to the top of the repo and entering:

make verify

Adding Dependencies

Volcano uses Go Modules to manage its dependencies. If you want to add or update a dependency, run:

go get dependency-name@version
go mod tidy
go mod vendor

Note: Go's module system, introduced in Go 1.11, provides an official dependency management solution built into the go command. Make sure GO111MODULE env is not off before using it.

About Testing

Before sending pull requests, you should at least make sure your changes have passed both unit tests and verification. We only merge pull requests when all tests are passing.

  • Unit tests should be fully hermetic
    • Only access resources in the test binary.
  • All packages and any significant files require unit tests.
  • Unit tests are written using the standard Go testing package.
  • The preferred method of testing multiple scenarios or input is table-driven testing.
  • Concurrent unit test runs must pass.