Function GenerateRuntimeSetupSteps

pkg/workflow/runtime_step_generator.go:19–45

GenerateRuntimeSetupSteps creates GitHub Actions steps for runtime setup. data is the WorkflowData for the workflow being compiled; it is forwarded to generateSetupStep so that the gh-aw setup-cli step can use the lock-file-aware pin resolver (getActionPinWithData) rather than the static embedded-pi

(requirements []RuntimeRequirement, data *WorkflowData)

// Pass nil only when WorkflowData is unavailable or when tests specifically
// target non-gh-aw runtime behavior.
func GenerateRuntimeSetupSteps(requirements []RuntimeRequirement, data *WorkflowData) []GitHubActionStep {
	runtimeStepGeneratorLog.Printf("Generating runtime setup steps: requirement_count=%d", len(requirements))
	runtimeSetupLog.Printf("Generating runtime setup steps for %d requirements", len(requirements))
	var steps []GitHubActionStep

	for _, req := range requirements {
		steps = append(steps, generateSetupStep(&req, data))

		// Add environment variable capture steps after setup actions for AWF chroot mode.
		// Most env vars are inherited via AWF_HOST_PATH, but Go is special.
		switch req.Runtime.ID {
		case "go":
			// GitHub Actions uses "trimmed" Go binaries that require GOROOT to be explicitly set.
			// Unlike other runtimes where PATH is sufficient, Go's trimmed binaries need GOROOT
			// for /proc/self/exe resolution. actions/setup-go does NOT export GOROOT to the
			// environment, so we must capture it explicitly.
			runtimeStepGeneratorLog.Print("Adding GOROOT capture step for chroot mode compatibility")
			steps = append(steps, generateEnvCaptureStep("GOROOT", "go env GOROOT"))
		}
		// Note: Java and .NET don't need capture steps anymore because:
		// - AWF_HOST_PATH captures the complete host PATH including $JAVA_HOME/bin and $DOTNET_ROOT
		// - AWF's entrypoint.sh exports PATH="${AWF_HOST_PATH}" which preserves all setup-* additions
	}

	runtimeStepGeneratorLog.Printf("Generated %d runtime setup steps", len(steps))
	return steps
}

// generateEnvCaptureStep creates a step to capture an environment variable and export it.
// This is required because some setup actions don't export env vars, but AWF chroot mode