Component option propagation (.NET SDK)

[EronWright]

Proposed changes

Epic: #2254
Fixes: #1214
Fixes: #2345

This PR standardizes the option propagation logic for the component resources in the pulumi-kubernetes .NET SDK. The general approach is:

1. In the component resource constructor, compute the child options to be propagated to any children. The child options consist of the component as parent, and with version and pluginDownloadURL if specified.
2. Compute the invoke options by copying the child options.

Specification

The component resource is responsible for computing sub-options for invokes and for child resource declarations. This table outlines the expected behavior for each resource option when presented to a component resource.

	Propagated	Remarks
additionalSecretOutputs	no	"does not apply to component resources"
aliases	no	Inherited via parent-child relationship.
customTimeouts	no	"does not apply to component resources"
deleteBeforeReplace	no
deletedWith	no
dependsOn	no	The children implicitly wait for the dependency.
ignoreChanges	no	Nonsensical to apply directly to children (see discussion).
import	no
parent	yes	The component becomes the parent.
protect	no	Inherited.
provider	no	Combined into providers map, then inherited via parent-child relationship.
providers	no	Inherited.
replaceOnChanges	no	"does not apply to component resources"
retainOnDelete	no	"does not apply to component resources"
transformations	no	Inherited.
version	yes	Influences default provider selection logic during invokes. Should propagate when child resource is from the same provider type.
pluginDownloadURL	yes	Influences default provider selection logic during invokes. Should propagate when child resource is from the same provider type.

Testing

A new test case is provided (test case, test program) that exercises option propagation across the component resources:

• kubernetes.helm.sh.v3.Chart
• kubernetes.kustomize.Directory
• kubernetes.yaml.ConfigGroup
• kubernetes.yaml.ConfigFile

Upgrade testing must be done manually, with an emphasis on avoiding replacement due to reparenting.

Upgrade Considerations

In previous versions, the ConfigFile and ConfigGroup component resources inadvertently assigned the wrong parent to the child resource(s). This would happen when the component resource itself had a parent; the child would be assigned that same parent. This also had the effect of disregarding the component resource's provider in favor of the parent's provider.

For example, here's a before/after look at the component hierarchy:
Before:

├─ pkg:index:MyComponent            parent                                               
│  ├─ kubernetes:core/v1:ConfigMap  cg-options-cg-options-cm-1                           
│  ├─ kubernetes:yaml:ConfigFile    cg-options-testdata/options/configgroup/manifest.yaml
│  ├─ kubernetes:core/v1:ConfigMap  cg-options-configgroup-cm-1                          
│  ├─ kubernetes:yaml:ConfigFile    cg-options-testdata/options/configgroup/empty.yaml   
│  └─ kubernetes:yaml:ConfigGroup   cg-options                                                                                     

After:

└─ pkg:index:MyComponent                  parent                                               
   └─ kubernetes:yaml:ConfigGroup         cg-options                                           
      ├─ kubernetes:yaml:ConfigFile       cg-options-testdata/options/configgroup/manifest.yaml
      │  └─ kubernetes:core/v1:ConfigMap  cg-options-configgroup-cm-1                          
      └─ kubernetes:core/v1:ConfigMap     cg-options-cg-options-cm-1      

This PR addresses this issue and attempts to heal existing stacks using aliases. This is effective at avoiding a replacement except in the case where the child was created with the wrong provider. In this case, Pulumi will suggest a replacement of the child resource(s), such that they use the correct provider.

Related issues (optional)

[github-actions]

Does the PR have any schema changes?

Looking good! No breaking changes found.
No new resources/functions.

[lblackstone]

This looks great! Nice work 🎉