package
Version:
v0.0.5
Opens a new window with list of versions in this module.
Published: Nov 7, 2025
License: MIT
Opens a new window with license information.
Imports: 5
Opens a new window with list of imports.
Imported by: 0
Opens a new window with list of known importers.
README
¶
GCP Cloud Run Plugin
Deploys containerized applications to Google Cloud Run with automatic scaling, traffic management, and service account integration.
Overview
This plugin provisions Cloud Run services with:
- Automatic scaling based on traffic
- Configurable CPU, memory, and concurrency limits
- Environment variable management
- Service account integration for secure resource access
- Flexible ingress controls
- Request timeout configuration
| Parameter |
Type |
Description |
project_id |
string |
Google Cloud Project ID (e.g. my-project-123) |
region |
string |
Google Cloud region for service deployment (e.g. us-central1) |
| Parameter |
Type |
Description |
Default |
environment |
map(string) |
Environment variables (e.g. {"NODE_ENV": "production", "API_KEY": "secret"}) |
{} |
memory_mb |
number |
Memory allocation in MB |
512 |
cpus |
number |
CPU allocation |
1 |
gpus |
number |
GPU allocation |
0 |
min_instances |
number |
Minimum instances to keep running |
0 |
max_instances |
number |
Maximum instances that can be created |
10 |
container_concurrency |
number |
Maximum concurrent requests per instance |
80 |
timeout_seconds |
number |
Maximum request timeout in seconds |
10 |
container_port |
number |
Container port number |
9001 |
ingress |
string |
Traffic ingress setting. Must be one of INGRESS_TRAFFIC_ALL, INGRESS_TRAFFIC_INTERNAL_ONLY, or INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER |
INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER |
Prerequisites
- Container image pushed to Google Container Registry or Artifact Registry
- Service account with appropriate IAM permissions (managed by
service-account plugin)
Usage Example
Note: This example shows platform file syntax. You can configure this plugin directly in the Suga Platform Builder UI without writing YAML.
services:
api:
plugin: "cloudrun"
identities:
- plugin: "service-account"
properties:
project_id: "my-project-123"
region: "us-central1"
environment:
NODE_ENV: "production"
DATABASE_URL: "postgresql://..."
memory_mb: 1024
cpus: 2
min_instances: 1
max_instances: 100
container_concurrency: 80
timeout_seconds: 300
container_port: 8080
ingress: "INGRESS_TRAFFIC_ALL"
Features
- Serverless: Pay only for the resources you use
- Auto-scaling: Automatically scales from zero to handle traffic spikes
- Security: Integrated with GCP IAM and service accounts
- Flexibility: Support for various runtime configurations and constraints
- Traffic Management: Multiple ingress options for different security requirements
References
Documentation
¶
Source Files
¶
Click to show internal directories.
Click to hide internal directories.