Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ updates:
directory: "/" # Location of package manifests
schedule:
interval: "daily"
cooldown:
default-days: 7
- package-ecosystem: "github-actions"
directory: "/"
groups:
Expand Down
3 changes: 2 additions & 1 deletion .npmrc
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
registry=https://registry.npmjs.org/
omit-lockfile-registry-resolved=true
strict-ssl=true
//registry.npmjs.org/:_authToken=${NPM_TOKEN}
27 changes: 27 additions & 0 deletions CONTRIBUTION.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,33 @@ Every Azure Storage REST APIs maps to one handler method. Handler methods throwi

Every handler will talk to persistence layer directly. We make implements of persistency layer abstract by creating interfaces. `LokiBlobDataStore` is one of the implementation based on Loki database used by Azurite V3.

## Dependency registry configuration

The repository does not set a registry, so installs use each contributor's
configured registry:

```bash
npm ci
```

Keep TLS validation enabled. The `omit-lockfile-registry-resolved=true` npm
setting keeps registry download URLs out of the public lockfile while preserving
pinned versions and integrity hashes.

Do not hard-code the public npm registry or the developer CFS proxy in the
repository's `.npmrc`. Microsoft developer devices should inherit the managed
CFS proxy default; external contributors use their own npm configuration.
If a Microsoft device still selects the public registry, contact Global Helpdesk
to remediate the managed configuration rather than disabling TLS validation.

The managed proxy is for developer laptops and dev boxes, not automated builds.
Microsoft CI should use an authenticated, CFS-compliant Azure Artifacts feed
configured by the build owner, unless an approved exception applies.

If a pinned package is unavailable, ask the feed owner to investigate its
availability. Do not assume a 404 means quarantine, disable TLS validation, or
downgrade a package without checking the fixes that would be lost.

## Debug

In the root of the repository, we have provided pre-defined debugging scripts. This makes it easy to debug in Visual Studio Code with simple F5 click for debug configuration "Azurite Blob Service" or "Azurite Queue Service".
Expand Down
1 change: 1 addition & 0 deletions ChangeLog.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ General:

Blob:

- Bumped the default Blob service API version to `2026-10-06`, and added `2026-10-06` to the supported Blob service API versions.
- Fixed Blob GET and HEAD requests for nonexistent blobs with `If-Match` so they now return `BlobNotFound` instead of `ConditionNotMet`, matching Azure Storage. (issue #2751)
- Added opt-in, per-account Blob Versioning configured with `--accountConfigFilePath` or `--accountConfigAsJson`; Azurite preserves previous versions on supported blob writes and supports listing, reading, restoring, and deleting specific versions.
- List Blobs continuation tokens are now opaque, matching Azure Storage. Tokens are base64url encoded, versioned JSON carrying the `[name, timestamp, recordId]` tuple used to sort records, filter records after the marker, and build the next marker, which makes paging deterministic when several records share a blob name. Tokens issued by previous versions of Azurite (plain blob names) are still accepted.
Expand Down
6 changes: 3 additions & 3 deletions README.mcr.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Azurite is an open source Azure Storage API compatible server (emulator). Based

The Linux Docker image includes the Node.js runtime but removes npm and its transitive dependencies. All existing Azurite commands remain available.

| Version | Azure Storage API Version | Service Support | Description |
| ------- | ------------------------- | ------------------------------ | ------------------------------------------------- |
| 3.37.0 | 2026-06-06 | Blob, Queue and Table(preview) | Azurite V3 based on TypeScript & New Architecture |
| Version | Azure Storage API Version | Service Support | Description |
| ------- | ----------------------------------------------- | ------------------------------ | ------------------------------------------------- |
| 3.37.0 | 2026-10-06 (Blob), 2026-06-06 (Queue and Table) | Blob, Queue and Table(preview) | Azurite V3 based on TypeScript & New Architecture |

# How to Use this Image

Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@
> The latest Azurite V3 code, which supports Blob, Queue, and Table (preview) is in the main branch.
> The legacy Azurite V2 code is in the [legacy-master](https://github.com/Azure/azurite/tree/legacy-master) branch.

| Version | Azure Storage API Version | Service Support | Description | Reference Links |
| ------------------------------------------------------------------ | ------------------------- | ------------------------------ | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 3.37.0 | 2026-06-06 | Blob, Queue and Table(preview) | Azurite V3 based on TypeScript & New Architecture | [NPM](https://www.npmjs.com/package/azurite) - [Docker](https://hub.docker.com/_/microsoft-azure-storage-azurite) - [Visual Studio Code Extension](https://marketplace.visualstudio.com/items?itemName=Azurite.azurite) |
| [Legacy (v2)](https://github.com/Azure/Azurite/tree/legacy-master) | 2016-05-31 | Blob, Queue and Table | Legacy Azurite V2 | [NPM](https://www.npmjs.com/package/azurite) |
| Version | Azure Storage API Version | Service Support | Description | Reference Links |
| ------------------------------------------------------------------ | ----------------------------------------------- | ------------------------------ | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 3.37.0 | 2026-10-06 (Blob), 2026-06-06 (Queue and Table) | Blob, Queue and Table(preview) | Azurite V3 based on TypeScript & New Architecture | [NPM](https://www.npmjs.com/package/azurite) - [Docker](https://hub.docker.com/_/microsoft-azure-storage-azurite) - [Visual Studio Code Extension](https://marketplace.visualstudio.com/items?itemName=Azurite.azurite) |
| [Legacy (v2)](https://github.com/Azure/Azurite/tree/legacy-master) | 2016-05-31 | Blob, Queue and Table | Legacy Azurite V2 | [NPM](https://www.npmjs.com/package/azurite) |

- [Azurite V3](#azurite-v3)
- [Introduction](#introduction)
Expand Down Expand Up @@ -81,7 +81,7 @@ Compared to V2, Azurite V3 implements a new architecture leveraging code generat

## Features & Key Changes in Azurite V3

- Blob storage features align with Azure Storage API version 2026-06-06 (Refer to support matrix section below)
- Blob storage features align with Azure Storage API version 2026-10-06 (Refer to support matrix section below)
- SharedKey/Account SAS/Service SAS/Public Access Authentications/OAuth
- Get/Set Blob Service Properties
- Create/List/Delete Containers
Expand Down Expand Up @@ -1160,7 +1160,7 @@ Legacy Azurite V2 supports Azure Storage Blob, Queue and Table services.
Azurite V3 currently only supports Azure Storage blob service. Queue service is supported after V3.2.0-preview.
Table service support is currently under discussion.

Azurite V3 supports features through Azure Storage API version 2026-06-06 and aims to maintain parity with the latest API versions more frequently than legacy Azurite V2.
Azurite V3 supports features through Azure Storage API version 2026-10-06 for Blob, and 2026-06-06 for Queue and Table, and aims to maintain parity with the latest API versions more frequently than legacy Azurite V2.

## TypeScript Server Code Generator

Expand Down Expand Up @@ -1194,7 +1194,7 @@ Useful commands:

## Support Matrix

Latest release targets **2026-06-06** API version **blob** service.
Latest release targets **2026-10-06** API version **blob** service.

Detailed support matrix:

Expand Down
Loading
Loading