sdkv2

Documentation

Index

• Constants
• func IsInstanceState(s shim.InstanceState) (*terraform.InstanceState, bool)
• func NewInstanceState(s *terraform.InstanceState) shim.InstanceState
• func NewInstanceStateForResource(s *terraform.InstanceState, resource *schema.Resource) shim.InstanceState
• func NewProvider(p *schema.Provider, opts ...providerOption) shim.Provider
• func NewResource(r *schema.Resource) shim.Resource
• func NewSchema(s *schema.Schema) shim.Schema
• func NewSchemaMap(m map[string]*schema.Schema) shim.SchemaMap
• func SetInstanceStateStrategy(resource shim.Resource, strategy InstanceStateStrategy)
• func WithDiffStrategy(s DiffStrategy) providerOption
• func WithPlanResourceChange(filter func(tfResourceType string) bool) providerOption
• type DiffStrategy
  • func ParseDiffStrategy(text string) (DiffStrategy, error)
  • func ParseDiffStrategyFromEnv() (DiffStrategy, bool, error)
  • func (s DiffStrategy) String() string
• type InstanceStateStrategy
  • func GetInstanceStateStrategy(resource shim.Resource) InstanceStateStrategy
  • func ParseInstanceStateStrategy(text string) (InstanceStateStrategy, error)
  • func ParseInstanceStateStrategyFromEnv() (InstanceStateStrategy, bool, error)
  • func (s InstanceStateStrategy) String() string

Constants

const UnknownVariableValue = "74D93920-ED26-11E3-AC10-0800200C9A66"

UnknownVariableValue is the sentinal defined in github.com/hashicorp/terraform/configs/hcl2shim, representing a variable whose value is not known at some particular time. The value is duplicated here in order to prevent an additional dependency - it is unlikely to ever change upstream since that would break rather a lot of things.

Functions

func IsInstanceState

func IsInstanceState(s shim.InstanceState) (*terraform.InstanceState, bool)

func NewInstanceState

func NewInstanceState(s *terraform.InstanceState) shim.InstanceState

func NewInstanceStateForResource

func NewInstanceStateForResource(s *terraform.InstanceState, resource *schema.Resource) shim.InstanceState

func NewProvider

func NewProvider(p *schema.Provider, opts ...providerOption) shim.Provider

func NewResource

func NewResource(r *schema.Resource) shim.Resource

func NewSchema

func NewSchema(s *schema.Schema) shim.Schema

func NewSchemaMap

func NewSchemaMap(m map[string]*schema.Schema) shim.SchemaMap

func SetInstanceStateStrategy

func SetInstanceStateStrategy(resource shim.Resource, strategy InstanceStateStrategy)

func WithDiffStrategy

func WithDiffStrategy(s DiffStrategy) providerOption

func WithPlanResourceChange

func WithPlanResourceChange(filter func(tfResourceType string) bool) providerOption

Selectively opt-in resources that pass the filter to using PlanResourceChange. Resources are identified by their TF type name such as aws_ssm_document.

Types

type DiffStrategy

type DiffStrategy int

Configures how the provider performs Diff. Since this is a sensitive method that can result in unexpected breaking changes, using a configurable DiffStrategy as a feature flag assists gradual rollout.

const (
	// Uses the strategy from pulumi-terraform-bridge v3.41.0 and before.
	ClassicDiff DiffStrategy = 0

	// An experimental strategy that mimics the behavior of Terraform CLI to compute PlannedState as part of the
	// diff, and performs better than ClassicDiff in complicated cases of set-nested blocks.
	PlanState DiffStrategy = 1

	// This strategy would run both PlanState and ClassicDiff strategies and compare their result, generating a
	// warning if they mismatch. It always behaves as ClassicDiff execept for the warnings.
	TryPlanState DiffStrategy = 2
)

func ParseDiffStrategy

func ParseDiffStrategy(text string) (DiffStrategy, error)

func ParseDiffStrategyFromEnv

func ParseDiffStrategyFromEnv() (DiffStrategy, bool, error)

func (DiffStrategy) String

func (s DiffStrategy) String() string

type InstanceStateStrategy

type InstanceStateStrategy int

Feature flag to configures how the provider reads instance state.

const (
	// The legacy strategy.
	ClassicInstanceState InstanceStateStrategy = iota

	// The strategy based on transcoding to cty.Value.
	CtyInstanceState
)

func GetInstanceStateStrategy

func GetInstanceStateStrategy(resource shim.Resource) InstanceStateStrategy

func ParseInstanceStateStrategy

func ParseInstanceStateStrategy(text string) (InstanceStateStrategy, error)

func ParseInstanceStateStrategyFromEnv

func ParseInstanceStateStrategyFromEnv() (InstanceStateStrategy, bool, error)

func (InstanceStateStrategy) String

func (s InstanceStateStrategy) String() string