Tech｜Gitに代わるFossilについて学ぼう

Fossilはバージョン管理システム、バグトラッカー、ウィキ、フォーラム、ドキュメントソリューションです。

開発者なら誰でも、コードの変更を記録しておくことが重要であることを知っています。好奇心や教育的な目的のために、プロジェクトの始まりと進化の歴史を示す必要があることもあるでしょう。他の開発者をプロジェクトに参加させたいので、異なるコードブランチをマージする信頼できる方法が必要なこともあるでしょう。もっと極端な例では、問題を解決するために変更したコードが、 既存の機能を動作させなくしてしまうこともあります。

ソースコード管理システムは、有名な データベースの作者によって開発された、オールインワンのバージョン管理システム、バグ追跡、ウィキ、フォーラム、文書化ソリューションです。

化石のインストール

FossilはスタンドアロンのCプログラムなので、ウェブサイトからダウンロードして環境変数 SQLite 任意の場所に置くことができます。例えば、/usr/local/binがすでに環境変数に入っているとします：

$ wget https://-.///---...gz
$ sudo tar xvf fossil-linux-x64-X.Y.tar.gz --directory /usr/local/bin

Fossilはパッケージ・マネージャーを通してリポジトリから見つけることもできますし、ソースから直接コンパイルすることもできます。

化石リポジトリの作成

すでにFossilで追跡したいコードプロジェクトがある場合、最初のステップはFossilリポジトリを作成することです：

$ fossil init myproject.fossil
project-id: ac6112fefb0bdd0684
server-id:  e9dc938ba1caac27f44
admin-user: klaatu (initial password is "")

Fossil リポジトリの作成プロセスでは、一意のプロジェクト ID、一意のサーバー ID、管理者 ID とパスワードの 3 行の情報が返されます。プロジェクト ID とサーバー ID はバージョン番号です。管理者認証情報はリポジトリの所有権を示し、他のユーザーがアクセスするサーバーとして Fossil を使用する際に管理者権限を使用できます。

化石倉庫ワークフロー

Fossil リポジトリを使用する前に、データの作業パスを作成する必要があります。このプロセスは、Pythonを使用する際の仮想環境の作成や、バックアップにのみ使用するZIPファイルの解凍に例えることができます。

作業ディレクトリを作成し、その中に入ります：

$ mkdir myprojectdir
$ cd myprojectdir

作成したディレクトリにFossilを開いてください：

$ fossil open ../myproject
project-name: <unnamed>
repository: /home/klaatu/myprojectdir/../myproject
local-root: /home/klaatu/myprojectdir/
config-db: /home/klaatu/.fossil
project-code: ac6112fefb0bdd0684
checkout: 9e6cd96ddaad58cdd   UTC
tags: trunk
comment: initial empty check-in (user: klaatu)
check-ins: 1

お気づきかもしれませんが、Fossilはホームディレクトリに.fossilという隠しファイルを作成し、グローバルなFossilコンフィギュレーションを記録します。このコンフィギュレーションは1つのプロジェクトに固有のものではなく、このファイルはFossilの初回使用時にのみ生成されます。

ファイルの追加

リポジトリにファイルを追加するには、add サブコマンドと commit サブコマンドを使用します。たとえば、簡単な README ファイルを作成し、リポジトリに追加します：

$ echo "My first Fossil project" > README
$ fossil add README
ADDED  README
$ fossil commit -m 'My first commit'
New_Version: acddedfc6aead01aa

ブランチの利用

Fossil リポジトリは trunk と呼ばれるデフォルトのマスターブランチで始まり、メインブランチに影響を与えずにコードに変更を加えたい場合は trunk ブランチから切り離すことができます。新しいブランチを作成するには、branch サブコマンドを使用します。branch サブコマンドは、新しいブランチの名前と、新しいブランチのベースブランチの名前の 2 つの引数を取ります。この場合、trunk というブランチしかないので、dev という新しいブランチを作成しようとします：

$ fossil branch --help
Usage: fossil branch new BRANCH-NAME BASIS ?OPTIONS?
$ fossil branch new dev trunk
New branch: cbfe0cd320fa0b12b5ebbc95

新しいブランチを作成しましたが、現在のブランチはトランクのままです：

$ fossil branch current

新しいブランチdevに切り替えるには checkout コマンドを使います：

$ fossil checkout dev

変更のマージ

新しいファイルをdevブランチに追加し、テストを終えて、それをtrunkにマージしたいとします。

まず、目的の枝まで切り戻します：

$ fossil checkout trunk

このブランチには新しいファイルはなく、その内容はマージ処理に必要な情報です：

$ fossil merge dev
 "fossil undo" is available to undo changes to the working checkout.
myfile.lua  README

Fossil のタイムラインを見る

リポジトリの履歴を見るには、タイムラインオプションを使用します。このコマンドは、各変更を表すために使用されたハッシュ値、各コミットで記入された情報、コミッターなど、リポジトリのすべての活動に関する詳細な情報を一覧表示します：

$ fossil timeline
===  ===
 [5efb] added exciting new file (user: klaatu tags: dev)
 [cbf2] Create new branch named "dev" (user: klaatu tags: dev)
 [a2bb] *CURRENT* some additions were made (user: klaatu tags: trunk)
 [acd] This is my first commit. (user: klaatu tags: trunk)
 [9e6cd96dd6] initial empty check-in (user: klaatu tags: trunk)
+++ no more data (5) +++

オープン化石倉庫

Fossil にはウェブインターフェイスが組み込まれているので、GitLab や Gitea のようなホスティングサービスは必要ありません。Fossil リポジトリを公開する際には、ウェブユーザーインターフェイスでいくつかの情報を設定する必要があります：

ローカル・インスタンスを開始するには、ui サブコマンドを使用します：

/home/klaatu/myprojectdir/
$ fossil ui

「Users "と "Settings "はセキュリティ関連で、"Configuration "はプロジェクトのプロパティです。ウェブ・インターフェースは単なる便利な機能ではありません。 本番環境やFossilプロジェクトのホストとして使用することができます。また、ユーザー管理や同じサーバー上の他のFossilリポジトリとのシングルサインオンなど、他の高度なオプションもあります。

設定が完了したら、ウェブ・インターフェースを閉じ、Ctrl+C を押して UI エンジンを停止します。Web の変更をコードであるかのようにコミットします。

$ fossil commit -m 'web ui updates'
New_Version: 11fe7fc303df00ec725d0fca526fa0b83fa67c95db73c60

これでFossilサーバーを設定できます。

1. Fossilリポジトリをサーバーにコピーしてください。
2. Fossilがサーバーにインストールされていない場合は、サーバーにFossilをインストールしてください。サーバーへのインストール手順はローカルと同じです。
3. cgi-binディレクトリに repo_myproject.cgi 名前のファイルを作成します：

#!/usr/local/bin/fossil
repository: /home/klaatu/public_html/myproject.fossil

実行可能パーミッションを追加します：

$ chmod +x repo_myproject.cgi

必要なことはすべて終わっています。このプロジェクトはインターネット経由でアクセスできるようになりました。

https://./-/_.giCGIスクリプトでウェブUIにアクセスできます。

コマンドラインから対話することもできます：

$ fossil clone https://@./-/_.gi

ローカルのクローンリポジトリで作業する場合、ローカルの変更をリモートリポジトリにプッシュするには push サブコマンドを使用し、リモートの変更をローカルリポジトリにプルするには pull サブコマンドを使用する必要があります：

$ fossil push https://@./-/_.gi

Fossilをスタンドアロンホスティングとして使用

Fossilは、もはや頼る必要のないマネージド・サービスの手に多くの力を与えます。この記事は基本的なコンセプトの簡単な紹介に過ぎません。あなたのコード・プロジェクトで使える便利な Fossil の機能は他にもたくさんあります。Fossilを試してみてください。バージョン管理に対する理解が変わるだけでなく、他のバージョン管理システムについて考えなくなるでしょう。

via: