はじめに

やりたいこと

Giteaを使い、Windows上にGitHubライクなソース管理環境を構築します。個人やチームでお手軽にソース管理をする場合に適しています。

Giteaとは

Giteaとは、自己ホスト型のオールインワンソフトウェア開発プラットフォームです。つまり、GitHubに似たことが社内などのプライベートネットワーク上でできます。

Giteaには以下の特徴があります。

MITライセンスに基づくOSSなので誰でも利用可能
軽量・高速のため、リソースに制約のある環境でもパフォーマンスが良好
Linux, Windowsなど多くのプラットフォームに対応
大規模な開発者コミュニティによって構築・維持されている

なぜWindows環境なのか

セキュリティ上、GitHubなどのクラウドサービスは使えない
既に使い慣れているWindowsサーバーがある
Linuxを使えるメンバーがいない
自宅のPCで簡単に試したい

などの事情があるでしょう。

環境構築

環境

今回は以下の環境で構築しました。OSはWindows10, Windows ServerでもOKです。

Windows11
Git for Windows 2.44.0
Gitea 1.21.4

Git for Windows のインストール

Windows版のGitです。
以下の公式サイトからインストーラをダウンロードします。

インストーラを起動し、基本的にはデフォルト設定で進めていけばOKです。
私は以下の設定のみ変更しました。

設定項目	設定値	備考
Choosing the default editor used by Git	Use Visual Studio Code as Git's default editor	デフォルトのエディタとしてVSCodeを使うため。
Adjusting the name of the initial branch in new repositories	Override the default branch name for new repositories にチェックし、ブランチ名は「main」に設定	デフォルトのブランチ名は main が主流らしいため。

画面キャプチャ付きの解説記事を書かれている方がいらっしゃいました。こちらもご参考ください。
Gitのインストール方法(Windows版) #Git - Qiita

Gitea の実行

以下の公式サイトから実行ファイルをダウンロードします。

バージョンを選ぶ場合はこちらからダウンロードできます。

ダウンロードした実行ファイル gitea-1.21.4-gogit-windows-4.0-amd64.exe を gitea.exe にリネームし¹、DBを保存するフォルダ配下に配置します。ここでは、以下のパスに配置しました。

実行ファイルのパス

C:\Gitea\gitea.exe

コマンドプロンプトから、Giteaを実行します。これでサーバーが立ち上がります。

Giteaを起動するコマンド

cd C:\Gitea
gitea.exe web

初期設定

ブラウザから http://localhost:3000/ へアクセスします。
初回のみ初期設定画面が表示されるので、各項目を入力します。
ここでは「データベースのタイプ」は、「SQLite3」にしました(自前で準備したMySQL, PostgresSQL, MSSQLを指定することもできます)。

複数人で使う場合、以下の設定にしておくとよいです。

設定項目	設定値
サーバーのドメイン	コンピュータ名
GiteaのベースURL	http://<コンピュータ名>:3000/

※コンピュータ名は以下のコマンドで取得できます。

コンピュータ名を取得するコマンド

echo %COMPUTERNAME%

複数人で使う場合、オプションのメール関連の項目を設定しておくと、アカウント作成時のメール認証やメールによる通知ができるようになります。
入力ができたら、「Giteaをインストール」を押します。

アカウント登録画面が表示されるので、各項目を入力して登録します。
最初に作成したアカウントが管理者アカウントになります。

自動起動の設定

PC起動時に自動的にGiteaサーバーが起動するように設定します。
設定ファイルは以下のパスにあります。
C:\Gitea\custom\conf\app.ini
RUN_USERの設定値を編集します。

app.ini

RUN_USER = <コンピュータ名>$

コンピュータ名がUSER-PCの場合、RUN_USER = USER-PC$ となります。

初期設定で「データベースのタイプ」を「SQLite3」にした場合は、データベースのPATHの項目に絶対パスを指定します(既に絶対パスになっている場合は変更なしでOK)。

app.ini

[database]
PATH = C:/Gitea/data/gitea.db

管理者権限でコマンドプロンプトを起動します。
以下のコマンドを実行し、GiteaをWindowsのサービスに登録します。

Giteaをサービスに登録するコマンド

sc.exe create gitea start= auto binPath= "\"C:\Gitea\gitea.exe\" web --config \"C:\Gitea\custom\conf\app.ini\""

サービスを起動します。(Windowsキー+Rで「ファイル名を指定して実行」→services.mscと入力し、Enter)
一覧の「gitea」を選択し、「サービスの開始」で起動できます。
※二重起動だとエラーになるので、コマンドプロンプトから gitea.exe web で起動した方は停止しておきます(Ctrl+Cや、ウィンドウを閉じれば終了します)。
「スタートアップの種類」が「自動」になっているので、PC起動時に自動で開始されます。

なお、以下のコマンドでGiteaをサービスから削除できます。

Giteaをサービスから削除するコマンド

sc.exe delete gitea

Giteaの基本的な使い方

リポジトリ・組織・チームの作成

アカウント登録が完了し、サインインしたら右上の＋ボタンから新しいリポジトリを作成できます。

複数人で使う場合は「新しい組織」から組織を作成します。

作成した組織のページの「新しいチーム」から、チームを作成します。

チームを作成したら、メンバーにアカウント登録をしてもらいます。アカウントをチームに追加することで適切な権限を与えます。

組織リポジトリの説明

個々のリポジトリは、作成者が所有者(Owner)です。組織リポジトリ(組織で作成したリポジトリ)の場合、所有者はこの組織のオーナーチームのメンバーです。チームには以下の3種類があります。1人のメンバーは複数のチームに参加することができます。

オーナーチーム(Owner Team)
組織が作成されるとオーナーチームが作成され、作成者がオーナーチームの最初のメンバーになります。オーナーチームは削除することができず、少なくとも1人のメンバーがいます。
管理チーム(Admin Team)
管理チームのメンバーは、そのチームに追加されたリポジトリに対して何でもできます。新しいチームを作成できるのは、オーナーまたは管理チームのメンバーだけです。
一般チーム(General Team)
一般チームには以下の表の通り、細かく権限設定ができます。組織内のすべてのリポジトリにアクセスすることも、特定のリポジトリにアクセスすることもできます。リポジトリの作成権限を与えることもできます。

おわりに

Giteaを使い、Windows上にGitHubライクなソース管理環境を構築する方法についてまとめました。より詳しい使い方は、以下の公式ドキュメント・フォーラムをご参考ください。

参考

Gitea Official Website
Documentation | Gitea Documentation
超軽量・高性能DevopsプラットフォームGitea #Git - Qiita
Gitのインストール方法(Windows版) #Git - Qiita
Giteaを使ってローカルでGitHubライクサーバーを作成する | saku note

ファイル名が長いため。また、Giteaは基本的にexeを差し替えるだけでバージョンを上げることができ、ファイル名にバージョンを入れない方がよいため。 ↩