Cycle de vie de l’API AKS Preview

Les API (API) en préversion de Azure Kubernetes Service (AKS) qui se terminent par -preview) ont une durée de vie d’environ un an à partir de leur date de publication. Cela signifie que vous pouvez vous attendre à ce que l’API 2023-01-02-preview soit déconseillée quelque part vers le 1er janvier 2024.

Nous apprécions lorsque les utilisateurs essaient nos fonctionnalités en préversion et nous donnent des commentaires. Nous vous encourageons donc à utiliser les API en préversion et les outils basés sur eux (tels que l’extension CLI AKS Preview).

Une fois qu’une version d’API est déconseillée, elle ne fonctionnera plus ! Nous vous recommandons d’effectuer régulièrement :

• Mettez à jour vos modèles ARM/BICEP à l’aide de versions d’API en préversion pour utiliser la dernière version de l’API en préversion.
• Mettez à jour votre extension CLI AKS en préversion vers la dernière version.
• Mettez à jour les kits SDK en préversion ou d’autres outils basés sur l’API d’aperçu vers la dernière version.

Vous devez effectuer ces mises à jour au minimum toutes les 6 à 9 mois. Si vous ne parvenez pas à le faire, vous serez averti que vous utilisez une version d’API bientôt dépréciée en tant qu’approche de dépréciation.

Comment vérifier les versions d’API que vous utilisez

Si vous n’êtes pas sûr du client ou de l’outil qui utilise cette version de l’API, vérifiez les journaux d’activité avec la commande suivante :

Définissez la version de l’API à inspecter pour une utilisation récente dans le journal d’activité. Dans cet exemple, nous vérifions la version de l’API 2022-04-01-preview .

export API_VERSION="2022-04-01-preview"
az monitor activity-log list --offset 30d --max-events 10000 --namespace microsoft.containerservice --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '$API_VERSION')]"

Comment effectuer la mise à jour vers une version plus récente de l’API

• Pour les kits de développement logiciel (SDK) Azure : utilisez une version plus récente de l’API en mettant à jour vers une version plus récente du SDK.
• Pour Azure CLI : mettez à jour la CLI elle-même ainsi que l’extension aks-preview (si utilisée) vers la dernière version en exécutant az upgrade et az extension update --name "aks-preview".
• Pour Terraform : effectuez une mise à jour vers la dernière version du module AzureRM Terraform. Pour savoir quelle version de l’API est utilisée par une version spécifique de Terraform, vérifiez les notes de publication Terraform ou effectuez un git log avec ce fichier.
• Pour d’autres outils : mettez à jour l’outil vers sa dernière version.

Dépréciations à venir

Dépréciations terminées