pulumi/pkg/resource/deploy/source_fixed.go
joeduffy 087deb7643 Add optional dependsOn to Resource constructors
This change adds an optiona dependsOn parameter to Resource constructors,
to "force" a fake dependency between resources.  We have an extremely strong
desire to resort to using this only in unusual cases -- and instead rely
on the natural dependency DAG based on properties -- but experience in other
resource provisioning frameworks tells us that we're likely to need this in
the general case.  Indeed, we've already encountered the need in AWS's
API Gateway resources... and I suspect we'll run into more especially as we
tackle non-serverless resources like EC2 Instances, where "ambient"
dependencies are far more commonplace.

This also makes parallelism the default mode of operation, and we have a
new --serialize flag that can be used to suppress this default behavior.
Full disclosure: I expect this to become more Make-like, i.e. -j 8, where
you can specify the precise width of parallelism, when we tackle
pulumi/pulumi-fabric#106.  I also think there's a good chance we will flip
the default, so that serial execution is the default, so that developers
who don't benefit from the parallelism don't need to worry about dependsOn
in awkward ways.  This tends to be the way most tools (like Make) operate.

This fixes pulumi/pulumi-fabric#335.
2017-09-15 16:38:52 -07:00

56 lines
1.3 KiB
Go

// Copyright 2016-2017, Pulumi Corporation. All rights reserved.
package deploy
import (
"github.com/pulumi/pulumi-fabric/pkg/tokens"
)
// NewFixedSource returns a valid planning source that is comprised of a list of pre-computed resource objects.
func NewFixedSource(ctx tokens.PackageName, resources []SourceGoal) Source {
return &fixedSource{ctx: ctx, resources: resources}
}
// A fixedSource just returns from a fixed set of resource states.
type fixedSource struct {
ctx tokens.PackageName
resources []SourceGoal
}
func (src *fixedSource) Close() error {
return nil // nothing to do.
}
func (src *fixedSource) Pkg() tokens.PackageName {
return src.ctx
}
func (src *fixedSource) Info() interface{} {
return nil
}
func (src *fixedSource) Iterate(opts Options) (SourceIterator, error) {
return &fixedSourceIterator{
src: src,
current: -1,
}, nil
}
// fixedSourceIterator always returns nil, nil in response to Next, indicating that it is done.
type fixedSourceIterator struct {
src *fixedSource
current int
}
func (iter *fixedSourceIterator) Close() error {
return nil // nothing to do.
}
func (iter *fixedSourceIterator) Next() (SourceGoal, error) {
iter.current++
if iter.current >= len(iter.src.resources) {
return nil, nil
}
return iter.src.resources[iter.current], nil
}