Skip to content

Deprecate S3v1 Storage Driver for Container Registry

Description

Summary

The S3 storage driver for GitLab Container Registry that uses AWS SDK v1 will be deprecated in GitLab 18.0 and removed in GitLab 19.0.

Motivation

AWS SDK v1 reaches end-of-life on July 31, 2025, and will no longer receive security updates or support from AWS after this date. To ensure continued security and functionality, we need to transition to the new S3v2 driver based on AWS SDK v2.

Proposal

  1. Add deprecation notices to:

  2. Implement runtime log warnings when users are running the deprecated S3v1 driver:

    Copy

    WARNING: You are using the deprecated S3v1 storage driver. Support for AWS SDK v1 ends on July 31, 2025. Please migrate to the v2 driver.

  3. Ensure clear migration instructions are available for users to switch from v1 to v2

Rollout Plan

  • GitLab 17.10 (Feb/March 2025): Deprecation announced, S3v2 available as beta
  • GitLab 18.3 (May 2025): S3v2 becomes GA and default
  • GitLab 19.0: S3v1 driver removed completely

Documentation

Documentation should include:

  • Announcement of the deprecation timeline
  • Migration instructions
  • Any breaking changes or gotchas (especially removing SignatureV2 signing dependencies)
  • Testing recommendations
Edited by Tim Rizzi
OSZAR »