First run
You can start nuvem against your own gcloud configuration, or try it first with no account at all.
Try it without a project
Section titled “Try it without a project”To see the whole interface with no Google Cloud account, run:
nuvem --demoDemo mode shows built-in sample data. A command that changes a resource, such as stopping an instance, reports success but does nothing. See Demo mode.
Run it against your project
Section titled “Run it against your project”-
Make sure that gcloud has a configuration and an account:
Shell gcloud config configurations listIf the list is empty, or its
ACCOUNTcolumn is blank, rungcloud init. It signs you in and creates a configuration. -
Start nuvem:
Shell nuvemnuvem loads your gcloud configurations and opens on the active one.
-
To start on a different configuration, pass its name. nuvem asks gcloud to activate it, then reloads the configuration list:
Shell nuvem --configuration dev -
To make sure that no key you press can change a cloud resource, add
--read-only. See Read-only mode.
Find your way around
Section titled “Find your way around”nuvem is keyboard-only: it has no mouse support.
| Press | To |
|---|---|
| h | Open Home: health, inventory and recent operations |
| g | Open Resources: every service, with a list and a detail pane |
| c | Open Configurations: your gcloud configurations |
| l | Open Logging on the project’s recent logs |
| Ctrl-t | Open Tunnels |
| Ctrl-f | Open FinOps |
| : | Open the command palette and run any command by name |
| ? | Show the keys for the view you are in |
| q | Quit from Home or a list. In a detail view, q goes back to the list. |
| Ctrl-C | Quit from anywhere |
The footer shows the most useful keys for the current view. ? lists all of
them. Keys lists every key in every view.
Background refresh
Section titled “Background refresh”While Resources is open, nuvem refreshes the active service every 5 seconds.
The same tick drives the Cloud Logging tail. To change the interval, pass
--poll-interval <seconds> or set poll_interval_secs in the
config file. 0 turns background refresh
off. You can still press r to refresh, and a service still loads when you
open it.
- Reading the screen explains the header, status markers and footer.
- Browse resources shows how to move through a service.
- Config file lists every setting.
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.