Google Firebase Terraform Module

Terraform module for managing Firebase resources on top of an existing GCP project.

What This Module Supports

• Initializing Firebase on an existing GCP project
• Firebase Authentication configuration
• Firestore databases and documents
• Firebase Storage bucket linking
• Firebase Rules ruleset and release management
• Multiple Firebase iOS app registrations
• Multiple Firebase Android app registrations
• Firebase mobile app config artifact retrieval

Existing Project Requirement

This module does not create a GCP project. You must pass an existing project ID via project_id.

Usage

module "firebase" {
  source     = "../../"
  project_id = "existing-firebase-project-id"
  fetch_mobile_app_config = true

  firebase_ios_apps = [
    {
      display_name = "My iOS App"
      bundle_id    = "com.example.ios"
    },
    {
      display_name = "My iOS App Staging"
      bundle_id    = "com.example.ios.staging"
      team_id      = "ABCDE12345"
    }
  ]

  firebase_android_apps = [
    {
      display_name = "My Android App"
      package_name = "com.example.android"
    },
    {
      display_name  = "My Android App Staging"
      package_name  = "com.example.android.staging"
      sha1_hashes   = var.android_staging_sha1_hashes
      sha256_hashes = var.android_staging_sha256_hashes
    }
  ]
}

Requirements

Name	Version
google	~> 6.0
google-beta	~> 6.0

Providers

Name	Alias	Notes
google	no_user_project_override	Used for API enablement with user project override disabled
google	default	Used for GA resources
google-beta	default	Used for Firebase beta-backed resources/data sources

Resources

Name	Type
google_project_service.required_apis	resource
google_firebase_project.this	resource
google_firebase_apple_app.this	resource
google_firebase_android_app.this	resource
google_identity_platform_config.this	resource
google_firestore_database.this	resource
google_firestore_document.this	resource
google_firestore_document.subdocs	resource
google_storage_bucket.this	resource
google_firebase_storage_bucket.this	resource
google_firebaserules_ruleset.this	resource
google_firebaserules_release.this	resource
google_firebase_apple_app_config.this	data source
google_firebase_android_app_config.this	data source

Inputs

Name	Type	Default	Description
project_id	string	n/a	Existing GCP project ID where Firebase resources are managed.
firebase_auth	object	null	Optional Firebase Authentication configuration (providers, duplicate email behavior, test phone numbers).
firestore_config	object	{}	Optional Firestore configuration (databases, root documents, and nested subdocuments).
firebase_storage	list(object)	[]	Optional Firebase Storage bucket definitions (name, location, labels).
firebase_rules	list(object)	[]	Optional Firebase rules definitions (id, name, language, content, fingerprint).
fetch_mobile_app_config	bool	false	Whether to fetch iOS/Android app config artifacts after app creation.
firebase_ios_apps	list(object)	[]	Optional list of Firebase iOS apps (display_name, bundle_id, optional app_store_id/team_id/deletion_policy). bundle_id values must be unique.
firebase_android_apps	list(object)	[]	Optional list of Firebase Android apps (display_name, package_name, optional sha1_hashes/sha256_hashes/deletion_policy). package_name values must be unique.

Outputs

Name	Description	Sensitive
project_id	Project ID in projects/{{project_id}} format.	No
ios_apps	Map of created Firebase iOS apps keyed by bundle ID.	No
android_apps	Map of created Firebase Android apps keyed by package name.	No
ios_app_config	Map of iOS app config artifacts keyed by bundle ID (base64 config content). Empty map when fetch_mobile_app_config is false.	Yes
android_app_config	Map of Android app config artifacts keyed by package name (base64 config content). Empty map when fetch_mobile_app_config is false.	Yes

License

Apache 2. See LICENSE.