github.com/graywolf-at-work-2/terraform-vendor@v1.4.5/internal/command/views/operation.go (about)

     1  package views
     2  
     3  import (
     4  	"bytes"
     5  	"fmt"
     6  	"strings"
     7  
     8  	"github.com/hashicorp/terraform/internal/addrs"
     9  	"github.com/hashicorp/terraform/internal/command/arguments"
    10  	"github.com/hashicorp/terraform/internal/command/format"
    11  	"github.com/hashicorp/terraform/internal/command/jsonformat"
    12  	"github.com/hashicorp/terraform/internal/command/jsonplan"
    13  	"github.com/hashicorp/terraform/internal/command/jsonprovider"
    14  	"github.com/hashicorp/terraform/internal/command/views/json"
    15  	"github.com/hashicorp/terraform/internal/plans"
    16  	"github.com/hashicorp/terraform/internal/states/statefile"
    17  	"github.com/hashicorp/terraform/internal/terraform"
    18  	"github.com/hashicorp/terraform/internal/tfdiags"
    19  )
    20  
    21  type Operation interface {
    22  	Interrupted()
    23  	FatalInterrupt()
    24  	Stopping()
    25  	Cancelled(planMode plans.Mode)
    26  
    27  	EmergencyDumpState(stateFile *statefile.File) error
    28  
    29  	PlannedChange(change *plans.ResourceInstanceChangeSrc)
    30  	Plan(plan *plans.Plan, schemas *terraform.Schemas)
    31  	PlanNextStep(planPath string)
    32  
    33  	Diagnostics(diags tfdiags.Diagnostics)
    34  }
    35  
    36  func NewOperation(vt arguments.ViewType, inAutomation bool, view *View) Operation {
    37  	switch vt {
    38  	case arguments.ViewHuman:
    39  		return &OperationHuman{view: view, inAutomation: inAutomation}
    40  	default:
    41  		panic(fmt.Sprintf("unknown view type %v", vt))
    42  	}
    43  }
    44  
    45  type OperationHuman struct {
    46  	view *View
    47  
    48  	// inAutomation indicates that commands are being run by an
    49  	// automated system rather than directly at a command prompt.
    50  	//
    51  	// This is a hint not to produce messages that expect that a user can
    52  	// run a follow-up command, perhaps because Terraform is running in
    53  	// some sort of workflow automation tool that abstracts away the
    54  	// exact commands that are being run.
    55  	inAutomation bool
    56  }
    57  
    58  var _ Operation = (*OperationHuman)(nil)
    59  
    60  func (v *OperationHuman) Interrupted() {
    61  	v.view.streams.Println(format.WordWrap(interrupted, v.view.outputColumns()))
    62  }
    63  
    64  func (v *OperationHuman) FatalInterrupt() {
    65  	v.view.streams.Eprintln(format.WordWrap(fatalInterrupt, v.view.errorColumns()))
    66  }
    67  
    68  func (v *OperationHuman) Stopping() {
    69  	v.view.streams.Println("Stopping operation...")
    70  }
    71  
    72  func (v *OperationHuman) Cancelled(planMode plans.Mode) {
    73  	switch planMode {
    74  	case plans.DestroyMode:
    75  		v.view.streams.Println("Destroy cancelled.")
    76  	default:
    77  		v.view.streams.Println("Apply cancelled.")
    78  	}
    79  }
    80  
    81  func (v *OperationHuman) EmergencyDumpState(stateFile *statefile.File) error {
    82  	stateBuf := new(bytes.Buffer)
    83  	jsonErr := statefile.Write(stateFile, stateBuf)
    84  	if jsonErr != nil {
    85  		return jsonErr
    86  	}
    87  	v.view.streams.Eprintln(stateBuf)
    88  	return nil
    89  }
    90  
    91  func (v *OperationHuman) Plan(plan *plans.Plan, schemas *terraform.Schemas) {
    92  	outputs, changed, drift, attrs, err := jsonplan.MarshalForRenderer(plan, schemas)
    93  	if err != nil {
    94  		v.view.streams.Eprintf("Failed to marshal plan to json: %s", err)
    95  		return
    96  	}
    97  
    98  	renderer := jsonformat.Renderer{
    99  		Colorize:            v.view.colorize,
   100  		Streams:             v.view.streams,
   101  		RunningInAutomation: v.inAutomation,
   102  	}
   103  
   104  	jplan := jsonformat.Plan{
   105  		PlanFormatVersion:     jsonplan.FormatVersion,
   106  		ProviderFormatVersion: jsonprovider.FormatVersion,
   107  		OutputChanges:         outputs,
   108  		ResourceChanges:       changed,
   109  		ResourceDrift:         drift,
   110  		ProviderSchemas:       jsonprovider.MarshalForRenderer(schemas),
   111  		RelevantAttributes:    attrs,
   112  	}
   113  
   114  	// Side load some data that we can't extract from the JSON plan.
   115  	var opts []jsonformat.PlanRendererOpt
   116  	if !plan.CanApply() {
   117  		opts = append(opts, jsonformat.CanNotApply)
   118  	}
   119  	if plan.Errored {
   120  		opts = append(opts, jsonformat.Errored)
   121  	}
   122  
   123  	renderer.RenderHumanPlan(jplan, plan.UIMode, opts...)
   124  }
   125  
   126  func (v *OperationHuman) PlannedChange(change *plans.ResourceInstanceChangeSrc) {
   127  	// PlannedChange is primarily for machine-readable output in order to
   128  	// get a per-resource-instance change description. We don't use it
   129  	// with OperationHuman because the output of Plan already includes the
   130  	// change details for all resource instances.
   131  }
   132  
   133  // PlanNextStep gives the user some next-steps, unless we're running in an
   134  // automation tool which is presumed to provide its own UI for further actions.
   135  func (v *OperationHuman) PlanNextStep(planPath string) {
   136  	if v.inAutomation {
   137  		return
   138  	}
   139  	v.view.outputHorizRule()
   140  
   141  	if planPath == "" {
   142  		v.view.streams.Print(
   143  			"\n" + strings.TrimSpace(format.WordWrap(planHeaderNoOutput, v.view.outputColumns())) + "\n",
   144  		)
   145  	} else {
   146  		v.view.streams.Printf(
   147  			"\n"+strings.TrimSpace(format.WordWrap(planHeaderYesOutput, v.view.outputColumns()))+"\n",
   148  			planPath, planPath,
   149  		)
   150  	}
   151  }
   152  
   153  func (v *OperationHuman) Diagnostics(diags tfdiags.Diagnostics) {
   154  	v.view.Diagnostics(diags)
   155  }
   156  
   157  type OperationJSON struct {
   158  	view *JSONView
   159  }
   160  
   161  var _ Operation = (*OperationJSON)(nil)
   162  
   163  func (v *OperationJSON) Interrupted() {
   164  	v.view.Log(interrupted)
   165  }
   166  
   167  func (v *OperationJSON) FatalInterrupt() {
   168  	v.view.Log(fatalInterrupt)
   169  }
   170  
   171  func (v *OperationJSON) Stopping() {
   172  	v.view.Log("Stopping operation...")
   173  }
   174  
   175  func (v *OperationJSON) Cancelled(planMode plans.Mode) {
   176  	switch planMode {
   177  	case plans.DestroyMode:
   178  		v.view.Log("Destroy cancelled")
   179  	default:
   180  		v.view.Log("Apply cancelled")
   181  	}
   182  }
   183  
   184  func (v *OperationJSON) EmergencyDumpState(stateFile *statefile.File) error {
   185  	stateBuf := new(bytes.Buffer)
   186  	jsonErr := statefile.Write(stateFile, stateBuf)
   187  	if jsonErr != nil {
   188  		return jsonErr
   189  	}
   190  	v.view.StateDump(stateBuf.String())
   191  	return nil
   192  }
   193  
   194  // Log a change summary and a series of "planned" messages for the changes in
   195  // the plan.
   196  func (v *OperationJSON) Plan(plan *plans.Plan, schemas *terraform.Schemas) {
   197  	for _, dr := range plan.DriftedResources {
   198  		// In refresh-only mode, we output all resources marked as drifted,
   199  		// including those which have moved without other changes. In other plan
   200  		// modes, move-only changes will be included in the planned changes, so
   201  		// we skip them here.
   202  		if dr.Action != plans.NoOp || plan.UIMode == plans.RefreshOnlyMode {
   203  			v.view.ResourceDrift(json.NewResourceInstanceChange(dr))
   204  		}
   205  	}
   206  
   207  	cs := &json.ChangeSummary{
   208  		Operation: json.OperationPlanned,
   209  	}
   210  	for _, change := range plan.Changes.Resources {
   211  		if change.Action == plans.Delete && change.Addr.Resource.Resource.Mode == addrs.DataResourceMode {
   212  			// Avoid rendering data sources on deletion
   213  			continue
   214  		}
   215  		switch change.Action {
   216  		case plans.Create:
   217  			cs.Add++
   218  		case plans.Delete:
   219  			cs.Remove++
   220  		case plans.Update:
   221  			cs.Change++
   222  		case plans.CreateThenDelete, plans.DeleteThenCreate:
   223  			cs.Add++
   224  			cs.Remove++
   225  		}
   226  
   227  		if change.Action != plans.NoOp || !change.Addr.Equal(change.PrevRunAddr) {
   228  			v.view.PlannedChange(json.NewResourceInstanceChange(change))
   229  		}
   230  	}
   231  
   232  	v.view.ChangeSummary(cs)
   233  
   234  	var rootModuleOutputs []*plans.OutputChangeSrc
   235  	for _, output := range plan.Changes.Outputs {
   236  		if !output.Addr.Module.IsRoot() {
   237  			continue
   238  		}
   239  		rootModuleOutputs = append(rootModuleOutputs, output)
   240  	}
   241  	if len(rootModuleOutputs) > 0 {
   242  		v.view.Outputs(json.OutputsFromChanges(rootModuleOutputs))
   243  	}
   244  }
   245  
   246  func (v *OperationJSON) PlannedChange(change *plans.ResourceInstanceChangeSrc) {
   247  	if change.Action == plans.Delete && change.Addr.Resource.Resource.Mode == addrs.DataResourceMode {
   248  		// Avoid rendering data sources on deletion
   249  		return
   250  	}
   251  	v.view.PlannedChange(json.NewResourceInstanceChange(change))
   252  }
   253  
   254  // PlanNextStep does nothing for the JSON view as it is a hook for user-facing
   255  // output only applicable to human-readable UI.
   256  func (v *OperationJSON) PlanNextStep(planPath string) {
   257  }
   258  
   259  func (v *OperationJSON) Diagnostics(diags tfdiags.Diagnostics) {
   260  	v.view.Diagnostics(diags)
   261  }
   262  
   263  const fatalInterrupt = `
   264  Two interrupts received. Exiting immediately. Note that data loss may have occurred.
   265  `
   266  
   267  const interrupted = `
   268  Interrupt received.
   269  Please wait for Terraform to exit or data loss may occur.
   270  Gracefully shutting down...
   271  `
   272  
   273  const planHeaderNoOutput = `
   274  Note: You didn't use the -out option to save this plan, so Terraform can't guarantee to take exactly these actions if you run "terraform apply" now.
   275  `
   276  
   277  const planHeaderYesOutput = `
   278  Saved the plan to: %s
   279  
   280  To perform exactly these actions, run the following command to apply:
   281      terraform apply %q
   282  `