Add C# usage examples for Helm, YAML, and Kustomize

CHANGELOG.md

@@ -6,6 +6,7 @@
 -   Add Python usage examples for Helm, Kustomize, and YAML resources. (https://github.com/pulumi/pulumi-kubernetes/pull/1209)
 -   Add v3 Helm package for Go SDK. (https://github.com/pulumi/pulumi-kubernetes/pull/1211)
 -   Add Go usage examples for Helm, Kustomize, and YAML resources. (https://github.com/pulumi/pulumi-kubernetes/pull/1212)
+-   Add C# usage examples for Helm, Kustomize, and YAML resources. (https://github.com/pulumi/pulumi-kubernetes/pull/1213)
 
 ## 2.4.0 (July 7, 2020)
 

provider/cmd/pulumi-gen-kubernetes/main.go

@@ -269,6 +269,8 @@ func writeDotnetClient(pkg *schema.Package, outdir, templateDir string) {
 		"Helm/Unwraps.cs":                 mustLoadFile(filepath.Join(templateDir, "helm", "Unwraps.cs")),
 		"Helm/V2/Chart.cs":                mustLoadFile(filepath.Join(templateDir, "helm", "v2", "Chart.cs")),
 		"Helm/V3/Chart.cs":                mustLoadFile(filepath.Join(templateDir, "helm", "v3", "Chart.cs")),
+		"Kustomize/Directory.cs":          mustLoadFile(filepath.Join(templateDir, "kustomize", "Directory.cs")),
+		"Kustomize/Invokes.cs":            mustLoadFile(filepath.Join(templateDir, "kustomize", "Invokes.cs")),
 		"Yaml/ConfigFile.cs":              mustLoadFile(filepath.Join(templateDir, "yaml", "ConfigFile.cs")),
 		"Yaml/ConfigGroup.cs":             mustLoadFile(filepath.Join(templateDir, "yaml", "ConfigGroup.cs")),
 		"Yaml/Invokes.cs":                 mustLoadFile(filepath.Join(templateDir, "yaml", "Invokes.cs")),

provider/pkg/gen/dotnet-templates/helm/v2/Chart.cs

@@ -29,6 +29,193 @@ namespace Pulumi.Kubernetes.Helm.V2
     /// the semantics are equivalent to running `helm template` and then using Pulumi to manage the
     /// resulting YAML manifests. Any values that would be retrieved in-cluster are assigned fake
     /// values, and none of Tiller's server-side validity testing is executed.
+    /// 
+    /// ## Example Usage
+    /// ### Local Chart Directory
+    /// 
+    /// ```csharp
+    /// using System.Threading.Tasks;
+    /// using Pulumi;
+    /// using Pulumi.Kubernetes.Helm;
+    /// using Pulumi.Kubernetes.Helm.V2;
+    /// 
+    /// class HelmStack : Stack
+    /// {
+    ///     public HelmStack()
+    ///     {
+    ///         var nginx = new Chart("nginx-ingress", new LocalChartArgs
+    ///         {
+    ///             Path = "./nginx-ingress",
+    ///         });
+    /// 
+    ///     }
+    /// }
+    /// ```
+    /// ### Remote Chart
+    /// 
+    /// ```csharp
+    /// using System.Threading.Tasks;
+    /// using Pulumi;
+    /// using Pulumi.Kubernetes.Helm;
+    /// using Pulumi.Kubernetes.Helm.V2;
+    /// 
+    /// class HelmStack : Stack
+    /// {
+    ///     public HelmStack()
+    ///     {
+    ///         var nginx = new Chart("nginx-ingress", new ChartArgs
+    ///         {
+    ///             Chart = "nginx-ingress",
+    ///             Version = "1.24.4",
+    ///             FetchOptions = new ChartFetchArgs
+    ///             {
+    ///                 Repo = "https://kubernetes-charts.storage.googleapis.com/"
+    ///             }
+    ///         });
+    /// 
+    ///     }
+    /// }
+    /// ```
+    /// ### Set Chart Values
+    /// 
+    /// ```csharp
+    /// using System.Collections.Generic;
+    /// using System.Threading.Tasks;
+    /// using Pulumi;
+    /// using Pulumi.Kubernetes.Helm;
+    /// using Pulumi.Kubernetes.Helm.V2;
+    /// 
+    /// class HelmStack : Stack
+    /// {
+    ///     public HelmStack()
+    ///     {
+    ///         var values = new Dictionary<string, dynamic>
+    ///         {
+    ///             ["controller"] = new Dictionary<string, dynamic>
+    ///             {
+    ///                 ["metrics"] = new Dictionary<string, dynamic>
+    ///                 {
+    ///                     ["enabled"] = true
+    ///                 }
+    ///             },
+    ///         };
+    /// 
+    ///         var nginx = new Chart("nginx-ingress", new ChartArgs
+    ///         {
+    ///             Chart = "nginx-ingress",
+    ///             Version = "1.24.4",
+    ///             FetchOptions = new ChartFetchArgs
+    ///             {
+    ///                 Repo = "https://kubernetes-charts.storage.googleapis.com/"
+    ///             },
+    ///             Values = values,
+    ///         });
+    /// 
+    ///     }
+    /// }
+    /// ```
+    /// ### Deploy Chart into Namespace
+    /// 
+    /// ```csharp
+    /// using System.Threading.Tasks;
+    /// using Pulumi;
+    /// using Pulumi.Kubernetes.Helm;
+    /// using Pulumi.Kubernetes.Helm.V2;
+    /// 
+    /// class HelmStack : Stack
+    /// {
+    ///     public HelmStack()
+    ///     {
+    ///         var nginx = new Chart("nginx-ingress", new ChartArgs
+    ///         {
+    ///             Chart = "nginx-ingress",
+    ///             Version = "1.24.4",
+    ///             Namespace = "test-namespace",
+    ///             FetchOptions = new ChartFetchArgs
+    ///             {
+    ///                 Repo = "https://kubernetes-charts.storage.googleapis.com/"
+    ///             },
+    ///         });
+    /// 
+    ///     }
+    /// }
+    /// ```
+    /// ### Chart with Transformations
+    /// 
+    /// ```csharp
+    /// using System.Collections.Generic;
+    /// using System.Collections.Immutable;
+    /// using System.Threading.Tasks;
+    /// using Pulumi;
+    /// using Pulumi.Kubernetes.Helm;
+    /// using Pulumi.Kubernetes.Helm.V2;
+    /// 
+    /// class HelmStack : Stack
+    /// {
+    ///     public HelmStack()
+    ///     {
+    ///         var nginx = new Chart("nginx-ingress", new ChartArgs
+    ///         {
+    ///             Chart = "nginx-ingress",
+    ///             Version = "1.24.4",
+    ///             FetchOptions = new ChartFetchArgs
+    ///             {
+    ///                 Repo = "https://kubernetes-charts.storage.googleapis.com/"
+    ///             },
+    ///             Transformations =
+    ///             {
+    ///                 LoadBalancerToClusterIP,
+    ///                 ResourceAlias,
+    ///                 OmitTestPod,
+    ///             }
+    /// 
+    ///         });
+    /// 
+    ///         // Make every service private to the cluster, i.e., turn all services into ClusterIP instead of LoadBalancer.
+    ///         ImmutableDictionary<string, object> LoadBalancerToClusterIP(ImmutableDictionary<string, object> obj, CustomResourceOptions opts)
+    ///         {
+    ///             if ((string)obj["kind"] == "Service" && (string)obj["apiVersion"] == "v1")
+    ///             {
+    ///                 var spec = (ImmutableDictionary<string, object>)obj["spec"];
+    ///                 if (spec != null && (string)spec["type"] == "LoadBalancer")
+    ///                 {
+    ///                     return obj.SetItem("spec", spec.SetItem("type", "ClusterIP"));
+    ///                 }
+    ///             }
+    /// 
+    ///             return obj;
+    ///         }
+    /// 
+    ///         // Set a resource alias for a previous name.
+    ///         ImmutableDictionary<string, object> ResourceAlias(ImmutableDictionary<string, object> obj, CustomResourceOptions opts)
+    ///         {
+    ///             if ((string)obj["kind"] == "Deployment")
+    ///             {
+    ///                 opts.Aliases = new List<Input<Alias>> { new Alias { Name = "oldName" } };
+    ///             }
+    /// 
+    ///             return obj;
+    ///         }
+    /// 
+    ///         // Omit a resource from the Chart by transforming the specified resource definition to an empty List.
+    ///         ImmutableDictionary<string, object> OmitTestPod(ImmutableDictionary<string, object> obj, CustomResourceOptions opts)
+    ///         {
+    ///             var metadata = (ImmutableDictionary<string, object>)obj["metadata"];
+    ///             if ((string)obj["kind"] == "Pod" && (string)metadata["name"] == "test")
+    ///             {
+    ///                 return new Dictionary<string, object>
+    ///                 {
+    ///                     ["apiVersion"] = "v1",
+    ///                     ["kind"] = "List",
+    ///                     ["items"] = new Dictionary<string, object>(),
+    ///                 }.ToImmutableDictionary();
+    ///             }
+    /// 
+    ///             return obj;
+    ///         }
+    ///     }
+    /// }
+    /// ```
     /// </summary>
     public sealed class Chart : ChartBase
     {