Feedback issue: Container registry storage driver upgrades

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

• Close this issue

Container Registry Storage Driver Feedback

Overview

This issue is for collecting feedback on the Beta versions of the next-generation storage drivers for the GitLab container registry:

• s3_v2 driver (replacing the legacy s3 driver)
• azure_v2 driver (replacing the legacy azure driver)

These new drivers will be required in GitLab 19.0 as the legacy drivers are being deprecated in GitLab 17.10.

How to provide feedback

Please share your experiences with these Beta drivers by commenting on this issue. Include details about:

1. Your environment (GitLab version, infrastructure details)
2. Which driver you're testing (s3_v2 or azure_v2)
3. Any differences in behavior compared to the legacy drivers
4. Performance observations
5. Configuration challenges
6. Any bugs or unexpected behavior

Why are we making this change?

• S3 driver: AWS is deprecating Signature Version 2 authentication, making the update to SDK v2 necessary
• Azure driver: The new driver supports modern authentication methods and improves overall reliability

Example configurations

S3 v2 driver

registry['storage'] = {
  's3_v2' => {
    'accesskey' => 's3-access-key',
    'secretkey' => 's3-secret-key-for-access-key',
    'bucket' => 'your-s3-bucket',
    'region' => 'your-s3-region',
    'regionendpoint' => 'your-s3-regionendpoint'
  }
}

Azure v2 driver

registry['storage'] = {
  'azure_v2' => {
    'credentials_type' => 'client_secret',
    'tenant_id' => '<your_tenant_id>',
    'client_id' => '<your_client_id>',
    'secret' => '<your_secret>',
    'container' => '<your_container>',
    'accountname' => '<your_account_name>'
  }
}

Testing recommendations

1. Create a test/staging environment that mirrors your production setup
2. Update to the Beta driver in your test environment
3. Test all common workflows:
   • Pushing and pulling images
   • Garbage collection operations
   • Repository management tasks
4. Monitor for errors and performance differences
5. Share your feedback in this issue

Migration timeline

• GitLab 17.10: Legacy drivers deprecated
• May 2025: s3_v2 and azure_v2 drivers available
• GitLab 19.0: Legacy drivers removed

Your feedback will help us ensure a smooth transition to these new drivers. Thank you for your assistance!