Subversion クライアントのサポート

GitHub リポジトリは、Git および Subversion (SVN) クライアントの両方からアクセスできます。 この記事では、GitHub 上での Subversion の使用および経験する可能性のあるいくつかの主な問題を取り上げます。

この記事の内容

GitHubは、HTTPS プロコトルを介して Subversion クライアントをサポートします。 GitHub に svn コマンドを伝えるには、Subversion ブリッジを使います。

Note

Subversion のサポートは、GitHub バージョン 3.13 で削除されます。 詳細については、「GitHub ブログ」を参照してください。

GitHub 上でサポートされる Subversion の機能

チェックアウト

最初に Subversion チェックアウトを行いましょう。 Git クローンは、ワーキングディレクトリ (ファイルを編集する場所) をリポジトリデータと分けたままにします。そのため、この時点でワーキングディレクトリにはブランチが 1 つしかありません。

Subversion チェックアウトは異なります。作業ディレクトリ内のリポジトリ データが混在するため、各ブランチの作業ディレクトリとチェックアウトしたタグがあります。多数のブランチとタグがあるリポジトリの場合、すべてをチェックアウトすることは帯域幅の負担になる可能性があるため、部分的なチェックアウトから始める必要があります。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. ファイルの一覧の上にある [コード] をクリックします。

    リポジトリのランディング ページのファイル リストのスクリーンショット。 [コード] ボタンが濃いオレンジ色の枠線で囲まれています。

  3. リポジトリの URL をコピーします。

    • HTTPS を使ってリポジトリをクローンするには、[HTTPS] の下の をクリックします。

    • Organization の SSH 認証機関から発行された証明書などの SSH キーを使ってリポジトリをクローンするには、 [SSH] をクリックしてから、 をクリックします。

    • GitHub CLI を使ってリポジトリをクローンするには、 [GitHub CLI] をクリックしてから、 をクリックします。

      [コード] ドロップダウン メニューのスクリーンショット。 リポジトリの HTTPS URL の右側に、コピー アイコンが濃いオレンジ色の枠線で囲まれています。

  4. リポジトリのエンプティチェックアウトをします:

    $ svn co --depth empty https://github.com/USER/REPO
> Checked out revision 1.
$ cd REPO

  5. trunk ブランチを取得します。 Subversion ブリッジは、トランクを Git の HEAD ブランチにマップします。

    $ svn up trunk
> A    trunk
> A    trunk/README.md
> A    trunk/gizmo.rb
> Updated to revision 1.

  6. branches ディレクトリのエンプティ チェックアウトを取得します。 ここは、すべての HEAD でないブランチが存在し、かつ、機能ブランチを作成する場所です。

    $ svn up --depth empty branches
Updated to revision 1.

ブランチを作成する

Subversion ブリッジを使って GitHub にブランチを作成することもできます。

svn クライアントで trunk を更新して、既定のブランチが最新であることを確認します。

$ svn up trunk
> At revision 1.

次に、svn copy を使用して新しいブランチを作成することができます。

$ svn copy trunk branches/more_awesome
> A    branches/more_awesome
$ svn commit -m 'Added more_awesome topic branch'
> Adding    branches/more_awesome

> Committed revision 2.

リポジトリのブランチドロップダウンに新しいブランチが存在することを確認できます:

リポジトリ ページのスクリーンショット。 ブランチ アイコンに [main] のラベルの付いたドロップダウン メニューがオレンジ色の枠線で強調表示されています。

コマンドラインで新しいブランチを確認することもできます:

$ git fetch
> From https://github.com/USER/REPO/
> * [new branch]    more_awesome -> origin/more_awesome

Subversion にコミットを作成する

いくつかの機能を追加しバグを修正した後は、GitHub にこれらの変更をコミットしましょう。 この手順は、あなたが慣れ親しんだ Subversion と非常に似ています。 ファイルを編集し、svn commit を使用して変更を記録します。

$ svn status
> M    gizmo.rb
$ svn commit -m 'Guard against known problems'
> Sending    more_awesome/gizmo.rb
> Transmitting file data .
> Committed revision 3.
$ svn status
> ?    test
$ svn add test
> A    test
> A    test/gizmo_test.rb
$ svn commit -m 'Test coverage for problems'
> Adding    more_awesome/test
> Adding    more_awesome/test/gizmo_test.rb
> Transmitting file data .
> Committed revision 4.

ブランチ間の切り替え

ブランチを切り替えるには、trunk のチェックアウトから始めることをお勧めします。

svn co --depth empty https://github.com/USER/REPO/trunk

次に、他のブランチにスイッチします:

svn switch https://github.com/USER/REPO/branches/more_awesome

Subversion コミットのために Git コミット SHA を検索する

Github の Subversion サーバーは、Subversion コミットのために Git コミット SHA を開示します。

コミット SHA を表示するには、git-commit のバージョンのないリモート プロパティを要求する必要があります。

$ svn propget git-commit --revprop -r HEAD https://github.com/USER/REPO
05fcc584ed53d7b0c92e116cb7e64d198b13c4e3

このコミット SHA によって、たとえば、GitHub 上の関連 Git コミットを検索できます。