package terraform import ( "fmt" "io" "reflect" "github.com/hashicorp/terraform/config" ) // rootModulePath is the path of the root module var rootModulePath = []string{"root"} // State keeps track of a snapshot state-of-the-world that Terraform // can use to keep track of what real world resources it is actually // managing. This is the latest format as of Terraform 0.3 type State struct { // Version is the protocol version. Currently only "1". Version int `json:"version"` // Serial is incremented on any operation that modifies // the State file. It is used to detect potentially conflicting // updates. Serial int64 `json:"serial"` // Modules contains all the modules in a breadth-first order Modules []*ModuleState `json:"modules"` } // ModuleByPath is used to lookup the module state for the given path. // This should be the prefered lookup mechanism as it allows for future // lookup optimizations. func (s *State) ModuleByPath(path []string) *ModuleState { for _, mod := range s.Modules { if reflect.DeepEqual(mod.Path, path) { return mod } } return nil } // RootModule returns the ModuleState for the root module func (s *State) RootModule() *ModuleState { return s.ModuleByPath(rootModulePath) } func (s *State) deepcopy() *State { if s == nil { return nil } n := &State{ Version: s.Version, Serial: s.Serial, Modules: make([]*ModuleState, 0, len(s.Modules)), } for _, mod := range s.Modules { n.Modules = append(n.Modules, mod.deepcopy()) } return n } // prune is used to remove any resources that are no longer required func (s *State) prune() { for _, mod := range s.Modules { mod.prune() } } func (s *State) GoString() string { return fmt.Sprintf("*%#v", *s) } // ModuleState is used to track all the state relevant to a single // module. Previous to Terraform 0.3, all state belonged to the "root" // module. type ModuleState struct { // Path is the import path from the root module. Modules imports are // always disjoint, so the path represents amodule tree Path []string `json:"path"` // Outputs declared by the module and maintained for each module // even though only the root module technically needs to be kept. // This allows operators to inspect values at the boundaries. Outputs map[string]string `json:"outputs"` // Resources is a mapping of the logically named resource to // the state of the resource. Each resource may actually have // N instances underneath, although a user only needs to think // about the 1:1 case. Resources map[string]*ResourceState `json:"resources"` } // Orphans returns a list of keys of resources that are in the State // but aren't present in the configuration itself. Hence, these keys // represent the state of resources that are orphans. func (m *ModuleState) Orphans(c *config.Config) []string { keys := make(map[string]struct{}) for k, _ := range m.Resources { keys[k] = struct{}{} } for _, r := range c.Resources { delete(keys, r.Id()) // Mark all the counts as not orphans. for i := 0; i < r.Count; i++ { delete(keys, fmt.Sprintf("%s.%d", r.Id(), i)) } } result := make([]string, 0, len(keys)) for k, _ := range keys { result = append(result, k) } return result } func (m *ModuleState) init() { if m.Outputs == nil { m.Outputs = make(map[string]string) } if m.Resources == nil { m.Resources = make(map[string]*ResourceState) } } func (m *ModuleState) deepcopy() *ModuleState { if m == nil { return nil } n := &ModuleState{ Path: make([]string, len(m.Path)), Outputs: make(map[string]string, len(m.Outputs)), Resources: make(map[string]*ResourceState, len(m.Resources)), } copy(n.Path, m.Path) for k, v := range m.Outputs { n.Outputs[k] = v } for k, v := range m.Resources { n.Resources[k] = v.deepcopy() } return n } // prune is used to remove any resources that are no longer required func (m *ModuleState) prune() { for k, v := range m.Resources { v.prune() if (v.Primary == nil || v.Primary.ID == "") && len(v.Tainted) == 0 { delete(m.Resources, k) } } } func (m *ModuleState) GoString() string { return fmt.Sprintf("*%#v", *m) } // ResourceState holds the state of a resource that is used so that // a provider can find and manage an existing resource as well as for // storing attributes that are used to populate variables of child // resources. // // Attributes has attributes about the created resource that are // queryable in interpolation: "${type.id.attr}" // // Extra is just extra data that a provider can return that we store // for later, but is not exposed in any way to the user. // type ResourceState struct { // This is filled in and managed by Terraform, and is the resource // type itself such as "mycloud_instance". If a resource provider sets // this value, it won't be persisted. Type string `json:"type"` // Dependencies are a list of things that this resource relies on // existing to remain intact. For example: an AWS instance might // depend on a subnet (which itself might depend on a VPC, and so // on). // // Terraform uses this information to build valid destruction // orders and to warn the user if they're destroying a resource that // another resource depends on. // // Things can be put into this list that may not be managed by // Terraform. If Terraform doesn't find a matching ID in the // overall state, then it assumes it isn't managed and doesn't // worry about it. Dependencies []string `json:"depends_on,omitempty"` // Primary is the current active instance for this resource. // It can be replaced but only after a successful creation. // This is the instances on which providers will act. Primary *InstanceState `json:"primary"` // Tainted is used to track any underlying instances that // have been created but are in a bad or unknown state and // need to be cleaned up subsequently. In the // standard case, there is only at most a single instance. // However, in pathological cases, it is possible for the number // of instances to accumulate. Tainted []*InstanceState `json:"tainted,omitempty"` } func (r *ResourceState) init() { if r.Primary == nil { r.Primary = &InstanceState{} r.Primary.init() } } func (r *ResourceState) deepcopy() *ResourceState { if r == nil { return nil } n := &ResourceState{ Type: r.Type, Dependencies: make([]string, len(r.Dependencies)), Primary: r.Primary.deepcopy(), Tainted: make([]*InstanceState, 0, len(r.Tainted)), } copy(n.Dependencies, r.Dependencies) for _, inst := range r.Tainted { n.Tainted = append(n.Tainted, inst.deepcopy()) } return n } // prune is used to remove any instances that are no longer required func (r *ResourceState) prune() { n := len(r.Tainted) for i := 0; i < n; i++ { inst := r.Tainted[i] if inst.ID == "" { copy(r.Tainted[i:], r.Tainted[i+1:]) r.Tainted[n-1] = nil n-- } } r.Tainted = r.Tainted[:n] } func (s *ResourceState) GoString() string { return fmt.Sprintf("*%#v", *s) } // MergeDiff takes a ResourceDiff and merges the attributes into // this resource state in order to generate a new state. This new // state can be used to provide updated attribute lookups for // variable interpolation. // // If the diff attribute requires computing the value, and hence // won't be available until apply, the value is replaced with the // computeID. func (s *ResourceState) MergeDiff(d *ResourceDiff) *ResourceState { var result ResourceState if s != nil { result = *s } result.init() if s != nil { for k, v := range s.Primary.Attributes { result.Primary.Attributes[k] = v } } if d != nil { for k, diff := range d.Attributes { if diff.NewRemoved { delete(result.Primary.Attributes, k) continue } if diff.NewComputed { result.Primary.Attributes[k] = config.UnknownVariableValue continue } result.Primary.Attributes[k] = diff.New } } return &result } // InstanceState is used to track the unique state information belonging // to a given instance. type InstanceState struct { // A unique ID for this resource. This is opaque to Terraform // and is only meant as a lookup mechanism for the providers. ID string `json:"id"` // Tainted is used to mark a resource as existing but being in // an unknown or errored state. Hence, it is 'tainted' and should // be destroyed and replaced on the next fun. Tainted bool `json:"tainted,omitempty"` // Attributes are basic information about the resource. Any keys here // are accessible in variable format within Terraform configurations: // ${resourcetype.name.attribute}. Attributes map[string]string `json:"attributes,omitempty"` // Ephemeral is used to store any state associated with this instance // that is necessary for the Terraform run to complete, but is not // persisted to a state file. Ephemeral EphemeralState `json:"-"` } func (i *InstanceState) init() { if i.Attributes == nil { i.Attributes = make(map[string]string) } i.Ephemeral.init() } func (i *InstanceState) deepcopy() *InstanceState { if i == nil { return nil } n := &InstanceState{ ID: i.ID, Tainted: i.Tainted, Attributes: make(map[string]string, len(i.Attributes)), Ephemeral: *i.Ephemeral.deepcopy(), } for k, v := range i.Attributes { n.Attributes[k] = v } return n } func (i *InstanceState) GoString() string { return fmt.Sprintf("*%#v", *i) } // EphemeralState is used for transient state that is only kept in-memory type EphemeralState struct { // ConnInfo is used for the providers to export information which is // used to connect to the resource for provisioning. For example, // this could contain SSH or WinRM credentials. ConnInfo map[string]string `json:"-"` } func (e *EphemeralState) init() { if e.ConnInfo == nil { e.ConnInfo = make(map[string]string) } } func (e *EphemeralState) deepcopy() *EphemeralState { if e == nil { return nil } n := &EphemeralState{ ConnInfo: make(map[string]string, len(e.ConnInfo)), } for k, v := range e.ConnInfo { n.ConnInfo[k] = v } return n } // ReadState reads a state structure out of a reader in the format that // was written by WriteState. func ReadState(src io.Reader) (*State, error) { // TODO return nil, nil } // WriteState writes a state somewhere in a binary format. func WriteState(d *State, dst io.Writer) error { // TODO return nil }