Git and GitHub

The list of Apache CouchDB version-controlled repositories can be found here:

https://git-wip-us.apache.org/repos/asf?s=couchdb

Many of these repositories are now actually hosted on GitHub (with the ASF copy being a two-way mirror). For instance:

https://github.com/apache/couchdb

If you have been elected as a CouchDB committer, you will want to complete the GitHub/ASF integration process here:

https://gitbox.apache.org/setup/

Please find general ASF info for working with git at https://git-wip-us.apache.org/#committers-getting-started

Configuration

This is how your git config file in the project should look like (with the osxkeychain helper for Mac people)

.git/config

[core]
  repositoryformatversion = 0
  filemode = true
  bare = false
  logallrefupdates = true
  ignorecase = true
  precomposeunicode = false
[remote "origin"]
  url = https://git-wip-us.apache.org/repos/asf/couchdb.git
  fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
  remote = origin
  merge = refs/heads/master
[user]
  name = Andy Wenk
  email = andywenk@apache.org
[credential]
;for any platform, especially UNIX
  cache --timeout=3600
;for macOS (if you want Keychain support)
  helper = osxkeychain
;for Windows (if you want Windows profile certificate storage support)
  helper = wincred

Because you don’t want to write your credentials for the git repository each time, you want to cache your password. Please follow these instructions:

https://help.github.com/articles/set-up-git#password-caching

You may not want to add the user.name, user.email and credential.helper globally but only to the current repository. In this case simply run:

git config user.name "your username"
git config user.email "your.name@apache.org"
git config credential.helper [cache|osxkeychain|wincred]

To get things working here, you have to setup a .netrc file (or extend an existing) in your home directory with the following content:

~/.netrc

machine git-wip-us.apache.org
login <your_asf_username>
password *********

GitHub Affiliation

You can show your affiliation with Apache by adding yourself to the following file available through Subversion:

svn co https://svn.apache.org/repos/private/committers/docs/github_team.txt

Then politely let Apache Infra know and your profile should show up at: https://github.com/apache?tab=members

  • No labels