Please contact the email@example.com mailing list if you have comments or suggestions regarding this service.
For now the repository URLs are all of the form:
To clone a repository:
# Non Committers $ git clone http://git-wip-us.apache.org/repos/asf/reponame.git # Committers $ git clone https://git-wip-us.apache.org/repos/asf/reponame.git
First things first, you'll want to set up your name and email that will be used by git when you make commits:
$ git config --global user.name "My Name Here" $ git config --global user.email firstname.lastname@example.org
If you're a long time GitHub user you can instead set these configuration variables on a per repository basis like such:
$ git config user.name "My Name Here" $ git config user.email email@example.com
You can also add your apache.org email address to your GitHub account so that your Gravatar and user account are linked to from the Apache mirrors on GitHub.
To push to a repository you need to authenticate. More recent versions of Git will prompt for a username and password, and in some cases will cache the credentials in your operating system's default credential store.
On Mac OS X, you need to have installed
git-credential-osxkeychain and set
the following configuration:
$ git config --global credential.helper osxkeychain
If you are not prompted, then you will need to setup a
~/.netrc file that
contains your user credentials:
$ (umask 0277; cat >> ~/.netrc <<EOF) machine git-wip-us.apache.org login username password mypassword EOF chmod 0600 ~/.netrc
Alternatively you can list your username in the Git repository URL but this will require that you type your password for every fetch and push. You can do this by cloning a URL like:
$ git clone https://firstname.lastname@example.org/repos/asf/reponame.git
While its possible to list your password in the URL this is highly discouraged as it obviously leaves your password in plain text in the shell history.
You can use git-gui as part of the msysgit package.
Instead of setting up a
~/.netrc file you need to:
- Set up a
%HOME%environment pointing to
- Create a
%HOME%\_netrcwith this text all on one line:
machine git-wip-us.apache.org login username password mypassword
In general, you will want line endings to be normalized in the Git repository and set to be platform specific on checkout.
The msysgit installer on Windows will prompt to set the
true by default. On Mac OS X or Linux, the following setting
should be used:
$ git config --global core.autocrlf input
Further details and attributes for handling them differently per file type can be found in the GitHub article Dealing with line endings.
With the continued growth of git usage, a service was created to support creating new repositories for PMCs. It is a fully automated tool, eliminating any additional tickets. The tool can be found at https://reporeq.apache.org.