runway.cfngin.blueprints.cfngin_bucket module

CFNgin Bucket Blueprint.

class runway.cfngin.blueprints.cfngin_bucket.CfnginBucket[source]

Bases: runway.cfngin.blueprints.base.Blueprint

CFNgin Bucket Blueprint.

property bucket: troposphere.s3.Bucket: CFNgin Bucket.

property bucket_encryption: Union[AWSHelperFn, s3.BucketEncryption]

CFNgin bucket encryption.

This cached property can be overridden in a subclass to customize the BucketEncryption property of the bucket without needing to override the bucket cached property.

property bucket_name: AWSHelperFn: CFNgin Bucket name.

property bucket_tags: troposphere.Tags

CFNgin bucket tags.

This cached property can be overridden in a subclass to customize the Tags property of the bucket without needing to override the bucket cached property.

create_template() → None[source]: Create template.

__init__(name: str, context: runway.context.CfnginContext, *, description: Optional[str] = None, mappings: Optional[Dict[str, Dict[str, Any]]] = None, template: Optional[troposphere.Template] = None, **_: Any)

Instantiate class.

Parameters

name – A name for the blueprint.
context – Context the blueprint is being executed under.
description – The description of the CloudFormation template that will be generated by this blueprint.
mappings – CloudFormation Mappings to be used in the template during the rendering process.
template – Optionally, provide a preexisting Template.

Changed in version 2.0.0: Added template.

Changed in version 2.0.0: Class only takes 2 positional arguments. The rest are now keyword arguments.

__new__(**kwargs)

add_output(name: str, value: Any) → None

Add an output to the template.

Wrapper for self.template.add_output(Output(name, Value=value)).

Parameters

name – The name of the output to create.
value – The value to put in the output.

property cfn_parameters: Dict[str, Union[List[Any], str]]

Return a dict of variables with type CFNType.

New in version 2.0.0.

Returns: Variables that need to be submitted as CloudFormation Parameters.

property defined_variables: Dict[str, BlueprintVariableTypeDef]: Return a copy of VARIABLES to avoid accidental modification of the ClassVar.

Changed in version 2.0.0: Changed from a method to a property.

get_cfn_parameters() → Dict[str, Union[List[Any], str]]

Return a dictionary of variables with type CFNType.

Deprecated since version 2.0.0: Replaced by cfn_parameters.

Returns: Variables that need to be submitted as CloudFormation Parameters.

get_output_definitions() → Dict[str, Dict[str, Any]]

Get the output definitions.

Deprecated since version 2.0.0: Replaced by output_definitions.

Returns: Output definitions. Keys are output names, the values are dicts containing key/values for various output properties.

get_parameter_definitions() → Dict[str, BlueprintVariableTypeDef]

Get the parameter definitions to submit to CloudFormation.

Any variable definition whose type is an instance of CFNType will be returned as a CloudFormation Parameter.

Deprecated since version 2.0.0: Replaced by parameter_definitions.

Returns: Parameter definitions. Keys are parameter names, the values are dicts containing key/values for various parameter properties.

get_parameter_values() → Dict[str, Union[List[Any], str]]

Return a dict of variables with type CFNType.

Deprecated since version 2.0.0: Replaced by parameter_values.

Returns: Variables that need to be submitted as CloudFormation Parameters. Will be a dictionary of <parameter name>: <parameter value>.

get_required_parameter_definitions() → Dict[str, BlueprintVariableTypeDef]

Return all template parameters that do not have a default value.

Deprecated since version 2.0.0: Replaced by required_parameter_definitions.

Returns: Dict of required CloudFormation Parameters for the blueprint. Will be a dictionary of <parameter name>: <parameter attributes>.

get_variables() → Dict[str, Any]

Return a dictionary of variables available to the template.

These variables will have been defined within VARIABLES or self.defined_variables. Any variable value that contains a lookup will have been resolved.

Deprecated since version 2.0.0: Replaced by variables.

Returns: Variables available to the template.
Raises: UnresolvedBlueprintVariables – If variables are unresolved.

import_mappings() → None: Import mappings from CFNgin config to the blueprint.

property output_definitions: Dict[str, Dict[str, Any]]

Get the output definitions.

New in version 2.0.0.

Returns: Output definitions. Keys are output names, the values are dicts containing key/values for various output properties.

property parameter_definitions: Dict[str, BlueprintVariableTypeDef]

Get the parameter definitions to submit to CloudFormation.

Any variable definition whose type is an instance of CFNType will be returned as a CloudFormation Parameter.

New in version 2.0.0.

Returns: Parameter definitions. Keys are parameter names, the values are dicts containing key/values for various parameter properties.

property parameter_values: Dict[str, Union[List[Any], str]]

Return a dict of variables with type CFNType.

New in version 2.0.0.

Returns: Variables that need to be submitted as CloudFormation Parameters. Will be a dictionary of <parameter name>: <parameter value>.

read_user_data(user_data_path: str) → str

Read and parse a user_data file.

Parameters: user_data_path – Path to the userdata file.

render_template() → Tuple[str, str]: Render the Blueprint to a CloudFormation template.

property rendered: str: Return rendered blueprint.

property required_parameter_definitions: Dict[str, BlueprintVariableTypeDef]

Return all template parameters that do not have a default value.

New in version 2.0.0.

Returns: Dict of required CloudFormation Parameters for the blueprint. Will be a dictionary of <parameter name>: <parameter attributes>.

property requires_change_set: bool: Return true if the underlying template has transforms.

reset_template() → None: Reset template.

resolve_variables(provided_variables: List[runway.variables.Variable]) → None

Resolve the values of the blueprint variables.

This will resolve the values of the VARIABLES with values from the env file, the config, and any lookups resolved.

Parameters: provided_variables – List of provided variables.

set_template_description(description: str) → None

Add a description to the Template.

Parameters: description – A description to be added to the resulting template.

setup_parameters() → None: Add any CloudFormation parameters to the template.

to_json(variables: Optional[Dict[str, Any]] = None) → str

Render the blueprint and return the template in json form.

Parameters: variables – Dictionary providing/overriding variable values.

property variables: Dict[str, Any]

Return a Dict of variables available to the Template.

These variables will have been defined within VARIABLES or defined_variables. Any variable value that contains a Lookup will have been resolved.

New in version 2.0.0.

Returns: Variables available to the Template.
Raises: UnresolvedBlueprintVariables – If variables are unresolved.

property version: str: Template version.