git: 8f51012a2a - main - ja/handbook: Update mirrors chapter
Ryusuke SUZUKI <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=8f51012a2abf7c52c64b8e630a5efd750b12b8d6 commit 8f51012a2abf7c52c64b8e630a5efd750b12b8d6 Author: Ryusuke SUZUKI <[email protected]> AuthorDate: 2022-02-07 02:14:34 +0000 Commit: Ryusuke SUZUKI <[email protected]> CommitDate: 2022-02-07 02:14:34 +0000 ja/handbook: Update mirrors chapter 4a47cb4f41 -> a987bb623c --- .../content/ja/books/handbook/mirrors/_index.adoc | 176 ++++++--------------- 1 file changed, 51 insertions(+), 125 deletions(-) diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc index 8edc6f8bb4..8e380e887b 100644 --- a/documentation/content/ja/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc @@ -357,7 +357,7 @@ FreeBSD を anonymous FTP から入手する場合には、近くのサイトを 問題がある場合は、このドメインのホストマスタ `<{mirrors-ireland-email}>` 宛にお問い合わせください。 -* {mirrors-ireland-ftp} (ftp / rsync) +* {mirrors-ireland-ftp} (ftp / rsync) [[japan]] *{mirrors-japan}* @@ -414,7 +414,7 @@ FreeBSD を anonymous FTP から入手する場合には、近くのサイトを 問題がある場合は、このドメインのホストマスタ `<{mirrors-norway-email}>` 宛にお問い合わせください。 -* {mirrors-norway-ftp} (ftp / rsync) +* {mirrors-norway-ftp} (ftp / rsync) [[poland]] *{mirrors-poland}* @@ -423,8 +423,7 @@ FreeBSD を anonymous FTP から入手する場合には、近くのサイトを * {mirrors-poland-ftp} * ftp2.pl.FreeBSD.org -* {mirrors-netherlands-ftp-http} - + [[russia]] *{mirrors-russia}* @@ -544,120 +543,77 @@ FreeBSD を anonymous FTP から入手する場合には、近くのサイトを [[git-intro]] === はじめに -2020 年 12 月から、FreeBSD はソースコード、ドキュメントのすべてを管理するメインのバージョン管理システムに git を使っています。 -2021 年 4 月から、FreeBSD は Ports Collection のすべてを管理するバージョン管理システムに git を使っています。 +2020 年 12 月、FreeBSD はソースコード、ドキュメントのすべてを管理するメインのバージョン管理システムを git に移行しました。 +2021 年 4 月、FreeBSD は Ports Collection のすべてを管理するバージョン管理システムを git に移行しました。 [NOTE] ==== 一般的には Git は開発用ツールです。 -ユーザによっては、FreeBSD ベースシステムのアップデートに `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”])、 -FreeBSD Ports Collection のアップデートに `portsnap` (crossref:ports[ports-using,“Ports Collection の利用”]) を好んで使用するでしょう。 +ユーザは好みに合わせて、FreeBSD ベースシステムのアップデートに `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”])、 +FreeBSD Ports Collection のアップデートに `portsnap` (crossref:ports[ports-using,“Ports Collection の利用”]を使用できます。 ==== -この章では、FreeBSD 上への Git のインストール方法および、 -FreeBSD リポジトリのローカルコピーの作成方法について説明します。 -Git の使用方法についても紹介します。 +この章では、FreeBSD への Git のインストール方法および FreeBSD ソースコードリポジトリのローカルコピーの作成方法について説明します。 [[git-install]] === インストール -package を使って Git をインストールできます。 +Ports Collection または package を使って Git をインストールできます。 [source,shell] .... # pkg install git .... -Ports Collection からも Git をインストールできます。 - -[source,shell] -.... -# cd /usr/ports/devel/git -# make install clean -.... - [[git-usage]] === Git の実行 -ソースコードをローカルディレクトリに新しくコピーするには、`git` を使ってください。 +ソースコードをローカルディレクトリに新しくコピーするには、`git clone` を使ってください。 このファイルのあるディレクトリのことを _ワークツリー_ と呼びます。 -[WARNING] -==== - -コピー先のディレクトリが既に存在する場合は、`git clone` をはじめて使う前にディレクトリを移動するか削除してください。 -git 以外の方法で用意されたディレクトリに対するリポジトリのクローンは失敗するでしょう。 -==== - -Git は、リポジトリの指定に _protocol://hostname/path_ 形式の URL を用います。 -path の最初でアクセスする FreeBSD リポジトリを指定します。 +Git は、リポジトリの指定に URL を用います。 リポジトリには `base`, `doc` および `ports` の 3 種類あります。 `base` は FreeBSD ベースシステムのソースコード、`doc` はドキュメント、そして `ports` は FreeBSD Ports Collection のリポジトリです。 -たとえば、`https://git.FreeBSD.org/src.git` という URL は、`https` プロトコルによる src リポジトリの main ブランチを示します。 +これら 3 つのリポジトリはすべて HTTPS および SSH という 2 つの異なるプロトコル経由でアクセスできます。 +たとえば、`https://git.FreeBSD.org/src.git` という URL は、`https` プロトコルによる `src` リポジトリの main ブランチを示します。 [[git-url-table]] .FreeBSD Git リポジトリの URL テーブル [options="header,footer"] |======================================================= |項目 | Git URL -| ウェブベースの src リポジトリブラウザ | `https://cgit.freebsd.org/src` -| HTTPS 経由の読み取り専用 src リポジトリ | `https://git.freebsd.org/src.git` -| Anonymous ssh による読み取り専用 src リポジトリ | `ssh://[email protected]/src.git` -| コミッタのための読み取り/書き込み用 src リポジトリ | `ssh://[email protected]/src.git` (*) -| ウェブベースの doc リポジトリブラウザ | `https://cgit.freebsd.org/doc` -| HTTPS 経由の読み取り専用 doc リポジトリ | `https://git.freebsd.org/doc.git` -| Anonymous ssh による読み取り専用 doc リポジトリ | `ssh://[email protected]/doc.git` -| コミッタのための読み取り/書き込み用 doc リポジトリ | `ssh://[email protected]/doc.git` (*) -| ウェブベースの ports リポジトリブラウザ | `https://cgit.freebsd.org/ports` -| HTTPS 経由の読み取り専用 ports リポジトリ| `https://git.freebsd.org/ports.git` -| Anonymous ssh による読み取り専用 ports リポジトリ | `ssh://[email protected]/ports.git` -| コミッタのための読み取り/書き込み用 ports リポジトリ | `ssh://[email protected]/ports.git` (*) +| HTTPS 経由の読み取り専用 src リポジトリ | `https://git.FreeBSD.org/src.git` +| Anonymous ssh による読み取り専用 src リポジトリ | `ssh://[email protected]/src.git` +| HTTPS 経由の読み取り専用 doc リポジトリ | `https://git.FreeBSD.org/doc.git` +| Anonymous ssh による読み取り専用 doc リポジトリ | `ssh://[email protected]/doc.git` +| HTTPS 経由の読み取り専用 ports リポジトリ| `https://git.FreeBSD.org/ports.git` +| Anonymous ssh による読み取り専用 ports リポジトリ | `ssh://[email protected]/ports.git` |======================================================= - - (*) `git` は、リポジトリサーバ上の特別なユーザです。 -リポジトリサーバは、FreeBSD.org に登録されている ssh 鍵からユーザを識別するので、変更する必要はありません。 - -[WARNING] -==== -git への移行完了後、`gitrepo.freebsd.org` は単純な `repo.freebsd.org` に変更される予定です。 -==== - -利用開始には、FreeBSD リポジトリを clone してください。 - -[source,shell] -.... -# git clone -o freebsd [ -b branch ] https://git.FreeBSD.org/repo.git wcdir -.... - -ここで -* _repo_ は、プロジェクトリポジトリの `src`, `ports`, または `doc` のどれかになります。 -* _branch_ は、使用しているリポジトリに依存します。 -`ports` および `doc` では、ほとんどの変更が `main` ブランチで行われる一方で、`src` では -CURRENT の最新版を `main` で管理し、各 -STABLE ブランチの最新版を `stable/12` (12._x_) および `stable/13` (13._x_) で管理しています。 -* _wcdir_ は、指定したブランチの内容が置かれるターゲットディレクトリです。 -通常、`ports` では [.filename]#/usr/ports#、 `src` では [.filename]#/usr/src#、そして `doc` では [.filename]#/usr/doc# です。 -* _freebsd_ は、使用する origin の名前です。 -FreeBSD のドキュメントの慣例で、origin は `freebsd` とします。 +プロジェクトのメンバーが管理する外部のミラーも存在します。 +<<external-mirrors>> の節を参照してください。 -この例では、FreeBSD リポジトリからシステムのソースの 'main' ブランチを HTTPS プロトコルを用いてチェックアウトし、ローカルのワーキングコピーを [.filename]#/usr/src# に作成します。 -もし、[.filename]#/usr/src# がすでに存在していて、`git` により作成されたものでなければ、チェックアウトの前に、名前を変更するか削除しておいてください。 -そうでなければ、git は何も行わないでしょう。 +FreeBSD システムのソースコードリポジトリを clone するには、以下のコマンドを実行してください。 [source,shell] .... # git clone -o freebsd https://git.FreeBSD.org/src.git /usr/src .... +ここで `-o freebsd` オプションは origin を指定します。 +FreeBSD のドキュメントの慣例で、origin は `freebsd` とします。 初めてチェックアウトする際には、リモートリポジトリのすべてのブランチをダウンロードするので時間がかかります。 -初めてのチェックアウト後は、 以下を実行することでローカルのワーキングコピーをアップデートできます。 - +ワーキングツリーには最初、CURRENT に対応する `main` ブランチのソースコードがダウンロードされます。 +13-STABLE に変更するには以下のように実行してください。 [source,shell] .... -# cd wcdir -# git pull --rebase +# cd /usr/src +# git checkout stable/13 .... -この例で作成された [.filename]#/usr/src# をアップデートするには、以下のようになります。 +ワーキングツリーは、`git pull` によりアップデートできます。 +上記の例で作成された [.filename]#/usr/src# をアップデートするには、以下のようになります。 [source,shell] .... @@ -667,85 +623,55 @@ FreeBSD のドキュメントの慣例で、origin は `freebsd` とします。 チェックアウトと比較すると、このアップデートでは変更点のあるファイルのみが転送されるので高速です。 -プロジェクトのメンバーが管理する外部のミラーも存在します。 -<<external-mirrors>> の節を参照してください。 - -=== SSH 関連情報 - -* `ssh://${user}@${url}/${repo}.git` は、`${user}@${url}:${repo}.git` と書くこともできます。すなわち git 上では以下の二つの URL は両方とも使えます。 --- -** `ssh://[email protected]/${repo}.git` -** `[email protected]:${repo}.git` - -読み書き用リポジトリでも同様です。 - -** `ssh://git@(git)repo.freebsd.org/${repo}.git` -** `git@(git)repo.freebsd.org:${repo}.git` --- - -* gitrepo.FreeBSD.org ホスト鍵のフィンガープリントは以下です。 -** ECDSA 鍵のフィンガープリントは `SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA` です。 -** ED25519 鍵のフィンガープリントは `SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo` です。 -** RSA 鍵のフィンガープリントは `SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI` です。 - -* git.FreeBSD.org ホスト鍵のフィンガープリントは以下です。 -** ECDSA 鍵のフィンガープリントは `SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w` です。 -** ED25519 鍵のフィンガープリントは `SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE` です。 -** RSA 鍵のフィンガープリントは `SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM` です。 - -これらは DNS の SSHFP レコードとしても公開されています。 - === ウェブベースのリポジトリブラウザ -FreeBSD プロジェクトは、現在 cgit をウェブベースのリポジトリブラウザ (https://cgit.freebsd.org/) として使用しています。 -各リポジトリの URL は、<<git-url-table>> にまとめられています。 - -=== ユーザ向けの説明 - -公式の配布用のミラーから`git clone` および `git pull` することが推奨されています。 -GeoDNS により、近くの利用可能なミラーがユーザに提供されます。 +FreeBSD プロジェクトは、現在 cgit をウェブベースのリポジトリブラウザ (link:https://cgit.FreeBSD.org/[https://cgit.FreeBSD.org/]) として使用しています。 === 開発者向けの説明 -extref:{committers-guide}[Committer's Guide, git-mini-primer] をご覧ください。 +リポジトリへの書き込みアクセスについてはの詳細は、extref:{committers-guide}[Committer's Guide, git-mini-primer] をご覧ください。 [[external-mirrors]] === 外部ミラー -FreeBSD.org は以下のミラーを管理しておらず、プロジェクトのメンバーが現在も維持しています。 +FreeBSD.org は以下のミラーを管理していませんが、プロジェクトのメンバーが現在も維持しています。 ユーザおよび開発者は自由にこれらのミラーのリポジトリを pull したりブラウザで見ることができます。 -これらのミラーとのプロジェクトワークフローは議論中です。 +`doc` GitHub リポジトリへの pull request は accept されますが、 +それ以外について、これらのミラーとのプロジェクトワークフローは議論中です。 -==== Codeberg +Codeberg:: - doc: https://codeberg.org/FreeBSD/freebsd-doc - ports: https://codeberg.org/FreeBSD/freebsd-ports - src: https://codeberg.org/FreeBSD/freebsd-src -==== GitHub +GitHub:: - doc: https://github.com/freebsd/freebsd-doc - ports: https://github.com/freebsd/freebsd-ports - src: https://github.com/freebsd/freebsd-src -==== GitLab +GitLab:: - doc: https://gitlab.com/FreeBSD/freebsd-doc - ports: https://gitlab.com/FreeBSD/freebsd-ports - src: https://gitlab.com/FreeBSD/freebsd-src === メーリングリスト -FreeBSD プロジェクトにおける git の一般的な使用方法や質問について: https://lists.freebsd.org/subscription/freebsd-git[freebsd-git] +FreeBSD プロジェクトにおける git の一般的な使用方法や質問についてのメインのメーリングリストは https://lists.freebsd.org/subscription/freebsd-git[freebsd-git] です。 +コミットメッセージの一覧などの詳細については、crossref:handbook/eresources[eresources-mail, メーリングリスト] の章をご覧ください。 + +=== SSH ホスト鍵 -コミットメッセージは以下のメーリングリストに送信されます。 +* gitrepo.FreeBSD.org ホスト鍵のフィンガープリント: +** ECDSA 鍵のフィンガープリントは `SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA` です。 +** ED25519 鍵のフィンガープリントは `SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo` です。 +** RSA 鍵のフィンガープリントは `SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI` です。 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-doc-all[dev-commits-doc-all]: doc リポジトリに対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-ports-all[dev-commits-ports-all]: ports リポジトリに対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-ports-main[dev-commits-ports-main]: ports リポジトリの "main" ブランチに対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-ports-branches[dev-commits-ports-branches]: ports リポジトリの quarterly ブランチに対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-src-all[dev-commits-src-all]: src リポジトリに対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-src-main[dev-commits-src-main]: src リポジトリの "main" ブランチ (FreeBSD-CURRENT ブランチ) に対するすべての変更 -- https://lists.freebsd.org/scubsciption/listinfo/dev-commits-src-branches[dev-commits-src-branches]: src リポジトリの stable ブランチに対するすべての変更 +* git.FreeBSD.org ホスト鍵のフィンガープリント: +** ECDSA 鍵のフィンガープリントは `SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w` です。 +** ED25519 鍵のフィンガープリントは `SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE` です。 +** RSA 鍵のフィンガープリントは `SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM` です。 -詳細については、ハンドブックの C.2. 「メーリングリスト」 crossref:handbook/eresources/[eresources-mail, Mailing lists] の "コミットメッセージリスト" の節を参照してください。 +これらは DNS の SSHFP レコードとしても公開されています。 [[svn]] == Subversion の利用