Skip to main content

ShipAMI - Simple AWS AMIs management

Build Status Version Coverage License

CLI for simple AWS AMIs management

Quick Start

Install with pip:

$ pip install shipami
$ shipami --help

Example: Publish AMI for AWS Marketplace

  1. List available AMIs in your default region (eg. eu-west-1)

$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin
  1. Create a release based on this image in us-east-1 region

$ shipami --region us-east-1 release ami-00000000 1.0 --source-region eu-west-1
ami-000000aa

$ shipami --region us-east-1 list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo-1.0    1.0        ami-000000aa  pending    just now     yes        eu-west-1:ami-00000000
  1. Manually share with AWS Marketplace account

$ shipami --region us-east-1 share ami-000000aa

$ shipami --region us-east-1 show ami-000000aa
id:     ami-000000aa
name:   foo-1.0
state:  available
tags:
  shipami:copied_from: eu-west-1:ami-00000000
  shipami:managed: True
  shipami:release: 1.0
devices mappings:
  /dev/xvda 8Go type:gp2
shared with:
  679593333241 (AWS MARKETPLACE) OK

Commands

You can get further help and usage instructions on any command with the --help option.

copy

$ shipami copy ami-00000000
ami-000000aa
$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin                  eu-west-1:ami-000000aa
foo                   ami-000000aa  pending    just now     yes        eu-west-1:ami-00000000

delete

$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin                  eu-west-1:ami-000000aa
foo                   ami-000000aa  available  1 day ago    yes        eu-west-1:ami-00000000

$ shipami delete ami-000000aa
ami-000000aa

$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin

list

$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin

release

$ shipami release ami-00000000 1.0
ami-000000aa
$ shipami list
NAME       RELEASE    ID            STATE      CREATED      MANAGED    COPIED FROM             COPIED TO
foo                   ami-00000000  available  5 days ago   no         origin                  eu-west-1:ami-000000aa
foo-1.0    1.0        ami-000000aa  pending    just now     yes        eu-west-1:ami-00000000

share

$ shipami share ami-000000aa 012345678912

show

$ shipami show ami-000000aa
id:     ami-000000aa
name:   foo-1.0
state:  available
tags:
  shipami:copied_from: eu-west-1:ami-00000000
  shipami:managed: True
  shipami:release: 1.0
devices mappings:
  /dev/xvda 8Go type:gp2
shared with:
  012345678912

Metadata

Release files for shipami 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for shipami 1.1.0
File Size Uploaded Provenance Actions
shipami-1.1.0.tar.gz 29.5 kB Without provenance Details for shipami-1.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for shipami 1.1.0
File Interpreter ABI Platform Actions
shipami-1.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details for shipami-1.1.0-py2.py3-none-any.whl

Total release size: 40.3 kB

Release files / shipami-1.1.0.tar.gz

Download URL shipami-1.1.0.tar.gz
Size 29.5 kB
Tags Source
SHA-256 checksum
How to use checksums
0a2a6c67f0ff70d5b8669bd1254d41eb3f7b2b1c5f3be6bc636ba318e99f9fe4
BLAKE2b-256 checksum
How to use checksums
cd488c191b9ef1155f75fb6ee666ec97d03258c96c5d583574de2324a242a548
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / shipami-1.1.0-py2.py3-none-any.whl

Download URL shipami-1.1.0-py2.py3-none-any.whl
Size 10.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
bd9462b2f27b51315fbacb22976bcd067dd0b25bea306246f03e1f91d48be381
BLAKE2b-256 checksum
How to use checksums
3b11e46c688a69a4806f8cb05fad20217890a3edd9494e439acc12cea0d3fc6a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for shipami 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page