Kubernetes-Anbieter für Bicep-Erweiterbarkeit (Vorschau)
Mithilfe des Kubernetes-Anbieters 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
Kubernetes-Anbieter wird für private Cluster derzeit nicht unterstützt:
resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
...
properties: {
apiServerAccessProfile: {
enablePrivateCluster: true
}
}
}
Aktivieren der Previewfunktion
Dieses Previewfeature kann durch Konfiguration der Datei bicepconfig.json aktiviert werden:
{
"experimentalFeaturesEnabled": {
"extensibility": true
}
}
Importieren eines Kubernetes-Anbieters
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 des Kubernetes-Anbieters die Import-Anweisung. Nach dem Importieren des Anbieters 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 der Kubernetes-Anbieter importiert:
@secure()
param kubeConfig string
import 'kubernetes@1.0.0' with {
namespace: 'default'
kubeConfig: kubeConfig
} as k8s
- Namespace: Geben Sie den Namespace der Variablen 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@2022-05-02-preview' 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.