package terraform import ( "github.com/hashicorp/terraform/config/module" "github.com/hashicorp/terraform/dag" ) // PlanGraphBuilder implements GraphBuilder and is responsible for building // a graph for planning (creating a Terraform Diff). // // The primary difference between this graph and others: // // * Based on the config since it represents the target state // // * Ignores lifecycle options since no lifecycle events occur here. This // simplifies the graph significantly since complex transforms such as // create-before-destroy can be completely ignored. // type PlanGraphBuilder struct { // Module is the root module for the graph to build. Module *module.Tree // State is the current state State *State // Providers is the list of providers supported. Providers []string // Targets are resources to target Targets []string // DisableReduce, if true, will not reduce the graph. Great for testing. DisableReduce bool // Validate will do structural validation of the graph. Validate bool } // See GraphBuilder func (b *PlanGraphBuilder) Build(path []string) (*Graph, error) { return (&BasicGraphBuilder{ Steps: b.Steps(), Validate: b.Validate, Name: "PlanGraphBuilder", }).Build(path) } // See GraphBuilder func (b *PlanGraphBuilder) Steps() []GraphTransformer { // Custom factory for creating providers. providerFactory := func(name string, path []string) GraphNodeProvider { return &NodeApplyableProvider{ NameValue: name, PathValue: path, } } concreteResource := func(a *NodeAbstractResource) dag.Vertex { return &NodePlannableResource{ NodeAbstractResource: a, } } concreteResourceOrphan := func(a *NodeAbstractResource) dag.Vertex { return &NodePlannableResourceOrphan{ NodeAbstractResource: a, } } steps := []GraphTransformer{ // Creates all the resources represented in the config &ConfigTransformer{ Concrete: concreteResource, Module: b.Module, }, // Add the outputs &OutputTransformer{Module: b.Module}, // Add orphan resources &OrphanResourceTransformer{ Concrete: concreteResourceOrphan, State: b.State, Module: b.Module, }, // Attach the configuration to any resources &AttachResourceConfigTransformer{Module: b.Module}, // Attach the state &AttachStateTransformer{State: b.State}, // Connect so that the references are ready for targeting. We'll // have to connect again later for providers and so on. &ReferenceTransformer{}, // Target &TargetsTransformer{Targets: b.Targets}, // Create all the providers &MissingProviderTransformer{Providers: b.Providers, Factory: providerFactory}, &ProviderTransformer{}, &DisableProviderTransformer{}, &ParentProviderTransformer{}, &AttachProviderConfigTransformer{Module: b.Module}, // Add root variables &RootVariableTransformer{Module: b.Module}, // Add module variables &ModuleVariableTransformer{Module: b.Module}, // Connect references again to connect the providers, module variables, // etc. This is idempotent. &ReferenceTransformer{}, // Single root &RootTransformer{}, } if !b.DisableReduce { // Perform the transitive reduction to make our graph a bit // more sane if possible (it usually is possible). steps = append(steps, &TransitiveReductionTransformer{}) } return steps }