AzureKubernetesIngressExtensions Methods

Class Methods 2 members

Provides extension methods for adding Kubernetes Ingress and Gateway resources to AKS environments.

AddGateway(IResourceBuilder<AzureKubernetesEnvironmentResource>, string) extension IResourceBuilder<KubernetesGatewayResource>

Adds a Kubernetes Gateway API Gateway resource to the application model, associated with the inner Kubernetes environment of the specified AKS environment.

public static class AzureKubernetesIngressExtensions
{
    public static IResourceBuilder<KubernetesGatewayResource> AddGateway(
        this IResourceBuilder<AzureKubernetesEnvironmentResource> builder,
        string name)
    {
        // ...
    }
}

AzureKubernetesIngressExtensions.cs#L75-L79

Parameters

builder IResourceBuilder<AzureKubernetesEnvironmentResource> The AKS environment resource builder.

name string The name of the gateway resource.

Returns

IResourceBuilder<KubernetesGatewayResource> A reference to the ApplicationModel.IResourceBuilder`1 for chaining.

Examples

var aks = builder.AddAzureKubernetesEnvironment("aks");
var gateway = aks.AddGateway("public")
    .WithGatewayClass("azure-alb-external");

var api = builder.AddProject<MyApi>("api");
gateway.WithRoute("/api", api.GetEndpoint("http"));

AddIngress(IResourceBuilder<AzureKubernetesEnvironmentResource>, string) extension IResourceBuilder<KubernetesIngressResource>

Adds a Kubernetes Ingress resource to the application model, associated with the inner Kubernetes environment of the specified AKS environment. The ingress generates a networking.k8s.io/v1 Ingress resource in the Helm chart output at publish time.

public static class AzureKubernetesIngressExtensions
{
    public static IResourceBuilder<KubernetesIngressResource> AddIngress(
        this IResourceBuilder<AzureKubernetesEnvironmentResource> builder,
        string name)
    {
        // ...
    }
}

AzureKubernetesIngressExtensions.cs#L46-L50

Parameters

builder IResourceBuilder<AzureKubernetesEnvironmentResource> The AKS environment resource builder.

name string The name of the ingress resource.

Returns

IResourceBuilder<KubernetesIngressResource> A reference to the ApplicationModel.IResourceBuilder`1 for chaining.

Remarks

This method delegates to the inner Kubernetes.KubernetesEnvironmentResource of the AKS environment. To use an AKS-specific ingress controller (e.g., Azure Application Gateway for Containers), call KubernetesIngressExtensions.WithIngressClass with the appropriate class name.

Examples

var aks = builder.AddAzureKubernetesEnvironment("aks");
var ingress = aks.AddIngress("public")
    .WithIngressClass("azure-alb-external");

var api = builder.AddProject<MyApi>("api");
ingress.WithRoute("/api", api.GetEndpoint("http"));