Registry /
aws / aws-cdk-aws-apprunner-alpha
Install & Compatibility
Where this runs
tested against v2.260.0a0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 361.5MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 17.2s · import 0.000s · 362MB
399MB installed
● package 399MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
alpha
✓ import aws_cdk.aws_apprunner_alpha as apprunner_alpha
✗ from aws_cdk import aws_apprunner_alpha
Makes symbol resolution ambiguous; use recommended alias pattern.
AppRunnerService
✓ from aws_cdk.aws_apprunner_alpha import AppRunnerService
✗ from aws_cdk.aws_apprunner import AppRunnerService
App Runner in CDK is only available via alpha module; stable module does not exist.
Minimal CDK stack creating an App Runner service from a GitHub repository.
import aws_cdk as cdk
from aws_cdk.aws_apprunner_alpha import AppRunnerService, Source, SourceCodeBuild
class MyStack(cdk.Stack):
def __init__(self, scope, id, **kwargs):
super().__init__(scope, id, **kwargs)
AppRunnerService(self, 'Service',
source=Source.from_asset({
'location': './app',
'source_code_provider': SourceCodeBuild({
'repository': 'https://github.com/example/repo',
'branch': 'main'
})
})
)
app = cdk.App()
MyStack(app, 'MyAppRunnerStack')
app.synth()
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'aws_cdk.aws_apprunner_alpha'
Package not installed or wrong Python environment.
fixpip install aws-cdk-aws-apprunner-alpha
jsii.errors.JSIIError: Expected a value of type @aws-cdk/aws-apprunner-alpha.Service but received ...
Mixing constructs from different CDK versions.
fixEnsure all CDK packages (aws-cdk-lib, aws-cdk-aws-apprunner-alpha) are the same version.
TypeError: __init__() got an unexpected keyword argument 'source'
Using an older version that used 'source_configuration' instead of 'source'.
fixUpgrade to latest version: pip install --upgrade aws-cdk-aws-apprunner-alpha
Upgrade
Version history
2.260.0a0latest on PyPI · released Jun 16, 2026
Audit
Dependencies
aws-cdk-librequiredRequired peer dependency for CDK constructs.
constructsrequiredRequired peer dependency for construct base classes.