azure-storage

Introducción

Qué hace el skill azure-storage

El azure-storage skill es una guía especializada sobre Microsoft Azure Storage Services, que cubre:

• Blob Storage: almacenamiento de objetos y archivos para copias de seguridad, recursos estáticos y archivos de datos grandes
• Azure Files (File Shares): recursos compartidos de archivos compatibles con SMB para cargas de trabajo de lift-and-shift
• Queue Storage: mensajería asíncrona ligera y colas de tareas en segundo plano
• Table Storage: almacenamiento NoSQL de pares clave-valor para datos sencillos sin esquema
• Azure Data Lake: almacenamiento para analítica de big data con espacios de nombres jerárquicos

Este skill no agrega un nuevo SDK ni una nueva CLI. En su lugar, te ayuda a:

• Elegir el servicio de Azure Storage adecuado para tu escenario
• Usar las herramientas del MCP server (cuando estén disponibles) para listar cuentas, contenedores y blobs
• Instalar los SDKs de lenguaje apropiados (Python, JavaScript/Node.js, Java, .NET, Go, Rust)
• Seguir prácticas recomendadas de autenticación para no exponer secretos ni usar DefaultAzureCredential de forma incorrecta

A quién va dirigido este skill

Usa el skill azure-storage si eres:

• Desarrollador backend que integra Azure Storage en APIs, servicios o procesos en segundo plano
• Ingeniero de nube o de DevOps que quiere estandarizar cómo usa Azure Storage su equipo
• Ingeniero de datos o de analítica que necesita una orientación rápida sobre Data Lake frente a Blob Storage
• Usuario de agentes / MCP que quiere flujos de trabajo con conocimiento de almacenamiento (listar cuentas de almacenamiento, contenedores y blobs mediante azure__storage)

Problemas que el skill azure-storage te ayuda a resolver

Con este skill puedes responder rápidamente preguntas como:

• ¿Qué servicio de Azure Storage debo usar para archivos, mensajes o datos clave-valor?
• ¿Cómo listar cuentas de almacenamiento, contenedores y blobs a través del MCP server?
• ¿Qué paquete de SDK debo instalar para Blob, Queue, File Share o Data Lake en mi lenguaje?
• ¿Cómo configuro autenticación sin contraseñas usando identidades administradas y Azure RBAC?
• ¿Cuándo debo usar DefaultAzureCredential y cuándo debo evitarlo?

Cuándo azure-storage es o no es una buena opción

Usa azure-storage para:

• Integrar Blob Storage en APIs o microservicios
• Montar o administrar file shares para cargas de trabajo de lift-and-shift
• Implementar colas asíncronas usando Azure Queue Storage
• Almacenar y consultar datos sencillos de entidades o clave-valor en Table Storage
• Trabajar con Azure Data Lake para datos de analítica

No uses azure-storage para:

• Bases de datos SQL relacionales (usa Azure SQL u otro skill específico de bases de datos)
• Flujos de trabajo con Cosmos DB (consulta mejor azure-prepare y skills específicos de Cosmos)
• Mensajería con Event Hubs o Service Bus (usa azure-messaging y skills relacionados)

Si tu carga de trabajo es principalmente SQL transaccional o streaming de eventos de alto nivel, este skill no es el mejor punto de partida.

---

Cómo usarlo

1. Instalar el skill azure-storage

Para que azure-storage esté disponible en tu entorno de agente, instálalo desde el repositorio microsoft/azure-skills:

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

Después de la instalación, el skill expone documentación y referencias que tu agente (o tú, desde la vista Files) puede consultar, incluyendo:

• SKILL.md: descripción general de los servicios y herramientas compatibles
• references/auth-best-practices.md: patrones de autenticación recomendados
• references/sdk-usage.md: vista general de SDKs multiplataforma y comandos de instalación
• references/sdk/*.md: referencias rápidas por lenguaje para Blob, Queue, File Share, Data Lake y Tables

Si tienes el Azure MCP server habilitado en tu entorno, el skill también se integra con las herramientas azure__storage para operaciones sobre cuentas y blobs.

2. Conocer los servicios y herramientas disponibles

Abre primero SKILL.md. Incluye una matriz de servicios que explica cuándo usar cada servicio de almacenamiento y qué herramientas funcionan con él:

• Blob Storage: almacenamiento de objetos general
  • MCP: azure__storage
  • CLI: az storage blob
• File Shares: recursos compartidos de archivos SMB
  • CLI: az storage file
• Queue Storage: mensajes asíncronos
  • CLI: az storage queue
• Table Storage: entidades clave-valor
  • CLI: az storage table
• Data Lake: analítica y espacio de nombres jerárquico
  • CLI: az storage fs

Esto te ayuda a elegir el servicio y el conjunto de comandos de CLI correctos antes de empezar a programar.

3. Usar el MCP server para descubrir almacenamiento (si está habilitado)

Cuando el Azure MCP server está configurado, el skill azure-storage explica cómo usar las herramientas azure__storage, incluidas órdenes como:

• storage_account_list: lista las cuentas de almacenamiento de tu suscripción
• storage_container_list: lista los contenedores dentro de una cuenta de almacenamiento
• storage_blob_list: lista los blobs dentro de un contenedor
• storage_blob_get: descarga el contenido de un blob

Estas herramientas son ideales cuando quieres que tu agente inspeccione el almacenamiento existente, obtenga datos de ejemplo o valide la configuración antes de escribir código.

4. Instalar los SDKs adecuados para tu lenguaje

El archivo references/sdk-usage.md ofrece una tabla compacta con los paquetes de SDK que debes instalar por lenguaje y servicio, junto con comandos de instalación de ejemplo.

Por ejemplo, para desarrollo con Python y Blob Storage:

pip install azure-storage-blob azure-identity

Para JavaScript/Node.js con Blob Storage:

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

Para Java con 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 también destaca los SDKs relacionados para Queue, File Share y Data Lake, de modo que puedas mantener una pila coherente en todos los servicios.

5. Seguir las mejores prácticas de autenticación

La autenticación suele ser el punto conflictivo en las integraciones con Azure Storage. El skill azure-storage incluye references/auth-best-practices.md, que condensa las recomendaciones de Microsoft en reglas prácticas.

Puntos clave:

• Usa managed identities y Azure RBAC en producción (entornos hospedados en Azure)
• En producción, prefiere ManagedIdentityCredential; evita depender de DefaultAzureCredential allí
• Para desarrollo local, DefaultAzureCredential es aceptable y cómodo
• Para pipelines de CI/CD, usa AzurePipelinesCredential o WorkloadIdentityCredential
• Para producción on-premises, usa ClientCertificateCredential o WorkloadIdentityCredential

Esto te ayuda a evitar exponer secretos, reduce desviaciones de configuración y hace que el comportamiento de autenticación sea predecible entre entornos.

6. Empezar a programar con las referencias rápidas

Una vez que sabes qué servicio y qué SDK necesitas, usa las referencias rápidas por lenguaje en references/sdk/ para acelerar tu implementación. Por ejemplo:

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

Cada referencia rápida suele incluir:

• Instrucciones de instalación para los paquetes de storage e identidad
• Un fragmento de Quick Start que muestra cómo crear un cliente con DefaultAzureCredential (para desarrollo local)
• Buenas prácticas de rendimiento, manejo de errores, diseño de particiones (para Tables) y patrones de carga/descarga

Al usarlas como plantillas, puedes pasar del concepto al código funcionando con la mínima fricción y alineado con los patrones recomendados.

7. Adaptar los ejemplos a tu entorno y modelo de despliegue

El skill azure-storage está diseñado para que lo adaptes, no para copiarlo y pegarlo sin más. Al adoptar los patrones:

• Sustituye las URLs de ejemplo como https://<account>.blob.core.windows.net por los endpoints reales de tu cuenta
• Ajusta tu elección de credenciales según el entorno (managed identity en producción, DefaultAzureCredential en local)
• Usa los comandos de CLI (az storage blob, az storage queue, etc.) de SKILL.md para comprobar que tu cuenta, contenedores, colas y permisos estén configurados correctamente antes de desplegar

Esto reduce el tiempo dedicado a depurar problemas de conexión y permisos después del despliegue.

---

Preguntas frecuentes

¿azure-storage es una biblioteca de código o un skill de documentación?

azure-storage es principalmente un skill de documentación y guía. No incluye sus propias bibliotecas de runtime; en su lugar, te dirige a los SDKs oficiales de Azure Storage para lenguajes como Python, JavaScript/Node.js, Java, .NET, Go y Rust, y documenta cómo usarlos correctamente.

¿El skill azure-storage me ayuda a listar cuentas y blobs?

Sí, si tienes el Azure MCP server configurado, el skill explica cómo usar las herramientas azure__storage, como storage_account_list, storage_container_list y storage_blob_list para enumerar cuentas, contenedores y blobs, y storage_blob_get para descargar el contenido de un blob.

¿Qué escenarios de almacenamiento encajan mejor con Blob frente a Data Lake?

El SKILL.md de azure-storage te ayuda a decidir:

• Usa Blob Storage para almacenamiento de objetos de uso general, copias de seguridad, contenido de sitios estáticos y cargas de trabajo tipo archivo
• Usa Data Lake cuando necesites analítica de big data, espacios de nombres jerárquicos o integración con motores de analítica que esperan semánticas de Data Lake

Ambos se ejecutan sobre la misma plataforma subyacente, así que tu elección se centra principalmente en cómo vas a organizar y consultar los datos.

¿Puedo usar azure-storage para Cosmos DB o bases de datos SQL?

No. El skill azure-storage está centrado únicamente en los servicios de Azure Storage. Para Cosmos DB y preparación de bases de datos más avanzada, el repositorio recomienda usar azure-prepare y skills específicos de Cosmos. Para bases de datos SQL relacionales, deberías usar herramientas o skills centrados en SQL.

¿Es seguro usar DefaultAzureCredential en producción con azure-storage?

El skill recomienda explícitamente no usar DefaultAzureCredential en producción. Es ideal para el desarrollo local, pero en producción deberías usar:

• ManagedIdentityCredential para cargas de trabajo hospedadas en Azure
• ClientCertificateCredential o WorkloadIdentityCredential para cargas de trabajo on-premises
• Credenciales específicas de CI como AzurePipelinesCredential cuando corresponda

Esto mantiene la autenticación determinista, reduce la latencia por intentos fallidos en la cadena de credenciales y limita tu superficie de ataque.

¿azure-storage cubre tanto Python como JavaScript/Node.js?

Sí. references/sdk-usage.md y los archivos bajo references/sdk/ incluyen referencias rápidas y comandos de instalación para Python y JavaScript/Node.js, así como para Java, .NET, Go y Rust. Si estás creando un backend en Python o Node.js, encontrarás ejemplos listos para adaptar para Blob, Queue, File Share, Data Lake y Tables.

¿Cómo decido si azure-storage es el punto de partida adecuado para mi proyecto?

Elige azure-storage si:

• Tu aplicación debe almacenar o servir archivos, objetos o grandes volúmenes de datos desde Azure
• Necesitas colas ligeras o almacenamiento clave-valor sin administrar tu propia infraestructura
• Quieres una guía clara y con opinión sobre qué SDK instalar y cómo autenticarte de forma segura

Si tu proyecto se centra principalmente en bases de datos relacionales, streaming de eventos de alto rendimiento (Event Hubs, Service Bus) o plataformas de analítica especializadas, empieza con los skills dedicados a esos servicios y complétalos con azure-storage solo cuando añadas funcionalidades centradas en almacenamiento.