Skip to content

A terminal UI for Google Cloud

Browse and operate your Google Cloud projects from the keyboard, in the spirit of k9s. nuvem works with the gcloud configurations you already have, and shows you what it is about to do before it changes anything.

brew install filipeaaoliveira/tap/nuvem

Homebrew on macOS and Linux. Or install with cargo, download a release binary, or build from source.

Try it first with nuvem --demo, on sample data with no account. Your own projects need the gcloud CLI, signed in. See First run.

nuvem --demo
┌Inventory───────────────────────
│GCE instances          10 loaded
│GKE clusters           5 loaded 
│Cloud SQL              7 loaded 
│Cloud Run              7 loaded 
│Cloud Storage          7 loaded 
│Secret Manager         7 loaded 
│Cloud Functions        7 loaded 
│Persistent disks       8 loaded 
│Pub/Sub topics         6 loaded 
│Pub/Sub subscriptions  8 loaded 
│BigQuery datasets      5 loaded 
│Service accounts       9 loaded 
│IAM policy             12 loaded
│VPC networks           4 loaded 
│VPC subnets            7 loaded 
│Firewall rules         8 loaded 
└────────────────────────────────
nuvem  Home
Configuration: dev  Project: dev-project  Account: dev@example.com  Region: europe-west1  Zone: europe-west1-b
Home
┌Context─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│Configuration: dev                                                                                                                      │
│Account: dev@example.com                                                                                                                │
│Region/Zone: europe-west1/europe-west1-b                                                                                                │
│Project: dev-project                                                                                                                    │
│gcloud: available (dev@example.com)                                                                                                     │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
┌Inventory───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│GCE instances          10 loaded  Pending 1  Running 7  Stopped 1  Suspended 1                                                          │
│GKE clusters           5 loaded  Provisioning 1  Reconciling 1  Running 3                                                               │
│Cloud SQL              7 loaded  Maintenance 1  Runnable 5  Stopped 1                                                                   │
│Cloud Run              7 loaded  Not ready 1  Ready 5  Reconciling 1                                                                    │
│Cloud Storage          7 loaded                                                                                                         │
│Secret Manager         7 loaded                                                                                                         │
│Cloud Functions        7 loaded  Active 5  Deploying 1  Failed 1                                                                        │
│Persistent disks       8 loaded  Ready 7  Restoring 1                                                                                   │
│Pub/Sub topics         6 loaded                                                                                                         │
│Pub/Sub subscriptions  8 loaded  Active 7  Resource error 1                                                                             │
│BigQuery datasets      5 loaded                                                                                                         │
│Service accounts       9 loaded                                                                                                         │
│IAM policy             12 loaded                                                                                                        │
│VPC networks           4 loaded                                                                                                         │
│VPC subnets            7 loaded                                                                                                         │
│Firewall rules         8 loaded                                                                                                         │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
┌Recent operations───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│No recent operations                                                                                                                    │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
[OK] Home
Updated: just now
r Refresh  g Resources  c Configurations  q Quit                                                                 : Command palette  ? Help
A tour of nuvem --demo on its built-in sample data: Home, a resource list, a filter, a detail view, a Stop confirmation, BigQuery tables and help. Open it full size.

Press a key

Real screens from nuvem --demo, set as text. Click a key, or move to the keys with Tab and type one.

Services (g)

nuvem  Resources
Configuration: dev  Project: dev-project  Account: dev@example.com  Service: GCE instances  Region: europe-west1  Zone: europe-west1-b
Home > Resources > GCE instances
┌Service navigator─────────┐Filter: none   Sort: Name ▲   Rows: 10/10   ←/→ col · s sort   +1 cols (w)         ┌Preview──────────────────┐
│  Analytics               │┌Resources / GCE instances────────────────────────────────────────────────────────┐│api-dev-1                │
│  BigQuery datasets       ││      [NAME▲]          STATUS     ZONE            MACHINE-TYPE   INTERNAL-IP     ││Status: Running          │
│  Compute                 ││>     api-dev-1        Running    europe-west1-b  e2-medium      10.132.0.4      ││Zone: europe-west1-b     │
│> GCE instances           ││      bastion          Running    europe-west1-b  e2-micro       10.132.0.2      ││Machine Type: e2-medium  │
│  Containers              ││      batch-runner     Running    europe-west1-d  n2-standard-4  10.132.0.21     ││Internal IP: 10.132.0.4  │
│  GKE clusters            ││      ci-runner-1      Suspended  us-central1-a   n2-standard-8  10.128.0.7      ││External IP: 203.0.113.20│
│  Databases               ││      file-server-a    Running    europe-west1-b  n2-standard-2  10.132.0.50     ││                         │
│  Cloud SQL               ││      file-server-b    Running    europe-west1-c  n2-standard-2  10.132.0.51     ││                         │
│  Messaging               ││      reporting-proxy  Pending    europe-west1-c  e2-small       10.132.0.30     ││                         │
│  Pub/Sub topics          ││      web-frontend-1   Running    europe-west1-b  e2-standard-2  10.132.0.11     ││                         │
│  Pub/Sub subscriptions   ││      web-frontend-2   Running    europe-west1-c  e2-standard-2  10.132.0.12     ││                         │
│  Networking              ││      worker-dev-1     Stopped    europe-west1-b  e2-small       10.132.0.5      ││                         │
│  VPC networks            ││                                                                                 ││                         │
│  VPC subnets             ││                                                                                 ││                         │
│  Firewall rules          ││                                                                                 ││                         │
│  Security                ││                                                                                 ││                         │
│  Secret Manager          ││                                                                                 ││                         │
│  Service accounts        ││                                                                                 ││                         │
│  IAM policy              ││                                                                                 ││                         │
│  Serverless              ││                                                                                 ││                         │
│  Cloud Run               ││                                                                                 ││                         │
│  Cloud Functions         ││                                                                                 ││                         │
│  Storage                 ││                                                                                 ││                         │
│  Persistent disks        ││                                                                                 ││                         │
│  Cloud Storage           ││                                                                                 ││                         │
│                          ││                                                                                 ││                         │
└──────────────────────────┘└─────────────────────────────────────────────────────────────────────────────────┘└─────────────────────────┘
[OK] GCE instances
Updated: just now
Enter Open  / Filter  s Sort column  w Wide columns  ←/→ Select column  r Refresh  v Toggle sidebar              : Command palette  ? Help
┌Service navigator─────────┐
│  Analytics               │
│  BigQuery datasets       │
│  Compute                 │
│> GCE instances           │
│  Containers              │
│  GKE clusters            │
│  Databases               │
│  Cloud SQL               │
│  Messaging               │
│  Pub/Sub topics          │
│  Pub/Sub subscriptions   │
│  Networking              │
│  VPC networks            │
│  VPC subnets             │
│  Firewall rules          │
│  Security                │
│  Secret Manager          │
│  Service accounts        │
│  IAM policy              │
│  Serverless              │
│  Cloud Run               │
│  Cloud Functions         │
│  Storage                 │
│  Persistent disks        │
│  Cloud Storage           │
│                          │
└──────────────────────────┘

g opens Resources: sixteen services in a sidebar, grouped by kind, each a list you can sort. Services.

Also in nuvem

Key: lCloud Logging
Read, tail and search the project's logs. In most services, L opens the logs of the selected resource.
Key: tTunnels
Start IAP, SSH or Cloud SQL Auth Proxy port forwards from a GCE instance or Cloud SQL row, and manage them from one list.
Flag: --read-onlyRead-only mode
Refuses every change to a cloud resource, and the SSH and k9s sessions that can make one.
Key: ,Plugins
Add your own gcloud commands to a service. They run against the selected row, after a confirmation that shows the whole command line.

Configurations, FinOps, related-resource jumps and themes are in the documentation, and the Keys page lists every key.

Sixteen services

Each one is a list you can sort, and seven open to more detail.

How it works

nuvem stores no credentials of its own. gcloud issues a short-lived token for the configuration you chose, and nuvem keeps it in memory. Before anything changes, a confirmation shows what is about to run.

How nuvem reaches Google Cloud: reads go straight to Google Cloud, and everything that can change something passes a confirmation first.
nuvem

Reads

  • Client librariesLists and details for every service but BigQuery, with a short-lived token that gcloud issues and nuvem keeps in memory.
  • bq, gcloudBigQuery datasets and tables, budgets, and label-mode filters.

Confirmation

Shows what is about to run. Nothing runs until you confirm.

Changes, SSH, tunnels and sessions

  • Client librariesGCE and Cloud SQL lifecycle actions, with the same token. Shows the API call, such as compute.instances.stop.
  • gcloudConfigurations, SSH, GCE tunnels and plugins. Shows the command line; for a new or edited configuration, the values it sets.
  • cloud-sql-proxyCloud SQL tunnels. Shows the command line.
  • k9sGKE clusters. Shows the k9s command, and the gcloud command that fetches credentials when one is needed.
Google Cloud

Read more in Before a change runs, the questions about credentials and the security policy.

nuvem /ˈnu.vẽj/ noun, Portuguese: cloud.

Install

brew install filipeaaoliveira/tap/nuvem

Every method, and what nuvem needs, is on the Install page.

Then run nuvem --demo to try it on sample data, with no account, or nuvem to open your active gcloud configuration.

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.