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 Import-Anweisung. 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
import 'kubernetes@1.0.0' 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-02-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.