Skip to content

Enable SOCI lazy loading by default on ECS service modules #124

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mabadir wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Enable SOCI lazy loading by default on ECS service modules #124

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
6643f63
introduce soci
mabadir Aug 27, 2026
7fe3484
Drop the small-image caveat from soci_enabled guidance
mabadir Aug 27, 2026
7890ab6
Merge remote-tracking branch 'origin/main' into mabadir/soci-enabled
mabadir Aug 27, 2026
c69cb87
Merge branch 'main' into mabadir/soci-enabled
mabadir Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,9 @@ sync by `node tools/ravion-modules/dist/src/cli.js readme` (enforced in CI, and
| `rvn-cloudfront` | CloudFront CDN | v1.3.0 | `cdn/cloudfront/` |
| `rvn-ec2-service` | EC2 Service | v1.4.1 | `compute/ec2_service/` |
| `rvn-ecs-cluster` | ECS Cluster | v1.0.1 | `compute/ecs_cluster/` |
| `rvn-ecs-nlb` | ECS Network Service | v1.1.1 | `compute/ecs_service/` |
| `rvn-ecs-web` | ECS Web Service | v1.1.0 | `compute/ecs_service/` |
| `rvn-ecs-worker` | ECS Worker | v1.1.0 | `compute/ecs_service/` |
| `rvn-ecs-nlb` | ECS Network Service | v1.2.0 | `compute/ecs_service/` |
| `rvn-ecs-web` | ECS Web Service | v1.2.0 | `compute/ecs_service/` |
| `rvn-ecs-worker` | ECS Worker | v1.2.0 | `compute/ecs_service/` |
| `rvn-efs` | EFS File System | v1.0.1 | `storage/efs/` |
| `rvn-elasticache` | ElastiCache | v1.0.1 | `cache/elasticache/` |
| `rvn-lambda` | Lambda Function | v1.1.0 | `compute/lambda/` |
Expand Down
8 changes: 5 additions & 3 deletions compute/ecs_service/rvn-ecs-nlb-definition.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ definition:
name: ECS Network Service
description: Network Load Balanced ECS service for exposing one to five TCP, UDP, or TLS ports through an ECS cluster Network Load Balancer.
release:
version: 1.1.1
description: Clarify that one ECS Network Service can expose up to five TCP, UDP, or TLS ports.
version: 1.2.0
description: Enable SOCI lazy loading by default so Fargate starts tasks before the full image finishes downloading, cutting task startup time. The larger the image the more it saves. Turn it off for EC2 capacity.
module:
inputs:
- id: section_cluster
Expand Down Expand Up @@ -333,7 +333,9 @@ module:
destroy:
pipeline_id: << defaults.destroy_pipeline_id >>
build:
$include: ../../partials/build/ecs-service-image-build.yml
$merge:
- ../../partials/build/ecs-service-image-build.yml
soci_enabled: << module.input.soci_enabled >>
deploy:
$merge:
- ../../partials/deploy/ecs-service-deploy-common.yml
Expand Down
8 changes: 5 additions & 3 deletions compute/ecs_service/rvn-ecs-web-definition.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ definition:
name: ECS Web Service
description: Web server ECS service for running an HTTP application behind an ECS cluster load balancer.
release:
version: 1.1.0
description: Add Builder IAM policies inputs that attach extra IAM managed policies to the EC2 build runner role or replace the step default policies entirely for the duration of each build.
version: 1.2.0
description: Enable SOCI lazy loading by default so Fargate starts tasks before the full image finishes downloading, cutting task startup time. The larger the image the more it saves. Turn it off for EC2 capacity.
module:
inputs:
- id: section_cluster
Expand Down Expand Up @@ -366,7 +366,9 @@ module:
destroy:
pipeline_id: << defaults.destroy_pipeline_id >>
build:
$include: ../../partials/build/ecs-service-image-build.yml
$merge:
- ../../partials/build/ecs-service-image-build.yml
soci_enabled: << module.input.soci_enabled >>
deploy:
$merge:
- ../../partials/deploy/ecs-service-deploy-common.yml
Expand Down
8 changes: 5 additions & 3 deletions compute/ecs_service/rvn-ecs-worker-definition.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ definition:
name: ECS Worker
description: Background worker ECS service for running private container workloads without exposed ports.
release:
version: 1.1.0
description: Add Builder IAM policies inputs that attach extra IAM managed policies to the EC2 build runner role or replace the step default policies entirely for the duration of each build.
version: 1.2.0
description: Enable SOCI lazy loading by default so Fargate starts tasks before the full image finishes downloading, cutting task startup time. The larger the image the more it saves. Turn it off for EC2 capacity.
module:
inputs:
- id: section_cluster
Expand Down Expand Up @@ -74,7 +74,9 @@ module:
destroy:
pipeline_id: << defaults.destroy_pipeline_id >>
build:
$include: ../../partials/build/ecs-service-image-build.yml
$merge:
- ../../partials/build/ecs-service-image-build.yml
soci_enabled: << module.input.soci_enabled >>
deploy:
$merge:
- ../../partials/deploy/ecs-service-deploy-common.yml
Expand Down
11 changes: 11 additions & 0 deletions partials/inputs/ecs-service-builder-ecr-misc-inputs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,17 @@
- dockerfile
- railpack
- nixpacks
- id: soci_enabled
label: SOCI lazy loading
type: boolean
description: Build a SOCI-enabled image so Fargate can lazily load it, starting tasks before the full image is downloaded. On by default, and the larger the image the more it saves. Turn it off for EC2 capacity, where the gzip layer compression SOCI requires makes builds slower without speeding up task startup. Lazy loading also changes how long tasks take to report healthy, so services behind a load balancer may need a longer health check grace period.
collapsible: true
show_when:
build_source:
- dockerfile
- railpack
- nixpacks
default: true
Comment on lines +9 to +19

@flybayer flybayer Aug 29, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should not expose this control and just enabled for fargate, disable for ec2

- id: section_ecr
label: Image registry lifecycle
type: section
Expand Down
Loading