Skip to Content
Engineering11 Documentation 🔥
BackendServer API PackagesGCP

GCP API

Google Cloud Platform utilities for project discovery, Cloud Run URLs, and App Engine metadata.

What It Does

The GCP API provides essential utilities for building applications on Google Cloud Platform. It handles intelligent project ID discovery, Cloud Run service URL generation, App Engine metadata extraction, and Identity-Aware Proxy integration—eliminating boilerplate for common GCP operations.

Key Capabilities

CapabilityDescription
Project ID DiscoveryMulti-source project ID resolution with caching
Cloud Run URL BuildingGenerate service URLs with project number and region support
App Engine MetadataExtract deployment, instance, and runtime information
IAP IntegrationOAuth audience discovery for Identity-Aware Proxy
Default LocationRegional configuration utilities
Project Number ResolutionGet numeric project identifier from Resource Manager
Environment DetectionIdentify runtime environment (Flex, Standard, Cloud Run, Functions)

Configuration

Environment Variables

  • GCP_PROJECT / GOOGLE_CLOUD_PROJECT / GCLOUD_PROJECT / PROJECT_ID: Project ID
  • FIREBASE_CONFIG: Firebase configuration with project ID
  • PROJECT_HASH: Legacy project identifier
  • PROJECT_NUMBER: Modern project identifier
  • E11_QUEUE_LOCATION: Default region override

Default Values

  • Default Region: us-central1
  • Redis Host: localhost
  • Redis Port: 6379

Exports

Classes

  • Project - Project discovery utilities
  • CloudRun - Cloud Run URL building
  • AppEngine - App Engine metadata (constants and types)

Functions

  • Project.findProjectId() - Async project discovery
  • Project.findProjectIdSync() - Sync project discovery
  • Project.findProjectNumber() - Get project number
  • Project.findProjectFlyweight() - Get complete metadata
  • Project.defaultLocation() - Get default region
  • CloudRun.buildUrl() - Generate Cloud Run URLs
  • findAppEngineAudience() - IAP audience discovery

Types and Constants

  • EnvironmentType - Flex or Standard
  • GAE_DEFAULT_LOCATION - us-central1
  • Error types

Common Use Cases

  • Service discovery: Generate Cloud Run service URLs
  • Multi-environment apps: Discover project context across GCP services
  • Regional routing: Build region-specific endpoints
  • IAP security: Find OAuth audiences for secured services
  • Metadata collection: Extract App Engine deployment information
  • Configuration: Resolve project-specific settings

What Customers Don’t Have to Build

  • Project ID discovery from multiple sources
  • Environment variable fallback logic
  • Resource Manager API integration
  • Cloud Run URL formatting
  • Region code transformation
  • App Engine metadata extraction
  • IAP OAuth audience discovery
  • Caching for project lookups
  • Default location management
  • Project number resolution
  • Flyweight metadata aggregation
Last updated on
SchedulerCDN