Bundle Import

Type: DEVRAMPS:BUNDLE:IMPORT

Category: build

Version: 1.0.0

---

Description

Imports an external bundle file from S3.

Polls an external S3 bucket for a bundle file and copies it to DevRamps-managed S3 storage. This allows integration with external build systems or importing pre-built bundles from other AWS accounts.

The executor will poll the source S3 at ~30 second intervals until the object is found or the timeout is reached. Once found, the object is copied to the CI/CD account S3 (or directly to the stage account for per-stage artifacts).

Source expressions can reference trigger context (e.g., ${{ trigger.sha }}) or stage context (e.g., ${{ stage.name }}) for dynamic paths.

Parameters

Required Parameters

Parameter	Type	Description
source_s3_url	string	Full S3 URI of the source bundle (supports expressions like ${{ trigger.sha }})
source_account	string	AWS account ID where the source bundle resides
source_region	string	AWS region where the source bundle resides
timeout_minutes	number	Maximum time to wait for the bundle to be available

Example Usage

artifacts:
  external-bundle:
    type: DEVRAMPS:BUNDLE:IMPORT
    per_stage: true
    params:
      source_account: "123456789012"
      source_region: "us-west-2"
      source_s3_url: s3://acme-builds/${{ stage.name }}/bundle-${{ trigger.sha }}.zip
      timeout_minutes: 15