Documentation ¶
Index ¶
- func GetIndent(step StepEventMetadata, seen map[resource.URN]StepEventMetadata) int
- func GetIndentationString(indent int) string
- func GetResourceOutputsPropertiesString(step StepEventMetadata, indent int, planning bool, debug bool, refresh bool) string
- func GetResourcePropertiesDetails(step StepEventMetadata, indent int, planning bool, summary bool, debug bool) string
- func GetResourcePropertiesSummary(step StepEventMetadata, indent int) string
- func IsInternalPropertyKey(key resource.PropertyKey) bool
- func ProjectInfoContext(projinfo *Projinfo, host plugin.Host, config plugin.ConfigSource, ...) (string, string, *plugin.Context, error)
- func ShouldRecordReadStep(step deploy.Step) bool
- type Context
- type DecryptError
- type DiagEventPayload
- type Event
- type EventType
- type PreludeEventPayload
- type Projinfo
- type ResourceChanges
- type ResourceOperationFailedPayload
- type ResourceOutputsEventPayload
- type ResourcePreEventPayload
- type SnapshotManager
- type SnapshotMutation
- type StdoutEventPayload
- type StepEventMetadata
- type StepEventStateMetadata
- type SummaryEventPayload
- type UpdateInfo
- type UpdateOptions
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func GetIndent ¶
func GetIndent(step StepEventMetadata, seen map[resource.URN]StepEventMetadata) int
GetIndent computes a step's parent indentation.
func GetIndentationString ¶ added in v0.16.0
func GetResourceOutputsPropertiesString ¶
func GetResourceOutputsPropertiesString( step StepEventMetadata, indent int, planning bool, debug bool, refresh bool) string
GetResourceOutputsPropertiesString prints only those properties that either differ from the input properties or, if there is an old snapshot of the resource, differ from the prior old snapshot's output properties.
func GetResourcePropertiesSummary ¶
func GetResourcePropertiesSummary(step StepEventMetadata, indent int) string
func IsInternalPropertyKey ¶ added in v0.17.2
func IsInternalPropertyKey(key resource.PropertyKey) bool
IsInternalPropertyKey returns true if the given property key is an internal key that should not be displayed to users.
func ProjectInfoContext ¶
func ProjectInfoContext(projinfo *Projinfo, host plugin.Host, config plugin.ConfigSource, pluginEvents plugin.Events, diag, statusDiag diag.Sink, tracingSpan opentracing.Span) (string, string, *plugin.Context, error)
ProjectInfoContext returns information about the current project, including its pwd, main, and plugin context.
func ShouldRecordReadStep ¶ added in v0.16.9
Types ¶
type Context ¶
type Context struct { Cancel *cancel.Context Events chan<- Event SnapshotManager SnapshotManager BackendClient deploy.BackendClient ParentSpan opentracing.SpanContext }
Context provides cancellation, termination, and eventing options for an engine operation. It also provides a way for the engine to persist snapshots, using the `SnapshotManager`.
type DecryptError ¶ added in v0.15.1
type DecryptError struct { Key config.Key // The configuration key whose value couldn't be decrypted Err error // The error that occurred while decrypting }
DecryptError is the type of errors that arise when the engine can't decrypt a configuration key. The most common reason why this happens is that this key is being decrypted in a stack that's not the same one that encrypted it.
func (DecryptError) Error ¶ added in v0.15.1
func (d DecryptError) Error() string
type DiagEventPayload ¶
type DiagEventPayload struct { URN resource.URN Prefix string Message string Color colors.Colorization Severity diag.Severity StreamID int32 Ephemeral bool }
DiagEventPayload is the payload for an event with type `diag`
type Event ¶
type Event struct { Type EventType Payload interface{} }
Event represents an event generated by the engine during an operation. The underlying type for the `Payload` field will differ depending on the value of the `Type` field
type EventType ¶
type EventType string
EventType is the kind of event being emitted.
const ( CancelEvent EventType = "cancel" StdoutColorEvent EventType = "stdoutcolor" DiagEvent EventType = "diag" PreludeEvent EventType = "prelude" SummaryEvent EventType = "summary" ResourcePreEvent EventType = "resource-pre" ResourceOutputsEvent EventType = "resource-outputs" ResourceOperationFailed EventType = "resource-operationfailed" )
type PreludeEventPayload ¶
type ResourceChanges ¶
ResourceChanges contains the aggregate resource changes by operation type.
func Destroy ¶
func Destroy(u UpdateInfo, ctx *Context, opts UpdateOptions, dryRun bool) (ResourceChanges, error)
func Refresh ¶
func Refresh(u UpdateInfo, ctx *Context, opts UpdateOptions, dryRun bool) (ResourceChanges, error)
func Update ¶
func Update(u UpdateInfo, ctx *Context, opts UpdateOptions, dryRun bool) (ResourceChanges, error)
func (ResourceChanges) HasChanges ¶
func (changes ResourceChanges) HasChanges() bool
HasChanges returns true if there are any non-same changes in the resulting summary.
type ResourceOperationFailedPayload ¶
type ResourceOperationFailedPayload struct { Metadata StepEventMetadata Status resource.Status Steps int }
type ResourceOutputsEventPayload ¶
type ResourceOutputsEventPayload struct { Metadata StepEventMetadata Planning bool Debug bool }
type ResourcePreEventPayload ¶
type ResourcePreEventPayload struct { Metadata StepEventMetadata Planning bool Debug bool }
type SnapshotManager ¶
type SnapshotManager interface { io.Closer // BeginMutation signals to the SnapshotManager that the planner intends to mutate the global // snapshot. It provides the step that it intends to execute. Based on that step, BeginMutation // will record this intent in the global snapshot and return a `SnapshotMutation` that, when ended, // will complete the transaction. BeginMutation(step deploy.Step) (SnapshotMutation, error) // RegisterResourceOutputs registers the set of resource outputs generated by performing the // given step. These outputs are persisted in the snapshot. RegisterResourceOutputs(step deploy.Step) error // RecordPlugin records that the current plan loaded a plugin and saves it in the snapshot. RecordPlugin(plugin workspace.PluginInfo) error }
SnapshotManager is responsible for maintaining the in-memory representation of the current state of the resource world.
type SnapshotMutation ¶
type SnapshotMutation interface { // End terminates the transaction and commits the results to the snapshot, returning an error if this // failed to complete. End(step deploy.Step, successful bool) error }
SnapshotMutation represents an outstanding mutation that is yet to be completed. When the engine completes a mutation, it must call `End` in order to record the successful completion of the mutation.
type StdoutEventPayload ¶
type StdoutEventPayload struct { Message string Color colors.Colorization }
type StepEventMetadata ¶
type StepEventMetadata struct { Op deploy.StepOp // the operation performed by this step. URN resource.URN // the resource URN (for before and after). Type tokens.Type // the type affected by this step. Old *StepEventStateMetadata // the state of the resource before performing this step. New *StepEventStateMetadata // the state of the resource after performing this step. Res *StepEventStateMetadata // the latest state for the resource that is known (worst case, old). Keys []resource.PropertyKey // the keys causing replacement (only for CreateStep and ReplaceStep). Diffs []resource.PropertyKey // the keys causing diffs Logical bool // true if this step represents a logical operation in the program. Provider string // the provider that performed this step. }
type StepEventStateMetadata ¶
type StepEventStateMetadata struct { // the resource's type. Type tokens.Type // the resource's object urn, a human-friendly, unique name for the resource. URN resource.URN // true if the resource is custom, managed by a plugin. Custom bool // true if this resource is pending deletion due to a replacement. Delete bool // the resource's unique ID, assigned by the resource provider (or blank if none/uncreated). ID resource.ID // an optional parent URN that this resource belongs to. Parent resource.URN // true to "protect" this resource (protected resources cannot be deleted). Protect bool // the resource's input properties (as specified by the program). Note: because this will cross // over rpc boundaries it will be slightly different than the Inputs found in resource_state. // Specifically, secrets will have been filtered out, and large values (like assets) will be // have a simple hash-based representation. This allows clients to display this information // properly, without worrying about leaking sensitive data, and without having to transmit huge // amounts of data. Inputs resource.PropertyMap // the resource's complete output state (as returned by the resource provider). See "Inputs" // for additional details about how data will be transformed before going into this map. Outputs resource.PropertyMap // the resource's provider reference Provider string // InitErrors is the set of errors encountered in the process of initializing resource (i.e., // during create or update). InitErrors []string }
type SummaryEventPayload ¶
type SummaryEventPayload struct { IsPreview bool // true if this summary is for a plan operation MaybeCorrupt bool // true if one or more resources may be corrupt Duration time.Duration // the duration of the entire update operation (zero values for previews) ResourceChanges ResourceChanges // count of changed resources, useful for reporting }
type UpdateInfo ¶
type UpdateInfo interface { // GetRoot returns the root directory for this update. This defines the scope for any filesystem resources // accessed by this update. GetRoot() string // GetProject returns information about the project associated with this update. This includes information such as // the runtime that will be used to execute the Pulumi program and the program's relative working directory. GetProject() *workspace.Project // GetTarget returns information about the target of this update. This includes the name of the stack being // updated, the configuration values associated with the target and the target's latest snapshot. GetTarget() *deploy.Target }
UpdateInfo abstracts away information about an apply, preview, or destroy.
type UpdateOptions ¶
type UpdateOptions struct { // an optional set of analyzers to run as part of this deployment. Analyzers []string // the degree of parallelism for resource operations (<=1 for serial). Parallel int // true if debugging output it enabled Debug bool // true if the plan should refresh before executing. Refresh bool // contains filtered or unexported fields }
UpdateOptions contains all the settings for customizing how an update (deploy, preview, or destroy) is performed.
This structre is embedded in another which uses some of the unexported fields, which trips up the `structcheck` linter. nolint: structcheck