AGit-Flow is Alibaba's centralized workflow for standardized code management.
Imagine:
-
What if creating a code review was as simple as running the
git pushcommand? -
Developers can create a code review in seconds instead of minutes, without switching between tools.
Adopting AGit-Flow and using thegit-repo tool accelerates your code review process and standardizes your workflow.
What is AGit-Flow?
AGit-Flow is a centralized Git workflow that combines the user-friendly ecosystem of GitHub with the powerful code review capabilities of Gerrit.
AGit-Flow does not require a forked repository or feature branch. Even users with read-only permissions can create a code review using the git push command.
A companion command-line tool, git-repo, supports this workflow. It works with single repositories and supports multi-repository collaboration, similar to the Android project model.
The AGit-Flow workflow
The following diagram illustrates the AGit-Flow workflow for a single repository.
The workflow works as follows:
Developer
A developer follows these steps to create and update a pull request:
-
Clone the repository.
-
Develop and create commits in the local repository.
-
Run the
git prcommand in your workspace to push local commits to the server. -
The server automatically creates a new code review, for example, pull request #123.
-
Incorporate review feedback by adding new commits or amending existing ones in the local workspace.
-
Run the
git prcommand again in the workspace to push the local commits to the server. -
The server detects an existing pull request from the same user for the target branch and updates it, rather than creating a new one.
Committer
A committer can provide review feedback and directly modify the code under review to update the pull request:
-
The committer runs the
git download 123command to download pull request #123 to their local repository. -
After modifying the code locally, the committer runs the
git pr --change 123command to push the changes to the server. -
The server receives the committer's special
git pushcommand and updates the pull request. -
A project manager clicks the Merge button on the pull request review page to merge the pull request into the master branch. This action updates the master branch and closes the pull request.
The steps above describe the AGit-Flow workflow for a single repository.
For a demonstration of multi-repository collaboration, see https://git-repo.info/en/docs/multi-repos/overview/.
Git-repo tool
git-repo is an open-source command-line tool from Alibaba. It wraps native Git commands to simplify operations in a centralized workflow like AGit-Flow.
git-repo supports AGit-Flow-compatible code hosting platforms as well as Gerrit. For downloads, see Tool Download.