runway.cfngin.lookups.handlers.envvar module

Environment variable lookup.

class runway.cfngin.lookups.handlers.envvar.EnvvarLookup

Bases: runway.lookups.handlers.base.LookupHandler

Environment variable lookup.

classmethod handle(value, context=None, provider=None, **kwargs)

Retrieve an environment variable.

Parameters

• value (str) – Parameter(s) given to this lookup.

• context (runway.cfngin.context.Context) – Context instance.

• provider (runway.cfngin.providers.base.BaseProvider) – Provider instance.

Example

# With CFNgin we would reference the environment variable like this:
conf_key: ${envvar ENV_VAR_NAME}

You can optionally store the value in a file, ie:

$ cat envvar_value.txt
ENV_VAR_NAME

and reference it within CFNgin (NOTE: the path should be relative to the CFNgin config file):

conf_key: ${envvar file://envvar_value.txt}

# Both of the above would resolve to
conf_key: ENV_VALUE