オープンソースに貢献する方法:Gitを使い始める

前書き

パブリックリポジトリでホストされているオープンソースプロジェクトは、より広範な開発者コミュニティによる貢献の恩恵を受けており、通常はGitで管理されています。

分散型バージョン管理システムであるGitは、チームベースのオープンソースソフトウェアプロジェクトの貢献と保守を容易にします。 無料でダウンロードして使用できるGitは、オープンソースプロジェクトそのものの例です。

このチュートリアルでは、オープンソースプロジェクトに貢献する利点について説明し、ソフトウェアプロジェクトに貢献できるようにGitのインストールとセットアップについて説明します。

オープンソースプロジェクトへの貢献

オープンソースソフトウェアは、使用、再配布、および修正が自由にできるソフトウェアです。

オープンソースのプロジェクトは、分散ピアレビューを通じて進められる透過的なプロセスを奨励します。 オープンソースプロジェクトは、必要に応じて迅速に更新でき、ロックされたプロプライエタリシステム上に構築されない信頼性の高い柔軟なソフトウェアを提供します。

オープンソースプロジェクトに貢献することで、プロジェクトができる限り優れたものとなり、幅広いテクノロジーエンドユーザーを代表するようになります。 エンドユーザーがコードまたはdocumentationを介してオープンソースプロジェクトに貢献する場合、その多様な視点は、プロジェクト、プロジェクトのエンドユーザー、およびより大きな開発者コミュニティに付加価値を提供します。

オープンソースプロジェクトに貢献し始めるための最良の方法は、すでに使用しているソフトウェアに貢献することから始めることです。 特定のツールのユーザーとして、どの機能がプロジェクトにとって最も価値があるかを最もよく理解できます。 最初に、ソフトウェアに関する利用可能なドキュメントを必ずお読みください。 実際、多くのオープンソースプロジェクトでは、ルートディレクトリにCONTRIBUTING.mdファイルがあります。これは、貢献する前に注意深く読む必要があります。 また、プロジェクトに関するフォーラムが利用可能な場合、コミュニティ内の他の開発者間の相互作用の感覚を取得することもできます。

最後に、オープンソースソフトウェアへの貢献を始めたばかりの場合は、小さなものから始めることをお勧めします。それぞれの貢献は価値があります。 タイプミスの修正、コメントの追加、またはより明確なドキュメントの作成から始めることをお勧めします。

Git

ソフトウェアの最も一般的なバージョン管理システムの1つはGitです。 Gitは、Linuxカーネルの作成者であるLinus Torvaldsによって2005年に作成されました。 元々Linuxカーネルの開発に利用されていたJunio Hamanoは、プロジェクトの現在のメンテナーです。

多くのプロジェクトはファイルをGitリポジトリに保持しており、GitHub、GitLab、Bitbucketなどのサイトでは、コードの共有と貢献がシンプルで、価値があり、効果的です。 Gitのすべての作業ディレクトリは、ネットワークアクセスや中央サーバーに依存しない完全な履歴と追跡を備えた本格的なリポジトリです。

これらのシステムを使用すると、ソースレベルでソフトウェアを追跡できるため、バージョン管理は現代のソフトウェア開発に不可欠なツールになりました。 あなたと開発チームの他のメンバーは、変更を追跡し、前の段階に戻り、ベースコードから分岐して、ファイルとディレクトリの代替バージョンを作成できます。

Gitは、多くの開発者の貢献を促進するため、オープンソースプロジェクトにとって非常に便利です。 各コントリビューターは、コードベースリポジトリのメインブランチまたはマスターブランチから分岐して独自の変更を分離し、プル要求を行ってこれらの変更をメインプロジェクトに統合することができます。

Gitを使用してオープンソースプロジェクトに貢献するには、Gitがインストールされているかどうかを確認し、インストールされていない場合は、ローカルマシンにインストールする方法を見ていきましょう。

Gitがインストールされているかどうかを確認します

まず、コンピューターにGitコマンドラインツールがインストールされているかどうかを確認します。 独自のコードのリポジトリを作成している場合は、ローカルマシンにGitがインストールされている可能性があります。 一部のオペレーティングシステムにはGitもインストールされているため、インストールする前に確認する価値があります。

Gitがインストールされているかどうか、および使用しているバージョンを確認するには、LinuxまたはMacでターミナルウィンドウを開き、Windowsでコマンドプロンプトウィンドウを開き、次のコマンドを入力します。

git --version

ただし、Gitがインストールされていない場合、次のようなエラーが表示されます。

-bash: git: command not found
'git' is not recognized as an internal or external command, operable program or batch file.

この場合、Gitをマシンにインストールする必要があります。 いくつかの主要なオペレーティングシステムのインストールを行ってみましょう。

LinuxにGitをインストールする

Gitをインストールして使用する準備を整える最も簡単な方法は、お使いのバージョンのLinuxのデフォルトリポジトリを使用することです。 この方法を使用してローカルLinuxマシンにGitをインストールする方法を見ていきましょう。

Ubuntu 18.04またはDebian 10にGitをインストールする

aptパッケージ管理ツールを使用して、ローカルパッケージインデックスを更新できます。 その後、プログラムをダウンロードしてインストールできます。

sudo apt update
sudo apt install git

これはGitをインストールする最も速い方法ですが、バージョンは最新バージョンよりも古い場合があります。 最新のリリースが必要な場合は、this guideを使用してソースからGitをコンパイルすることを検討してください。

ここから、Setting Up Gitのセクションに進むことができます。

CentOSにGitをインストールする

CentOSのネイティブパッケージマネージャーであるyumを使用して、CentOSのリポジトリで利用可能な最新のGitパッケージを検索してインストールします。

次のコマンドを実行して、最初にyumが最新であることを確認します。

sudo yum -y update

-yフラグは、変更を行っていることをシステムに警告するために使用され、端末が確認を求めるプロンプトを表示しないようにします。

これで、Gitをインストールできます。

sudo yum install git

これはGitをインストールする最も速い方法ですが、バージョンは最新バージョンよりも古い場合があります。 最新のリリースが必要な場合は、this guideのオプション2に従って、ソースからGitをコンパイルすることを検討してください。

ここから、Setting Up Gitのセクションに進むことができます。

FedoraにGitをインストールする

FedoraのGitパッケージは、yumdnfの両方から入手できます。 Fedora 18で導入されたDNF、またはDandified Yumは、Fedora 22からFedoraのデフォルトのパッケージマネージャーです。

ターミナルウィンドウから、dnfを更新してGitをインストールします。

sudo dnf update
sudo dnf install git

古いバージョンのFedoraを使用している場合は、代わりにyumコマンドを使用できます。 最初にyumを更新してから、Gitをインストールしましょう。

sudo yum update
sudo yum install git

ここから、Setting Up Gitのセクションに進むことができます。

macOSにGitをインストールする

ローカルのMacintoshコンピュータで、ターミナルウィンドウにGitコマンドを入力すると(上記のgit --versionのように)、Gitがまだシステムにインストールされていない場合は、インストールするように求められます。 このプロンプトが表示されたら、Gitをインストールし、指示に従ってターミナルウィンドウのプロンプトに応答することに同意する必要があります。

Gitの最新バージョンをMacにインストールするには、バイナリインストーラーを使用してインストールします。 OS X Gitインストーラーが維持されており、Git Webサイトからダウンロードできます。 hereをクリックすると、ダウンロードが自動的に開始されます。

Gitが完全にインストールされたら、Setting Up Gitのセクションに進むことができます。

GitをWindowsにインストールする

Windowsの場合、公式ビルドはGit Webサイトからダウンロードできます。 hereをクリックすると、ダウンロードが自動的に開始されます。

Git for Windowsと呼ばれるオープンソースプロジェクトもあります。これは公式のGit Webサイトとは別のものです。 このツールは、WindowsマシンでGitを効果的に使用するためのコマンドラインツールとグラフィカルユーザーインターフェイスツールの両方を提供します。 このプロジェクトの詳細、およびコードの検査とダウンロードについては、Git for Windows project siteにアクセスしてください。

Gitが完全にインストールされたら、Setting Up Gitのセクションに進むことができます。

Gitのセットアップ

Gitをインストールしたら、生成されるコミットメッセージに正しい情報が含まれるように、いくつかのことを行う必要があります。

これを行う最も簡単な方法は、git configコマンドを使用することです。 特に、Gitはコミットするたびにこの情報を埋め込むため、名前とメールアドレスを提供する必要があります。 次のように入力して、この情報を追加できます。

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

次のように入力すると、設定されているすべての構成アイテムを確認できます。

git config --list

git設定

user.name=Your Name
[email protected]

ご覧のとおり、これはわずかに異なる形式を持っています。 情報はGit構成ファイルに保存されます。オプションで、たとえばnanoなどのテキストエディターを使用して手動で編集できます。

nano ~/.gitconfig

~/.gitconfig contents

[user]
    name = Your Name
    email = [email protected]

ファイルの編集が完了したら、コントロールキーとxキーを入力してnanoを終了し、ファイルを保存するように求められたら、yを押します。

他にも多くのオプションを設定できますが、これらは将来の警告を防ぐために必要な2つの重要なオプションです。

結論

ローカルマシンにGitをインストールしてセットアップすると、Gitを使用して独自のソフトウェアプロジェクトのバージョン管理を行う準備が整い、一般公開されているオープンソースプロジェクトに貢献できます。

オープンソースソフトウェアにあなた自身の貢献を加えることは、より広範な開発者コミュニティにより深く関わり、一般向けに作られたソフトウェアが高品質でエンドユーザーを完全に代表することを保証するのに役立ちます。