Bicep Kubernetes-tillägget (förhandsversion)

Med Kubernetes-tillägget kan du skapa Kubernetes-resurser direkt med Bicep. Bicep kan distribuera allt som kan distribueras med Kubernetes kommandoradsklient (kubectl) och en Kubernetes-manifestfil.

Kommentar

Kubernetes-tillägget stöds för närvarande inte för privata kluster:

resource AKS 'Microsoft.ContainerService/managedClusters@2024-02-01' = {
 ...
 properties: {
  apiServerAccessProfile: {
    enablePrivateCluster: true
  }
 }
}

Aktivera förhandsgranskningsfunktionen

Den här förhandsgranskningsfunktionen kan aktiveras genom att konfigurera bicepconfig.json:

{
  "experimentalFeaturesEnabled": {
    "extensibility": true
  }
}

Importera Kubernetes-tillägg

För att på ett säkert sätt skicka hemligheter för Kubernetes-distributionen måste du anropa Kubernetes-koden med en Bicep-modul och skicka parametern som en hemlighet. Om du vill importera Kubernetes-tillägget använder du import-instruktionen. När du har importerat tillägget kan du omstrukturera Bicep-modulfilen som vanligt, till exempel med hjälp av variabler, parametrar och utdata. Efter kontrakt innehåller Kubernetes-manifestet i YML inte något programmeringsstöd.

Följande exempel importerar Kubernetes-tillägget:

@secure()
param kubeConfig string

import 'kubernetes@1.0.0' with {
  namespace: 'default'
  kubeConfig: kubeConfig
} as k8s

• namespace: Ange namnområdet för tillägget.
• KubeConfig: Ange ett base64-kodat värde för autentiseringsuppgifterna för Kubernetes-klusteradministratören.

Följande exempel visar hur du skickar kubeConfig värde från en överordnad Bicep-fil:

resource aks 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: 'demoAKSCluster'
}

module kubernetes './kubernetes.bicep' = {
  name: 'buildbicep-deploy'
  params: {
    kubeConfig: aks.listClusterAdminCredential().kubeconfigs[0].value
  }
}

AKS-klustret kan vara en ny resurs eller en befintlig resurs. Kommandot Import Kubernetes manifest från Visual Studio Code kan automatiskt lägga till importfragmentet. Mer information finns i Importera Kubernetes-manifestkommando.

Import av Visual Studio Code

Från Visual Studio Code kan du importera Kubernetes-manifestfiler för att skapa Bicep-modulfiler. Mer information finns i Visual Studio Code.

Nästa steg

• Snabbstart – Distribuera Azure-program till Azure Kubernetes Services med hjälp av Bicep Kubernetes-tillägget