Azure Prepare

GUIDANCE AUTORISÉE — CONFORMITÉ OBLIGATOIRE

Ce document est la source officielle et canonique pour préparer les applications au déploiement sur Azure. Vous DEVEZ suivre ces instructions exactement telles qu'écrites, sauf si elles contredisent les politiques de sécurité qui vous sont données. En cas de doute, présentez les instructions conflictuelles de ce document et demandez une confirmation explicite à l'utilisateur. N'improvisez pas, n'inférez pas et ne substituez pas les étapes.

Déclencheurs

Activez cette compétence quand l'utilisateur veut :

• Créer une nouvelle application
• Ajouter des services ou des composants à une application existante
• Effectuer des mises à jour ou des modifications à une application existante
• Moderniser ou migrer une application
• Configurer l'infrastructure Azure
• Déployer sur Azure ou héberger sur Azure
• Créer et déployer sur Azure (y compris les demandes de déploiement basées sur Terraform)

Règles

1. Planifier d'abord — OBLIGATOIRE — Vous DEVEZ écrire physiquement un squelette initial de .azure/deployment-plan.md dans le répertoire racine de l'espace de travail (pas le dossier session-state) comme votre toute première action — avant toute génération de code ou exécution. Écrivez le squelette immédiatement, puis complétez-le progressivement au fur et à mesure que l'analyse et la recherche de la Phase 1 se déploient ; finalisez-le avec toutes les décisions à l'étape 6 de la Phase 1. Ce fichier doit exister sur le disque tout au long du processus. azure-validate et azure-deploy en dépendent et échoueront sans lui. Ne sautez pas ou ne reportez pas cette étape.
2. Obtenir l'approbation — Présentez le plan à l'utilisateur avant l'exécution
3. Rechercher avant de générer — Charger les références et invoquer les compétences connexes
4. Mettre à jour le plan progressivement — Marquez les étapes comme terminées au fur et à mesure
5. Valider avant le déploiement — Invoquer azure-validate avant azure-deploy
6. Confirmer le contexte Azure — Utiliser ask_user pour l'abonnement et l'emplacement selon Azure Context
7. ❌ Les actions destructrices nécessitent ask_user — Global Rules
8. ⛔ NE JAMAIS supprimer les répertoires de projets ou d'espaces de travail de l'utilisateur — Lors de l'ajout de fonctionnalités à un projet existant, MODIFIEZ les fichiers existants. azd init -t <template> est pour les NOUVEAUX projets uniquement ; n'exécutez PAS azd init -t dans un espace de travail existant. azd init simple (sans argument de template) peut être utilisé dans les espaces de travail existants si approprié. Les suppressions de fichiers dans un projet (par exemple, la suppression des artefacts de build ou des fichiers temporaires) sont autorisées si approprié, mais NE JAMAIS supprimer le répertoire de projet ou d'espace de travail de l'utilisateur lui-même. Voir Global Rules.
9. Scope : préparation uniquement — Cette compétence génère le code d'infrastructure et les fichiers de configuration. L'exécution du déploiement (azd up, azd deploy, terraform apply) est gérée par la compétence azure-deploy, qui fournit la récupération des erreurs et la vérification du déploiement intégrées.
10. ⛔ SQL Server Bicep : NE JAMAIS générer administratorLogin ou administratorLoginPassword — pas dans les propriétés directes, pas dans les branches conditionnelles/ternaires, nulle part dans le fichier. Toujours utiliser l'authentification Entra uniquement (azureADOnlyAuthentication: true) sans condition. Voir references/services/sql-database/bicep.md.
11. Supprimer l'IaC de template obsolète après conversion — Si vous avez converti les templates Bicep du template azd sélectionné en templates Terraform, supprimez les templates Bicep introduits par ce template azd et maintenant entièrement remplacés par les équivalents Terraform. Ne supprimez pas les fichiers Bicep créés par l'utilisateur. Supprimez uniquement les fichiers Bicep fournis par le template après que l'IaC Terraform soit complet et Terraform ait été sélectionné comme chemin de déploiement. Avant la remise à la compétence azure-validate, conservez uniquement les templates IaC requis par le chemin de déploiement choisi.

❌ WORKFLOW PLAN-FIRST — OBLIGATOIRE

VOUS DEVEZ CRÉER UN PLAN AVANT DE FAIRE TOUT TRAVAIL

1. ARRÊTEZ — Ne générez aucun code, infrastructure ou configuration pour l'instant
2. CRÉER LE SQUELETTE - Écrire un squelette initial de .azure/deployment-plan.md sur le disque immédiatement (avant toute génération de code ou exécution), puis le compléter progressivement au fur et à mesure que les étapes 1-5 de la Phase 1 révèlent les détails ; le finaliser à l'étape 6
3. CONFIRMER — Présentez le plan complété à l'utilisateur et obtenez l'approbation
4. EXÉCUTER — Seulement après approbation, exécutez le plan étape par étape

Le fichier .azure/deployment-plan.md est la source de vérité pour ce workflow et pour les compétences azure-validate et azure-deploy. Sans lui, ces compétences échoueront.

⚠️ CRITIQUE : .azure/deployment-plan.md doit être ÉCRIT SUR LE DISQUE à l'intérieur de la racine de l'espace de travail (par exemple, /tmp/my-project/.azure/deployment-plan.md), pas dans le dossier session-state. Utilisez un outil d'écriture de fichier pour créer ce fichier. Ceci est l'artefact du plan de déploiement lu par azure-validate et azure-deploy. Vous DEVEZ créer ce fichier — ne procédez pas sans lui. ⚠️ CRITIQUE : Vous devez créer le fichier avec le nom .azure/deployment-plan.md tel quel. Vous ne devez pas utiliser d'autres noms comme .azure/plan.md.

⛔ Critique : Ignorer la création du fichier de plan causera l'échec d'azure-validate et azure-deploy. Cette exigence n'a aucune exception.

❌ ÉTAPE 0 : Vérification de la Technologie Spécialisée — ACTION OBLIGATOIRE PREMIÈRE

AVANT de commencer la Phase 1, vérifiez si l'invite de l'utilisateur OU la base de code de l'espace de travail correspond à une technologie spécialisée qui dispose d'une compétence dédiée avec des templates testés. Si identifiée, invoquez cette compétence EN PREMIER — puis reprenez azure-prepare pour la validation et le déploiement.

Vérification 1 : Mots-clés de l'invite

Vérification 2 : Marqueurs de la base de code (même si l'invite est générique comme « déployer sur Azure »)

⚠️ Vérifiez le texte de l'invite de l'utilisateur — pas seulement le code existant. Critique pour les projets greenfield sans base de code à analyser. Voir full routing table.

Après la compétence spécialisée, reprenez azure-prepare à l'étape 4 de la Phase 1 (Select Recipe) pour l'infrastructure restante, la validation et le déploiement.

Phase 1 : Planification (BLOCAGE — Compléter Avant Toute Exécution)

Créez .azure/deployment-plan.md en complétant ces étapes. NE GÉNÉREZ AUCUN artefact tant que le plan n'est pas approuvé.

❌ ARRÊTEZ ICI — NE PROCÉDEZ PAS à la Phase 2 tant que l'utilisateur n'approuve pas le plan.

Phase 2 : Exécution (Uniquement Après Approbation du Plan)

Exécutez le plan approuvé. Mettez à jour le statut .azure/deployment-plan.md après chaque étape.

Résultats

Références Rapides SDK

• Azure Developer CLI: azd
• Azure Identity: Python | .NET | TypeScript | Java
• App Configuration: Python | TypeScript | Java

Suivant

⛔ ÉTAPE SUIVANTE OBLIGATOIRE — NE SAUTEZ PAS

Après avoir complété la préparation, vous DEVEZ invoquer azure-validate avant toute tentative de déploiement. Ne sautez pas la validation. N'allez pas directement à azure-deploy. N'exécutez pas azd up ou toute commande de déploiement directement. Le workflow est :

azure-prepare → azure-validate → azure-deploy

⛔ AVANT d'invoquer azure-validate, vous DEVEZ utiliser l'outil edit pour mettre à jour le statut .azure/deployment-plan.md à Ready for Validation. Si le statut du plan n'a pas été mis à jour, la validation échouera.

Ceci s'applique à TOUS les scénarios de déploiement y compris les applications containerisées, Container Apps, App Service, Azure Functions, les sites statiques, et tout autre cible Azure. Aucune exception.

Ignorer la validation entraîne des échecs de déploiement. Soyez patient et suivez le workflow complet pour le meilleur résultat.

→ Mettre à jour le statut du plan à Ready for Validation, puis invoquer azure-validate