Skip to main content

Google Cloud Connector

The Google Cloud connector ingests cloud resources from a Google Cloud Platform organization, folder, or project into the Context Catalog. It runs through the ibdm binary in one of two modes:

  • Sync — pull-based: enumerates resources via the Cloud Asset REST APIs and exits.
  • Run — push-based: subscribes to a Pub/Sub topic that receives events from a Cloud Asset Feed.

Commands

ibdm sync gcp --mapping-file <path to mapping file or folder>
ibdm run gcp --mapping-file <path to mapping file or folder>

Configuration

VariableRequiredDescription
GOOGLE_CLOUD_SYNC_PARENTSyncName of the organization, folder, or project containing the resources to sync. Must be one of organizations/{org-number}, folders/{folder-number}, projects/{project-id}, or projects/{project-number}.
GOOGLE_CLOUD_PUBSUB_PROJECTRunProject hosting the Pub/Sub subscription.
GOOGLE_CLOUD_PUBSUB_SUBSCRIPTIONRunName of the Pub/Sub subscription the source consumes events from.
GOOGLE_APPLICATION_CREDENTIALSOptionalPath to a service-account key file, used by Application Default Credentials.

Authentication

The source authenticates through Application Default Credentials (ADC). You can supply credentials in any of the standard ADC ways, including pointing GOOGLE_APPLICATION_CREDENTIALS at a service-account key file. The principal must have read access to the resources you intend to ingest.

See also