[!important]
The GitLab Environment Toolkit is a collection of opinionated Terraform and Ansible scripts to assist with the deployment of a self managed GitLab environment. It's recommended that users review the Before You Start section before use. Users should have a good working knowledge of Infrastructure management, Terraform, Ansible and GitLab administration as well as be aware that ultimately self managed environments are the responsibility of the user. As such, it's strongly recommended that you independently review the Toolkit in full to ensure it meets your requirements, especially around security or data integrity.
If upgrading, it's always recommended to review the release notes in full as well as the relevant documentation and to upgrade the Toolkit first before the environment.
[[TOC]]
New Key Features
Gitaly Server Side Backups Support
- Merge Request(s): !1558
- Documentation
Server Side backups are now supported for Gitaly, allowing for direct backups to Object Storage!
Thanks @shenson!
Advanced Search Custom Config
- Merge Request(s): !1606 !1618
- Documentation
Advanced Search setup can now be fully customized with additional configuration options!
Ansible Remote Environment variable support
- Merge Request(s): !1617 !1620
- Documentation
Ansible Remote Environment variables can now be configured for target hosts, such as when using a proxy!
Further Updates and Improvements
- Ubuntu 20.04, RHEL 8 and Amazon Linux 2 are now deprecated. See below section for more information. !1603
- Minimum supported GitLab version is now
16.0. See below section for more information. !1604
- OpenSearch VM version has been increased to
2.19.1. !1589 (thanks@axugl!)
- External SSL certificates can now be passed directly in Ansible and no longer require to be files. !1585
- AWS S3v2 storage drivers are now supported for Container Registry storage. !1598 (thanks
@niskhakova)
- Added option to exclude specific host groups in an Ansible inventory. !1599
- Cloud Native Monitoring namespaces are now only created when required. !1597 (thanks
@niskhakova)
- Fixed GitLab Charts config to work on non cloud provider Kubernetes clusters. !1612 (thanks
@nwestbury!)
- Fixed the uninstall playbook to always remove the GitLab repository. !1624
- Improved handling of Postgres Patroni restarts for Zero Downtime. !1608
- Several improvements and fixes have been made for Geo deployments. !1595 !1590 !1609 !1616 !1619
- Various other small updates, improvements and fixes.
Deprecation Notices
GitLab minimum version support (16.0)
As per the main Support policy, the minimum supported version of GitLab is now 16.0. Versions older than this are no longer supported.
Support for Ubuntu 20.04 / RHEL 8 / Amazon Linux 2
Support for the following OS versions are now deprecated:
- Ubuntu 20.04 - Reaching EOL in April 2025
- RHEL 8 / Amazon Linux 2 - Ansible support was deprecated in version 10 and is scheduled to end in May 2025.
Users who are targeting these OS versions are recommended to upgrade at the earliest opportunity to a newer OS version for continued support and compatibility with the GitLab Environment Toolkit.
Feedback
Got any feedback or found an issue? Please feel free to create an issue on our tracker.