ign8google

Google Cloud integration for the ign8 ecosystem. Manage GCP projects and API keys from the CLI or a full-screen TUI.

Install

pip install ign8google

Authenticate

ign8google uses Application Default Credentials. Authenticate once with:

gcloud auth application-default login

The caller needs the roles/serviceusage.apiKeysAdmin role (or equivalent) on the target project, and the apikeys.googleapis.com service must be enabled.

Usage

Pick a project

ign8google projects list
ign8google projects use my-gcp-project
# or create a new one
ign8google projects create my-gcp-project --billing AAAAAA-BBBBBB-CCCCCC --use

Selection persists to .ign8google/state.json. IGN8_GOOGLE_PROJECT in .env or --project on any command overrides it.

Manage API keys

# Create a server-restricted key for Google Maps backend usage
ign8google keys create maps-server \
    --allow-ip 203.0.113.10 \
    --allow-ip 198.51.100.7 \
    --allow-api directions.googleapis.com \
    --allow-api distancematrix.googleapis.com \
    --allow-api geocoding-backend.googleapis.com \
    --write-env GOOGLE_MAPS_API_KEY_SERVER

ign8google keys list
ign8google keys show   maps-server
ign8google keys delete maps-server

TUI

ign8google tui

Bindings:

• ↑/↓ move within the focused pane, Tab switches panes
• Enter on a project — load its keys
• u set the highlighted project as active
• n new (project or key, depending on focused pane), e edit key, d delete, r reveal key string
• F5 refresh, q quit