push
====

.. argparse::
   :module: pubtools._ami.tasks.push
   :func: doc_parser
   :prog: pubtools-ami-push

Example
.......

A typical invocation of push would look like this:

.. code-block::

  pubtools-ami-push \
    --rhsm-url https://rhsm.example.com \
    --aws-provider-name awstest \
    --accounts '{"region-1": {"access-r": "secret-r"},
                 "default": {"access-1": "secret-1"}}' \
    --aws-access-id access_id \
    --aws-secret-key secret_key \
    staged:/stage/ami/root

All the AMIs in the given source path will be verified for
provider and product combination in RHSM and then uploaded
to AWS for the accounts of the region the image is pushed to
or the default accounts.


Example: ship images
....................

To the ship the images to be available to users, --ship option
should be used. This updates the metadata on RHSM services.

.. code-block::

  pubtools-ami-push \
    --rhsm-url https://rhsm.example.com \
    --aws-provider-name awstest \
    --accounts '{"region-1": {"access-r": "secret-r"},
                 "default": {"access-1": "secret-1"}}' \
    --aws-access-id access_id \
    --aws-secret-key secret_key \
    --ship \
    staged:/stage/ami/root


Shipping the images to general public i.e. ones that are available
to all like hourly images which can be used by general users for a
fee requires using --allow-public-images along with the above options.

.. code-block::

  pubtools-ami-push \
    --rhsm-url https://rhsm.example.com \
    --aws-provider-name awstest \
    --accounts '{"region-1": {"access-r": "secret-r"},
                 "default": {"access-1": "secret-1"}}' \
    --aws-access-id access_id \
    --aws-secret-key secret_key \
    --ship \
    --allow-public-image \
    staged:/stage/ami/root


Example: modify retry
.....................

Uploads might fail on the first try for any reason. It gets retired by default
for 4 times after every 30 seconds. These defaults can be modified as:

.. code-block::

  pubtools-ami-push \
    --rhsm-url https://rhsm.example.com \
    --aws-provider-name awstest \
    --accounts '{"region-1": {"access-r": "secret-r"},
                 "default": {"access-1": "secret-1"}}' \
    --aws-access-id access_id \
    --aws-secret-key secret_key \
    --max-retires 2 \
    --retry-wait 10 \
    staged:/stage/ami/root