Images Bundled Service Modernization and Migration Support
What's New in this Release
This release introduces support for a modernized, open-source Image Processing service (Pillow) running on Google Cloud Run as a drop-in replacement for the legacy App Engine Images bundled service.
🚀 Key Features & Enhancements
- Cloud Run Backend Routing
- Configures the App Engine SDK to route image transformation requests to a customer-hosted Cloud Run instance.
- Utilizes the same gRPC service definition interface as the legacy backend to minimize integration friction.
Backward Compatibility (Default)
SDK changes are backward compatible by default. Upgrading the SDK without setting the environment variable will retain standard legacy behavior.
⚠️ Breaking Changes & Limitations
API Exception Handling
Calls to get_serving_url() after enabling this feature will throw a RuntimeException. Users must transition to serving directly from Cloud Storage (GCS) or Cloud CDN.
⚙️ How to Enable
To use the custom Cloud Run service as the backend for image processing, add the following environment variables to your app.yaml:
env_variables:
APPENGINE_USE_CUSTOM_IMAGES_GRPC_SERVICE: 'true'
APPENGINE_IMAGES_SERVICE_ENDPOINT: '<your-service-name.region.run.app>'
For more details, please refer to : Official Migration Guide
Changelog
- Commits by @manuskc in #152
- Full Changelog: v2.0.1...v3.0.2
Contributors
manuskc