{"id":20972,"library":"aws-cdk-aws-apprunner-alpha","title":"AWS CDK App Runner Alpha","description":"Alpha version of the CDK Construct Library for AWS App Runner, allowing deployment of containerized web applications and APIs. Current version 2.251.0a0, release follows CDK releases.","status":"active","version":"2.251.0a0","language":"python","source_language":"en","source_url":"https://github.com/aws/aws-cdk/tree/main/packages/%40aws-cdk/aws-apprunner-alpha","tags":["aws","cdk","apprunner","alpha","cloud"],"install":[{"cmd":"pip install aws-cdk-aws-apprunner-alpha","lang":"bash","label":"Install alpha module"}],"dependencies":[{"reason":"Required peer dependency for CDK constructs.","package":"aws-cdk-lib","optional":false},{"reason":"Required peer dependency for construct base classes.","package":"constructs","optional":false}],"imports":[{"note":"Makes symbol resolution ambiguous; use recommended alias pattern.","wrong":"from aws_cdk import aws_apprunner_alpha","symbol":"alpha","correct":"import aws_cdk.aws_apprunner_alpha as apprunner_alpha"},{"note":"App Runner in CDK is only available via alpha module; stable module does not exist.","wrong":"from aws_cdk.aws_apprunner import AppRunnerService","symbol":"AppRunnerService","correct":"from aws_cdk.aws_apprunner_alpha import AppRunnerService"}],"quickstart":{"code":"import aws_cdk as cdk\nfrom aws_cdk.aws_apprunner_alpha import AppRunnerService, Source, SourceCodeBuild\n\nclass MyStack(cdk.Stack):\n    def __init__(self, scope, id, **kwargs):\n        super().__init__(scope, id, **kwargs)\n        AppRunnerService(self, 'Service',\n            source=Source.from_asset({\n                'location': './app',\n                'source_code_provider': SourceCodeBuild({\n                    'repository': 'https://github.com/example/repo',\n                    'branch': 'main'\n                })\n            })\n        )\n\napp = cdk.App()\nMyStack(app, 'MyAppRunnerStack')\napp.synth()","lang":"python","description":"Minimal CDK stack creating an App Runner service from a GitHub repository."},"warnings":[{"fix":"Use pip install aws-cdk-aws-apprunner-alpha instead of @aws-cdk/aws-apprunner-alpha.","message":"Module prefix changed from @aws-cdk/aws-apprunner-alpha to aws-cdk-aws-apprunner-alpha in v2.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Update imports to from aws_cdk.aws_apprunner_alpha import ...","message":"Construct path changed: now under aws_cdk.aws_apprunner_alpha (lowercase, underscore) vs previous aws_cdk.aws_apprunner (no alpha suffix, different casing).","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Pin exact version in requirements.txt and review changelog before upgrading.","message":"Alpha modules are not subject to semantic versioning and may have breaking changes in minor releases.","severity":"gotcha","affected_versions":"all"},{"fix":"Always pass keyword arguments: source=Source.from_asset({...})","message":"Source.from_asset() expects a dictionary with 'location' and 'source_code_provider' keys; ordering of arguments is strict.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install aws-cdk-aws-apprunner-alpha","cause":"Package not installed or wrong Python environment.","error":"ModuleNotFoundError: No module named 'aws_cdk.aws_apprunner_alpha'"},{"fix":"Ensure all CDK packages (aws-cdk-lib, aws-cdk-aws-apprunner-alpha) are the same version.","cause":"Mixing constructs from different CDK versions.","error":"jsii.errors.JSIIError: Expected a value of type @aws-cdk/aws-apprunner-alpha.Service but received ..."},{"fix":"Upgrade to latest version: pip install --upgrade aws-cdk-aws-apprunner-alpha","cause":"Using an older version that used 'source_configuration' instead of 'source'.","error":"TypeError: __init__() got an unexpected keyword argument 'source'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}