|Number of watchers on Github||61|
|Number of open issues||8|
|Average time to close an issue||7 days|
|Average time to merge a PR||1 day|
|Open pull requests||0+|
|Closed pull requests||0+|
|Last commit||over 3 years ago|
|Repo Created||over 4 years ago|
|Repo Last Updated||over 1 year ago|
|Organization / Author||fatih|
|Do you use images? Leave a review!|
|View open issues (8)|
|View images activity|
|View on github|
|Fresh, new opensource launches 🚀🚀🚀|
Trendy new open source projects in your inbox! View examples
Images is a tool to manage machine images from multiple providers over a single CLI interface. Its fast(concurrent actions), simple to use and very flexible. Think of it as a companion to the popular image creation tool Packer. You can fetch images from multiple providers, delete them, change tags or names of multiple images, any many other things.
Images is still under development. Any feedback/contribution is welcome! Download the latest release suitable for your system:
(Want to build & develop the source? Check out the Build&Develop section!)
To list all commands just run
$ images usage: images [--version] [--help] <command> [<args>] Available commands are: copy Copy images to regions delete Delete available images list List available images modify Modify image properties version Prints the Images version ...
images is built around to support multiple providers, each provider
has a specific set of features. To display the specific provider help message
-providers name -help flags at any time, where
name is the provider
name, such as
Current supported providers are:
images is a very flexible CLI tool. It can parse the necessary configuration from
either a file, from environment variables or command line flags. Examples:
$ images list --providers aws --regions "us-east-1,eu-west-2" --access-key "..." -secret-key "..."
or via environment variable:
$ IMAGES_PROVIDERS=aws IMAGES_AWS_REGIONS="us-east-1" IMAGES_AWS_ACCESS_KEY=".." images list
.imagesrc file, which can be either in
JSON. Below is an example for
providers = ["aws"] no_color = true [aws] regions = ["us-east-1","eu-west-2"] access_key = "..." secret_key = "..."
and execute simply:
$ images list
images has multi provider support. The following examples are for the
aws. The commands are supposed to be executed with
IMAGES_PROVIDERS=aws or with
--providers aws or added to
providers = "aws"
List images for a given region. Examples:
$ images list -regions "us-east-1"
List from all regions (fetches concurrently):
$ images list -regions "all"
List from multiple providers (fetches concurrently):
$ images list -providers "aws,do"
List from all supported providers
$ images list -providers "all"
Change output mode to json
$ images list -output json
Delete images from the given provider. Examples:
$ images delete -ids "ami-1ec4d766,ami-c3h207b4,ami-26f1d9r37"
Note that you don't need to specify a region if you define multiple ids.
images is automatically matching the correct region and deletes it. Plus they
all are deleted concurrently.
images allows to change the tags of AWS images for the provider
To create or override a image tag:
$ images modify --create-tags "Name=ImagesExample" --ids ami-f465e69d
To delete the tags of an image
$ images modify --delete-tags "Name=ImagesExample" --ids ami-f465e69d
The commands also have support for batch action:
$ images modify --create-tags "Name=Example" --ids ami-f465e69d,ami-c5c237ac,ami-64pgca7e $ images modify --delete-tags "Name=Example" --ids ami-f465e69d,ami-c5c237ac,ami-64pgca7e
Just like for the
delete command, all you need to give is the ami ids.
images will automatically match the region for the given id. You don't need
to define any region information.
Copy supports copying an AMI to the same or different regions. Below is a simple example:
$ images copy -image "ami-530ay345" -to "us-east-1"
Copy supports concurrent copying to multiple regions.:
$ images copy -image "ami-530ay345" -to "us-east-1,ap-southeast-1,eu-central-1"
Description can be given too (optional):
$ images copy -image "ami-530ay345" -to "us-east-1" -desc "My new AMI"
images just run (gb needs to be available on the
$ make build
This will put the
images binary in the bin folder. Development builds doesn't
have a version, so if called with
--version it'll output
$ .bin/images --version dev
release binaries run (goxc required):
IMAGES_VERSION="0.1.0" make release
The BSD 3-Clause License - see
LICENSE for more details
First release of