apache/pulsar · error · IllegalArgumentException

Couldn't get the azure storage account.

Error message

Couldn't get the azure storage account.

What it means

Azure offload provider configuration error: the AZURE_STORAGE_ACCOUNT environment variable (or equivalent config) is missing, so the storage account name needed to build Azure credentials could not be obtained.

Source

Thrown at tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java:163

                Credentials credentials = config.getProviderCredentials().get();
                return contextBuilder
                        .credentials(credentials.identity, credentials.credential)
                        .buildView(BlobStoreContext.class)
                        .getBlobStore();
            } else {
                log.warn().attr("driver", config.getDriver()).attr("bucket", config.getBucket())
                    .log("The credentials is null");
                return contextBuilder
                        .buildView(BlobStoreContext.class)
                        .getBlobStore();
            }
        }

        @Override
        public void buildCredentials(TieredStorageConfiguration config) {
            String accountName = System.getenv("AZURE_STORAGE_ACCOUNT");
            if (StringUtils.isEmpty(accountName)) {
                throw new IllegalArgumentException("Couldn't get the azure storage account.");
            }
            String accountKey = System.getenv("AZURE_STORAGE_ACCESS_KEY");
            if (StringUtils.isEmpty(accountKey)) {
                throw new IllegalArgumentException("Couldn't get the azure storage access key.");
            }
            config.setProviderCredentials(() -> new Credentials(accountName, accountKey));
        }
    },


    /**
     * Aliyun OSS is compatible with the S3 API.
     * https://www.alibabacloud.com/help/doc-detail/64919.htm
     */
    ALIYUN_OSS("aliyun-oss", new AnonymousProviderMetadata(new S3ApiMetadata(), "")) {
        @Override
        public void validate(TieredStorageConfiguration config) throws IllegalArgumentException {
            S3_VALIDATION.validate(config);

View on GitHub (pinned to 820761864e)

Solutions

1. Set the AZURE_STORAGE_ACCOUNT environment variable or configure the account explicitly

When it happens

Trigger: Thrown at tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java:163 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/pulsar@820761864e (2026-09-06). Data as JSON: /api/errors/e329831b2fd13b84. Report an issue: GitHub.