2018-05-22 21:43:36 +02:00
|
|
|
// 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.
|
2018-02-22 00:11:21 +01:00
|
|
|
|
|
|
|
package cmd
|
|
|
|
|
|
|
|
import (
|
|
|
|
"os"
|
2019-11-01 01:39:15 +01:00
|
|
|
"strings"
|
2018-02-22 00:11:21 +01:00
|
|
|
|
2018-09-05 00:40:15 +02:00
|
|
|
"github.com/pulumi/pulumi/pkg/backend/display"
|
2018-02-22 00:11:21 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/graph"
|
|
|
|
"github.com/pulumi/pulumi/pkg/graph/dotconv"
|
2020-03-18 21:36:19 +01:00
|
|
|
"github.com/pulumi/pulumi/sdk/go/common/resource"
|
2018-02-22 00:11:21 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/resource/deploy"
|
|
|
|
"github.com/pulumi/pulumi/pkg/util/cmdutil"
|
|
|
|
"github.com/spf13/cobra"
|
|
|
|
)
|
|
|
|
|
2018-02-23 02:31:45 +01:00
|
|
|
// Whether or not we should ignore parent edges when building up our graph.
|
|
|
|
var ignoreParentEdges bool
|
|
|
|
|
|
|
|
// Whether or not we should ignore dependency edges when building up our graph.
|
|
|
|
var ignoreDependencyEdges bool
|
|
|
|
|
|
|
|
// The color of dependency edges in the graph. Defaults to #246C60, a blush-green.
|
|
|
|
var dependencyEdgeColor string
|
|
|
|
|
|
|
|
// The color of parent edges in the graph. Defaults to #AA6639, an orange.
|
|
|
|
var parentEdgeColor string
|
|
|
|
|
2018-02-22 00:11:21 +01:00
|
|
|
func newStackGraphCmd() *cobra.Command {
|
2018-06-26 02:24:53 +02:00
|
|
|
var stackName string
|
2018-07-07 06:30:00 +02:00
|
|
|
|
2018-02-23 02:31:45 +01:00
|
|
|
cmd := &cobra.Command{
|
2019-11-01 01:39:15 +01:00
|
|
|
Use: "graph [filename]",
|
2018-02-22 00:11:21 +01:00
|
|
|
Args: cmdutil.ExactArgs(1),
|
|
|
|
Short: "Export a stack's dependency graph to a file",
|
|
|
|
Long: "Export a stack's dependency graph to a file.\n" +
|
|
|
|
"\n" +
|
|
|
|
"This command can be used to view the dependency graph that a Pulumi program\n" +
|
|
|
|
"admitted when it was ran. This graph is output in the DOT format. This command operates\n" +
|
|
|
|
"on your stack's most recent deployment.",
|
|
|
|
Run: cmdutil.RunFunc(func(cmd *cobra.Command, args []string) error {
|
2018-09-05 00:40:15 +02:00
|
|
|
opts := display.Options{
|
2018-07-07 06:30:00 +02:00
|
|
|
Color: cmdutil.GetGlobalColorization(),
|
|
|
|
}
|
|
|
|
|
Initial support for passing URLs to `new` and `up` (#1727)
* Initial support for passing URLs to `new` and `up`
This PR adds initial support for `pulumi new` using Git under the covers
to manage Pulumi templates, providing the same experience as before.
You can now also optionally pass a URL to a Git repository, e.g.
`pulumi new [<url>]`, including subdirectories within the repository,
and arbitrary branches, tags, or commits.
The following commands result in the same behavior from the user's
perspective:
- `pulumi new javascript`
- `pulumi new https://github.com/pulumi/templates/templates/javascript`
- `pulumi new https://github.com/pulumi/templates/tree/master/templates/javascript`
- `pulumi new https://github.com/pulumi/templates/tree/HEAD/templates/javascript`
To specify an arbitrary branch, tag, or commit:
- `pulumi new https://github.com/pulumi/templates/tree/<branch>/templates/javascript`
- `pulumi new https://github.com/pulumi/templates/tree/<tag>/templates/javascript`
- `pulumi new https://github.com/pulumi/templates/tree/<commit>/templates/javascript`
Branches and tags can include '/' separators, and `pulumi` will still
find the right subdirectory.
URLs to Gists are also supported, e.g.:
`pulumi new https://gist.github.com/justinvp/6673959ceb9d2ac5a14c6d536cb871a6`
If the specified subdirectory in the repository does not contain a
`Pulumi.yaml`, it will look for subdirectories within containing
`Pulumi.yaml` files, and prompt the user to choose a template, along the
lines of how `pulumi new` behaves when no template is specified.
The following commands result in the CLI prompting to choose a template:
- `pulumi new`
- `pulumi new https://github.com/pulumi/templates/templates`
- `pulumi new https://github.com/pulumi/templates/tree/master/templates`
- `pulumi new https://github.com/pulumi/templates/tree/HEAD/templates`
Of course, arbitrary branches, tags, or commits can be specified as well:
- `pulumi new https://github.com/pulumi/templates/tree/<branch>/templates`
- `pulumi new https://github.com/pulumi/templates/tree/<tag>/templates`
- `pulumi new https://github.com/pulumi/templates/tree/<commit>/templates`
This PR also includes initial support for passing URLs to `pulumi up`,
providing a streamlined way to deploy installable cloud applications
with Pulumi, without having to manage source code locally before doing
a deployment.
For example, `pulumi up https://github.com/justinvp/aws` can be used to
deploy a sample AWS app. The stack can be updated with different
versions, e.g.
`pulumi up https://github.com/justinvp/aws/tree/v2 -s <stack-to-update>`
Config values can optionally be passed via command line flags, e.g.
`pulumi up https://github.com/justinvp/aws -c aws:region=us-west-2 -c foo:bar=blah`
Gists can also be used, e.g.
`pulumi up https://gist.github.com/justinvp/62fde0463f243fcb49f5a7222e51bc76`
* Fix panic when hitting ^C from "choose template" prompt
* Add description to templates
When running `pulumi new` without specifying a template, include the template description along with the name in the "choose template" display.
```
$ pulumi new
Please choose a template:
aws-go A minimal AWS Go program
aws-javascript A minimal AWS JavaScript program
aws-python A minimal AWS Python program
aws-typescript A minimal AWS TypeScript program
> go A minimal Go program
hello-aws-javascript A simple AWS serverless JavaScript program
javascript A minimal JavaScript program
python A minimal Python program
typescript A minimal TypeScript program
```
* React to changes to the pulumi/templates repo.
We restructured the `pulumi/templates` repo to have all the templates in the root instead of in a `templates` subdirectory, so make the change here to no longer look for templates in `templates`.
This also fixes an issue around using `Depth: 1` that I found while testing this. When a named template is used, we attempt to clone or pull from the `pulumi/templates` repo to `~/.pulumi/templates`. Having it go in this well-known directory allows us to maintain previous behavior around allowing offline use of templates. If we use `Depth: 1` for the initial clone, it will fail when attempting to pull when there are updates to the remote repository. Unfortunately, there's no built-in `--unshallow` support in `go-git` and setting a larger `Depth` doesn't appear to help. There may be a workaround, but for now, if we're cloning the pulumi templates directory to `~/.pulumi/templates`, we won't use `Depth: 1`. For template URLs, we will continue to use `Depth: 1` as we clone those to a temp directory (which gets deleted) that we'll never try to update.
* List available templates in help text
* Address PR Feedback
* Don't show "Installing dependencies" message for `up`
* Fix secrets handling
When prompting for config, if the existing stack value is a secret, keep it a secret and mask the prompt. If the template says it should be secret, make it a secret.
* Fix ${PROJECT} and ${DESCRIPTION} handling for `up`
Templates used with `up` should already have a filled-in project name and description, but if it's a `new`-style template, that has `${PROJECT}` and/or `${DESCRIPTION}`, be helpful and just replace these with better values.
* Fix stack handling
Add a bool `setCurrent` param to `requireStack` to control whether the current stack should be saved in workspace settings. For the `up <url>` case, we don't want to save. Also, split the `up` code into two separate functions: one for the `up <url>` case and another for the normal `up` case where you have workspace in your current directory. While we may be able to combine them back into a single function, right now it's a bit cleaner being separate, even with some small amount of duplication.
* Fix panic due to nil crypter
Lazily get the crypter only if needed inside `promptForConfig`.
* Embellish comment
* Harden isPreconfiguredEmptyStack check
Fix the code to check to make sure the URL specified on the command line matches the URL stored in the `pulumi:template` config value, and that the rest of the config from the stack satisfies the config requirements of the template.
2018-08-11 03:08:16 +02:00
|
|
|
s, err := requireStack(stackName, false, opts, true /*setCurrent*/)
|
2018-02-22 00:11:21 +01:00
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
2018-05-23 00:39:13 +02:00
|
|
|
snap, err := s.Snapshot(commandContext())
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
2018-02-22 00:11:21 +01:00
|
|
|
|
2018-05-23 00:39:13 +02:00
|
|
|
dg := makeDependencyGraph(snap)
|
2018-02-22 00:11:21 +01:00
|
|
|
file, err := os.Create(args[0])
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
if err := dotconv.Print(dg, file); err != nil {
|
|
|
|
_ = file.Close()
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2018-02-23 00:52:06 +01:00
|
|
|
cmd.Printf("%sWrote stack dependency graph to `%s`", cmdutil.EmojiOr("🔍 ", ""), args[0])
|
|
|
|
cmd.Println()
|
2018-02-22 00:11:21 +01:00
|
|
|
return file.Close()
|
|
|
|
}),
|
|
|
|
}
|
2018-06-26 02:24:53 +02:00
|
|
|
cmd.PersistentFlags().StringVarP(
|
|
|
|
&stackName, "stack", "s", "", "The name of the stack to operate on. Defaults to the current stack")
|
|
|
|
cmd.PersistentFlags().BoolVar(&ignoreParentEdges, "ignore-parent-edges", false,
|
2018-02-23 02:31:45 +01:00
|
|
|
"Ignores edges introduced by parent/child resource relationships")
|
2018-06-26 02:24:53 +02:00
|
|
|
cmd.PersistentFlags().BoolVar(&ignoreDependencyEdges, "ignore-dependency-edges", false,
|
2018-02-23 02:31:45 +01:00
|
|
|
"Ignores edges introduced by dependency resource relationships")
|
2018-06-26 02:24:53 +02:00
|
|
|
cmd.PersistentFlags().StringVar(&dependencyEdgeColor, "dependency-edge-color", "#246C60",
|
2018-02-23 02:31:45 +01:00
|
|
|
"Sets the color of dependency edges in the graph")
|
2018-06-26 02:24:53 +02:00
|
|
|
cmd.PersistentFlags().StringVar(&parentEdgeColor, "parent-edge-color", "#AA6639",
|
2018-02-23 02:31:45 +01:00
|
|
|
"Sets the color of parent edges in the graph")
|
|
|
|
return cmd
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// All of the types and code within this file are to provide implementations of the interfaces
|
|
|
|
// in the `graph` package, so that we can use the `dotconv` package to output our graph in the
|
|
|
|
// DOT format.
|
|
|
|
//
|
|
|
|
// `dependencyEdge` implements graph.Edge, `dependencyVertex` implements graph.Vertex, and
|
|
|
|
// `dependencyGraph` implements `graph.Graph`.
|
|
|
|
type dependencyEdge struct {
|
2019-11-01 01:39:15 +01:00
|
|
|
to *dependencyVertex
|
|
|
|
from *dependencyVertex
|
|
|
|
labels []string
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// In this simple case, edges have no data.
|
|
|
|
func (edge *dependencyEdge) Data() interface{} {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *dependencyEdge) Label() string {
|
2019-11-01 01:39:15 +01:00
|
|
|
return strings.Join(edge.labels, ", ")
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *dependencyEdge) To() graph.Vertex {
|
|
|
|
return edge.to
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *dependencyEdge) From() graph.Vertex {
|
|
|
|
return edge.from
|
|
|
|
}
|
|
|
|
|
2018-02-23 02:31:45 +01:00
|
|
|
func (edge *dependencyEdge) Color() string {
|
|
|
|
return dependencyEdgeColor
|
|
|
|
}
|
|
|
|
|
|
|
|
// parentEdges represent edges in the parent-child graph, which
|
|
|
|
// exists alongside the dependency graph. An edge exists from node
|
|
|
|
// A to node B if node B is considered to be a parent of node A.
|
|
|
|
type parentEdge struct {
|
|
|
|
to *dependencyVertex
|
|
|
|
from *dependencyVertex
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *parentEdge) Data() interface{} {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// In this simple case, edges have no label.
|
|
|
|
func (edge *parentEdge) Label() string {
|
|
|
|
return ""
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *parentEdge) To() graph.Vertex {
|
|
|
|
return edge.to
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *parentEdge) From() graph.Vertex {
|
|
|
|
return edge.from
|
|
|
|
}
|
|
|
|
|
|
|
|
func (edge *parentEdge) Color() string {
|
|
|
|
return parentEdgeColor
|
|
|
|
}
|
|
|
|
|
2018-02-22 00:11:21 +01:00
|
|
|
// A dependencyVertex contains a reference to the graph to which it belongs
|
|
|
|
// and to the resource state that it represents. Incoming and outgoing edges
|
|
|
|
// are calculated on-demand using the combination of the graph and the state.
|
|
|
|
type dependencyVertex struct {
|
2018-02-23 00:52:06 +01:00
|
|
|
graph *dependencyGraph
|
|
|
|
resource *resource.State
|
|
|
|
incomingEdges []graph.Edge
|
|
|
|
outgoingEdges []graph.Edge
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
func (vertex *dependencyVertex) Data() interface{} {
|
|
|
|
return vertex.resource
|
|
|
|
}
|
|
|
|
|
|
|
|
func (vertex *dependencyVertex) Label() string {
|
|
|
|
return string(vertex.resource.URN)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (vertex *dependencyVertex) Ins() []graph.Edge {
|
2018-02-23 00:52:06 +01:00
|
|
|
return vertex.incomingEdges
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// Outgoing edges are indirectly calculated by traversing the entire graph looking
|
|
|
|
// for edges that point to this vertex. This is slow, but our graphs aren't big enough
|
|
|
|
// for this to matter too much.
|
|
|
|
func (vertex *dependencyVertex) Outs() []graph.Edge {
|
2018-02-23 00:52:06 +01:00
|
|
|
return vertex.outgoingEdges
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// A dependencyGraph is a thin wrapper around a map of URNs to vertices in
|
|
|
|
// the graph. It is constructed directly from a snapshot.
|
|
|
|
type dependencyGraph struct {
|
|
|
|
vertices map[resource.URN]*dependencyVertex
|
|
|
|
}
|
|
|
|
|
|
|
|
// Roots are edges that point to the root set of our graph. In our case,
|
2018-02-23 02:31:45 +01:00
|
|
|
// for simplicity, we define the root set of our dependency graph to be everything.
|
2018-02-22 00:11:21 +01:00
|
|
|
func (dg *dependencyGraph) Roots() []graph.Edge {
|
2018-02-23 02:31:45 +01:00
|
|
|
rootEdges := []graph.Edge{}
|
2018-02-22 00:11:21 +01:00
|
|
|
for _, vertex := range dg.vertices {
|
2018-02-23 02:31:45 +01:00
|
|
|
edge := &dependencyEdge{
|
|
|
|
to: vertex,
|
|
|
|
from: nil,
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
2018-02-23 02:31:45 +01:00
|
|
|
|
|
|
|
rootEdges = append(rootEdges, edge)
|
2018-02-22 00:11:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
return rootEdges
|
|
|
|
}
|
|
|
|
|
|
|
|
// Makes a dependency graph from a deployment snapshot, allocating a vertex
|
|
|
|
// for every resource in the graph.
|
|
|
|
func makeDependencyGraph(snapshot *deploy.Snapshot) *dependencyGraph {
|
|
|
|
dg := &dependencyGraph{
|
|
|
|
vertices: make(map[resource.URN]*dependencyVertex),
|
|
|
|
}
|
|
|
|
|
|
|
|
for _, resource := range snapshot.Resources {
|
|
|
|
vertex := &dependencyVertex{
|
|
|
|
graph: dg,
|
|
|
|
resource: resource,
|
|
|
|
}
|
|
|
|
|
|
|
|
dg.vertices[resource.URN] = vertex
|
|
|
|
}
|
|
|
|
|
2018-02-23 00:52:06 +01:00
|
|
|
for _, vertex := range dg.vertices {
|
2018-02-23 02:31:45 +01:00
|
|
|
if !ignoreDependencyEdges {
|
2019-11-01 01:39:15 +01:00
|
|
|
// If we have per-property dependency information, annotate the dependency edges
|
|
|
|
// we generate with the names of the properties associated with each dependency.
|
|
|
|
depBlame := make(map[resource.URN][]string)
|
|
|
|
for k, deps := range vertex.resource.PropertyDependencies {
|
|
|
|
for _, dep := range deps {
|
|
|
|
depBlame[dep] = append(depBlame[dep], string(k))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-02-23 02:31:45 +01:00
|
|
|
// Incoming edges are directly stored within the checkpoint file; they represent
|
|
|
|
// resources on which this vertex immediately depends upon.
|
|
|
|
for _, dep := range vertex.resource.Dependencies {
|
|
|
|
vertexWeDependOn := vertex.graph.vertices[dep]
|
2019-11-01 01:39:15 +01:00
|
|
|
edge := &dependencyEdge{to: vertex, from: vertexWeDependOn, labels: depBlame[dep]}
|
2018-02-23 02:31:45 +01:00
|
|
|
vertex.incomingEdges = append(vertex.incomingEdges, edge)
|
|
|
|
vertexWeDependOn.outgoingEdges = append(vertexWeDependOn.outgoingEdges, edge)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// alongside the dependency graph sits the resource parentage graph, which
|
|
|
|
// is also displayed as part of this graph, although with different colored
|
|
|
|
// edges.
|
|
|
|
if !ignoreParentEdges {
|
|
|
|
if parent := vertex.resource.Parent; parent != resource.URN("") {
|
|
|
|
parentVertex := dg.vertices[parent]
|
|
|
|
vertex.outgoingEdges = append(vertex.outgoingEdges, &parentEdge{
|
|
|
|
to: parentVertex,
|
|
|
|
from: vertex,
|
|
|
|
})
|
|
|
|
}
|
2018-02-23 00:52:06 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-02-22 00:11:21 +01:00
|
|
|
return dg
|
|
|
|
}
|