pulumi/cmd/plugin.go
Sean Gillespie 14baf866f6
Snapshot management overhaul and refactor (#1273)
* Refactor the SnapshotManager interface

Lift snapshot management out of the engine by delegating it to the
SnapshotManager implementation in pkg/backend.

* Add a event interface for plugin loads and use that interface to record plugins in the snapshot

* Remove dead code

* Add comments to Events

* Add a number of tests for SnapshotManager

* CR feedback: use a successful bit on 'End' instead of having a separate 'Abort' API

* CR feedback

* CR feedback: register plugins one-at-a-time instead of the entire state at once
2018-04-25 17:20:08 -07:00

77 lines
2.5 KiB
Go

// Copyright 2016-2018, Pulumi Corporation. All rights reserved.
package cmd
import (
"github.com/spf13/cobra"
"github.com/pulumi/pulumi/pkg/engine"
"github.com/pulumi/pulumi/pkg/resource/plugin"
"github.com/pulumi/pulumi/pkg/util/cmdutil"
"github.com/pulumi/pulumi/pkg/util/contract"
"github.com/pulumi/pulumi/pkg/workspace"
)
func newPluginCmd() *cobra.Command {
cmd := &cobra.Command{
Use: "plugin",
Short: "Manage language and resource provider plugins",
Long: "Manage language and resource provider plugins.\n" +
"\n" +
"Pulumi uses dynamically loaded plugins as an extensibility mechanism for\n" +
"supporting any number of languages and resource providers. These plugins are\n" +
"distributed out of band and must be installed manually. Attempting to use a\n" +
"package that provisions resources without the corresponding plugin will fail.\n" +
"\n" +
"You may write your own plugins, for example to implement custom languages or\n" +
"resources, although most people will never need to do this. To understand how to\n" +
"write and distribute your own plugins, please consult the relevant documentation.\n" +
"\n" +
"The plugin family of commands provides a way of explicitly managing plugins.",
Args: cmdutil.NoArgs,
}
cmd.AddCommand(newPluginInstallCmd())
cmd.AddCommand(newPluginLsCmd())
cmd.AddCommand(newPluginRmCmd())
return cmd
}
// getProjectPlugins fetches a list of plugins used by this project.
func getProjectPlugins() ([]workspace.PluginInfo, error) {
proj, root, err := readProject()
if err != nil {
return nil, err
}
projinfo := &engine.Projinfo{Proj: proj, Root: root}
pwd, main, ctx, err := engine.ProjectInfoContext(projinfo, nil, nil, cmdutil.Diag(), nil)
if err != nil {
return nil, err
}
// Get the required plugins and then ensure they have metadata populated about them. Because it's possible
// a plugin required by the project hasn't yet been installed, we will simply skip any errors we encounter.
var results []workspace.PluginInfo
plugins, err := ctx.Host.GetRequiredPlugins(plugin.ProgInfo{
Proj: proj,
Pwd: pwd,
Program: main,
})
if err != nil {
return nil, err
}
for _, plugin := range plugins {
if _, path, _ := workspace.GetPluginPath(plugin.Kind, plugin.Name, plugin.Version); path != "" {
err = plugin.SetFileMetadata(path)
if err != nil {
return nil, err
}
contract.IgnoreError(err)
}
results = append(results, plugin)
}
return results, nil
}