Sysadmin/GitKdeOrgManual

From KDE Community Wiki
Revision as of 17:13, 7 October 2010 by Hein (talk | contribs) (Created page with '== Overview of facilities == '''[http://identity.kde.org/ KDE Identity] (identity.kde.org)''' - Account management; notably managing your SSH public keys for read-write develope...')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Overview of facilities

KDE Identity (identity.kde.org) - Account management; notably managing your SSH public keys for read-write developer access. git.kde.org: Serves up the repositories, via git:// for anonymous write access and via SSH for read-write developer access (read-only access via HTTP is on the way). KDE Projects (projects.kde.org) - Central project hub and primary repository browser. gitweb.kde.org - Alternative repository browser. At present the only way to view personal clones of project repositories and personal scratch repositories (see below), however the former are planned to appear in projects.kde.org in the future. ReviewBoard (git.reviewboard.kde.org) - Patch review. commits.kde.org - Provides git commit "short URLs", redirecting to projects.kde.org and gitweb.kde.org pages as appropriate (example).

How to get an account

KDE developer accounts are managed through KDE Identity. If you already had a KDE SVN developer account, it has been imported into KDE Identity and you may use the Password Reset feature to set a password and manage your SSH public keys. If you don't have a developer account yet, you can request Developer Access in the website's menu upon registering and logging into your account.


Overview of repository URL schemes

Anonymous read-only access uses the following URL prefix:

 git://git.kde.org/

Read-write developer access uses this prefix instead:

 [email protected]:

Following the prefix, here are the URL schemes for different types of repositories:

<project identifier>.git - A KDE project repository, be it part of the KDE SC, KDE Extragear or KDE Playground. websites/<website address without leading www. and dots replaced with dashes>.git - A KDE website, e.g. websites/projects-kde-org.git. sysadmin/<repository name>.git - Non-public repositories used by KDE's sysadmin team. clones/<original repository path>/<KDE Identity user name>/<user-chosen repository name>.git - Personal clones of project or website repositories, e.g. clones/konversation.git/hein/morecowbell.git (see below). scratch/<KDE identity user name>/<user-chosen repository name>.git - Personal "scratch" repositories, used to start an new project or store your favorite .bashrc (see below).


Overview of server-side commands

git.kde.org understands several server-side commands that can be used on the command line via SSH in this fashion:

ssh [email protected] <command> [parameters]

Here is a list of the commands that are currently available:

expand - Shows a listing of repositories you have the permission to see, as well as details about your access rights to them. clone <path to source repository> <clone name> - Can be used to make a personal clone of a project or website repository, e.g. ssh [email protected] clone konversation mykonvi would result in clones/konversation.git/<your KDE Identity user name>/mykonvi.git (more below). destroy <repository path> - Used to remove a personal clone of a project or website repository or a personal scratch repository. sudo <KDE Identity user name> <command> - Used by system administrators to run one of the above as another user.


Requesting migrations from KDE SVN or Gitorious.org

To get your project moved from KDE SVN or Gitorious.org to git.kde.org, you have to file a sysadmin request providing the following information:

  • The name and description of the project.
  • The current location of the project.
  • Its current or intended module (e.g. playground/utils or extragear/network).
  • Which KDE Identity user name(s) should have admin rights to the repository and the entry on KDE Projects.
  • The email address that the [ReviewBoard] group for the project should send emails to.
  • The date and time the migration should take place (can be "asap").

When we have completed processing your request, there will be an empty repository at the chosen path (more) that the repository admins can push the data into.


Personal repositories

git.kde.org currently offers two types of personal repositories: Personal clones of project or website repositories and personal scratch repositories.

Personal clones

A personal clone of a project or website repository can be made using the server-side clone command on the command line:

 ssh [email protected] clone <path to source repository> <clone name>

This will result in a clone of the source repository located at clones/<path to source repository>/<KDE Identity user name>/<clone name>.

This scheme makes it very easy to locate all personal clones of a given project or website repository and should be preferred over making personal clones of one of those in your personal scratch space. (In fact, the server-side clone command won't allow you to clone a project or website repository into your personal scratch space, but nothing technically prevents you from taking the detour of a local clone to achieve this.)

Personal clones of project or website repositories currently do not show up on KDE Projects, but we have plans to change that in the future. Until then, you can use gitweb.kde.org to browse these repositories.

Personal scratch repositories

Personal scratch repositories are a means to start a new project or just to store your favorite .bashrc in a safe location.

Creating one is easily done just by pushing, e.g.

 git push --all [email protected]:scratch/<KDE Identity user name>/<repo name of your choosing>.git

(Or you could use git remote add to add an origin remote to push to.)

Personal scratch repositories can be browsed on gitweb.kde.org.

If you feel your new project is ready for the wider world and/or wish to signal that it welcomes outside contributors, you may wish to promote it to the status of a KDE Playground project. KDE Playground project repositories are located at the top-level, i.e. the repository will be moved out of your scratch space and may have to be renamed in the event of a collision with an existing repository name. KDE Playground projects are featured on KDE Projects and covered by the kde-commits mailing list (and thus CommitFilter), LXR, the EBN and CIA, unlike personal scratch repositories.

To request your scratch repository be promoted to the status of a KDE Playground project, you currently need to file a sysadmin request. In the future we plan to provide a fully automated facility on KDE Projects.

Note that we have deliberately decided not to allow the direct creation of KDE Playground projects; the path to existence for a KDE Playground repository project always leads through a personal scratch space first. This is to give you the power to decide whether your project is ready, and also to force you to deliberate whether it truely is.