Giteaのソースを表示

[[Category:バージョン管理システム]]
[[en:Gitea]]
{{Related articles start}}
{{Related|Gogs}}
{{Related articles end}}
[https://gitea.io/ Gitea] は Go で書かれた軽量なコードホスティングサーバーである [[Gogs]] のコミュニティによるフォークです。MIT ライセンスで配布されています。

== インストール ==

{{AUR|gitea}} か {{AUR|gitea-git}} パッケージをインストールしてください。

Gitea はデータベースバックエンドを必要とします。以下のデータベースがサポートされています:
* [[MariaDB]]
* [[PostgreSQL]]
* [[SQLite]] 
* [https://github.com/pingcap/tidb TiDB]

=== MariaDB ===
{{Note|listen アドレスとして {{ic|/var/run/mysqld/mysqld.sock}} を使用することで MySQL のソケットを利用することができます。}}

[[MariaDB]] は以下のように設定してください:
{{hc|$ mysql -u root -p|2=
mysql> CREATE DATABASE `gitea` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
mysql> CREATE USER '''gitea'''@'localhost' IDENTIFIED BY ''''password'''';
mysql> GRANT ALL ON `gitea`.* TO 'gitea'@'localhost';
mysql> \q
}}

新しいユーザーで新しいデータベースへの接続を試行してみてください:

 $ mysql -u '''gitea''' -p -D gitea

最初の起動時や {{ic|app.ini}} を編集して MariaDB を設定します:
{{hc|/var/lib/gitea/custom/conf/app.ini|2=
DB_TYPE  = mysql
HOST     = /var/run/mysqld/mysqld.sock ; or 127.0.0.1:3306
NAME     = gitea
USER     = gitea
PASSWD   = '''password'''
}}

== 実行 ==
{{ic|gitea.service}} を[[起動]]・[[有効化]]してください。ウェブインターフェイスは {{ic|http://localhost:3000}} からアクセスできます。

Gitea を最初に起動したときは {{ic|http://localhost:3000/install}} にリダイレクトされます。

== 設定 ==
ユーザー設定ファイルは {{ic|/var/lib/gitea/custom/conf/app.ini}} です。メインの設定ファイルである {{ic|/var/lib/gitea/conf/app.ini}} を編集してはいけません。このファイルはバイナリに含められるため、アップデートによって上書きされてしまいます。

Gitea のアプリケーションやリポジトリのデータは {{ic|/var/lib/gitea}} に保存されます。{{ic|/var/lib/gitea/custom/conf/app.ini}} で別の保存場所を指定することもできます。

=== HTTP プロトコルの無効化 ===
Gitea ではデフォルトで HTTP プロトコルを使ってリポジトリを操作できるようになっています。{{ic|DISABLE_HTTP_GIT}} を '''false''' に設定することでサポートを無効化できます。

== 高度な設定 ==
他の設定例は [https://gogs.io/docs/intro/faqs Gogs の FAQ] を見てください。

=== nginx をリバースプロキシとして設定 ===
[[nginx]] をリバースプロキシとして [[OpenSSL]] を使用する例:
{{hc|/etc/nginx/servers-available/git|2=
# redirect to ssl
server {
  listen 80;
  server_name git.domain.tld;
  return 301 https://$server_name$request_uri;
}

server {
  listen 443 ssl http2;
  server_name git.domain.tld;
  ssl_certificate ssl/'''cert.crt''';
  ssl_certificate_key ssl/'''cert.key''';

  location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://localhost:3000;
  }
}
}}

{{ic|app.ini}} の ''server'' セクションを更新してください:
{{hc|/var/lib/gitea/custom/conf/app.ini|2=
[server]
PROTOCOL               = http
DOMAIN                 = git.domain.tld
ROOT_URL               = https://git.domain.tld/
HTTP_ADDR              = 0.0.0.0
HTTP_PORT              = 3000
}}
{{Note|{{ic|app.ini}} で SSL 証明書のオプションを有効にする必要はありません。}}

== 参照 ==
* [https://docs.gitea.io/ Gitea ドキュメント]
* [https://gogs.io/docs Gogs ドキュメント]