emicklei / gcloudx

extra features for accessing the Google Cloud Platform

gcloudx

extra features for accessing the Google Cloud Platform

requirements

Authenticated GCP user account with relevant permissions.

gcloud auth application-default login

install

go install github.com/emicklei/gcloudx/cmd/gcloudx@latest

pubsub - publish

gcloudx pubsub publish -h

NAME:
gcloudx pubsub publish - publish a document from file

USAGE:
gcloudx pubsub publish [command options] [arguments...]

OPTIONS:
-p value  GCP project identifier
-t value  PubSub topic identifier (short name)
-f value  File containing the payload

pubsub - pullpush

NAME:
gcloudx pubsub pullpush - pulls messages from a subscription and pushes them to a HTTP endpoint

USAGE:
gcloudx pubsub pullpush [command options] [arguments...]

OPTIONS:
-p value  GCP project identifier
-t value  PubSub topic identifier (short name)
-f value  subscription filter using a CEL expression
-u value  PubSub Push subscription URL

Example filter expression

-f "attributes[\"x-ag5-cloudevent-data-category\"] == \"entity_change\" "

iam

gcloudx iam roles -h   

NAME:
gcloudx iam roles - list all permissions assigned to a member

USAGE:
gcloudx iam roles [arguments...]

examples

Find all owners

gcloudx iam owners

bq

gcloudx bq deps -h  

NAME:
gcloudx bq deps - bq deps PROJECT(.|:)DATASET.VIEW,...

USAGE:
gcloudx bq deps [command options] [arguments...]

OPTIONS:
-o value  output file with DOT notation (default: "bigquery.dot")

examples

Open a graph diagram with all dependencies found frmo a given BigQuery view

gcloudx bq deps -o g.dot myproject-id.my_dataset.my_view && cat g.dot | dot -Tpng > gcloudx-deps-bigquery.png && open gcloudx-deps-bigquery.png

spanner

gcloudx spanner dml -h

NAME:
    gcloudx spanner dml - execute a long runnning DML query

USAGE:
    gcloudx spanner dml [command options] [arguments...]

OPTIONS:
    -d value    Spanner|BQ full database identifier
    -f value    File containing the payload
    --help, -h  show help

emulator

The client libraries used in gcloudx are able to use the emulator version of the service. For example, see for pub/sub.

© 2022 ernestmicklei.com MIT License.