qubership-git-system-follower 0.6.20

The package manager for Git providers

git-system-follower

git-system-follower (gsf) is a package manager for Git providers.

:eyes: Overview • :wrench: Problems It Solves • :star2: Key Features • :dart: Key Beneficiaries • :package: Install • :page_with_curl: Docs

Supported resources

Git providers • Gear registries

:eyes: Overview

gsf designed to streamline the management of repository branch content and configuration. By automating installations, updates, and removals, gsf reduces manual intervention, prevents errors, and ensures a consistent state across projects.

If you’re managing CI/CD pipelines, infrastructure configurations, or any repository-bound tools, gsf is here to make your work easier, faster, and more reliable using Git packages, aka Gears.

:wrench: Problems It Solves

Have you used versioned .gitlab-ci.yml that require a specific file structure in the repository?

If so, you've probably encountered configuration issues: you forgot to specify a mandatory parameter, didn't create the right file, and eventually the Pipeline doesn't work. Or maybe everything was working, and suddenly the Pipeline starts crashing for no apparent reason - and you waste time figuring out that someone accidentally changed the startup parameters. And if you need to update an old .gitlab-ci.yml to the latest version, you often have to manually migrate through multiple versions.

gsf solves all of these problems by automatically managing your config file version and structure, eliminating all of these errors and saving you a lot of work:

• Reduced manual work
  Engineers no longer need to handle installation or updates manually — this is done by the package developer, who knows all the details.

• Version management
  The package manager supports migrations between versions. When updating, it automatically performs intermediate steps, ensuring no errors occur from skipping versions.

• Preserving user changes
  During template generation, the tool carefully compares files to avoid overwriting user-made changes.

• Security and control
  The state of all installed packages is stored in a special .state.yaml file. The data inside is hashed to prevent unauthorized changes or misuse.

:star2: Key Features

• Works only with repository branch content
  The manager operates exclusively within branches, managing the repository’s content without altering branches, commits, or other repository elements.

• GitLab-specific support
  The current implementation is tailored to work with GitLab repositories.

• Package installation
  Quickly add new tools or configurations to a repository.

• Package updates
  Ensure smooth migrations between versions.

• Package removal
  Completely remove configurations and tools without leaving traces.

• Variable management
  Add or update variables in CI/CD systems like GitLab.

• Template generation
  Create configuration files while considering existing settings and user changes.

• Developer interface
  Provides API and tools for package developers to define how their packages are installed, updated, and removed. This ensures that package developers can define migration steps and other actions with precision.

:dart: Key Beneficiaries

DevOps engineers, SRE engineers and other professionals working with GitOps repositories, for example, configuring projects linked to ArgoCD, GitLab CI/CD, or similar tools.

:package: Install

See Installation Guide.

:page_with_curl: Docs

Get started with the Quick Start Guide or plunge into the complete documentation.

:handshake: Contributing

• CODE-OF-CONDUCT.md
  This document outlines the expected behavior for everyone interacting with the project. It fosters a respectful and inclusive environment for developers, contributors, and users.

• CONTRIBUTING.md
  This document acts as a guide for anyone interested in contributing to the project. It clarifies the contribution process and helps maintainers manage contributions effectively.

• SECURITY.md
  This document focuses on security practices and reporting vulnerabilities. It aims to promote a secure development environment and responsible handling of security issues.

:arrows_counterclockwise: Changelog

Detailed changes for each release are documented in the TBD.

:black_nib: License

Apache License 2.0