runway.lookups.handlers.ecr module

Retrieve a value from AWS Elastic Container Registry (ECR).

This Lookup only supports very specific queries.

Supported Queries

login-password

Get a password to login to ECR registry.

The returned value can be passed to the login command of the container client of your preference, such as the Docker CFNgin hook. After you have authenticated to an Amazon ECR registry with this Lookup, you can use the client to push and pull images from that registry as long as your IAM principal has access to do so until the token expires. The authorization token is valid for 12 hours.

Arguments

This Lookup does not support any arguments.

Example

runway.yml
deployments:
  - modules:
      - path: example.cfn
        parameters:
          ecr_password: ${ecr login-password}
    ...
cfngin.yml
pre_build:
  - path: runway.cfngin.hooks.docker.login
    args:
      password: ${ecr login-password}
      ...
class runway.lookups.handlers.ecr.EcrLookup[source]

Bases: runway.lookups.handlers.base.LookupHandler

ECR Lookup.

static get_login_password(client)[source]

Get a password to login to ECR registry.

classmethod handle(value, context, **_)[source]

Retrieve a value from AWS Elastic Container Registry (ECR).

Parameters
  • value – The value passed to the Lookup.

  • context – The current context object.