Skip to main content

Docker Import

Stable

Type: DEVRAMPS:DOCKER:IMPORT

Category: build

Version: 1.0.0

Description​

Imports an external Docker image from ECR.

Polls an external ECR repository for a Docker image and copies it to DevRamps-managed ECR storage. This allows integration with external build systems or importing pre-built images from other AWS accounts.

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

Source expressions can reference trigger context (e.g., ${{ trigger.sha }}) for dynamic image tags.

Parameters​

Required Parameters​

ParameterTypeDescription
source_image_urlstringFull ECR URI of the source image (supports expressions like ${{ trigger.sha }})
timeout_minutesnumberMaximum time to wait for the image to be available

Example Usage​

artifacts:
  external-image:
    type: DEVRAMPS:DOCKER:IMPORT
    per_stage: true
    params:
      source_image_url: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:${{ trigger.sha }}
      timeout_minutes: 15