Fournisseur Kubernetes d’extensibilité Bicep (préversion)
Le fournisseur Kubernetes vous permet de créer des ressources Kubernetes directement avec Bicep. Bicep peut déployer tout élément déployable avec le client de ligne de commande Kubernetes (kubectl) et un fichier manifeste Kubernetes.
Remarque
Actuellement, le fournisseur Kubernetes n’est pas pris en charge pour les clusters privés :
resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
...
properties: {
apiServerAccessProfile: {
enablePrivateCluster: true
}
}
}
Activer la fonctionnalité de préversion
Vous pouvez activer cette fonctionnalité d’évaluation en configurant bicepconfig.json :
{
"experimentalFeaturesEnabled": {
"extensibility": true
}
}
Importer un fournisseur Kubernetes
Pour transmettre en toute sécurité des secrets pour déploiement Kubernetes, vous devez appeler le code Kubernetes avec un module Bicep, puis transmettre le paramètre en tant que secret. Pour importer le fournisseur Kubernetes, utilisez l’instruction import. Après avoir importé le fournisseur, vous pouvez refactoriser le fichier de module Bicep comme d’habitude, par exemple à l’aide de variables, de paramètres et de sortie. Selon un contrat, le manifeste Kubernetes dans YML n’inclut aucune prise en charge de programmabilité.
L’exemple suivant importe le fournisseur Kubernetes :
@secure()
param kubeConfig string
import 'kubernetes@1.0.0' with {
namespace: 'default'
kubeConfig: kubeConfig
} as k8s
- namespace : spécifiez l’espace de noms de la variable.
- KubeConfig : spécifiez une valeur encodée en base64 des informations d’identification d’administrateur du cluster Kubernetes.
L’exemple suivant montre comment transmettre une valeur kubeConfig depuis un fichier Bicep parent :
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
}
}
Le cluster AKS peut être une nouvelle ressource ou une ressource existante. La commande Import Kubernetes manifest de Visual Studio Code permet d’ajouter automatiquement l’extrait d’importation. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Importer la commande de manifeste Kubernetes.
Importation de Visual Studio Code
Depuis Visual Studio Code, vous pouvez importer des fichiers manifestes Kubernetes pour créer des fichiers de module Bicep. Pour plus d’informations, consultez Visual Studio Code.