Metadata-Version: 2.0
Name: cf-upgrade
Version: 1.0.2
Summary: Trivial AWS CloudFormation updater
Home-page: https://github.com/curvetips/cf_upgrade
Author: Wichert Akkerman
Author-email: wichert@wiggy.net
License: BSD
Keywords: aws cloudformation
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: DFSG approved
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Requires-Dist: boto3
Requires-Dist: click
Requires-Dist: tabulate

cf-upgrade
==========

This package contains a simple strict to update an existing CloudFormation
stack. It is intended to be used as part of a CI/CD flow to update a
deployment.

Usage is simple, since there are only two commands. First you can list
all CloudFormation stacks using the `list` command:

.. code-block:: shell

    $ cf-upgrade list
    Stack             Status
    ----------------  ---------------
    my-example-stack  UPDATE_COMPLETE

To update a stack use the `upgrade` command. In its simplest version you can
pass a version number which will be used for a `Version` parameter:

.. code-block:: shell

    $ cf-upgrade my-example-stack 1.2.0
    Stack updating, waiting to complete... done

If you want to modify another parameter, or a different one you can also
provide one or more key=value options:

.. code-block:: shell

    $ cf-upgrade my-example-stack ApiVersion=1.1.0 Nginx=1.13.4
    Stack updating, waiting to complete... done

Credentials
-----------

This command assumes you have `AWS CLI credentials configured <http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>`_.
You can use the `--profile` and `--region` options to indicate which AWS profile
and region to use.

Permissions
-----------

In order to operate this your will need to use an AWS user with permissions to
find our existing stack template and update it. In addition you must grant any
permissions necessary to update your resources.

Here is a sample policy document to allow updating of ECS services:

.. code-block:: json

    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "cloudformation:DescribeStacks",
                    "cloudformation:ListStacks",
                    "cloudformation:GetTemplate",
                    "cloudformation:GetTemplateSummary",
                    "cloudformation:UpdateStack",

                    "iam:GetRole",
                    "iam:PassRole",

                    "ecs:UpdateService",
                    "ecs:DeregisterTaskDefinition",
                    "ecs:DescribeServices",
                    "ecs:RegisterTaskDefinition"
                ],
                "Resource": "*"
            }
        ]
    }

Changelog
=========

1.0.2 - September 4, 2017
-------------------------

Fix a ReST syntax error.


1.0.1 - September 4, 2017
-------------------------

Use ReST for documentation to improve display on pypi.org


1.0 - September 4, 2017
-----------------------

First release


