Utiliser l’extension Bicep Kubernetes (préversion)
L’extension 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
L’extension Kubernetes n’est actuellement pas prise en charge pour les clusters privés :
resource AKS 'Microsoft.ContainerService/managedClusters@2024-02-01' = {
...
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 l’extension 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é l’extension, 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 l’extension Kubernetes :
@secure()
param kubeConfig string
import 'kubernetes@1.0.0' with {
namespace: 'default'
kubeConfig: kubeConfig
} as k8s
- Espace de noms : spécifiez l'espace de noms de l’extension.
- 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@2024-02-01' 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.