Development using git:Developer repositories: Difference between revisions

From Alpine Linux
(explain how to request pulls)
(explain when git send-email should be used instead of the developer repo)
Line 1: Line 1:
Some git repositories of Alpine developer are hosted at [http://git.alpinelinux.org/ git.alpinelinux.org]. Developers who has no push access to the offical aports repo can has a developer aports repo that can be used as a staging area. Developers with push access can review and pull from this or can choose to reject if the changes needs more fixing.
Some git repositories of Alpine developer are hosted at [http://git.alpinelinux.org/ git.alpinelinux.org]. Developers who has no push access to the offical aports repo can has a developer aports repo that can be used as a staging area. Developers with push access can review and pull from this or can choose to reject if the changes needs more fixing.
The git repos are to be used when there are many changes (more than 3) that need no or very little review. If comments are requested or if there are doubts, then its better to use ''git send-email''. It might also be better to use ''git send-email'' for single commits.


== Git Push (Distributed Workflows) ==
== Git Push (Distributed Workflows) ==

Revision as of 19:51, 16 May 2012

Some git repositories of Alpine developer are hosted at git.alpinelinux.org. Developers who has no push access to the offical aports repo can has a developer aports repo that can be used as a staging area. Developers with push access can review and pull from this or can choose to reject if the changes needs more fixing.

The git repos are to be used when there are many changes (more than 3) that need no or very little review. If comments are requested or if there are doubts, then its better to use git send-email. It might also be better to use git send-email for single commits.

Git Push (Distributed Workflows)

If working with Distributed Workflows you would 'pull' from public repository, 'push' to another publically accessible repository (where you have write access), main developer (who has write access to public repository) 'pulls' you changes from your publically accessed repository into the public repository.

To make it easier for you to work, you can configure 'git push' to push your work to your publically accessible repository ('git pull' would still pull from same repository as you cloned from).

cd /your/private/repo/where/you/work/reponame git config remote.origin.pushurl "ssh://user@dev.alpinelinux/home/user/cgit/reponame.git"

Now 'git pull' pulls the public repository and 'git push' pushes to your public repository.

Note: The path where you want to push to should first be prepared with

git clone --bare ...

as described below in section 'Upload the new project'

Requesting a pull from developer repo to official

Before asking for merging the developer repo into the official make sure that:

  1. All modified packages builds
  2. The commit history looks nice. You can use the cgit interface for this. It is a goal that it should be easy to revert single commits in case problems should appear in future. So avoid changing multiple packages with single commits.

Before asking for a pull, rebase your public repo with the official repo. This is done with:

git pull --rebase

git push

If there have been changes in official repo that conflicts with your work, then you have to resolve those conflicts. And maybe redo or drop some of your commits.

You can ask directly on IRC #alpine-devel or by sending an email to alpine-devel mailing list. Please include the git url (eg. git://git.alpinelinux.org/user/aports.git) that can easily be copied and pasted and please also mention why the merge is needed. This explanation is meant to be copied and pasted in the merge commit.

Example request on IRC:

please pull git://git.alpinelinux.org/ncopa/aports
It includes a new python application pyfoo with all its dependencies.

Example email:

Subject: please pull git://git.alpinelinux.org/ncopa/aports

The libfoo was upgraded to 2.0. This upgrade breaks ABI so all packages linking
to libfoo was rebuilt. The rebuilt packages was:
- libbar
- bazapp
- bar-utils