GVM provides an interface to manage Go versions.
The current maintainer of the fork is @soulteary, fixed some issues that were not exposed in the past few years, and supports Apple M1 devices.
- Thanks to the original author of the program: By Josh Bussdieker (jbuss, jaja, jbussdieker) while working at Moovweb
- Thanks to previous project maintainers: Benjamin Knigge
- Install/Uninstall Go versions with
gvm install [tag]where tag is "60.3", "go1", "weekly.2011-11-08", or "tip" - List added/removed files in GOROOT with
gvm diff - Manage GOPATHs with
gvm pkgset [create/use/delete] [name]. Use--localasnameto manage repository under local path (/path/to/repo/.gvm_local). - List latest release tags with
gvm listall. Use--allto list weekly as well. - Cache a clean copy of the latest Go source for multiple version installs.
- Link project directories into GOPATH
When we started developing in Go mismatched dependencies and API changes plauged our build process and made it extremely difficult to merge with other peoples changes.
After nuking my entire GOROOT several times and rebuilding I decided to come up with a tool to oversee the process. It eventually evolved into what gvm is today.
To install:
curl -sSL https://github.com/soulteary/gvm/raw/master/binscripts/gvm-installer | bashOr if you are using zsh just change bash with zsh.
It is recommended to manually add the following content to ~/.bashrc or ~/.zshrc , then restart Terminal and use the gvm command.
export GO111MODULE=on
# set mirroring, if you need to
export GOPROXY=https://goproxy.io,direct
# or `export GOPROXY="https://goproxy.cn"`
export GOPATH="$HOME/go"
PATH="$GOPATH/bin:$PATH"
# you can set as your own mirror
# export GO_BINARY_BASE_URL=https://golang.google.cn/dl/
[[ -s "$HOME/.gvm/scripts/gvm" ]] && source "$HOME/.gvm/scripts/gvm"
export GOROOT_BOOTSTRAP=$GOROOT# download golang binaries, "clean and hygienic"
gvm install go1.18 -B
# or download golang source code, complie and install
# gvm install go1.18
gvm use go1.18 [--default]Once this is done Go will be in the path and ready to use.
$GOROOT and $GOPATH are set automatically.
Additional options can be specified when installing Go:
Usage: gvm install [version] [options]
-s, --source=SOURCE Install Go from specified source.
-n, --name=NAME Override the default name for this version.
-pb, --with-protobuf Install Go protocol buffers.
-b, --with-build-tools Install package build tools.
-B, --binary Only install from binary.
--prefer-binary Attempt a binary install, falling back to source.
-h, --help Display this message.
Go 1.5+ removed the C compilers from the toolchain and replaced them with one written in Go. Obviously, this creates a bootstrapping problem if you don't already have a working Go install. In order to compile Go 1.5+, make sure Go 1.18 is installed first.
gvm install go1.18 -B
gvm use go1.18
export GOROOT_BOOTSTRAP=$GOROOT
gvm install go1.18To list all installed Go versions (The current version is prefixed with "=>"):
gvm listTo list all Go versions available for download:
gvm listallTo completely remove gvm and all installed Go versions and packages:
gvm implodeIf that doesn't work see the troubleshooting steps at the bottom of this page.
- Install Mercurial from https://www.mercurial-scm.org/downloads
- Install Xcode Command Line Tools from the App Store.
xcode-select --install
brew update
brew install mercurialsudo apt-get install curl git mercurial make binutils bison gcc build-essentialsudo yum install curl
sudo yum install git
sudo yum install make
sudo yum install bison
sudo yum install gcc
sudo yum install glibc-devel- Install Mercurial from http://pkgs.repoforge.org/mercurial/
sudo pkg_add -r bash
sudo pkg_add -r git
sudo pkg_add -r mercurialGVM supports vendoring package set-specific native code and related dependencies, which is useful if you need to qualify a new configuration or version of one of these dependencies against a last-known-good version in an isolated manner. Such behavior is critical to maintaining good release engineering and production environment hygiene.
As a convenience matter, GVM will furnish the following environment variables to aid in this manner if you want to decouple your work from what the operating system provides:
-
${GVM_OVERLAY_PREFIX}functions in a manner akin to a root directory hierarchy suitable for auto{conf,make,tools} where it could be passed in to./configure --prefix=${GVM_OVERLAY_PREFIX}and not conflict with any existing operating system artifacts and hermetically be used by your workspace. This is suitable to use withC{PP,XX}FLAGS and LDFLAGS, but you will have to manage these yourself, since each tool that uses them is different. -
${PATH}includes${GVM_OVERLAY_PREFIX}/binso that any tools you manually install will reside there, available for you. -
${LD_LIBRARY_PATH}includes${GVM_OVERLAY_PREFIX}/libso that any runtime library searching can be fulfilled there on FreeBSD and Linux. -
${DYLD_LIBRARY_PATH}includes${GVM_OVERLAY_PREFIX}/libso that any runtime library searching can be fulfilled there on Mac OS X. -
${PKG_CONFIG_PATH}includes${GVM_OVERLAY_PREFIX}/lib/pkgconfigso thatpkg-configcan automatically resolve any vendored dependencies.
Recipe for success:
gvm use go1.18
gvm pkgset use current-known-good
# Let's assume that this includes some C headers and native libraries, which
# Go's CGO facility wraps for us. Let's assume that these native
# dependencies are at version V.
gvm pkgset create trial-next-version
# Let's assume that V+1 has come along and you want to safely trial it in
# your workspace.
gvm pkgset use trial-next-version
# Do your work here replicating current-known-good from above, but install
# V+1 into ${GVM_OVERLAY_PREFIX}.See examples/native for a working example.
Sometimes especially during upgrades the state of gvm's files can get mixed up. This is mostly true for upgrade from older version than 0.0.8. Changes are slowing down and a LTR is imminent. But for now rm -rf ~/.gvm will always remove gvm. Stay tuned!
