0550f71a35
Fixes #2277. Adds a new ignoreChanges resource option that allows specifying a list of property names whose values will be ignored during updates. The property values will be used for Create, but will be ignored for purposes of updates, and as a result also cannot trigger replacements. This is a feature of the Pulumi engine, not of the resource providers, so no new logic is needed in providers to support this feature. Instead, the engine simply replaces the values of input properties in the goal state with old inputs for properties marked as ignoreChanges. Currently, only top level properties may be specified in ignoreChanges. In the future, this could be extended to support paths to nested properties (including into array elements) with a JSONPath/JMESPath syntax.
58 lines
2.7 KiB
Go
58 lines
2.7 KiB
Go
// Copyright 2016-2018, Pulumi Corporation.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package resource
|
|
|
|
import (
|
|
"github.com/pulumi/pulumi/pkg/tokens"
|
|
)
|
|
|
|
// Goal is a desired state for a resource object. Normally it represents a subset of the resource's state expressed by
|
|
// a program, however if Output is true, it represents a more complete, post-deployment view of the state.
|
|
type Goal struct {
|
|
Type tokens.Type // the type of resource.
|
|
Name tokens.QName // the name for the resource's URN.
|
|
Custom bool // true if this resource is custom, managed by a plugin.
|
|
Properties PropertyMap // the resource's property state.
|
|
Parent URN // an optional parent URN for this resource.
|
|
Protect bool // true to protect this resource from deletion.
|
|
Dependencies []URN // dependencies of this resource object.
|
|
Provider string // the provider to use for this resource.
|
|
InitErrors []string // errors encountered as we attempted to initialize the resource.
|
|
PropertyDependencies map[PropertyKey][]URN // the set of dependencies that affect each property.
|
|
DeleteBeforeReplace bool // true if this resource should be deleted prior to replacement.
|
|
IgnoreChanges []string // a list of property names to ignore during changes.
|
|
}
|
|
|
|
// NewGoal allocates a new resource goal state.
|
|
func NewGoal(t tokens.Type, name tokens.QName, custom bool, props PropertyMap,
|
|
parent URN, protect bool, dependencies []URN, provider string, initErrors []string,
|
|
propertyDependencies map[PropertyKey][]URN, deleteBeforeReplace bool, ignoreChanges []string) *Goal {
|
|
|
|
return &Goal{
|
|
Type: t,
|
|
Name: name,
|
|
Custom: custom,
|
|
Properties: props,
|
|
Parent: parent,
|
|
Protect: protect,
|
|
Dependencies: dependencies,
|
|
Provider: provider,
|
|
InitErrors: initErrors,
|
|
PropertyDependencies: propertyDependencies,
|
|
DeleteBeforeReplace: deleteBeforeReplace,
|
|
IgnoreChanges: ignoreChanges,
|
|
}
|
|
}
|