/aminator

A tool for creating EBS AMIs. This tool currently works for CentOS/RedHat Linux images and is intended to run on an EC2 instance.

Primary LanguagePythonApache License 2.0Apache-2.0

aminator - Easily create application-specific custom AMIs

Aminator creates a custom AMI from just:

  • A base ami ID
  • A link to a deb or rpm package that installs your application.

This is useful for many AWS workflows, particularly ones that take advantage of auto-scaling groups.

Requirements

  • Python 2.6+ (Python 3.x support not yet available)
  • Linux or UNIX cloud instance (EC2 currently supported)

Installation

Clone this repository and run:

# python setup.py install

or

# pip install git+https://github.com/Netflix/aminator.git#egg=aminator

Usage

usage: aminate [-h] [-e ENVIRONMENT] [--version] [--debug] [-n NAME]
               [-s SUFFIX] [-c CREATOR] (-b BASE_AMI_NAME | -B BASE_AMI_ID)
               [--ec2-region REGION] [--boto-secure] [--boto-debug]
               package

positional arguments:
  package               package to aminate. A string resolvable by the native
                        package manager or a file system path or http url to
                        the package file.

optional arguments:
  -h, --help            show this help message and exit
  -e ENVIRONMENT, --environment ENVIRONMENT
                        The environment configuration for amination
  --version             show program's version number and exit
  --debug               Verbose debugging output

AMI Tagging and Naming:
  Tagging and naming options for the resultant AMI

  -n NAME, --name NAME  name of resultant AMI (default package_name-version-
                        release-arch-yyyymmddHHMM-ebs
  -s SUFFIX, --suffix SUFFIX
                        suffix of ami name, (default yyyymmddHHMM)
  -c CREATOR, --creator CREATOR
                        The user who is aminating. The resultant AMI will
                        receive a creator tag w/ this user

Base AMI:
  EITHER AMI id OR name, not both!

  -b BASE_AMI_NAME, --base-ami-name BASE_AMI_NAME
                        The name of the base AMI used in provisioning
  -B BASE_AMI_ID, --base-ami-id BASE_AMI_ID
                        The id of the base AMI used in provisioning

EC2 Options:
  EC2 Connection Information

  --ec2-region REGION   EC2 region (default: us-east-1)
  --boto-secure         Connect via https
  --boto-debug          Boto debug output

Details

The rough amination workflow:

  1. Create a volume from the snapshot of the base AMI
  2. Attach and mount the volume
  3. Chroot into mounted volume
  4. Provision application onto mounted volume using rpm or deb package
  5. Unmount the volume and create a snapshot
  6. Register the snapshot as an AMI

Support

Documentation

See the aminator wiki for documentation

License

Copyright 2013 Netflix, Inc.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.