GitHub Workflows to contribute to upstream Gerrit Replicated Repositories (github2gerrit v0.1)

[Anil Shashikumar Belur]

Hi everyone,

I'm excited to share a new set of GitHub workflows/actions (askb/github2gerrit v0.1) designed to help developers familiar with GitHub workflow contribute to upstream projects hosted on Gerrit repositories!

These workflows streamline the contribution process for Gerrit-replicated repositories on GitHub. Here's how it works:

Prerequisites:

* The Gerrit repositories must be replicated to GitHub using SSH.
* The workflows need to be enabled on the replicated GitHub repository.

Workflow Overview:

* Users can submit a pull request to the GitHub project repository.
* This captures and submits the changes as an upstream change request to the Gerrit repository.
* A "change-Id" is required in the commit footer for Gerrit (or generated automatically if missing).
* All commits in the pull request are squashed into a single commit with a consolidated list of commit messages and submitted as a topic (e.g., `PR-###`).
* Gerrit committers review and approve the change request which get replicated to Github once merged.
* Updates to the pull request require creating a new pull request or reopening the existing one with updated commits on the forked Gerrit repository.

* The pull request gets closed once the changes in the pull request is submitted to Gerrit.

Future Enhancements:

We plan to add optional flags to the workflow that allow using the pull request title and body as the commit message header and body.

This is an initial release (v0.1) designed primarily for [opendaylight.org](https://git.opendaylight.org) repositories, generalized to work on other environments. 

We welcome contributions! If you've used similar solutions ([askb/github2gerrit](https://github.com/askb/github2gerrit)), would love to hear your experience.

Cheers,
Anil Belur

[1.] https://github.com/askb/github2gerrit

[Anil Shashikumar Belur]

The repository has been transferred under the organization 'lfit',

Please use the corrected link to the repo:
[1.] https://github.com/lfit/github2gerrit

 

[1.] https://github.com/askb/github2gerrit