Credentials for multiple git services

You need git credentials to be able to aggregate your various documentation sources. For example, if you are using both GitHub and Bitbucket to store different documentation sections, you need to configure git credentials so that both services can be accessed.

SSH protocol

The most straightforward way to manage git credentials is using the SSH protocol. This means that your sections' URLs look like git@github.com:myorg/myrepo or git@bitbucket.org:myaccount/myrepo. These would be specified in your book's config.yml like so:

sections:
- repository:
    name: git@github.com:myorg/myrepo
  directory: myfinaldirectoryname
- repository:
    name: git@bitbucket.org:myaccount/myrepo
  directory: anotherfinaldirname

In order to configure git access to these repos, we'd need each service (GitHub and Bitbucket) to have our public key. It's possible to have separate public keys for each service.

Create ~/.ssh/config to configure this. It must have read/write permissions for the user, and be inaccessible to all other users (this is chmod 0600 ~/.ssh/config).

~/.ssh/config should contain something like the following:

Host github.com
    IdentityFile ~/.ssh/my_github_id_rsa

Host bitbucket.org
    IdentityFile ~/.ssh/my_bitbucket_id_rsa