Install
Install nuvem with Homebrew, with Cargo, from a release archive, or from source. However you install it, nuvem needs the Google Cloud CLI, signed in. See Requirements.
Install with Homebrew
Section titled “Install with Homebrew”On macOS or Linux with Homebrew:
brew install filipeaaoliveira/tap/nuvemTo upgrade later, run brew upgrade nuvem. Homebrew does not install the
Google Cloud CLI for you. If you do not have it, run
brew install --cask gcloud-cli and then gcloud auth login.
Install with Cargo
Section titled “Install with Cargo”With Rust 1.94 or newer, install nuvem from crates.io:
cargo install nuvem --lockedCargo builds nuvem on your machine, so you also need a C toolchain and
cmake, as for a build from source. --locked builds
with the exact dependency versions nuvem was tested with. To upgrade later,
run the same command again.
Download a release
Section titled “Download a release”Each GitHub release
carries a nuvem-<target>.tar.gz archive and a .sha256 file beside it.
| Platform | Target |
|---|---|
| Linux, x86_64 | x86_64-unknown-linux-gnu |
| Linux, arm64 | aarch64-unknown-linux-gnu |
| macOS, Apple silicon | aarch64-apple-darwin |
| macOS, Intel | x86_64-apple-darwin |
CI builds every archive on a runner of its own platform, runs the test suite there, and smoke-tests the binary before packaging it.
-
Download the archive for your platform and its
.sha256file. -
Verify the archive against its checksum:
Shell shasum -a 256 -c nuvem-<target>.tar.gz.sha256 -
Unpack it and put the binary in
~/.local/bin. The first command creates that directory if it does not exist yet:Shell mkdir -p ~/.local/bintar xzf nuvem-<target>.tar.gz && install nuvem-<target>/nuvem ~/.local/bin/ -
Make sure that
~/.local/binis on yourPATH. Ifcommand -v nuvemprints nothing, addexport PATH=to your shell’s startup file, such as"$HOME/ .local/ bin: $PATH" ~/.zshrcor~/.bashrc, and open a new terminal.
The Linux binaries need glibc 2.28 or newer. Ubuntu 20.04, Debian 10, RHEL 8
and later releases have it. To see your version, run ldd --version. With an
older glibc, nuvem fails at startup with GLIBC_2.xx not found.
Every archive also carries a signed build-provenance attestation. It records the workflow, commit and run that built the archive. The checksum shows that the download is intact, and the attestation shows where it came from. To verify the attestation with the GitHub CLI, run:
gh attestation verify nuvem-x86_64-unknown-linux-gnu.tar.gz --repo filipeaaoliveira/nuvemBuild from source
Section titled “Build from source”You need Rust 1.94 or newer, a C toolchain and cmake on your PATH. The C
toolchain and cmake build the TLS library that the Google Cloud client
libraries use, which compiles native code. If you use rustup, it installs
the pinned Rust version for you.
git clone https://github.com/filipeaaoliveira/nuvemcd nuvemcargo install --path . --lockedRequirements
Section titled “Requirements”- The Google Cloud CLI (
gcloud), installed and signed in withgcloud auth login. nuvem reads your gcloud configurations and asksgcloudfor an access token, so it stores no credentials of its own. - A terminal at least 60 columns wide and 12 rows tall.
- Linux or macOS. Process control uses POSIX APIs, so Windows works only inside WSL.
- Outbound HTTPS to
*.googleapis.com.
Some features need one more program on your PATH. nuvem runs without these
programs. If one is missing, nuvem tells you when you use the feature that
needs it:
| Program | Used for | Flag to point at it |
|---|---|---|
bq |
Browsing BigQuery datasets. It ships with the Google Cloud CLI. | --bq-binary |
k9s |
Opening a GKE cluster in k9s | --k9s-binary |
kubectl |
Checking whether your kubeconfig already has a kube context (the entry kubectl and k9s use to reach a cluster) for the GKE cluster before k9s opens |
--kubectl-binary |
cloud-sql-proxy |
Cloud SQL tunnels | --cloud-sql-proxy-binary |
wl-copy, xclip or xsel |
Copying to the clipboard on Linux. macOS uses pbcopy. |
none |
Check the install
Section titled “Check the install”nuvem --versionnuvem infonuvem info prints the config, plugin, log and cache paths nuvem uses, and
any warning about your config file. It does not start the interface. Next,
read First run.
nuvem is released under the MIT License. The source is on GitHub.
nuvem is an independent project, not affiliated with or endorsed by Google. Google Cloud is a trademark of Google LLC.