stacks

package
v0.19.1102 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2026 License: AGPL-3.0 Imports: 5 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func FormatRunnerEnvVars added in v0.19.850

func FormatRunnerEnvVars(cfg *app.AppRunnerConfig, runnerBinaryVersion string) string

FormatRunnerEnvVars converts an AppRunnerConfig's EnvVars hstore into a newline-delimited string of "export key=value" statements. Default values are injected only when not already defined in cfg.EnvVars.

func PhoneHomeRoleName added in v0.19.1091

func PhoneHomeRoleName(installID string) string

PhoneHomeRoleName is the deterministic IAM role name for an install's phone-home Lambda, matching the `<install_id>-<purpose>` convention the install stack's other roles already use (`<install_id>-provision`, `-maintenance`, `-deprovision`).

This is the single source of truth for the name. A cross-account grant naming this principal cannot be validated at deploy time — IAM accepts a resource policy that references a role which does not exist yet, and a mismatch only surfaces as an AccessDeniedException at phone-home time. Both the template and any policy that names the principal must derive it from here.

Types

type TemplateInput

type TemplateInput struct {
	Install                    *app.Install             `validate:"required"`
	CloudFormationStackVersion *app.InstallStackVersion `validate:"required"`
	InstallState               *state.State             `validate:"required"`
	AppCfg                     *app.AppConfig           `validate:"required"`

	Runner   *app.Runner              `validate:"required"`
	Settings *app.RunnerGroupSettings `validate:"required"`
	APIToken string                   `validate:"required"`

	// runner env vars from runner.toml [env_vars] section, formatted as
	// newline-delimited "export key=value" pairs for injection into user-data.
	RunnerEnvVars string

	// subscripts and embedded templates
	RunnerInitScriptURL string `validate:"required"`
	PhonehomeScript     string `validate:"required"`

	// Custom template URLs for VPC/VNet and runner nested/linked deployments (AWS CloudFormation, Azure ARM)
	VPCNestedStackTemplateURL    string
	RunnerNestedStackTemplateURL string

	// Where the phone-home token map lives, for the Lambda to fetch at invocation
	// time. Never the token itself: the rendered template is fetched
	// unauthenticated from S3 via the quick-link, so it may only carry the secret's
	// location. Empty whenever phone-home auth is not active for the install, which
	// is why these are unvalidated — the GCP path shares this struct and never sets
	// them.
	PhoneHomeSecretARN    string
	PhoneHomeSecretRegion string
}

Directories

Path Synopsis
Package aws renders the install-stacks/aws Terraform module's tfvars file for an AWS install.
Package aws renders the install-stacks/aws Terraform module's tfvars file for an AWS install.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL