cli.cloudformation Namespace Reference

Functions
def	__get_boto_client__ (region)
def	__get_stack_name__ (cluster, region, name, uuid)
def	__get_changeset_name__ (stack_name, git_sha)
def	__read_template_body_as_json__ ()
def	__aws_tags_translation__ (tags)
def	__aws_params_translation__ (params)
def	__update_template_tasks_environments__ (template, env)
def	__validate_template__ (client, template_body)
def	describe_stack (stack, **kwargs)
def	describe_changeset (stack, git_sha, **kwargs)
def	watch_stack_progress (stack, **kwargs)
def	watch_changeset_progress (stack, git_sha, **kwargs)
def	list_stack_events (stack, **kwargs)
def	create_cloudformation_stack (stack, params, tags=None, **kwargs)
def	create_cloudformation_changeset (stack, params, git_sha, tags=None, **kwargs)
def	execute_changeset (stack, git_sha, **kwargs)
def	deploy_changeset (stack, git_sha, params, **kwargs)
def	delete_stack (stack, **kwargs)

Variables
string	STACK_TEMPLATE_DIR = '/cloudformation'
	STACK_TEMPLATE = os.path.join(STACK_TEMPLATE_DIR, 'odyssey.cf.json')
	LOG = logging.getLogger(__name__)

Detailed Description

Hosting Cloudformation Library

Function Documentation

create_cloudformation_changeset()

def cli.cloudformation.create_cloudformation_changeset	(		stack,
			params,
			git_sha,
			tags = None,
		**	kwargs
	)

Create AWS Cloudformation Changeset

Definition at line 167 of file cloudformation.py.

def create_cloudformation_changeset(stack,
                                    params,
                                    git_sha,
                                    tags=None,
                                    **kwargs):
    '''Create AWS Cloudformation Changeset'''
    if tags is None:
        tags = {}
    client = __get_boto_client__(stack.region)
    stack_name = __get_stack_name__(stack.cluster,
                                    stack.region,
                                    stack.name,
                                    stack.uuid)
    changeset_name = __get_changeset_name__(stack_name, git_sha)
    stack_template = __update_template_tasks_environments__(
        __read_template_body_as_json__(),
        stack.env
    )
    template_body = json.dumps(stack_template, indent=2)

    if kwargs.get('verbose', False):
        print(__validate_template__(client, template_body), file=sys.stderr)

    try:
        response = client.create_change_set(
            StackName=stack_name,
            ChangeSetName=changeset_name,
            TemplateBody=template_body,
            Parameters=__aws_params_translation__(params),
            Capabilities=['CAPABILITY_NAMED_IAM'],
            Tags=__aws_tags_translation__(tags))
    except Exception as ex:
        print(ex, file=sys.stderr)
        return False

    if kwargs.get('verbose', False):
        print(response, file=sys.stderr)

    if response['ResponseMetadata']['HTTPStatusCode'] != 200:
        return False
    else:
        return True

create_cloudformation_stack()

def cli.cloudformation.create_cloudformation_stack	(		stack,
			params,
			tags = None,
		**	kwargs
	)

Create AWS Cloudformation Stack

Definition at line 136 of file cloudformation.py.

def create_cloudformation_stack(stack,
                                params,
                                tags=None,
                                **kwargs):
    '''Create AWS Cloudformation Stack'''
    if tags is None:
        tags = {}
    stack_name = __get_stack_name__(stack.cluster,
                                    stack.region,
                                    stack.name,
                                    stack.uuid)
    stack_template = __update_template_tasks_environments__(
        __read_template_body_as_json__(),
        stack.env
    )
    template_body = json.dumps(stack_template, indent=4)

    client = __get_boto_client__(stack.region)

    if kwargs.get('verbose', False):
        print(__validate_template__(client, template_body), file=sys.stderr)

    response = client.create_stack(
        StackName=stack_name,
        Parameters=__aws_params_translation__(params),
        TemplateBody=template_body,
        Capabilities=['CAPABILITY_NAMED_IAM'],
        Tags=__aws_tags_translation__(tags))
    return response.get('StackId')

delete_stack()

def cli.cloudformation.delete_stack	(		stack,
		**	kwargs
	)

Delete stack

Definition at line 252 of file cloudformation.py.

def delete_stack(stack, **kwargs):
    '''Delete stack'''
    assert stack
    stack_name = __get_stack_name__(stack.cluster,
                                    stack.region,
                                    stack.name,
                                    stack.uuid)
    client = boto3.client('cloudformation', region_name=stack.region)
    client.delete_stack(StackName=stack_name)
    if kwargs.get('wait_until_complete', False):
        watch_stack_progress(stack, **kwargs)