Skip to content

Latest commit

 

History

History
77 lines (52 loc) · 2.25 KB

README.md

File metadata and controls

77 lines (52 loc) · 2.25 KB

AMI Update Resource

A Concourse CI resource to check for new Amazon Machine Images (AMI).

Source Configuration

  • aws_access_key_id: Your AWS access key ID.

  • aws_secret_access_key: Your AWS secret access key.

  • region: Required. The AWS region to search for AMIs.

  • filters: Required. A map of named filters to their values. Check the AWS CLI describe-images documentation for a complete list of acceptable filters and values.

If aws_access_key_id and aws_secret_access_key are both absent, AWS CLI will fall back to other authentication mechanisms. See Configuration setting and precedence

Behaviour

check: Check for new AMIs

Searches for AMIs that match the provided source filters, ordered by their creation date. The AMI ID serves as the resulting version.

Parameters

None.

in: Fetch the description of an AMI

Places the following files in the destination:

  • output.json: The complete AMI description object in JSON format. Check the AWS CLI describe-images documentation for examples.

  • id: A plain text file containing the AMI ID, e.g. ami-5731123e

  • packer.json: The AMI ID in Packer var-file input format, typically for use with packer-resource, e.g.

    {"source_ami": "ami-5731123e"}

Parameters

None.

Example

This pipeline will check for a new Ubuntu 14.04 LTS AMI in the Sydney region every hour, triggering the next step of the build plan if it finds one.

resource_types:
- name: ami
  type: docker-image
  source:
    repository: jdub/ami-resource

resources:
- name: ubuntu-ami
  type: ami
  check_every: 1h
  source:
    aws_access_key_id: "..."
    aws_secret_access_key: "..."
    region: ap-southeast-2
    filters:
      owner-id: "099720109477"
      is-public: true
      state: available
      name: ubuntu/images/hvm-ssd/ubuntu-trusty-*server*

jobs:
- name: my-ami
  plan:
  - get: ubuntu-ami
    trigger: true
  - task: build-fresh-image
    ...