aws-cdk.aws-apprunner-alpha

What it is and what it does

This package is an experimental AWS CDK construct library for App Runner, a fully managed service that deploys and scales containerized web applications without requiring infrastructure expertise. It wraps the low-level CloudFormation resources into higher-level Python constructs, letting you define App Runner services declaratively in your CDK stacks.

The library supports multiple deployment sources: ECR repositories, ECR Public images, GitHub repositories with CI/CD integration, and local Docker asset directories. It also provides constructs for configuring auto-scaling, VPC connectivity, IAM roles, and private ingress endpoints. The package is marked as experimental and subject to breaking changes across versions, so production use requires awareness of potential migration costs when upgrading.

Use it for:

• Deploy a containerized web application from an ECR Public image with automatic load balancing and scaling.
• Set up continuous deployment from a GitHub repository with App Runner handling builds and container orchestration.
• Build and push a local Docker image to ECR, then deploy it as an App Runner service with auto-scaling configuration.
• Create a private App Runner service accessible only from within a VPC using VPC connectors and ingress endpoints.
• Define IAM roles and policies for an App Runner service to access other AWS resources like S3 buckets.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides AWS CDK constructs for deploying containerized applications to AWS App Runner with support for ECR, ECR Public, GitHub, and local Docker assets as deployment sources.

Yes, if you are using AWS CDK and need to deploy containerized applications to App Runner. The low install friction, active maintenance, and permissive license make it straightforward to adopt. However, the experimental status means you should expect potential breaking changes in future releases and plan for code updates when upgrading versions.

Install

aws-cdk-aws-apprunner-alpha on PyPI

pip install aws-cdk-aws-apprunner-alpha

uv add aws-cdk-aws-apprunner-alpha

poetry add aws-cdk-aws-apprunner-alpha

Installing aws-cdk.aws-apprunner-alpha

Before you install

Released 1 day ago with active maintenance; low install friction and a pure-Python wheel distribution. Requires Python 3.10 or later and depends on aws-cdk-lib, constructs, jsii, and publication.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart

pip install aws-cdk.aws-apprunner-alpha

import aws_cdk.aws_apprunner_alpha as apprunner

service = apprunner.Service(self, "MyService",
    source=apprunner.Source.from_ecr_public(
        image_configuration=apprunner.ImageConfiguration(port=8000),
        image_identifier="public.ecr.aws/aws-containers/hello-app-runner:latest"
    )
)

Requires Python 3.10 or later and an existing AWS CDK stack context (self parameter must be a valid CDK Construct).

Verify before relying

• Whether the alpha stability banner means breaking changes are expected in near-term releases
• Whether all four source types (ECR, ECR Public, GitHub, asset) are equally mature or if some have known limitations

Package facts

Evidence: aws_cdk_aws_apprunner_alpha-2.265.0a0-py3-none-any.whl

Tags

More Application Frameworks packages