This directory contains Go-based tools to use with go tool.
Each tool is within its own directory with its own go.mod file to avoid
dependency conflicts.
Using a tool
go tool -modfile <path to modfile> <tool>For example, to use controller-gen:
go tool -modfile gotools/controller-gen/go.mod controller-gen -hAdd a new tool
From repository root:
TOOLNAME=<tool name>
mkdir -p gotools/"$TOOLNAME"
go mod init -modfile=gotools/"$TOOLNAME"/go.mod github.com/rancher/rancher/gotools/"$TOOLNAME"
go get -tool -modfile=gotools/"$TOOLNAME"/go.mod <module>@<version>For example, controller-gen was added this way:
TOOLNAME=controller-gen
mkdir -p gotools/"$TOOLNAME"
go mod init -modfile=gotools/"$TOOLNAME"/go.mod github.com/rancher/rancher/gotools/"$TOOLNAME"
go get -tool -modfile=gotools/"$TOOLNAME"/go.mod sigs.k8s.io/controller-tools/cmd/[email protected]
Update existing tool
From repository root:
TOOLNAME=<tool name>
go get -tool -modfile=gotools/"$TOOLNAME"/go.mod <module>@<new version>For example, to update controller-gen to v0.17.3:
TOOLNAME=controller-gen
go get -tool -modfile=gotools/"$TOOLNAME"/go.mod sigs.k8s.io/controller-tools/cmd/[email protected]