Environment setup

Search…
Environment setup
Set up your environment to work with Go and Nextmv tools
GitHub access
If this is your first time using GitHub you will need to add SSH keys to your GitHub account to associate it to your machine. Instructions on doing so can be found here. We manage access to our repositories using GitHub teams, generally you will be added at the beginning of your trial.
Git setup
Your ~/.gitconfig will work best if it directs git to clone repositories over ssh. Add the following to your ~/.gitconfig configuration file.
Text
1
[url "[email protected]:"]
2
    insteadOf = https://github.com/
Copied!
Go setup
To install and set up Go on your machine you have two options:
​Manually install Go (recommended for Mac users)
​Install with asdf (advanced users interested in working with different versions of Go. Recommended for Windows & Linux users)
Install Go manually
Nextmv requires at least Go 1.13. You should be able to find the binaries for your target system at https://golang.org/dl/. After installing the pre-compiled packages, set the following environment variables in your ~/.bashrc, ~/.zshrc or a similar configuration file.
Text
1
export GOPATH=$(go env GOPATH)
2
export GOROOT=$(go env GOROOT)
3
export GOPRIVATE=github.com/nextmv-io/*
4
export PATH=$PATH:$GOPATH/bin
Copied!
Note that if you installed Go directly from Golang, you do not need to add exports for GOPATH or GOROOT. If you installed go via Homebrew, you will need to add those lines to ~/.zshrc. If you were using bash previously, also be sure to source ~/.zshrc by running source ~/.zshrc.
Single script install with asdf
This single script to install Go and set the environment variables makes use of bash. If you are using another shell, please read the asdf docs to make changes to the script. If you are on a Windows machine, please install WSL for Windows. You can find the installation instructions here. We recommend using Ubuntu.
Bash
1
set -e
2
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1
3
echo '
4
# Install asdf
5
. $HOME/.asdf/asdf.sh
6
. $HOME/.asdf/completions/asdf.bash' >> ~/.bashrc
7
source ~/.bashrc
8
asdf plugin-add golang
9
asdf install golang 1.16.8
10
asdf global golang 1.16.8
11
echo '
12
# Go modifications for hop
13
export GOPATH=$(asdf where golang)/packages
14
export GOROOT=$(asdf where golang)/go
15
export GOPRIVATE=github.com/nextmv-io/*
16
export PATH="${PATH}:$(go env GOPATH)/bin"' >> ~/.bashrc
17
source ~/.bashrc
18
echo "SUCCESS - golang version is: $(go version)"
Copied!
Go workspace
We use Go modules to setup your Nextmv app. You can learn more about them in our modules and packages section.
Go package docs
You can learn more about the Nextmv Decision Stack by setting up the Go package docs.
SDK - Previous
Get started
Repo tour
Last modified 7mo ago
Export as PDF
Copy link
Contents