2017-06-26 23:46:34 +02:00
|
|
|
// Copyright 2016-2017, Pulumi Corporation. All rights reserved.
|
2017-03-15 23:40:06 +01:00
|
|
|
|
2017-09-22 04:18:21 +02:00
|
|
|
package cmd
|
2017-03-15 23:40:06 +01:00
|
|
|
|
|
|
|
import (
|
2017-10-31 02:39:58 +01:00
|
|
|
"fmt"
|
|
|
|
"os"
|
|
|
|
"path/filepath"
|
|
|
|
|
|
|
|
"github.com/pkg/errors"
|
2017-03-15 23:40:06 +01:00
|
|
|
"github.com/spf13/cobra"
|
Make major commands more pleasant
This change eliminates the need to constantly type in the environment
name when performing major commands like configuration, planning, and
deployment. It's probably due to my age, however, I keep fat-fingering
simple commands in front of investors and I am embarrassed!
In the new model, there is a notion of a "current environment", and
I have modeled it kinda sorta just like Git's notion of "current branch."
By default, the current environment is set when you `init` something.
Otherwise, there is the `coco env select <env>` command to change it.
(Running this command w/out a new <env> will show you the current one.)
The major commands `config`, `plan`, `deploy`, and `destroy` will prefer
to use the current environment, unless it is overridden by using the
--env flag. All of the `coco env <cmd> <env>` commands still require the
explicit passing of an environment which seems reasonable since they are,
after all, about manipulating environments.
As part of this, I've overhauled the aging workspace settings cruft,
which had fallen into disrepair since the initial prototype.
2017-03-22 03:23:32 +01:00
|
|
|
|
2017-10-31 02:39:58 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/apitype"
|
2017-09-22 04:18:21 +02:00
|
|
|
"github.com/pulumi/pulumi/pkg/engine"
|
2017-10-19 00:37:18 +02:00
|
|
|
"github.com/pulumi/pulumi/pkg/resource/config"
|
2017-10-31 02:39:58 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/tokens"
|
|
|
|
"github.com/pulumi/pulumi/pkg/util/archive"
|
2017-09-22 04:18:21 +02:00
|
|
|
"github.com/pulumi/pulumi/pkg/util/cmdutil"
|
2017-10-31 02:39:58 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/workspace"
|
2017-03-15 23:40:06 +01:00
|
|
|
)
|
|
|
|
|
2017-09-23 00:15:42 +02:00
|
|
|
func newPreviewCmd() *cobra.Command {
|
2017-10-31 02:39:58 +01:00
|
|
|
if usePulumiCloudCommands() {
|
|
|
|
return newCloudPreviewCmd()
|
|
|
|
}
|
|
|
|
return newFAFPreviewCmd()
|
|
|
|
}
|
|
|
|
|
|
|
|
func newFAFPreviewCmd() *cobra.Command {
|
2017-03-15 23:40:06 +01:00
|
|
|
var analyzers []string
|
2017-07-14 02:09:46 +02:00
|
|
|
var debug bool
|
2017-10-16 21:04:35 +02:00
|
|
|
var stack string
|
2017-09-17 17:10:46 +02:00
|
|
|
var parallel int
|
2017-03-15 23:40:06 +01:00
|
|
|
var showConfig bool
|
2017-08-06 19:05:51 +02:00
|
|
|
var showReplacementSteps bool
|
2017-06-11 17:09:20 +02:00
|
|
|
var showSames bool
|
2017-03-15 23:40:06 +01:00
|
|
|
var summary bool
|
|
|
|
var cmd = &cobra.Command{
|
2017-10-21 02:36:47 +02:00
|
|
|
Use: "preview",
|
|
|
|
SuggestFor: []string{"plan"},
|
|
|
|
Short: "Show a preview of updates to an stack's resources",
|
2017-10-16 21:04:35 +02:00
|
|
|
Long: "Show a preview of updates an stack's resources\n" +
|
2017-03-15 23:40:06 +01:00
|
|
|
"\n" +
|
2017-10-16 21:04:35 +02:00
|
|
|
"This command displays a preview of the updates to an existing stack whose state is\n" +
|
2017-09-23 00:15:42 +02:00
|
|
|
"represented by an existing snapshot file. The new desired state is computed by compiling\n" +
|
|
|
|
"and evaluating an executable package, and extracting all resource allocations from its\n" +
|
|
|
|
"resulting object graph. These allocations are then compared against the existing state to\n" +
|
|
|
|
"determine what operations must take place to achieve the desired state. No changes to the\n" +
|
2017-10-16 21:04:35 +02:00
|
|
|
"stack will actually take place.\n" +
|
2017-03-15 23:40:06 +01:00
|
|
|
"\n" +
|
2017-10-06 17:50:54 +02:00
|
|
|
"The package to execute is loaded from the current directory. Use the `-C` or `--cwd` flag to\n" +
|
|
|
|
"use a different directory.",
|
2017-04-12 20:12:25 +02:00
|
|
|
Run: cmdutil.RunFunc(func(cmd *cobra.Command, args []string) error {
|
2017-10-16 21:04:35 +02:00
|
|
|
stackName, err := explicitOrCurrent(stack)
|
2017-10-03 01:37:12 +02:00
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2017-10-19 00:37:18 +02:00
|
|
|
cfg, err := getConfiguration(stackName)
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
var decrypter config.ValueDecrypter = panicCrypter{}
|
|
|
|
|
|
|
|
if hasSecureValue(cfg) {
|
|
|
|
decrypter, err = getSymmetricCrypter()
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
localProvider := localStackProvider{decrypter: decrypter}
|
|
|
|
pulumiEngine := engine.Engine{Targets: localProvider, Snapshots: localProvider}
|
|
|
|
|
2017-10-05 23:08:46 +02:00
|
|
|
events := make(chan engine.Event)
|
|
|
|
done := make(chan bool)
|
|
|
|
|
|
|
|
go displayEvents(events, done, debug)
|
|
|
|
|
2017-10-19 00:37:18 +02:00
|
|
|
if err = pulumiEngine.Preview(stackName, events, engine.PreviewOptions{
|
2017-08-06 19:05:51 +02:00
|
|
|
Analyzers: analyzers,
|
2017-09-17 17:10:46 +02:00
|
|
|
Parallel: parallel,
|
2017-08-06 19:05:51 +02:00
|
|
|
ShowConfig: showConfig,
|
|
|
|
ShowReplacementSteps: showReplacementSteps,
|
|
|
|
ShowSames: showSames,
|
|
|
|
Summary: summary,
|
2017-10-21 02:28:35 +02:00
|
|
|
}); err != nil {
|
|
|
|
return err
|
|
|
|
}
|
2017-10-05 23:08:46 +02:00
|
|
|
|
|
|
|
<-done
|
2017-10-23 00:22:15 +02:00
|
|
|
close(events)
|
|
|
|
close(done)
|
2017-10-21 02:28:35 +02:00
|
|
|
return nil
|
2017-03-15 23:40:06 +01:00
|
|
|
}),
|
|
|
|
}
|
|
|
|
|
|
|
|
cmd.PersistentFlags().StringSliceVar(
|
|
|
|
&analyzers, "analyzer", []string{},
|
2017-09-23 00:15:42 +02:00
|
|
|
"Run one or more analyzers as part of this preview")
|
2017-07-14 02:09:46 +02:00
|
|
|
cmd.PersistentFlags().BoolVarP(
|
|
|
|
&debug, "debug", "d", false,
|
|
|
|
"Print detailed debugging output during resource operations")
|
Make major commands more pleasant
This change eliminates the need to constantly type in the environment
name when performing major commands like configuration, planning, and
deployment. It's probably due to my age, however, I keep fat-fingering
simple commands in front of investors and I am embarrassed!
In the new model, there is a notion of a "current environment", and
I have modeled it kinda sorta just like Git's notion of "current branch."
By default, the current environment is set when you `init` something.
Otherwise, there is the `coco env select <env>` command to change it.
(Running this command w/out a new <env> will show you the current one.)
The major commands `config`, `plan`, `deploy`, and `destroy` will prefer
to use the current environment, unless it is overridden by using the
--env flag. All of the `coco env <cmd> <env>` commands still require the
explicit passing of an environment which seems reasonable since they are,
after all, about manipulating environments.
As part of this, I've overhauled the aging workspace settings cruft,
which had fallen into disrepair since the initial prototype.
2017-03-22 03:23:32 +01:00
|
|
|
cmd.PersistentFlags().StringVarP(
|
2017-10-16 21:04:35 +02:00
|
|
|
&stack, "stack", "s", "",
|
|
|
|
"Choose an stack other than the currently selected one")
|
2017-09-17 17:10:46 +02:00
|
|
|
cmd.PersistentFlags().IntVarP(
|
|
|
|
¶llel, "parallel", "p", 0,
|
|
|
|
"Allow P resource operations to run in parallel at once (<=1 for no parallelism)")
|
2017-03-15 23:40:06 +01:00
|
|
|
cmd.PersistentFlags().BoolVar(
|
|
|
|
&showConfig, "show-config", false,
|
|
|
|
"Show configuration keys and variables")
|
Implement `get` functions on all resources
This change implements the `get` function for resources. Per pulumi/lumi#83,
this allows Lumi scripts to actually read from the target environment.
For example, we can now look up a SecurityGroup from its ARN:
let group = aws.ec2.SecurityGroup.get(
"arn:aws:ec2:us-west-2:153052954103:security-group:sg-02150d79");
The returned object is a fully functional resource object. So, we can then
link it up with an EC2 instance, for example, in the usual ways:
let instance = new aws.ec2.Instance(..., {
securityGroups: [ group ],
});
This didn't require any changes to the RPC or provider model, since we
already implement the Get function.
There are a few loose ends; two are short term:
1) URNs are not rehydrated.
2) Query is not yet implemented.
One is mid-term:
3) We probably want a URN-based lookup function. But we will likely
wait until we tackle pulumi/lumi#109 before adding this.
And one is long term (and subtle):
4) These amount to I/O and are not repeatable! A change in the target
environment may cause a script to generate a different plan
intermittently. Most likely we want to apply a different kind of
deployment "policy" for such scripts. These are inching towards the
scripting model of pulumi/lumi#121, which is an entirely different
beast than the repeatable immutable infrastructure deployments.
Finally, it is worth noting that with this, we have some of the fundamental
underpinnings required to finally tackle "inference" (pulumi/lumi#142).
2017-06-20 02:24:00 +02:00
|
|
|
cmd.PersistentFlags().BoolVar(
|
2017-08-06 19:05:51 +02:00
|
|
|
&showReplacementSteps, "show-replacement-steps", false,
|
|
|
|
"Show detailed resource replacement creates and deletes instead of a single step")
|
2017-03-15 23:40:06 +01:00
|
|
|
cmd.PersistentFlags().BoolVar(
|
2017-06-11 17:09:20 +02:00
|
|
|
&showSames, "show-sames", false,
|
2017-03-15 23:40:06 +01:00
|
|
|
"Show resources that needn't be updated because they haven't changed, alongside those that do")
|
2017-10-16 21:04:35 +02:00
|
|
|
cmd.PersistentFlags().BoolVar(
|
|
|
|
&summary, "summary", false,
|
2017-09-23 00:15:42 +02:00
|
|
|
"Only display summarization of resources and operations")
|
2017-03-15 23:40:06 +01:00
|
|
|
|
|
|
|
return cmd
|
|
|
|
}
|
2017-10-31 02:39:58 +01:00
|
|
|
|
|
|
|
func newCloudPreviewCmd() *cobra.Command {
|
|
|
|
var stack string
|
|
|
|
|
|
|
|
var cmd = &cobra.Command{
|
|
|
|
Use: "preview",
|
|
|
|
SuggestFor: []string{"plan"},
|
|
|
|
Short: "Show a preview of updates to an stack's resources",
|
|
|
|
Long: "Show a preview of updates an stack's resources\n" +
|
|
|
|
"\n" +
|
|
|
|
"This command displays a preview of the updates to an existing stack. The new desired state" +
|
|
|
|
"is computed by compiling and evaluating an executable package, and extracting all resource" +
|
|
|
|
"allocations from its resulting object graph. These allocations are then compared against" +
|
|
|
|
"the existing state to determine what operations must take place to achieve the desired state." +
|
|
|
|
"No changes to the stack will actually take place.\n" +
|
|
|
|
"\n" +
|
|
|
|
"The package to execute is loaded from the current directory. Use the `-C` or `--cwd` flag to\n" +
|
|
|
|
"use a different directory.",
|
|
|
|
Run: cmdutil.RunFunc(func(cmd *cobra.Command, args []string) error { // Look up the owner, repository, and project from the workspace and nearest package.
|
|
|
|
// Get the project being previewed.
|
|
|
|
w, err := newWorkspace()
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
projID, err := getCloudProjectIdentifier(w)
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Default to the workspace settings if stack isn't provided.
|
|
|
|
stackName := tokens.QName(stack)
|
|
|
|
if stackName == "" {
|
|
|
|
stackName = w.Settings().Stack
|
|
|
|
}
|
|
|
|
if stackName == "" {
|
|
|
|
return errors.New("stack argument not set and workspace does not have selected stack")
|
|
|
|
}
|
|
|
|
|
|
|
|
// Zip up the Pulumi program's directory, which may be a parent of CWD.
|
|
|
|
cwd, err := os.Getwd()
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("getting working directory: %v", err)
|
|
|
|
}
|
|
|
|
programPath, err := workspace.DetectPackage(cwd)
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("looking for Pulumi package: %v", err)
|
|
|
|
}
|
|
|
|
if programPath == "" {
|
|
|
|
return fmt.Errorf("no Pulumi package found")
|
|
|
|
}
|
|
|
|
// programPath is the path to the pulumi.yaml file. Need its parent folder.
|
|
|
|
programFolder := filepath.Dir(programPath)
|
|
|
|
archive, err := archive.EncodePath(programFolder)
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("creating archive: %v", err)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Gather up configuration.
|
|
|
|
// TODO(pulumi-service/issues/221): Have pulumi.com handle the encryption/decryption.
|
|
|
|
textConfig, err := getDecryptedConfig(stackName)
|
|
|
|
if err != nil {
|
|
|
|
return errors.Wrap(err, "getting decrypted configuration")
|
|
|
|
}
|
|
|
|
|
|
|
|
// Preview the program in the Pulumi Cloud. Uses same API shape as update.
|
|
|
|
updateRequest := apitype.UpdateProgramRequest{
|
|
|
|
ProgramArchive: archive,
|
|
|
|
Config: textConfig,
|
|
|
|
}
|
|
|
|
var updateResponse apitype.UpdateProgramResponse
|
|
|
|
path := fmt.Sprintf("/orgs/%s/programs/%s/%s/stacks/%s/preview",
|
|
|
|
projID.Owner, projID.Repository, projID.Project, string(stackName))
|
|
|
|
if err = pulumiRESTCall("POST", path, &updateRequest, &updateResponse); err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
fmt.Printf("Previewing update to Stack '%s'...\n", string(stackName))
|
|
|
|
|
|
|
|
// Wait for the update to complete.
|
|
|
|
status, err := waitForUpdate(path)
|
|
|
|
fmt.Println() // The PPC's final message we print to STDOUT doesn't include a newline.
|
|
|
|
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("waiting for preview: %v", err)
|
|
|
|
}
|
|
|
|
if status == apitype.StatusSucceeded {
|
|
|
|
fmt.Println("Preview resulted in success.")
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
return fmt.Errorf("preview result was unsuccessful: status %v", status)
|
|
|
|
}),
|
|
|
|
}
|
|
|
|
|
|
|
|
cmd.PersistentFlags().StringVarP(
|
|
|
|
&stack, "stack", "s", "",
|
|
|
|
"Choose an stack other than the currently selected one")
|
|
|
|
|
|
|
|
return cmd
|
|
|
|
}
|