Migrer de Functions on Azure Container Apps V1 vers Functions on Azure Container Apps V2

Utilisez ce guide pour passer du modèle d’hébergement Functions sur Azure Container Apps V1 vers le modèle recommandé Functions on Azure Container Apps V2. Vous découvrez pourquoi migrer, quels changements et comment exécuter la transition avec un risque minimal.

Vous pouvez héberger Azure Functions dans Azure Container Apps à l’aide de deux modèles de déploiement :

• Fonctions sur Azure Container Apps V1 : Modèle proxy hérité utilisant une application de fonctions (Microsoft.Webfournisseur de ressources) ainsi qu’une application conteneur en coulisses.

• Fonctions sur Azure Container Apps V2 : Modèle natif qui crée une seule ressource Azure Container App (Microsoft.App) avec kind=functionapp.

Lorsque vous passez à Functions sur Azure Container Apps V2, vous simplifiez la gestion, débloquez des fonctionnalités natives et vous alignez sur la feuille de route future d’Azure Functions.

Comparaison des modèles

Limitations des fonctions sur Azure Container Apps v1

Les fonctions sur Azure Container Apps V1 présentent plusieurs limitations qui affectent la scalabilité, la gestion et la disponibilité des fonctionnalités. Comprendre ces contraintes aide à clarifier les avantages de migrer vers les fonctions sur Azure Container Apps V2.

Lacunes de fonctionnalités

Les fonctionnalités suivantes ne sont pas disponibles pour les fonctions sur les applications Azure Container Apps V1 :

• Authentification facile
• Sondes d’intégrité
• Domaines personnalisés
• Conteneurs side-car
• Certificats managés
• Secrets d’application conteneur
• Paramètres de mise à l’échelle granulaires
• Fractionnement du trafic multi-version

Résolution des contraintes

Avec Functions sur Azure Container Apps V1, vous n'avez pas d'accès direct aux conteneurs ni de sortie console en temps réel. Utilisez plutôt Log Analytics pour le diagnostic de l’infrastructure et Application Insights pour les journaux d’application.

Problèmes d’intégration Dapr

Les fonctions isolées de Dapr et .NET peuvent entrer en conflit pendant la génération ou l’exécution en raison de contraintes d'ordre des dépendances et de l’initialisation.

Avantages des fonctions sur Azure Container Apps v2

Functions on Azure Container Apps V2 crée directement une ressource native d’application conteneur. Cette approche supprime l’indirection de proxy et active les fonctionnalités complètes d’Azure Container Apps.

Principaux avantages :

• Activez "Easy Auth" pour le délestage d’identité.
• Configurez les sondes de santé pour améliorer la résilience.
• Définissez des domaines personnalisés et utilisez des certificats managés.
• Réduisez la surcharge opérationnelle avec une seule ressource.
• Stockez les secrets en mode natif et montez des conteneurs sidecar.
• Bénéficiez de métriques plus claires, d’alertes et d'un streaming de journaux en direct.
• Utilisez des déploiements multiversions et fractionnez le trafic en toute sécurité.
• Appliquez des règles de mise à l’échelle granulaires (intervalle d’interrogation, refroidissement).

Déploiement d’images directes héritées (non pris en charge)

Certains déploiements utilisent une application conteneur standard sans kind=functionapp et exécutent manuellement une image Functions.

Recommandation : Migrer vers les fonctions sur Azure Container Apps v2.

Prerequisites

Avant de migrer :

• Abonnement Azure et autorisation de créer des ressources.
• [Azure CLI](/cli/azure/install-azure-cli-windows ?view=azure-cli-latest (dernier) installé.
• Extensions requises : az extension add --name containerapp, az extension add --name functionapp (le cas échéant).
• Accès à l’image conteneur utilisée par vos fonctions sur le déploiement Azure Container Apps V1.
• Inventaire des variables d’environnement, des secrets, des liaisons de stockage et des paramètres réseau.

Procédure de migration

1. Préparer

1. Identifiez que votre déploiement actuel est une application Functions on Azure Container Apps V1.
2. Exportez toutes les données de configuration, notamment les variables d’environnement, les secrets, les chaînes de connexion et les liaisons personnalisées.
3. Passez en revue les quotas d’environnement (processeur, mémoire, instances maximales) et ajustez si nécessaire.
4. Vérifiez la disponibilité de l’image dans votre Registre.

2. Créer une fonction sur Azure Container Apps v2

1. Créez ou réutilisez un environnement Azure Container Apps.

2. Déploie une nouvelle fonction sur l’application Azure Container Apps V2 avec la même image.

   az containerapp create \
     --name my-func-v2 \
     --resource-group <RESOURCE_GROUP_NAME> \
     --environment <ENVRONMENT_NAME> \
     --image myregistry.azurecr.io/<IMAGE_NAME>:<TAG_NAME> \
     --kind functionapp \
     --ingress external --target-port <TARGET_PORT>
   

3. Réappliquez les détails de configuration, notamment les secrets, les variables d’environnement, l’identité, la mise en réseau.

4. Activez l’authentification ou le domaine personnalisé si nécessaire.

5. Définissez les règles de mise à l’échelle (HTTP, PROCESSEUR, corrélation des déclencheurs de file d’attente selon les besoins).

3. Valider

1. Appeler des fonctions déclenchées par HTTP (curl ou browser).

2. Testez chaque type de déclencheur (Event Hubs, Service Bus, minuteur).

3. Vérifiez les données de télémétrie d'Application Insights et les journaux de Log Analytics.

4. Vérifiez le comportement de mise à l’échelle sous charge (déclenchement de règles de mise à l’échelle automatique).

5. Vérifiez que les secrets et les chaînes de connexion sont résolus correctement.

6. Vérifiez la vérification de l'état de santé et les détails de la révision du conteneur.

4. Mettre à jour dns ou des domaines personnalisés (facultatif)

1. Si vous utilisez un domaine personnalisé, mappez-le au nouveau nom d'hôte Functions on Azure Container Apps V2 (CNAME ou enregistrement A).

2. Relier des certificats SSL/TLS (gérés ou téléchargés).

3. Testez la résolution de domaine et le handshake TLS.

4. Communiquer les modifications de point de terminaison en interne.

5. Migrer

1. Déplacer le trafic de production (mettre à jour la durée de vie DNS ou les règles de routage).

2. Surveillez la latence, les erreurs et les nombres d’appels.

3. Ajustez les paramètres de mise à l’échelle si nécessaire (refroidissement, instances min/max).

4. Surveillez les journaux pour détecter des anomalies pendant les premières heures.

6. Nettoyer

1. Désactivez les anciennes fonctions sur l’application Azure Container Apps V1 et les ressources associées.

   Caution

   Vérifiez qu’aucun trafic de production n’est toujours dirigé vers le point de terminaison V1 de Functions sur Azure Container Apps avant de le supprimer.

2. Supprimez les secrets inutilisés ou les références de stockage.

3. Mettez à jour la documentation interne et les runbooks opérationnels.

Liste de vérification de validation

Améliorations opérationnelles (facultatives)

Améliorez la fiabilité après la migration :

• Ajouter des règles d’alerte
• Régler l’échelle automatique
• Appliquer l’utilisation des identités managées
• Centraliser les secrets

Contenu connexe

• Vue d’ensemble des fonctions sur Azure Container Apps
• Vue d’ensemble de la migration d’Heroku vers Azure Container Apps