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 l’extension Kubernetes, utilisez l’instruction d’extension. 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

extension kubernetes 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-08-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.

Étapes suivantes

• Pour parcourir un guide de démarrage rapide, consultez Démarrage rapide : déployer des applications Azure sur Azure Kubernetes Services à l’aide de l’extension Kubernetes Bicep.
• Pour en savoir plus sur l’utilisation de l’extension Microsoft Graph, consultez Modèles Bicep pour Microsoft Graph.