azure-storage

Vue d’ensemble

Ce que fait la skill azure-storage

La skill azure-storage est un guide ciblé sur Microsoft Azure Storage Services, couvrant :

• Blob Storage – stockage d’objets et de fichiers pour les sauvegardes, les assets statiques et les gros fichiers de données
• Azure Files (File Shares) – partages de fichiers compatibles SMB pour les workloads de type lift-and-shift
• Queue Storage – messagerie asynchrone légère et files de tâches en arrière-plan
• Table Storage – stockage NoSQL clé-valeur pour des données simples et sans schéma
• Azure Data Lake – stockage pour l’analytique big data avec espaces de noms hiérarchiques

Cette skill n’ajoute pas elle-même de nouveau SDK ou CLI. Elle vous aide plutôt à :

• Choisir le bon service Azure Storage pour votre scénario
• Utiliser les outils du MCP server (lorsqu’ils sont disponibles) pour lister comptes, conteneurs et blobs
• Installer les SDK de langage adaptés (Python, JavaScript/Node.js, Java, .NET, Go, Rust)
• Suivre les bonnes pratiques d’authentification pour éviter d’embarquer des secrets ou de mal utiliser DefaultAzureCredential

À qui s’adresse cette skill

Utilisez la skill azure-storage si vous êtes :

• Développeur backend intégrant Azure Storage dans des API, services ou workers en arrière-plan
• Ingénieur cloud ou DevOps cherchant à standardiser la façon dont votre équipe utilise Azure Storage
• Ingénieur data ou analytique ayant besoin d’un rapide point de repère entre Data Lake et Blob Storage
• Utilisateur Agent / MCP souhaitant des workflows sensibles au stockage (liste des comptes, conteneurs et blobs via azure__storage)

Problèmes que la skill azure-storage vous aide à résoudre

Avec cette skill, vous pouvez répondre rapidement à des questions comme :

• Quel service Azure Storage dois-je utiliser pour les fichiers vs les messages vs les données clé-valeur ?
• Comment lister les comptes de stockage, conteneurs et blobs via le MCP server ?
• Quel package SDK installer pour Blob, Queue, File Share ou Data Lake dans mon langage ?
• Comment mettre en place une authentification sans mot de passe avec les managed identities et Azure RBAC ?
• Quand utiliser DefaultAzureCredential et quand l’éviter ?

Quand azure-storage est (ou n’est pas) adapté

Utilisez azure-storage pour :

• Intégrer Blob Storage dans des API ou microservices
• Monter ou gérer des file shares pour des workloads lift-and-shift
• Mettre en œuvre des queues asynchrones avec Azure Queue Storage
• Stocker et interroger des données simples clé-valeur ou entités dans Table Storage
• Travailler avec Azure Data Lake pour des données analytiques

N’utilisez pas azure-storage pour :

• Les bases de données SQL relationnelles (utilisez Azure SQL ou une skill dédiée aux bases de données)
• Les workflows Cosmos DB (reportez-vous à azure-prepare et aux skills spécifiques Cosmos)
• La messagerie Event Hubs ou Service Bus (utilisez azure-messaging et les skills associées)

Si votre workload est principalement du SQL transactionnel ou du streaming d’événements de haut niveau, cette skill n’est pas le meilleur point d’entrée.

---

Comment l’utiliser

1. Installer la skill azure-storage

Pour rendre azure-storage disponible dans votre environnement d’agent, installez-la depuis le dépôt microsoft/azure-skills :

npx skills add https://github.com/microsoft/azure-skills --skill azure-storage

Après l’installation, la skill expose une documentation et des références que votre agent (ou vous, via la vue Files) peut consulter, notamment :

• SKILL.md – description de haut niveau des services et outils pris en charge
• references/auth-best-practices.md – modèles d’authentification recommandés
• references/sdk-usage.md – vue d’ensemble multi-langages des SDK et commandes d’installation
• references/sdk/*.md – fiches de référence par langage pour Blob, Queue, File Share, Data Lake et Tables

Si vous avez activé Azure MCP server dans votre environnement, la skill se connecte également aux outils azure__storage pour les opérations sur les comptes et les blobs.

2. Comprendre les services et outils disponibles

Commencez par ouvrir SKILL.md. Vous y trouverez une matrice des services qui explique quand utiliser chaque service de stockage et quels outils peuvent fonctionner avec :

• Blob Storage – stockage d’objets générique
  • MCP : azure__storage
  • CLI : az storage blob
• File Shares – partages de fichiers SMB
  • CLI : az storage file
• Queue Storage – messages asynchrones
  • CLI : az storage queue
• Table Storage – entités clé-valeur
  • CLI : az storage table
• Data Lake – analytique et espace de noms hiérarchique
  • CLI : az storage fs

Cela vous aide à choisir le bon service et le bon ensemble de commandes CLI avant de commencer à coder.

3. Utiliser le MCP server pour explorer le stockage (si activé)

Lorsque Azure MCP server est configuré, la skill azure-storage explique comment utiliser les outils azure__storage, y compris des commandes comme :

• storage_account_list – lister les comptes de stockage de votre abonnement
• storage_container_list – lister les conteneurs d’un compte de stockage
• storage_blob_list – lister les blobs d’un conteneur
• storage_blob_get – télécharger le contenu d’un blob

Ces outils sont idéaux si vous souhaitez que votre agent inspecte le stockage existant, récupère des données d’exemple ou valide la configuration avant d’écrire du code.

4. Installer les bons SDK pour votre langage

Le fichier references/sdk-usage.md fournit un tableau synthétique des packages SDK à installer par langage et par service, avec des exemples de commandes d’installation.

Par exemple, pour un développement Python avec Blob Storage :

pip install azure-storage-blob azure-identity

Pour JavaScript/Node.js avec Blob Storage :

npm install @azure/storage-blob @azure/identity

Pour Java avec Blob Storage (Maven) :

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-storage-blob</artifactId>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
</dependency>

references/sdk-usage.md met aussi en avant les SDK associés pour Queue, File Share et Data Lake, afin que vous puissiez garder une stack cohérente entre les services.

5. Suivre les bonnes pratiques d’authentification

L’authentification est souvent le point de friction principal dans les intégrations Azure Storage. La skill azure-storage inclut references/auth-best-practices.md, qui condense les recommandations Microsoft en règles pratiques.

Points clés :

• Utilisez des managed identities et Azure RBAC en production (environnements hébergés sur Azure)
• En production, privilégiez ManagedIdentityCredential ; évitez de dépendre de DefaultAzureCredential
• Pour le développement local, DefaultAzureCredential est acceptable et pratique
• Pour les pipelines CI/CD, utilisez AzurePipelinesCredential ou WorkloadIdentityCredential
• Pour la production on-premises, utilisez ClientCertificateCredential ou WorkloadIdentityCredential

Cela vous aide à éviter d’embarquer des secrets, limite la dérive de configuration et rend le comportement d’authentification prévisible entre les environnements.

6. Commencer à coder avec les fiches de référence rapide

Une fois que vous savez quel service et quel SDK vous devez utiliser, servez-vous des fichiers de référence rapide par langage dans references/sdk/ pour accélérer votre implémentation. Par exemple :

• references/sdk/azure-storage-blob-py.md – Blob Storage avec Python
• references/sdk/azure-storage-blob-ts.md – Blob Storage avec TypeScript/Node.js
• references/sdk/azure-storage-file-share-py.md et azure-storage-file-share-ts.md – Azure Files
• references/sdk/azure-storage-queue-py.md et azure-storage-queue-ts.md – Queue Storage
• references/sdk/azure-storage-file-datalake-py.md – Data Lake Storage avec Python
• references/sdk/azure-data-tables-py.md et azure-data-tables-java.md – Table Storage

Chaque fiche de référence inclut généralement :

• Des instructions d’installation pour les packages de stockage et d’identité
• Un extrait Quick Start montrant comment construire un client avec DefaultAzureCredential (pour le dev local)
• Des bonnes pratiques sur la performance, la gestion des erreurs, la conception des partitions (pour Tables) et les patterns d’upload/download

En les utilisant comme modèles, vous passez de l’idée à un code fonctionnel rapidement, tout en restant aligné sur les patterns recommandés.

7. Adapter aux environnements et modèles de déploiement

La skill azure-storage est conçue pour être adaptée, pas copiée-collée telle quelle. Quand vous adoptez les patterns :

• Remplacez les URLs d’exemple comme https://<account>.blob.core.windows.net par les endpoints de vos propres comptes
• Adaptez le choix du credential à l’environnement (managed identity en production, DefaultAzureCredential en local)
• Utilisez les commandes CLI (az storage blob, az storage queue, etc.) depuis SKILL.md pour vérifier que vos comptes, conteneurs, queues et permissions sont correctement configurés avant de déployer

Cela réduit le temps passé à déboguer les problèmes de connexion et de permissions après le déploiement.

---

FAQ

azure-storage est-elle une bibliothèque de code ou une skill de documentation ?

azure-storage est avant tout une skill de documentation et de guidage. Elle ne fournit pas ses propres bibliothèques d’exécution ; elle vous oriente vers les SDK officiels Azure Storage pour des langages comme Python, JavaScript/Node.js, Java, .NET, Go et Rust, et documente la bonne façon de les utiliser.

Est-ce que la skill azure-storage m’aide à lister les comptes et les blobs ?

Oui, si Azure MCP server est configuré, la skill explique comment utiliser les outils azure__storage tels que storage_account_list, storage_container_list et storage_blob_list pour énumérer les comptes, conteneurs et blobs, ainsi que storage_blob_get pour télécharger le contenu d’un blob.

Quels scénarios de stockage conviennent le mieux à Blob vs Data Lake ?

Le fichier SKILL.md de la skill azure-storage vous aide à décider :

• Utilisez Blob Storage pour du stockage d’objets générique, des sauvegardes, du contenu de site web statique et des workloads de type fichiers
• Utilisez Data Lake lorsque vous avez besoin de big data analytics, d’espaces de noms hiérarchiques ou d’une intégration avec des moteurs d’analytique qui attendent des sémantiques Data Lake

Les deux reposent sur la même plateforme sous-jacente ; votre choix porte donc surtout sur la façon dont vous organisez et interrogez vos données.

Puis-je utiliser azure-storage pour Cosmos DB ou des bases SQL ?

Non. La skill azure-storage est centrée sur les services Azure Storage uniquement. Pour Cosmos DB et la préparation de bases plus avancée, le dépôt recommande d’utiliser azure-prepare et les skills spécifiques Cosmos. Pour les bases SQL relationnelles, privilégiez des outils ou skills orientés SQL.

DefaultAzureCredential est-il sûr à utiliser en production avec azure-storage ?

La skill recommande explicitement de ne pas utiliser DefaultAzureCredential en production. Il est idéal pour le développement local, mais en production vous devriez utiliser :

• ManagedIdentityCredential pour les workloads hébergés sur Azure
• ClientCertificateCredential ou WorkloadIdentityCredential pour les workloads on-premises
• Des credentials spécifiques CI comme AzurePipelinesCredential lorsque c’est pertinent

Cela rend l’authentification déterministe, réduit la latence liée aux tentatives de fallback échouées et limite votre surface d’attaque.

azure-storage couvre-t-elle à la fois Python et JavaScript/Node.js ?

Oui. references/sdk-usage.md et les fichiers sous references/sdk/ incluent des fiches de référence rapide et des commandes d’installation pour Python et JavaScript/Node.js, ainsi que pour Java, .NET, Go et Rust. Si vous développez un backend en Python ou Node.js, vous trouverez des exemples prêts à adapter pour Blob, Queue, File Share, Data Lake et Tables.

Comment savoir si azure-storage est le bon point de départ pour mon projet ?

Choisissez azure-storage si :

• Votre application doit stocker ou servir des fichiers, objets ou jeux de données volumineux depuis Azure
• Vous avez besoin de queues légères ou de stockage clé-valeur sans gérer votre propre infrastructure
• Vous voulez des recommandations claires et assumées sur quel SDK installer et comment vous authentifier en toute sécurité

Si votre projet porte principalement sur des bases de données relationnelles, du streaming d’événements à très haut débit (Event Hubs, Service Bus) ou des plateformes analytiques spécialisées, commencez plutôt par les skills dédiées à ces services, puis complétez avec azure-storage uniquement lorsque vous ajoutez des fonctionnalités centrées sur le stockage.