Skip to content

[Feature flag] Enable writing bitmap lookup tables

What

Enable the :gitaly_write_bitmap_lookup_table feature flag, which enables writing bitmap lookup tables during repository maintenance. Lookup tables are a recent addition that has been released with Git v2.38.0. If this extension is present in the on-disk bitmaps, then Git is able to defer loading bitmaps until they're really required.

As loading bitmaps scales with the bitmap size, and many Git commands do use bitmaps, this ultimately means that we can expect to offload that constant loading time in many cases.

Rolls out !5278 (merged).

Owners

  • Team: Gitaly
  • Most appropriate slack channel to reach out to: #g_gitaly
  • Best individual to reach out to: pks-t

Expectations

What release does this feature occur in first?

%15.9

What are we expecting to happen?

We should see that repository housekeeping starts to write bitmap lookup tables. Ideally, some operations may see small speedups. This is more likely to manifest in large repositories with huge bitmaps.

What might happen if this goes wrong?

The bitmap may become corrupted.

What can we monitor to detect problems with this?

Roll Out Steps

  • Enable on staging
  • Enable on production
  • Default-enable the feature flag (optional, only required if backwards-compatibility concerns exist)
    • Wait for release containg default-disabled feature flag.
    • Change the feature flag to default-enabled (howto)
    • Wait for release containing default-enabled feature flag.
  • Remove feature flag
    • Remove the feature flag and the pre-feature-flag code (howto)
    • Remove the feature flag via chatops (howto)
    • Close this issue

Please refer to the documentation of feature flags for further information.

Edited by Patrick Steinhardt
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information