---
id: aws-cdk-aws-apprunner-alpha
version: "2.265.0a0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-apprunner-alpha — The CDK Construct Library for AWS::AppRunner

License: permissive · Maintenance: active · Downloads: 93.4K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 93.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws app runner cdk, containerized app deployment cdk, ecr app runner construct, github app runner deploy, aws cdk apprunner, container service infrastructure as code, app runner vpc connector, aws-cdk, infrastructure-as-code, container-deployment

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-apprunner-alpha) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-apprunner-alpha/)