Development using git: Difference between revisions

From Alpine Linux
m (Added to Other related articles: Gitolite)
No edit summary
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This document describes how to use [http://git-scm.com git] for Alpine Linux development and related projects. If you just want to browse the Alpine git repositories, please visit [http://git.alpinelinux.org/cgit/aports git.alpinelinux.org].
{{Move|Git|All git development articles should be consolidated}}
 
This document describes how to use [https://git-scm.com git] for Alpine Linux development and related projects. If you just want to browse the Alpine git repositories, please visit [https://git.alpinelinux.org/aports git.alpinelinux.org].


== Basic Git usage ==
== Basic Git usage ==
Line 11: Line 13:


{{Tip| If you want to use git with proxy server:
{{Tip| If you want to use git with proxy server:
  {{Cmd|git config --global http.proxy http://proxy_ip:proxy_port}}
  {{Cmd|git config --global http.proxy <nowiki>http://proxy_ip:proxy_port</nowiki>}}
}}
}}
{{:Development_using_git:Email}}


== Cloning a repository via Git ==
== Cloning a repository via Git ==
Line 23: Line 23:
* ...with write access.
* ...with write access.


[http://git.alpinelinux.org/cgit/aports git.alpinelinux.org] shows all available Alpine git repositories.
[https://git.alpinelinux.org/aports git.alpinelinux.org] shows all available Alpine git repositories.


=== Without write access ===
=== Without write access ===
Line 29: Line 29:
If you want to clone the Alpine aports repository, switch to the directory you want to have the ''aports/'' directory in and launch git.
If you want to clone the Alpine aports repository, switch to the directory you want to have the ''aports/'' directory in and launch git.
   
   
{{Cmd|git clone git://git.alpinelinux.org/aports.git}}
{{Cmd|git clone <nowiki>git://git.alpinelinux.org/aports.git</nowiki>}}


{{Tip| If you are using proxy server:
{{Tip| If you are using proxy server:
  {{Cmd|git clone http://git.alpinelinux.org/cgit/aports}}
  {{Cmd|git clone https://git.alpinelinux.org/aports}}
}}
}}


If you want only the last 3 revisions:
If you want only the last 3 revisions:


{{Cmd|git clone git://git.alpinelinux.org/aports.git --depth 3}}
{{Cmd|git clone <nowiki>git://git.alpinelinux.org/aports.git</nowiki> --depth 3}}


Use the command below to see the full log of the trunk.  
Use the command below to see the full log of the trunk.  


{{Cmd|git log}}
{{Cmd|git log}}
=== Submitting work without write access ===
You can still [https://wiki.alpinelinux.org/wiki/Creating_patches submit a patch] without write access to the Alpine repository. For this you need to create an account on Alpine's GitLab, fork the desired repository (the fork resides on the server), clone the fork on your computer, make your changes into a separate branch, push the squashed branch to the fork (as branch; do not merge/rebase it into the master!) and create a merge request for that branch through the GitLab Web GUI.


=== With write access ===
=== With write access ===


If you have write access to the Alpine the URL needs to be adjusted for cloning a repository
If you have write access to the Alpine repository, the URL needs to be adjusted for cloning a repository
 
{{Cmd|git clone git@git.alpinelinux.org:aports}}


{{Cmd|git clone ssh://username@git.alpinelinux.org/aports.git}}
Alternatively you can set the remote url of an exisiting git clone:
{{Cmd|git remote set-url origin git@git.alpinelinux.org:aports}}


== General GIT Workflow ==
== General GIT Workflow ==

Latest revision as of 06:47, 23 August 2023

This page is proposed for moving ...

It should be renamed to Git. All git development articles should be consolidated (Discuss)

This document describes how to use git for Alpine Linux development and related projects. If you just want to browse the Alpine git repositories, please visit git.alpinelinux.org.

Basic Git usage

Configure your global git config

First you need to tell your name and email to git. This name and email will show up in all your commits.

git config --global user.name "Your Name Comes Here" git config --global user.email you@yourdomain.example.com

Using git config without --global let you configure other details for a specific git repository.

Tip: If you want to use git with colored output use:

git config --global color.ui true git config --global core.pager more

Tip: If you want to use git with proxy server:

git config --global http.proxy http://proxy_ip:proxy_port

Cloning a repository via Git

There are two ways to work with the Alpine git repository...

  • ...without write access.
  • ...with write access.

git.alpinelinux.org shows all available Alpine git repositories.

Without write access

If you want to clone the Alpine aports repository, switch to the directory you want to have the aports/ directory in and launch git.

git clone git://git.alpinelinux.org/aports.git

Tip: If you are using proxy server:

git clone https://git.alpinelinux.org/aports

If you want only the last 3 revisions:

git clone git://git.alpinelinux.org/aports.git --depth 3

Use the command below to see the full log of the trunk.

git log

Submitting work without write access

You can still submit a patch without write access to the Alpine repository. For this you need to create an account on Alpine's GitLab, fork the desired repository (the fork resides on the server), clone the fork on your computer, make your changes into a separate branch, push the squashed branch to the fork (as branch; do not merge/rebase it into the master!) and create a merge request for that branch through the GitLab Web GUI.

With write access

If you have write access to the Alpine repository, the URL needs to be adjusted for cloning a repository

git clone git@git.alpinelinux.org:aports

Alternatively you can set the remote url of an exisiting git clone:

git remote set-url origin git@git.alpinelinux.org:aports

General GIT Workflow

  1. Make your file edits in your local checkout of the local copy of repository.
  2. Commit the changes in your local repository:

    git commit

  3. Bring the rest of your local repository up to date:

    git pull --rebase

  4. Check what you are going to push:

    git log origin..master

  5. Move your changes up to the master if you have write access

    git push

    or create a patch if not.

Other related articles

Further reading