Configuration¶
This library uses library-config('github.com/cloudboss/unobin-library-aws') for per-alias settings. Pass a value to library-configs: in factory source, usually from a factory input so stack files can choose the environment-specific settings.
Description¶
Configuration selects how a component reaches AWS. Every field is optional; an empty or nil Configuration means the SDK's default chain alone: env credentials, shared config and credentials files, SSO, web identity, container credentials, then IMDS. Static credential fields are deliberately absent; credentials enter through the chain, a profile, or role assumption.
Fields¶
region
string
profile
string
endpoint-url
string
endpoints
object
object({
s3: optional(string)
sts: optional(string)
kms: optional(string)
})
max-attempts
integer
retry-mode
string
shared-config-files
list(string)
shared-credentials-files
list(string)
custom-ca-bundle
string
http-proxy
string
https-proxy
string
no-proxy
string
assume-role
object
object({
role-arn: string
role-session-name: optional(string)
external-id: optional(string)
duration-seconds: optional(integer)
policy: optional(string)
policy-arns: optional(list(string))
source-identity: optional(string)
tags: optional(map(string))
transitive-tag-keys: optional(list(string))
})
assume-role-with-web-identity
object
object({
role-arn: string
web-identity-token-file: string
role-session-name: optional(string)
duration-seconds: optional(integer)
policy: optional(string)
policy-arns: optional(list(string))
})