As explained in pulumi/pulumi-fabric#293, we were a little ad-hoc in how configuration was "applied" to resource providers. In fact, config wasn't ever communicated directly to providers; instead, the resource providers would simply ask the engine to read random heap locations (via tokens). Now that we're on a plan where configuration gets handed to the program at startup, and that's that, and where generally speaking resource providers never communicate directly with the language runtime, we need to take a different approach. As such, the resource provider interface now offers a Configure RPC method that the resource planning engine will invoke at the right times with the right subset of configuration variables filtered to just that provider's package. This fixes pulumi/pulumi#293.
29 lines
1.4 KiB
Go
29 lines
1.4 KiB
Go
// Copyright 2016-2017, Pulumi Corporation. All rights reserved.
|
|
|
|
package plugin
|
|
|
|
import (
|
|
"io"
|
|
|
|
"github.com/pulumi/pulumi-fabric/pkg/tokens"
|
|
)
|
|
|
|
// LanguageRuntime is a convenient interface for interacting with language runtime plugins. These tend to be
|
|
// dynamically loaded as plugins, although this interface hides this fact from the calling code.
|
|
type LanguageRuntime interface {
|
|
// Closer closes any underlying OS resources associated with this plugin (like processes, RPC channels, etc).
|
|
io.Closer
|
|
// Run executes a program in the language runtime for planning or deployment purposes. If info.DryRun is true,
|
|
// the code must not assume that side-effects or final values resulting from resource deployments are actually
|
|
// available. If it is false, on the other hand, a real deployment is occurring and it may safely depend on these.
|
|
Run(info RunInfo) (string, error)
|
|
}
|
|
|
|
// RunInfo contains all of the information required to perform a plan or deployment operation.
|
|
type RunInfo struct {
|
|
Pwd string // the program's working directory.
|
|
Program string // the path to the program to execute.
|
|
Args []string // any arguments to pass to the program.
|
|
Config map[tokens.ModuleMember]string // the configuration variables to apply before running.
|
|
DryRun bool // true if we are performing a dry-run (plan).
|
|
}
|