Gogsのソースを表示

[[Category:バージョン管理システム]]
[[en:Gogs]]
{{Related articles start}}
{{Related|Gitea}}
{{Related articles end}}
[http://gogs.io/ Gogs] (Go Git Service) はセルフホスティング Git サービスです。[[Go]] プログラミング言語で書かれています。

== パッケージ ==

* {{AUR|gogs}} - リリース版パッケージ。
* {{AUR|gogs-git}} - Git の {{ic|master}} ブランチ版パッケージ [https://github.com/gogits/gogs]
* {{AUR|gogs-git-dev}}{{Broken package link|package not found}} - Git の {{ic|dev}} ブランチ版パッケージ [https://github.com/gogits/gogs/tree/develop]

上記のパッケージでは sqlite, redis, memcache が有効になります。使用するには、{{ic|app.ini}} 設定ファイルを編集する必要があります ([[#設定]]を参照)。

== インストール ==

[[AUR]] から Gogs をインストールすることで、手動でインストールする場合に設定する必要があることをほとんど自動で行ってくれます (例: ファイルのパーミッションや所有者の設定など)。

[[AUR]] から Gogs のパッケージをインストールする前に、Gogs と同じマシンにデータベースを作る場合、データベースバックエンドを選んでください:

* SQLite: {{Pkg|sqlite}} - Gogs で SQLite を使用する方法は [[#SQLite]] を見てください。
* PostgreSQL: {{Pkg|postgresql}} - [[PostgreSQL#PostgreSQL のインストール]]を読んでセットアップして[[デーモン]]を起動してください。Gogs で PostgreSQL を使用する方法は [[#PostgreSQL]] を見てください。
* MariaDB: {{Pkg|mariadb}} - [[MariaDB#インストール]]を読んでセットアップして[[デーモン]]を起動してください。Gogs で MariaDB を使用する方法は [[#MariaDB]] を見てください。

SSH を使ってリポジトリを操作できるようにする場合、{{ic|/etc/ssh/sshd_config}} の {{ic|AllowUsers}} エントリに {{ic|gogs}} ユーザーを追加してください。

== 初期設定 ==

{{ic|gogs.service}} を[[起動]]したら、{{ic|http://[server]:3000}} からサービスにアクセスできるようになります。初めてアクセスしたときは、インストールページに転送されます。インストールページでは様々な設定オプションを設定できます。他の設定は {{ic|/srv/gogs/conf/app.ini}} 設定ファイルで変更できます (ポート番号など)。

== 設定 ==

最初の起動時、Gogs は設定ファイルを {{ic|/srv/gogs/conf}} ディレクトリに作成します。

=== .gitignore と license ファイル ===

{{ic|/srv/gogs/conf/gitignore}} または {{ic|/srv/gogs/conf/license}} ディレクトリにファイルを追加してください。ディレクトリが存在しない場合、最初に作成する必要があります。

.gitignore ファイルは [http://www.gitignore.io/ こちらのページ] から取得・作成できます。

=== データベース ===

==== SQLite ====

{{Pkg|sqlite}} をインストールしてインストールページで SQLite を選択してください。

==== PostgreSQL ====

{{Pkg|postgresql}} をインストールしてインストールページで PostgreSQL を選択してください。

 # su - postgres -c
 # createuser -P gogs
 # createdb -O gogs gogs

==== MariaDB ====

{{Pkg|mariadb}} をインストールしてユーザーとデータベースを設定してください:

 # CREATE DATABASE `ishouldchangethisdatabasename` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
 # CREATE USER 'ishouldchangethisusername'@'localhost' IDENTIFIED BY 'ishouldchangethispassword';
 # GRANT ALL ON `ishouldchangethisdatabasename`.* TO 'ishouldchangethisusername'@'localhost';

インストールページでは '''mysql''' を選択して、設定したユーザーとパスワード、データベース名を入力してください。

== Tips and tricks ==

=== テーマ ===

最新パッケージ (gogs-git* と gogs>=0.4.2) ではカスタムテーマに対応しています。Gogs のテーマを保存するディレクトリは {{ic|/usr/share/themes/gogs/}} です。Gogs にはデフォルトテーマが付属していますが、簡単にテーマを作成することができます。デフォルトの {{ic|theme}} ディレクトリをコピーして自由に変更してください。{{ic|public}} ディレクトリには javascript やスタイルシート、フォントファイルを保存し {{ic|template}} ディレクトリには HTML テンプレートを保存します。{{ic|app.ini}} の設定パラメータ {{ic|STATIC_ROOT_PATH}} を変更することでテーマを選ぶことができます。新しいテーマの絶対パスに変更してください。

=== アップグレード後に再起動 ===

Gogs はアップグレード後に再起動を必要とします。javascript や css アセットのパスが変更されウェブサイトが表示できなくなるためです。以下の pacman フックを {{ic|/etc/pacman.d/hooks/gogs.hook}} として作成することで再起動を自動化できます:

 [Trigger]
 Type = File
 Operation = Upgrade
 Target = usr/share/gogs/gogs
 [Action]
 Description = Restart gogs...
 When = PostTransaction
 Exec = /usr/bin/systemctl try-restart gogs.service

== SSH ポート ==

SSH サーバーのポートをデフォルトから変更している場合、クローン URL が醜くなります。ポート 22 を使用して gogs で独自の SSH サーバーを起動させることができます。

gogs バイナリから特権ポートの使用を許可:

 # setcap CAP_NET_BIND_SERVICE=+eip /usr/share/gogs/gogs

{{ic|/srv/gogs/conf/app.ini}} で gogs の SSH サーバーを設定:

 START_SSH_SERVER       = true
 SSH_PORT               = 22
 SSH_LISTEN_PORT        = 22

== 参照 ==

* [https://gogs.io/docs 公式ドキュメント]