# Aspire.Hosting.Azure.Kubernetes

- Module: `Aspire.Hosting.Azure.Kubernetes`
- Version: `13.4.0-preview.1.26281.18`
- Source: [GitHub](https://github.com/microsoft/aspire)
- Functions: `14`
- Types: `3`

## Types

- [AksNodePoolResource](/reference/api/typescript/aspire.hosting.azure.kubernetes/aksnodepoolresource.md) -- `handle` - 1 members
- [AzureKubernetesEnvironmentResource](/reference/api/typescript/aspire.hosting.azure.kubernetes/azurekubernetesenvironmentresource.md) -- `handle` - 10 members
- [AzureKubernetesLoadBalancerResource](/reference/api/typescript/aspire.hosting.azure.kubernetes/azurekubernetesloadbalancerresource.md) -- `handle` - 0 members

## Functions

- [addAzureKubernetesEnvironment](/reference/api/typescript/aspire.hosting.azure.kubernetes/addazurekubernetesenvironment.md) -- `method` -- Adds an Azure Kubernetes Service (AKS) environment to the distributed application. This provisions an AKS cluster and configures it as a Kubernetes compute environment.
- [addCertManager](/reference/api/typescript/aspire.hosting.azure.kubernetes/addcertmanager.md) -- `method` -- Installs cert-manager into an AKS environment
- [addGateway](/reference/api/typescript/aspire.hosting.azure.kubernetes/addgateway.md) -- `method` -- Adds a Kubernetes Gateway API Gateway resource to the application model, associated with the inner Kubernetes environment of the specified AKS environment.
- [addHelmChart](/reference/api/typescript/aspire.hosting.azure.kubernetes/addhelmchart.md) -- `method` -- Adds an external Helm chart to be installed in the AKS environment's inner Kubernetes environment. The chart is installed via `helm upgrade --install` as a pipeline step after the main application Helm chart is deployed.
- [addIngress](/reference/api/typescript/aspire.hosting.azure.kubernetes/addingress.md) -- `method` -- 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.
- [addLoadBalancer](/reference/api/typescript/aspire.hosting.azure.kubernetes/addloadbalancer.md) -- `method` -- Adds an Azure Application Gateway for Containers (AGC) `ApplicationLoadBalancer` to this AKS environment, bound to the supplied delegated subnet. Returns a resource builder that can be passed to `gateway.WithLoadBalancer(lb)` / `ingress.WithLoadBalancer(lb)` to route traffic through this load balancer.
- [addNodePool](/reference/api/typescript/aspire.hosting.azure.kubernetes/addnodepool.md) -- `method` -- Adds a node pool to the AKS cluster.
- [withContainerRegistry](/reference/api/typescript/aspire.hosting.azure.kubernetes/withcontainerregistry.md) -- `method` -- Configures the AKS environment to use a specific Azure Container Registry for image storage. When set, this replaces the auto-created default container registry.
- [withLoadBalancer](/reference/api/typescript/aspire.hosting.azure.kubernetes/withloadbalancer.md) -- `method` -- Routes a Kubernetes Gateway through an AGC ApplicationLoadBalancer
- [withLoadBalancer](/reference/api/typescript/aspire.hosting.azure.kubernetes/withloadbalancer.md) -- `method` -- Routes a Kubernetes Ingress through an AGC ApplicationLoadBalancer
- [withSubnet](/reference/api/typescript/aspire.hosting.azure.kubernetes/withsubnet.md) -- `method` -- Configures the AKS cluster to use a VNet subnet
- [withSubnet](/reference/api/typescript/aspire.hosting.azure.kubernetes/withsubnet.md) -- `method` -- Configures an AKS node pool to use a specific VNet subnet
- [withSystemNodePool](/reference/api/typescript/aspire.hosting.azure.kubernetes/withsystemnodepool.md) -- `method` -- Replaces the default system node pool with a customized configuration.
- [withWorkloadIdentity](/reference/api/typescript/aspire.hosting.azure.kubernetes/withworkloadidentity.md) -- `method` -- Enables or disables workload identity on the AKS environment, allowing pods to authenticate to Azure services using federated credentials.