小さな構成で始めるセルフホストGitサービス Gogs

ビジョンとアーキテクチャ

Gogsプロジェクト（発音：/gɑgz/）は、READMEにおいて、最も苦労のない方法でセットアップできる、シンプルで安定した拡張可能なセルフホストGitサービスの構築を目指すと述べられています。Goで書かれているため、Goがサポートするすべてのプラットフォーム（Linux、macOS、Windows、ARMベースのシステムを含む）に独立したバイナリとして配布できます。リポジトリメタデータは主要言語をGoとし、ホームページをgogs.ioとしています。メタデータのスナップショット時点で、リポジトリには47,719スター、5,077フォーク、1,007のオープンイシューがありますが、README自体にはこれらの数字は記載されていません。

機能概要

READMEには幅広い機能が列挙されています。ユーザーはダッシュボード、プロフィール、アクティビティタイムラインを利用できます。リポジトリにはSSH、HTTP、HTTPSプロトコルでアクセスできます。このサービスには、ユーザー、組織、リポジトリの管理に加え、Slack、Discord、Dingtalkに送信できるリポジトリおよび組織向けのWebhookが含まれます。Gitフック、デプロイキー、Git LFSもサポートされています。イシュートラッキング、プルリクエスト、wiki、保護されたブランチ、コラボレーションツールもパッケージの一部です。他のコードホストからwiki付きでリポジトリを移行・ミラーリングでき、リポジトリファイルやwikiを素早く編集するためのWebエディタも備えています。Jupyter NotebookとPDFのレンダリングにも対応しています。認証オプションにはSMTP、LDAP、リバースプロキシ、GitHub.com、GitHub Enterpriseが含まれ、二要素認証をサポートします。HTMLテンプレートと静的ファイルはカスタマイズ可能で、データベースバックエンドはPostgreSQL、MySQL、MariaDB、SQLite3、またはこれらのプロトコルを話す任意のデータベースをサポートします。READMEによると、ローカライゼーションは31以上の言語で提供されています。

ハードウェアとブラウザの要件

READMEのハードウェアガイドは控えめです。Raspberry Piまたは5ドルのDigitalOcean Dropletで十分に始められ、64MB RAMのDockerコンテナで運用している例もあると述べています。チームでの使用には、2 CPUコアと512MB RAMがベースラインとされています。チームサイズが大幅に大きくなった場合はCPUコアを増やすことを推奨しており、メモリ使用量は低いままであるとしています。ブラウザ側では、Semantic UIのブラウザサポートリストを参照して具体的なバージョンを確認するよう指示しています。公式にサポートされる最小解像度は1024x768ですが、READMEはこれより小さい解像度でもUIが正常に見えるかもしれないが、約束や修正はしないと述べています。

インストール、デプロイ、チュートリアル

READMEには段階的なインストールコマンドは含まれておらず、代わりにgogs.ioのドキュメントを参照してインストール手順を確認するよう案内しています。クラウド展開については、Cloudron、YunoHost、alwaysdataのオプションを挙げています。、Raspberry Pi、Ubuntu 14.04、Docker、DockerとPostgreSQLなどの環境をカバーする第三者のチュートリアルをまとめており、中国語のガイドやFreeBSDのインストールメモも含まれます。これらのチュートリアルの具体的なコマンドや手順はREADMEには再現されていないため、具体的なインストール手順は外部の情報源で検証する必要があります。

コミュニティと統合

READMEには、Gogsと連携する外部ツールやサービスがいくつか挙げられています：GogsのWebhook用のJenkinsプラグイン、Puppetモジュール、SynologyのDockerサポート、Syncloudのアプリストアです。プロジェクトはDigitalOceanの支援に感謝し、無料クレジットを得るための紹介リンクも提供しています。また、Egon Elbre氏が元のロゴをデザインしたこと、Mintlifyがドキュメントプランをスポンサーしていること、Crowdinが翻訳プランを、BuildkiteがCI/CDプランをスポンサーしていることに感謝しています。コントリビューターページには上位100人のコントリビューターがリストされ、リポジトリには公開された翻訳者リストがあります。

ライセンスとソース条項

GogsはMITライセンスのもとでリリースされています。ライセンスの抜粋は、著作権表示と許可表示がすべてのコピーまたは実質的な部分に含まれることを条件に、ソフトウェアのコピーを使用、複製、変更、統合、公開、配布、サブライセンス、および販売する権利を許可します。ソフトウェアは「現状のまま」提供され、商品性、特定目的への適合性、非侵害の保証を含む、明示的または黙示的な保証は一切ありません。著者および著作権保持者は、ソフトウェアに起因するいかなる請求、損害、その他の責任についても責任を負いません。ライセンス文書には、セキュリティ保証、サポートの約束、プロジェクトのメンテナンスのペースについては何も記載されていません。

編集部の結論

小規模チームでGitリポジトリ、Issue、Wikiを自分の環境に置きたい場合に検討できます。READMEは導入コマンドを掲載せず、gogs.ioの文書と複数の配布先へ案内しているため、選定時は対象OS、データベース、バックアップ経路をその文書で突き合わせてください。64MB級の例はありますが、チーム運用の基準として2 CPUと512MB RAMも示されており、負荷試験なしに容量を決める根拠にはなりません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes