Bicep Kubernetes-Erweiterung (Preview)

Mithilfe der Kubernetes-Erweiterung können Sie Kubernetes-Ressourcen direkt mit Bicep erstellen. Bicep kann alles bereitstellen, was mit dem Kubernetes-Befehlszeilenclient (kubectl) und einer Kubernetes-Manifestdatei bereitgestellt werden kann.

Hinweis

Die Kubernetes-Erweiterung wird derzeit für private Cluster nicht unterstützt:

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

Aktivieren der Previewfunktion

Dieses Previewfeature kann durch Konfiguration der Datei bicepconfig.json aktiviert werden:

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

Importieren der Kubernetes-Erweiterung

Zur sicheren Übergabe von Geheimnissen für die Kubernetes-Bereitstellung müssen Sie den Kubernetes-Code mit einem Bicep-Modul aufrufen und den Parameter als Geheimnis übergeben. Verwenden Sie zum Importieren der Kubernetes-Erweiterung die Erweiterungsanweisung. Nach dem Importieren der Erweiterung können Sie die Bicep-Moduldatei wie gewohnt umgestalten, z. B. durch die Verwendung von Variablen, Parametern und Ausgaben. Das Kubernetes-Manifest in YML enthält vertragsgemäß keine Unterstützung für die Programmierbarkeit.

Im folgenden Beispiel wird die Kubernetes-Erweiterung importiert:

@secure()
param kubeConfig string

extension kubernetes with {
  namespace: 'default'
  kubeConfig: kubeConfig
} as k8s

• Namespace: Geben Sie den Namespace der Erweiterung an.
• KubeConfig: Geben Sie einen Base64-codierten Wert der Anmeldeinformationen für Kubernetes-Clusteradministrator an.

Das folgende Beispiel zeigt, wie ein kubeConfig-Wert aus einer übergeordneten Bicep-Datei übergeben wird:

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

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

Der AKS-Cluster kann eine neue Ressource oder eine vorhandene Ressource sein. Der Befehl Import Kubernetes manifest von Visual Studio Code kann den Import-Codeschnipsel automatisch hinzufügen. Weitere Informationen finden Sie unter Importieren des Kubernetes-Manifestbefehls.

Import aus Visual Studio Code

Sie können Kubernetes-Manifestdateien aus Visual Studio Code importieren, um Bicep-Moduldateien zu erstellen. Weitere Informationen finden Sie unter Visual Studio Code.

Nächste Schritte

• Informationen zum Durchlaufen einer Schnellstartanleitung finden Sie unter Schnellstart – Bereitstellen von Azure-Anwendungen in Azure Kubernetes Services mithilfe der Bicep Kubernetes-Erweiterung.
• Informationen zur Verwendung der Microsoft Graph-Erweiterung finden Sie unter Bicep-Vorlagen für Microsoft Graph.