package packer import ( "encoding/json" "fmt" "github.com/mitchellh/mapstructure" ) // The rawTemplate struct represents the structure of a template read // directly from a file. The builders and other components map just to // "interface{}" pointers since we actually don't know what their contents // are until we read the "type" field. type rawTemplate struct { Name string Builders []map[string]interface{} Hooks map[string][]string Provisioners []map[string]interface{} Outputs []map[string]interface{} } // The Template struct represents a parsed template, parsed into the most // completed form it can be without additional processing by the caller. type Template struct { Name string Builders map[string]rawBuilderConfig Hooks map[string][]string Provisioners []rawProvisionerConfig } // The rawBuilderConfig struct represents a raw, unprocessed builder // configuration. It contains the name of the builder as well as the // raw configuration. If requested, this is used to compile into a full // builder configuration at some point. type rawBuilderConfig struct { Name string Type string rawConfig interface{} } // rawProvisionerConfig represents a raw, unprocessed provisioner configuration. // It contains the type of the provisioner as well as the raw configuration // that is handed to the provisioner for it to process. type rawProvisionerConfig struct { Type string Override map[string]interface{} rawConfig interface{} } // ParseTemplate takes a byte slice and parses a Template from it, returning // the template and possibly errors while loading the template. The error // could potentially be a MultiError, representing multiple errors. Knowing // and checking for this can be useful, if you wish to format it in a certain // way. func ParseTemplate(data []byte) (t *Template, err error) { var rawTpl rawTemplate err = json.Unmarshal(data, &rawTpl) if err != nil { return } t = &Template{} t.Name = rawTpl.Name t.Builders = make(map[string]rawBuilderConfig) t.Hooks = rawTpl.Hooks t.Provisioners = make([]rawProvisionerConfig, len(rawTpl.Provisioners)) errors := make([]error, 0) // Gather all the builders for i, v := range rawTpl.Builders { var raw rawBuilderConfig if err := mapstructure.Decode(v, &raw); err != nil { if merr, ok := err.(*mapstructure.Error); ok { for _, err := range merr.Errors { errors = append(errors, fmt.Errorf("builder %d: %s", i+1, err)) } } else { errors = append(errors, fmt.Errorf("builder %d: %s", i+1, err)) } continue } if raw.Type == "" { errors = append(errors, fmt.Errorf("builder %d: missing 'type'", i+1)) continue } // Attempt to get the name of the builder. If the "name" key // missing, use the "type" field, which is guaranteed to exist // at this point. if raw.Name == "" { raw.Name = raw.Type } // Check if we already have a builder with this name and error if so if _, ok := t.Builders[raw.Name]; ok { errors = append(errors, fmt.Errorf("builder with name '%s' already exists", raw.Name)) continue } raw.rawConfig = v t.Builders[raw.Name] = raw } // Gather all the provisioners for i, v := range rawTpl.Provisioners { raw := &t.Provisioners[i] if err := mapstructure.Decode(v, raw); err != nil { if merr, ok := err.(*mapstructure.Error); ok { for _, err := range merr.Errors { errors = append(errors, fmt.Errorf("provisioner %d: %s", i+1, err)) } } else { errors = append(errors, fmt.Errorf("provisioner %d: %s", i+1, err)) } continue } if raw.Type == "" { errors = append(errors, fmt.Errorf("provisioner %d: missing 'type'", i+1)) continue } raw.rawConfig = v } // If there were errors, we put it into a MultiError and return if len(errors) > 0 { err = &MultiError{errors} return } return } // BuildNames returns a slice of the available names of builds that // this template represents. func (t *Template) BuildNames() []string { names := make([]string, 0, len(t.Builders)) for name, _ := range t.Builders { names = append(names, name) } return names } // Build returns a Build for the given name. // // If the build does not exist as part of this template, an error is // returned. func (t *Template) Build(name string, components *ComponentFinder) (b Build, err error) { // Setup the Builder builderConfig, ok := t.Builders[name] if !ok { err = fmt.Errorf("No such build found in template: %s", name) return } // We panic if there is no builder function because this is really // an internal bug that always needs to be fixed, not an error. if components.Builder == nil { panic("no builder function") } // Panic if there are provisioners on the template but no provisioner // component finder. This is always an internal error, so we panic. if len(t.Provisioners) > 0 && components.Provisioner == nil { panic("no provisioner function") } builder, err := components.Builder(builderConfig.Type) if err != nil { return } if builder == nil { err = fmt.Errorf("Builder type not found: %s", builderConfig.Type) return } // Gather the Hooks hooks := make(map[string][]Hook) for tplEvent, tplHooks := range t.Hooks { curHooks := make([]Hook, 0, len(tplHooks)) for _, hookName := range tplHooks { var hook Hook hook, err = components.Hook(hookName) if err != nil { return } if hook == nil { err = fmt.Errorf("Hook not found: %s", hookName) return } curHooks = append(curHooks, hook) } hooks[tplEvent] = curHooks } // Prepare the provisioners provisioners := make([]coreBuildProvisioner, 0, len(t.Provisioners)) for _, rawProvisioner := range t.Provisioners { var provisioner Provisioner provisioner, err = components.Provisioner(rawProvisioner.Type) if err != nil { return } if provisioner == nil { err = fmt.Errorf("Provisioner type not found: %s", rawProvisioner.Type) return } configs := make([]interface{}, 1, 2) configs[0] = rawProvisioner.rawConfig if rawProvisioner.Override != nil { if override, ok := rawProvisioner.Override[name]; ok { configs = append(configs, override) } } coreProv := coreBuildProvisioner{provisioner, configs} provisioners = append(provisioners, coreProv) } b = &coreBuild{ name: name, builder: builder, builderConfig: builderConfig.rawConfig, hooks: hooks, provisioners: provisioners, } return }