はじめに
GitHub Organizationで、外部コラボレータ(Outside collaborators)を利用する際のメモ。外部コラボレータの追加方法、制約などを紹介する。
環境
- GitHub Enterprise
外部コラボレータとは
外部のコラボレータは、Organizationのメンバーではないものの、Organizationの1つ以上のリポジトリにアクセスできるユーザです。各外部コラボレーターに許可するアクセスのレベルを選択できます。 外部コラボレーターをリポジトリに追加する場合は、アクセスするリポジトリのフォークにも追加する必要があります。
上記のある通り、
- Organization内のリポジトリにアクセス権を与えたい、Organization外のメンバー
- 具体的には、社内メンバーではない協力会社のメンバーなど
となる。
外部コラボレータの追加方法
Organization内の各リポジトリに対して権限を個別に与える。外部コラボレータには以下の制約がある。
- Organizationのメンバーとして参加することはできない
- 招待はできるが、参加することはできない
- GitHub Teamに追加することはできない
- TeamはOrganizationメンバーしか利用できないため
また、Enterpriseなどの有料のOrganizationを利用している場合、プライベートリポジトリに対して外部コラボレータを追加する際、１ユーザあたり追加の費用が発生するので注意する（参考）。
以下に外部コラボレータの追加手順を示す。
- 各リポジトリの「Settings」の「Collaborators and teams」を選択する
- 「Add people」ボタンを押す
- 追加したいメンバーを指定して、「Add to repository」ボタンを押す
- 招待されたメンバーが承認すると、外部コラボレータとして登録される
上記の方法は、GUIから各リポジトリごとに権限を追加する必要がある。リポジトリ数が多い場合は、外部コラボレータを追加するREST APIが用意されているのでそちらを使うと良い。
外部コラボレータの確認方法
Organizationページの、「People」の「Outside collaborators」から確認できる。
まとめ
外部コラボレータの追加方法と制約を紹介した。GitHubを使った社外メンバーとの共同開発の際などに役立つ。
参考