azure-storage

Tổng quan

Kỹ năng azure-storage làm được gì

Kỹ năng azure-storage là một hướng dẫn tập trung về Microsoft Azure Storage Services, bao gồm:

• Blob Storage – lưu trữ object và file cho backup, static assets và các tệp dữ liệu lớn
• Azure Files (File Shares) – file share tương thích SMB cho các workload lift-and-shift
• Queue Storage – hàng đợi messaging async nhẹ và task nền
• Table Storage – lưu trữ NoSQL key-value cho dữ liệu đơn giản, không schema
• Azure Data Lake – lưu trữ phân tích big data với hierarchical namespaces

Kỹ năng này không tự bổ sung SDK hay CLI mới. Thay vào đó, nó giúp bạn:

• Chọn dịch vụ Azure Storage phù hợp với từng kịch bản
• Sử dụng công cụ MCP server (nếu có) để liệt kê accounts, containers và blobs
• Cài đặt language SDKs phù hợp (Python, JavaScript/Node.js, Java, .NET, Go, Rust)
• Làm theo thực tiễn tốt nhất về xác thực để không vô tình đưa secrets vào code hoặc dùng sai DefaultAzureCredential

Kỹ năng này dành cho ai

Hãy dùng kỹ năng azure-storage nếu bạn là:

• Backend developer tích hợp Azure Storage vào APIs, services hoặc background workers
• Cloud engineer hoặc DevOps đang chuẩn hóa cách team của bạn sử dụng Azure Storage
• Data/analytics engineer cần cái nhìn nhanh về sự khác nhau giữa Data Lake và Blob Storage
• Người dùng Agent / MCP muốn có workflow hiểu về storage (liệt kê storage accounts, containers và blobs qua azure__storage)

Những vấn đề azure-storage giúp bạn giải quyết

Với kỹ năng này, bạn có thể nhanh chóng trả lời các câu hỏi như:

• Nên dùng dịch vụ Azure Storage nào cho files vs messages vs dữ liệu key-value?
• Làm sao để liệt kê storage accounts, containers và blobs qua MCP server?
• Nên cài SDK package nào cho Blob, Queue, File Share hoặc Data Lake trong ngôn ngữ của tôi?
• Thiết lập passwordless authentication với managed identities và Azure RBAC như thế nào?
• Khi nào nên dùng DefaultAzureCredential và khi nào nên tránh?

Khi nào azure-storage phù hợp và khi nào không

Hãy dùng azure-storage cho:

• Tích hợp Blob Storage vào APIs hoặc microservices
• Mount hoặc quản lý file shares cho các workload lift-and-shift
• Triển khai async queues dùng Azure Queue Storage
• Lưu trữ và truy vấn dữ liệu đơn giản dạng key-value hoặc entity trong Table Storage
• Làm việc với Azure Data Lake cho dữ liệu phân tích

Không nên dùng azure-storage cho:

• Cơ sở dữ liệu SQL quan hệ (hãy dùng Azure SQL hoặc kỹ năng chuyên cho database khác)
• Workflows với Cosmos DB (xem azure-prepare và các kỹ năng chuyên cho Cosmos)
• Messaging bằng Event Hubs hoặc Service Bus (dùng azure-messaging và các kỹ năng liên quan)

Nếu workload của bạn chủ yếu là giao dịch SQL hoặc event streaming cấp cao, đây không phải điểm bắt đầu phù hợp.

---

Cách sử dụng

1. Cài đặt kỹ năng azure-storage

Để dùng azure-storage trong môi trường agent của bạn, hãy cài đặt từ repository microsoft/azure-skills:

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

Sau khi cài đặt, kỹ năng cung cấp tài liệu và các reference mà agent của bạn (hoặc bạn, qua Files view) có thể xem, bao gồm:

• SKILL.md – mô tả cấp cao về các dịch vụ và công cụ được hỗ trợ
• references/auth-best-practices.md – các mẫu xác thực được khuyến nghị
• references/sdk-usage.md – tổng quan SDK đa ngôn ngữ và lệnh cài đặt
• references/sdk/*.md – quick reference theo từng ngôn ngữ cho Blob, Queue, File Share, Data Lake và Tables

Nếu bạn đã bật Azure MCP server trong môi trường, kỹ năng cũng liên kết với các công cụ azure__storage cho thao tác với account và blob.

2. Hiểu các dịch vụ và công cụ sẵn có

Mở SKILL.md trước. Tệp này có Services matrix giải thích khi nào nên dùng mỗi dịch vụ storage và công cụ nào có thể làm việc với nó:

• Blob Storage – object storage tổng quát
  • MCP: azure__storage
  • CLI: az storage blob
• File Shares – SMB file shares
  • CLI: az storage file
• Queue Storage – async messages
  • CLI: az storage queue
• Table Storage – key-value entities
  • CLI: az storage table
• Data Lake – phân tích và hierarchical namespace
  • CLI: az storage fs

Điều này giúp bạn chọn đúng dịch vụ và bộ lệnh CLI trước khi bắt đầu viết code.

3. Dùng MCP server để khám phá storage (nếu đã bật)

Khi Azure MCP server đã được cấu hình, kỹ năng azure-storage giải thích cách dùng các công cụ azure__storage, bao gồm các lệnh như:

• storage_account_list – liệt kê storage accounts trong subscription của bạn
• storage_container_list – liệt kê containers trong một storage account
• storage_blob_list – liệt kê blobs trong một container
• storage_blob_get – tải nội dung blob

Các công cụ này rất hữu ích khi bạn muốn agent kiểm tra storage hiện có, lấy mẫu dữ liệu hoặc xác thực cấu hình trước khi viết code.

4. Cài đúng SDK cho ngôn ngữ của bạn

Tệp references/sdk-usage.md đưa ra một bảng tóm tắt những SDK packages cần cài theo từng ngôn ngữ và dịch vụ, kèm các lệnh cài đặt mẫu.

Ví dụ, cho phát triển Python với Blob Storage:

pip install azure-storage-blob azure-identity

Cho JavaScript/Node.js với Blob Storage:

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

Cho Java với 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 cũng nêu bật các SDK liên quan cho Queue, File Share và Data Lake, giúp bạn giữ stack đồng nhất giữa các dịch vụ.

5. Tuân theo thực tiễn tốt nhất về xác thực

Xác thực thường là nơi tích hợp Azure Storage dễ gặp lỗi. Kỹ năng azure-storage bao gồm references/auth-best-practices.md, tóm lược hướng dẫn từ Microsoft thành những quy tắc thực tế.

Các điểm chính:

• Dùng managed identities và Azure RBAC trong production (môi trường chạy trên Azure)
• Ưu tiên ManagedIdentityCredential trong production; tránh phụ thuộc vào DefaultAzureCredential ở đó
• Với local development, DefaultAzureCredential là lựa chọn chấp nhận được và tiện lợi
• Với CI/CD pipelines, dùng AzurePipelinesCredential hoặc WorkloadIdentityCredential
• Với production on-premises, dùng ClientCertificateCredential hoặc WorkloadIdentityCredential

Điều này giúp bạn tránh để lộ secrets, giảm sai lệch cấu hình và khiến hành vi xác thực dễ dự đoán hơn giữa các môi trường.

6. Bắt đầu viết code với các quick reference

Khi bạn đã biết cần dùng dịch vụ và SDK nào, hãy dùng các quick reference theo ngôn ngữ trong references/sdk/ để triển khai nhanh. Ví dụ:

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

Mỗi quick reference thường có:

• Hướng dẫn Install cho các storage và identity packages
• Đoạn Quick Start minh họa cách khởi tạo client với DefaultAzureCredential (cho local dev)
• Best practices về hiệu năng, xử lý lỗi, thiết kế partition (cho Tables) và các pattern upload/download

Bằng cách dùng những tài liệu này làm template, bạn có thể đi từ ý tưởng đến code chạy được với ít ma sát nhưng vẫn bám sát các pattern được khuyến nghị.

7. Tùy biến theo môi trường và mô hình triển khai

Kỹ năng azure-storage được thiết kế để tùy biến, không phải để copy-paste nguyên xi. Khi áp dụng các pattern:

• Thay các URL placeholder như https://<account>.blob.core.windows.net bằng endpoint account thực tế của bạn
• Gắn lựa chọn credential với môi trường (managed identity trong production, DefaultAzureCredential cho local)
• Dùng các lệnh CLI (az storage blob, az storage queue, v.v.) trong SKILL.md để xác thực rằng account, containers, queues và quyền truy cập được cấu hình đúng trước khi deploy

Điều này giúp bạn giảm thời gian debug các lỗi kết nối và quyền truy cập sau khi triển khai.

---

Câu hỏi thường gặp (FAQ)

azure-storage là thư viện code hay là kỹ năng kiểu tài liệu?

azure-storage chủ yếu là một kỹ năng về tài liệu và hướng dẫn. Nó không cung cấp runtime library riêng; thay vào đó, nó trỏ bạn tới các Azure Storage SDK chính thức cho các ngôn ngữ như Python, JavaScript/Node.js, Java, .NET, Go và Rust, và giải thích cách dùng chúng cho đúng.

Kỹ năng azure-storage có giúp tôi liệt kê accounts và blobs không?

Có. Nếu bạn đã cấu hình Azure MCP server, kỹ năng sẽ giải thích cách dùng các công cụ azure__storage như storage_account_list, storage_container_list và storage_blob_list để liệt kê accounts, containers và blobs, cũng như storage_blob_get để tải nội dung blob.

Nên dùng Blob hay Data Lake cho những kịch bản lưu trữ nào?

Tệp SKILL.md của azure-storage giúp bạn quyết định:

• Dùng Blob Storage cho object storage tổng quát, backup, nội dung static website và các workload giống file
• Dùng Data Lake khi bạn cần phân tích big data, hierarchical namespaces hoặc tích hợp với các engine phân tích kỳ vọng semantics của Data Lake

Cả hai chạy trên cùng một nền tảng cơ bản, nên lựa chọn chủ yếu là về cách bạn tổ chức và truy vấn dữ liệu.

Tôi có thể dùng azure-storage cho Cosmos DB hoặc SQL databases không?

Không. Kỹ năng azure-storage tập trung vào các dịch vụ Azure Storage. Với Cosmos DB và các bước chuẩn bị database nâng cao hơn, repository khuyến nghị dùng azure-prepare và các kỹ năng chuyên cho Cosmos. Với cơ sở dữ liệu SQL quan hệ, bạn nên dùng các công cụ hoặc kỹ năng chuyên về SQL.

DefaultAzureCredential có an toàn để dùng trong production với azure-storage không?

Kỹ năng này nêu rõ khuyến nghị không dùng DefaultAzureCredential trong production. Nó lý tưởng cho local development, nhưng trong production bạn nên dùng:

• ManagedIdentityCredential cho workloads chạy trên Azure
• ClientCertificateCredential hoặc WorkloadIdentityCredential cho workloads on-premises
• Các credential chuyên cho CI như AzurePipelinesCredential khi phù hợp

Cách này giúp xác thực diễn ra nhất quán, giảm độ trễ do các lần fallback credential thất bại và hạn chế bề mặt tấn công.

azure-storage có hỗ trợ cả Python và JavaScript/Node.js không?

Có. references/sdk-usage.md và các tệp dưới references/sdk/ bao gồm quick reference và lệnh cài đặt cho Python và JavaScript/Node.js, cũng như Java, .NET, Go và Rust. Nếu bạn đang xây dựng backend bằng Python hoặc Node.js, bạn sẽ tìm được các ví dụ dễ tùy biến cho Blob, Queue, File Share, Data Lake và Tables.

Làm sao biết azure-storage có phải điểm khởi đầu phù hợp cho dự án của tôi không?

Hãy chọn azure-storage nếu:

• Ứng dụng của bạn cần lưu trữ hoặc phục vụ files, objects hoặc các bộ dữ liệu lớn từ Azure
• Bạn cần queues nhẹ hoặc lưu trữ key-value mà không phải tự vận hành hạ tầng
• Bạn muốn có hướng dẫn rõ ràng, có quan điểm về nên cài SDK nào và xác thực an toàn ra sao

Nếu dự án của bạn chủ yếu xoay quanh cơ sở dữ liệu quan hệ, event streaming throughput cao (Event Hubs, Service Bus) hoặc các nền tảng phân tích chuyên biệt, hãy bắt đầu với các kỹ năng dành riêng cho những dịch vụ đó, rồi bổ sung azure-storage khi bạn thêm các tính năng tập trung vào storage.