stack

Documentation

Overview

Copyright 2021, Pulumi Corporation. All rights reserved.

Index

• Constants
• func Add(mgr manager.Manager) error
• func IsNamespaceIsolationWaived() bool
• type ProjectFile
• type ReconcileRequestedPredicate
  • func (p ReconcileRequestedPredicate) Update(e event.UpdateEvent) bool
• type ReconcileStack
  • func (r *ReconcileStack) Reconcile(ctx context.Context, request reconcile.Request) (retres reconcile.Result, reterr error)
• type StallError

Constants

const (
	// envInsecureNoNamespaceIsolation is the name of the environment entry which, when set to a
	// truthy value (1|true), shall allow multiple namespaces to be watched, and cross-namespace
	// references to be accepted.
	EnvInsecureNoNamespaceIsolation = "INSECURE_NO_NAMESPACE_ISOLATION"
)

const INFERNS = "PULUMI_INFER_NAMESPACE"

Environment variable to toggle namespace behavior

Functions

func Add

func Add(mgr manager.Manager) error

Add creates a new Stack Controller and adds it to the Manager. The Manager will set fields on the Controller and Start it when the Manager is Started.

func IsNamespaceIsolationWaived

func IsNamespaceIsolationWaived() bool

Types

type ProjectFile

type ProjectFile struct {
	Name    string `json:"name"`
	Runtime string `json:"runtime"`
	pulumiv1.ProgramSpec
}

ProjectFile adds required Pulumi 'project' fields to the Program spec, making it valid to be given to Pulumi.

type ReconcileRequestedPredicate

type ReconcileRequestedPredicate struct {
	predicate.Funcs
}

• when you want the object to be considered for reconciliation, annotate it with the key `shared.ReconcileRequestAnnotation` and any likely-to-be-unique value. This causes the object to be queued for consideration by the controller;
• the controller shall save the value of the annotation to `.status.observedReconcileRequest` whenever it processes a resource without returning an error. This is so you can check the status to see whether the annotation has been seen (similar to `.status.observedGeneration`).

This protocol is the same mechanism used by many Flux controllers, as explained at https://pkg.go.dev/github.com/fluxcd/pkg/runtime/predicates#ReconcileRequestedPredicate and related documentation.

func (ReconcileRequestedPredicate) Update

func (p ReconcileRequestedPredicate) Update(e event.UpdateEvent) bool

Update filters update events based on whether the request reconciliation annotation has been added or amended.

type ReconcileStack

type ReconcileStack struct {
	// contains filtered or unexported fields
}

ReconcileStack reconciles a Stack object

func (*ReconcileStack) Reconcile

func (r *ReconcileStack) Reconcile(ctx context.Context, request reconcile.Request) (retres reconcile.Result, reterr error)

Reconcile reads that state of the cluster for a Stack object and makes changes based on the state read and what is in the Stack.Spec

type StallError

type StallError struct {
	// contains filtered or unexported fields
}

StallError represents a problem that makes a Stack spec unprocessable, while otherwise being valid. For example: the spec refers to a secret in another namespace. This is used to signal "stall" failures within helpers -- that is, when the operator cannot process the object as it is specified.