Skip to content

App startup should not fail when enhanced citations storage is unreachable #1155

Description

@paullizer

Summary

When enhanced citations are enabled, the latest application version can fail to start if it cannot reach the configured storage account. Startup should not be blocked by enhanced citations storage connectivity; the application should still run as long as Cosmos DB connectivity is available.

Background

A customer upgraded from an older version around 0.222.229 to the latest 0.250.x+ version. Enhanced citations were already enabled, but storage account access was not functional. The upgrade introduced a startup path that now attempts to access the storage account early enough that the application does not run at all when that storage access fails.

Current behavior

  • Enhanced citations are enabled.
  • The configured storage account is unreachable, inaccessible, or misconfigured.
  • Application startup fails and the app does not run.
  • Admins may not have a clear application-level indication that enhanced citations storage connectivity is the cause.

Expected behavior

  • Cosmos DB connectivity should be the only required dependency for the application to boot.
  • Enhanced citations storage failures should be handled as a degraded optional capability, not as a fatal startup error.
  • The application should inform admins that enhanced citations storage access is failing or misconfigured.
  • Features that require enhanced citations storage should fail gracefully with a clear admin-facing error or health/status indication.

Acceptance criteria

  • Application startup succeeds when Cosmos DB is reachable, even if enhanced citations storage is unreachable.
  • Enhanced citations storage connectivity failures are logged and surfaced to admins without preventing startup.
  • Enhanced citations behavior is disabled, degraded, or error-reported only where that feature is used.
  • Startup and/or configuration validation avoids fatal storage account calls for enhanced citations.
  • Regression coverage verifies startup with enhanced citations enabled and storage unavailable.

Notes

This should prevent optional storage connectivity issues from turning into full application outages during upgrades or configuration drift.

Metadata

Metadata

Labels

bugSomething isn't working

Type

No type

Projects

Status
Scheduled

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions