package command import ( "fmt" "io/ioutil" "os" "strings" "github.com/hashicorp/nomad/api" flaghelper "github.com/hashicorp/nomad/helper/flags" "github.com/posener/complete" ) type JobDispatchCommand struct { Meta } func (c *JobDispatchCommand) Help() string { helpText := ` Usage: nomad job dispatch [options] [input source] Dispatch creates an instance of a parameterized job. A data payload to the dispatched instance can be provided via stdin by using "-" or by specifying a path to a file. Metadata can be supplied by using the meta flag one or more times. An optional idempotency token can be used to prevent more than one instance of the job to be dispatched. If an instance with the same token already exists, the command returns without any action. Upon successful creation, the dispatched job ID will be printed and the triggered evaluation will be monitored. This can be disabled by supplying the detach flag. When ACLs are enabled, this command requires a token with the 'dispatch-job' capability for the job's namespace. General Options: ` + generalOptionsUsage(usageOptsDefault) + ` Dispatch Options: -meta = Meta takes a key/value pair separated by "=". The metadata key will be merged into the job's metadata. The job may define a default value for the key which is overridden when dispatching. The flag can be provided more than once to inject multiple metadata key/value pairs. Arbitrary keys are not allowed. The parameterized job must allow the key to be merged. -detach Return immediately instead of entering monitor mode. After job dispatch, the evaluation ID will be printed to the screen, which can be used to examine the evaluation using the eval-status command. -idempotency-token Optional identifier used to prevent more than one instance of the job from being dispatched. -verbose Display full information. ` return strings.TrimSpace(helpText) } func (c *JobDispatchCommand) Synopsis() string { return "Dispatch an instance of a parameterized job" } func (c *JobDispatchCommand) AutocompleteFlags() complete.Flags { return mergeAutocompleteFlags(c.Meta.AutocompleteFlags(FlagSetClient), complete.Flags{ "-meta": complete.PredictAnything, "-detach": complete.PredictNothing, "-idempotency-token": complete.PredictAnything, "-verbose": complete.PredictNothing, }) } func (c *JobDispatchCommand) AutocompleteArgs() complete.Predictor { return complete.PredictFunc(func(a complete.Args) []string { client, err := c.Meta.Client() if err != nil { return nil } resp, _, err := client.Jobs().PrefixList(a.Last) if err != nil { return []string{} } // filter by parameterized jobs matches := make([]string, 0, len(resp)) for _, job := range resp { if job.ParameterizedJob { matches = append(matches, job.ID) } } return matches }) } func (c *JobDispatchCommand) Name() string { return "job dispatch" } func (c *JobDispatchCommand) Run(args []string) int { var detach, verbose bool var idempotencyToken string var meta []string flags := c.Meta.FlagSet(c.Name(), FlagSetClient) flags.Usage = func() { c.Ui.Output(c.Help()) } flags.BoolVar(&detach, "detach", false, "") flags.BoolVar(&verbose, "verbose", false, "") flags.StringVar(&idempotencyToken, "idempotency-token", "", "") flags.Var((*flaghelper.StringFlag)(&meta), "meta", "") if err := flags.Parse(args); err != nil { return 1 } // Truncate the id unless full length is requested length := shortId if verbose { length = fullId } // Check that we got one or two arguments args = flags.Args() if l := len(args); l < 1 || l > 2 { c.Ui.Error("This command takes one or two argument: [input source]") c.Ui.Error(commandErrorText(c)) return 1 } job := args[0] var payload []byte var readErr error // Read the input if len(args) == 2 { switch args[1] { case "-": payload, readErr = ioutil.ReadAll(os.Stdin) default: payload, readErr = ioutil.ReadFile(args[1]) } if readErr != nil { c.Ui.Error(fmt.Sprintf("Error reading input data: %v", readErr)) return 1 } } // Build the meta metaMap := make(map[string]string, len(meta)) for _, m := range meta { split := strings.SplitN(m, "=", 2) if len(split) != 2 { c.Ui.Error(fmt.Sprintf("Error parsing meta value: %v", m)) return 1 } metaMap[split[0]] = split[1] } // Get the HTTP client client, err := c.Meta.Client() if err != nil { c.Ui.Error(fmt.Sprintf("Error initializing client: %s", err)) return 1 } // Dispatch the job w := &api.WriteOptions{ IdempotencyToken: idempotencyToken, } resp, _, err := client.Jobs().Dispatch(job, metaMap, payload, w) if err != nil { c.Ui.Error(fmt.Sprintf("Failed to dispatch job: %s", err)) return 1 } // See if an evaluation was created. If the job is periodic there will be no // eval. evalCreated := resp.EvalID != "" basic := []string{ fmt.Sprintf("Dispatched Job ID|%s", resp.DispatchedJobID), } if evalCreated { basic = append(basic, fmt.Sprintf("Evaluation ID|%s", limit(resp.EvalID, length))) } c.Ui.Output(formatKV(basic)) // Nothing to do if detach || !evalCreated { return 0 } c.Ui.Output("") mon := newMonitor(c.Ui, client, length) return mon.monitor(resp.EvalID) }