terraform-gitlab-drift

terraform-gitlab-drift

Detect GitLab resources not managed by Terraform and generate Terraform code to bring them under management.

Uses the GitLab Terraform Provider resource definitions.

Features

• 🔍 Drift Detection: Scan GitLab groups and projects to identify resources not managed by Terraform
• 📝 Code Generation: Automatically generate Terraform code for unmanaged resources
• 🔄 Diff Comparison: Show differences between existing and generated Terraform configurations
• 🐳 Docker-ready: Designed for CI/CD pipeline

Quick Start

Local Installation

go install github.com/xMoelletschi/terraform-gitlab-drift@latest
terraform-gitlab-drift scan --group my-group

GitLab CI Usage

Basic Drift Check

drift-check:
  image: ghcr.io/xmoelletschi/terraform-gitlab-drift:latest
  script:
    - terraform-gitlab-drift scan --group $CI_PROJECT_ROOT_NAMESPACE

Configuration

Command-line Flags

Supported Resources

• ✅ GitLab Groups (gitlab_group)
• ✅ GitLab Projects (gitlab_project)
• 🚧 More resources coming soon

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Push to the branch (git push origin feature/amazing-feature)
4. Open a Pull Request

Please make sure to:

• Add tests for new features
• Update documentation as needed
• Ensure CI checks pass

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Acknowledgments

Built with:

• Cobra - CLI framework
• GitLab Go SDK - GitLab API client
• HCL - Terraform configuration parsing

Note: This tool is not affiliated with HashiCorp or GitLab.