// Copyright 2016-2018, Pulumi Corporation. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package cmd import ( "context" "github.com/pkg/errors" "github.com/spf13/cobra" "github.com/pulumi/pulumi/pkg/backend" "github.com/pulumi/pulumi/pkg/engine" "github.com/pulumi/pulumi/pkg/util/cmdutil" ) func newUpdateCmd() *cobra.Command { var debug bool var expectNop bool var message string var stack string // Flags for engine.UpdateOptions. var analyzers []string var color colorFlag var diffDisplay bool var nonInteractive bool var parallel int var showConfig bool var showReplacementSteps bool var showSames bool var skipPreview bool var yes bool var cmd = &cobra.Command{ Use: "update", Aliases: []string{"up"}, SuggestFor: []string{"deploy", "push"}, Short: "Update the resources in a stack", Long: "Update the resources in a stack.\n" + "\n" + "This command updates an existing stack whose state is represented by the existing checkpoint\n" + "file. The new desired state is computed by running a Pulumi program, and extracting all resource\n" + "allocations from its resulting object graph. These allocations are then compared against the\n" + "existing state to determine what operations must take place to achieve the desired state. This\n" + "command results in a checkpoint containing a full snapshot of the stack's new resource state, so\n" + "that it may be updated incrementally again later.\n" + "\n" + "The program to run is loaded from the project in the current directory. Use the `-C` or\n" + "`--cwd` flag to use a different directory.", Args: cmdutil.NoArgs, Run: cmdutil.RunFunc(func(cmd *cobra.Command, args []string) error { interactive := isInteractive(nonInteractive) if !interactive { yes = true // auto-approve changes, since we cannot prompt. } opts, err := updateFlagsToOptions(interactive, skipPreview, yes) if err != nil { return err } s, err := requireStack(stack, true) if err != nil { return err } proj, root, err := readProject() if err != nil { return err } m, err := getUpdateMetadata(message, root) if err != nil { return errors.Wrap(err, "gathering environment metadata") } opts.Engine = engine.UpdateOptions{ Analyzers: analyzers, Parallel: parallel, Debug: debug, } opts.Display = backend.DisplayOptions{ Color: color.Colorization(), ShowConfig: showConfig, ShowReplacementSteps: showReplacementSteps, ShowSameResources: showSames, IsInteractive: interactive, DiffDisplay: diffDisplay, Debug: debug, } changes, err := s.Update(commandContext(), proj, root, m, opts, cancellationScopes) switch { case err == context.Canceled: return errors.New("update cancelled") case err != nil: return err case expectNop && changes != nil && changes.HasChanges(): return errors.New("error: no changes were expected but changes occurred") default: return nil } }), } cmd.PersistentFlags().BoolVarP( &debug, "debug", "d", false, "Print detailed debugging output during resource operations") cmd.PersistentFlags().BoolVar( &expectNop, "expect-no-changes", false, "Return an error if any changes occur during this update") cmd.PersistentFlags().StringVarP( &stack, "stack", "s", "", "Choose a stack other than the currently selected one") cmd.PersistentFlags().StringVarP( &message, "message", "m", "", "Optional message to associate with the update operation") // Flags for engine.UpdateOptions. cmd.PersistentFlags().StringSliceVar( &analyzers, "analyzer", []string{}, "Run one or more analyzers as part of this update") cmd.PersistentFlags().VarP( &color, "color", "c", "Colorize output. Choices are: always, never, raw, auto") cmd.PersistentFlags().BoolVar( &diffDisplay, "diff", false, "Display operation as a rich diff showing the overall change") cmd.PersistentFlags().BoolVar( &nonInteractive, "non-interactive", false, "Disable interactive mode") cmd.PersistentFlags().IntVarP( ¶llel, "parallel", "p", 0, "Allow P resource operations to run in parallel at once (<=1 for no parallelism)") cmd.PersistentFlags().BoolVar( &showConfig, "show-config", false, "Show configuration keys and variables") cmd.PersistentFlags().BoolVar( &showReplacementSteps, "show-replacement-steps", false, "Show detailed resource replacement creates and deletes instead of a single step") cmd.PersistentFlags().BoolVar( &showSames, "show-sames", false, "Show resources that don't need be updated because they haven't changed, alongside those that do") cmd.PersistentFlags().BoolVar( &skipPreview, "skip-preview", false, "Do not perform a preview before performing the update") cmd.PersistentFlags().BoolVarP( &yes, "yes", "y", false, "Automatically approve and perform the update after previewing it") return cmd }