{"id":415909,"date":"2024-06-30T00:38:20","date_gmt":"2024-06-30T00:38:20","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=415909"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=415909","title":{"rendered":"cGit-UI \u2014 a web interface for Git Repositories<\/span>"},"content":{"rendered":"
<\/div>\n
\n
\n
\n
\n

cGit-UI<\/b> \u2014 is a web interface for Git<\/b> repositories. cGit-UI<\/b> is based on CGI script written in \u0421<\/b>. <\/p>\n

<\/p>\n

This article covers installing and configuring cGit-UI<\/b> to work using Nginx<\/b><\/a> + uWsgi<\/b><\/a>. Setting up server components is quite simple and practically does not differ from setting up cGit<\/b><\/a>. <\/p>\n

<\/p>\n

cGit-UI<\/b> supports Markdown<\/b> files that are processed on the server side using the md4c<\/a> library, which has proven itself in the KDE Plasma<\/b> project. cGit-UI<\/b> provides the ability to add site verification codes and scripts from systems such as Google Analytics<\/em><\/b> and Yandex.Metrika<\/em><\/b> for trafic analysis. Users who wonder to receive donations for his projects can create and import custom donation modal dialogs. <\/p>\n

<\/p>\n

Instead of looking at screenshots, it is better to look at the working site<\/a> to decide on installing cGit-UI<\/b><\/a> on your own server. <\/p>\n

<\/a> <\/p>\n

Reqired Packages<\/h2>\n

<\/p>\n

cGit-UI<\/b> depends of following libraries: libpcre2<\/b><\/a>, libmd4c<\/b><\/a>, libmd4c-html<\/b><\/a>, libmagic<\/b><\/a>, and libgit2<\/b><\/a>. <\/p>\n

<\/p>\n

Also cGit-UI<\/b> depends on the cScm<\/b> package. Therefore, before installing cGit-UI<\/b>, you have to install and configure cScm Configuration Daemon<\/b><\/a>. <\/p>\n

<\/p>\n

To use cGit-UI<\/b> a web server must be installed and configured on the system. We recommend the Nginx<\/b><\/a> with uWsgi<\/b><\/a> application server. Of course, Git<\/b><\/a> SCM<\/b> system should be installed too. <\/p>\n

<\/p>\n

Installation<\/h2>\n

<\/p>\n

To obtain sources we have to checkout its from SVN repository<\/a>: <\/p>\n

<\/p>\n

svn checkout svn:\/\/radix.pro\/cgit-ui\/tags\/cgit-ui-0.1.4 cgit-ui-0.1.4 <\/code><\/pre>\n
  <\/p>\n
and run the bootstrap script:  <\/p>\n
  <\/p>\n
cd csvn-0.1.4 .\/bootstrap <\/code><\/pre>\n
  <\/p>\n
Also cGit-UI source packages are available for download on the Radix.pro FTP-server<\/a>.  <\/p>\n
  <\/p>\n
Bootstrap Script<\/h3>\n
  <\/p>\n
The bootstrap<\/em> script especially created for Autotools<\/em> install automation. To install Autotools<\/em> into the source directory on the build machine (i.e. when build<\/b> == host<\/b>) the bootstrap<\/em> script can be run without arguments.  <\/p>\n
  <\/p>\n
.\/bootstrap <\/code><\/pre>\n
  <\/p>\n
In this case Autotools<\/em> will be installed from current root file system.  <\/p>\n
  <\/p>\n
For the cross environment the —target-dest-dir<\/b> option allows to install some stuff from development root file system:  <\/p>\n
  <\/p>\n
TARGET_DEST_DIR=\/home\/developer\/prog\/trunk-672\/dist\/.s9xx-glibc\/enybox-x2 \\     .\/bootstrap --target-dest-dir=${TARGET_DEST_DIR} <\/code><\/pre>\n
  <\/p>\n
For example, in this case the aclocal.m4<\/em> script will be collected from the
  ${TARGET_DEST_DIR}\/usr\/share\/aclocal<\/em> directory.  <\/p>\n
  <\/p>\n
Configuring Sources<\/h3>\n
  <\/p>\n
.\/configure --prefix=\/usr \\             --with-scriptdir=\/var\/www\/htdocs\/cgit <\/code><\/pre>\n
Install on the Build Machine<\/h4>\n
  <\/p>\n
make make install <\/code><\/pre>\n
Cross Compilation Example<\/h4>\n
  <\/p>\n
#!\/bin\/sh  TARGET_DEST_DIR=\/home\/developer\/prog\/trunk-672\/dist\/.s9xx-glibc\/enybox-x2 TOOLCHAIN_PATH=\/opt\/toolchains\/aarch64-S9XX-linux-glibc\/1.1.4\/bin TARGET=aarch64-s9xx-linux-gnu  .\/bootstrap --target-dest-dir=${TARGET_DEST_DIR}  PKG_CONFIG=\/usr\/bin\/pkg-config \\ PKG_CONFIG_PATH=${TARGET_DEST_DIR}\/usr\/lib${LIBDIRSUFFIX}\/pkgconfig:${TARGET_DEST_DIR}\/usr\/share\/pkgconfig \\ PKG_CONFIG_LIBDIR=${TARGET_DEST_DIR}\/usr\/lib${LIBDIRSUFFIX}\/pkgconfig:${TARGET_DEST_DIR}\/usr\/share\/pkgconfig \\ STRIP=\"${TOOLCHAIN_PATH}\/${TARGET}-strip\" \\ CC=\"${TOOLCHAIN_PATH}\/${TARGET}-gcc --sysroot=${TARGET_DEST_DIR}\" \\ .\/configure --prefix=\/usr   --build=x86_64-pc-linux-gnu \\   --host=${TARGET} \\   --with-scriptdir=\/var\/www\/htdocs\/cgit  make make install DESTDIR=${TARGET_DEST_DIR} <\/code><\/pre>\n
  <\/p>\n
Also we can make use of additional variables such as CFLAGS<\/b>, LDFLAGS<\/b>:  <\/p>\n
  <\/p>\n
LDFLAGS=\"-L${TARGET_DEST_DIR}\/lib -L${TARGET_DEST_DIR}\/usr\/lib\" TARGET_INCPATH=\"-L${TARGET_DEST_DIR}\/usr\/include\" CFLAGS=\"${TARGET_INCPATH}\" CPPFLAGS=\"${TARGET_INCPATH}\" <\/code><\/pre>\n
Post Install<\/h2>\n
  <\/p>\n
The system user, on whose behalf the Nginx<\/b> server is launched, must have permissions to access the directory in which the cGit-UI<\/b> CGI script was installed:  <\/p>\n
  <\/p>\n
chown -R nginx:nginx \/var\/www\/htdocs\/cgit <\/code><\/pre>\n
  <\/p>\n
Additionaly if nginx<\/b> user has not enough permissions to access repositories we have to change owner of \/var\/www\/htdocs\/cgit\/cgit-ui.cgi<\/em> script and set SUID<\/b> or SGID<\/b> bit:  <\/p>\n
  <\/p>\n
chown -R 0:0 \/var\/www\/htdocs\/cgit\/cgit-ui.cgi chmod 4755 \/var\/www\/htdocs\/cgit\/cgit-ui.cgi <\/code><\/pre>\n
uWsgi<\/h2>\n
  <\/p>\n
Since we used the —with-scriptdir=\/var\/www\/htdocs\/cgit<\/em> option on configuring stage, the cGit-UI<\/b> CGI script installed in the \/var\/www\/htdocs\/cgit\/<\/em> directory. In this case, the \/etc\/uwsgi\/cgit-ui.ini<\/em> file should look like this:  <\/p>\n
  \/etc\/uwsgi\/cgit-ui.ini:<\/b>  <\/p>\n
[uwsgi] master          = true plugins         = cgi socket          = \/run\/uwsgi\/%n.sock uid             = nginx gid             = nginx procname-master = uwsgi cgit-ui processes       = 1 threads         = 2 cgi             = \/var\/www\/htdocs\/cgit\/cgit-ui.cgi <\/code><\/pre>\n
  <\/p>\n
Where \/var\/www\/htdocs\/cgit\/cgit-ui.cgi<\/em> is the full name of installed cGit-UI<\/b> CGI script.  <\/p>\n
  <\/p>\n
To run the uWSGI<\/b> daemon for cGit-UI<\/b> backend we can make use following start\/stop script:  <\/p>\n
  \/ets\/rc.d\/rc.cgit-ui-uwsgi:<\/b>  <\/p>\n
#!\/bin\/sh # # uWSGI daemon control script. #  CONF=cgit-ui BIN=\/usr\/bin\/uwsgi CONFDIR=\/etc\/uwsgi PID=\/var\/run\/$CONF-uwsgi.pid  uwsgi_start() {   # Sanity checks.   if [ ! -r $CONFDIR\/cgit-ui.ini ]; then # no config files, exit:     echo \"There are config files in $CONFDIR directory. Abort.\"     exit 1   fi    if [ -s $PID ]; then     echo \"uWSGI for cGit-ui appears to already be running?\"     exit 1   fi    echo \"Starting uWSGI for cGit-ui server daemon...\"   if [ -x $BIN ]; then     \/bin\/mkdir -p \/run\/uwsgi     \/bin\/chown nginx:nginx \/run\/uwsgi     \/bin\/chmod 0755 \/run\/uwsgi     $BIN --thunder-lock --pidfile $PID --daemonize \/var\/log\/cgit-ui-uwsgi.log --ini $CONFDIR\/$CONF.ini   fi }  uwsgi_stop() {   echo \"Shutdown uWSGI for cGit-ui gracefully...\"   \/bin\/kill -INT $(cat $PID)   \/bin\/rm -f $PID }  uwsgi_reload() {   echo \"Reloading uWSGI for cGit-ui configuration...\"   kill -HUP $(cat $PID) }  uwsgi_restart() {   uwsgi_stop   sleep 3   uwsgi_start }  case \"$1\" in   start)     uwsgi_start     ;;   stop)     uwsgi_stop     ;;   reload)     uwsgi_reload     ;;   restart)     uwsgi_restart     ;;   *)   echo \"usage: `basename $0` {start|stop|reload|restart}\" esac <\/code><\/pre>\n
  <\/p>\n
To run this daemon on systems with BSD-like initialization such as Slackware<\/b> we have to add the following lines to the \/etc\/rc.d\/rc.M<\/em> and \/etc\/rc.d\/rc.6<\/em> scripts correspondingly.  <\/p>\n
  \/etc\/rc.d\/rc.M:<\/b>  <\/p>\n
# Start uWSGI for cGit-ui server: if [ -x \/etc\/rc.d\/rc.cgit-ui-uwsgi ]; then   \/etc\/rc.d\/rc.cgit-ui-uwsgi start fi <\/code><\/pre>\n
  \/etc\/rc.d\/rc.6:<\/b>  <\/p>\n
# Stop uWSGI for cGit-ui server: if [ -x \/etc\/rc.d\/rc.cgit-ui-uwsgi ]; then   \/etc\/rc.d\/rc.cgit-ui-uwsgi stop fi <\/code><\/pre>\n
Nginx<\/h2>\n
  <\/p>\n
First of all, we have to add a virtual server to the main Nginx<\/b> config file:  <\/p>\n
  \/etc\/nginx\/nginx.conf:<\/b>  <\/p>\n
    include \/etc\/nginx\/vhosts\/cgit.example.org.conf; <\/code><\/pre>\n
The following configuration used uWsgi<\/b> and will serve cGit-UI<\/b> on a subdomain like cgit.example.org:  <\/p>\n
  \/etc\/nginx\/vhosts\/cgit.example.org.conf:<\/b>  <\/p>\n
# # cGit server: #      server {         listen 80;         server_name cgit.example.org;         return 301 https:\/\/cgit.example.org$request_uri;     }      server {         listen 443 ssl;         server_name cgit.example.org;         root \/var\/www\/htdocs\/cgit;          charset UTF-8;          #         # see:         #   https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/Security\/HTTP_strict_transport_security ,         #   https:\/\/raymii.org\/s\/tutorials\/HTTP_Strict_Transport_Security_for_Apache_NGINX_and_Lighttpd.html         #         # see also: http:\/\/classically.me\/blogs\/how-clear-hsts-settings-major-browsers         # and do not include includeSubdomains; parameter into line:         #         add_header Strict-Transport-Security \"max-age=63072000; preload\";          error_log \/var\/log\/nginx\/cgit.example.org-error.log;         access_log \/var\/log\/nginx\/cgit.example.org-access.log;          keepalive_timeout        60;         ssl_certificate          \/etc\/letsencrypt\/live\/cgit.example.org\/fullchain.pem;         ssl_certificate_key      \/etc\/letsencrypt\/live\/cgit.example.org\/privkey.pem;         ssl_trusted_certificate  \/etc\/letsencrypt\/live\/cgit.example.org\/chain.pem;         ssl_protocols            SSLv3 TLSv1 TLSv1.1 TLSv1.2;         ssl_ciphers              \"RC4:HIGH:!aNULL:!MD5:!kEDH\";          gzip on;         gzip_disable \"msie6\";         gzip_comp_level 6;         gzip_min_length 1100;         gzip_buffers 16 8k;         gzip_proxied any;         gzip_types text\/plain text\/css text\/js text\/xml text\/javascript                    image\/svg+xml image\/gif image\/jpeg image\/png                    application\/json application\/x-javascript application\/xml application\/xml+rss application\/javascript                    font\/truetype font\/opentype application\/font-woff application\/font-woff2                    application\/x-font-ttf application\/x-font-opentype application\/vnd.ms-fontobject application\/font-sfnt;          #         # Serve static content with nginx         #          #         # Rewrite rules for versioning CSS + JS thtouh filemtime directive         #         location ~* ^.+.(css|js)$ {             rewrite ^(.+).(d+).(css|js)$ $1.$3 last;              expires 31536000s;              access_log off;             log_not_found off;              add_header Pragma public;             add_header Cache-Control \"max-age=31536000, public\";         }          #         # Caching of static files         #         location ~* .(asf|asx|wax|wmv|wmx|avi|bmp|class|divx|doc|docx|eot|exe|gif|gz|gzip|ico|jpg|jpeg|jpe|mdb|mid|midi|mov|qt|mp3|m4a|mp4|m4v|mpeg|mpg|mpe|mpp|odb|odc|odf|odg|odp|ods|odt|ogg|ogv|otf|pdf|png|pot|pps|ppt|pptx|ra|ram|svg|svgz|swf|tar|t?gz|tif|tiff|ttf|wav|webm|wma|woff|wri|xla|xls|xlsx|xlt|xlw|zip)$ {             expires 31536000s;              access_log off;             log_not_found off;              add_header Pragma public;             add_header Cache-Control \"max-age=31536000, public\";         }          location ~* ^.+(favicon.ico|robots.txt) {             root \/var\/www\/htdocs\/cgit;             expires 30d;         }          location = \/robots.txt {             allow all;             log_not_found off;             access_log off;         }          location \/ {             try_files $uri @cgit-ui;         }          location @cgit-ui {             gzip off;             include uwsgi_params;             uwsgi_modifier1 9;             uwsgi_pass unix:\/run\/uwsgi\/cgit-ui.sock;         }     } <\/code><\/pre>\n
Configuring Git Repositories<\/h2>\n
  <\/p>\n
A detailed description of the configuration file format can be found in the cgit-ui.rc(5)<\/b><\/a> manual page:  <\/p>\n
  <\/p>\n
man 5 cgit-ui.rc <\/code><\/pre>\n
Working Example<\/h2>\n
  <\/p>\n
As an example, we will give a working configuration file in which the pkgtools.git<\/b><\/a> repository is presented.  <\/p>\n
  <\/p>\n
git-utc-offset = +0300;  clone-prefix-readonly = 'git:\/\/radix.pro'; clone-prefix          = 'git:\/\/git@radix.pro:pub';  trunk    = 'master';  snapshots = 'tar.xz';  css = '\/.cgit\/css\/cgit.css'; logo = '\/.cgit\/pixmaps\/cgit-banner-280x280.png'; logo-alt = \"Radix.pro\"; logo-link = \"https:\/\/radix.pro\"; main-menu-logo = '\/.cgit\/pixmaps\/logo\/git-logo-white-256x256.svg'; favicon-path = '\/.cgit\/pixmaps\/favicon'; syntax-highlight-css = '_cgit.css'; header = '\/.cgit\/html\/header.html'; footer = '\/.cgit\/html\/footer.html'; page-size = 200;  owner = \"Andrey V.Kosteltsev\"; author = \"Andrey V.Kosteltsev\"; title = \"Radix.pro Git Repositories\"; description = \"Git repositories hosted at radix.pro (St.-Petersburg)\"; keywords = \"cGit repositories cgit-ui web web-ui user interface Git\"; copyright = \"\u00a9 Andrey V. Kosteltsev, 2019 \u2013 2020.\"; copyright-notice = \"Where any material of this site is being reproduced, published or issued to others the reference to the source is obligatory.\";  home-page = \"https:\/\/radix.pro\/\";  section \"Tools\" {   repo 'pkgtools.git' {     owner = \"Andrey V.Kosteltsev\";     title = \"Package Tools Utilities\";     description = \"Pkgtools \u2013 is a set of utilities to create, install, remove and update packages\";     home-page = \"https:\/\/radix.pro\/\";     git-root = '\/u3\/scm\/git';     clone-prefix-readonly = 'git:\/\/git@radix.pro:git';     clone-prefix          = 'git:\/\/git@radix.pro:git';   } } <\/code><\/pre>\n
See Also<\/h2>\n
  <\/p>\n
\u00a0\u00a0\u00a0\u00a0 README<\/b><\/a>, cscmd(8)<\/b><\/a>, cgit-ui.rc(5)<\/b><\/a>  <\/p>\n
  <\/p>\n
Enjoy.  <\/p>\n<\/div>\n<\/div>\n<\/div>\n
<\/div>\n

 \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438  https:\/\/habr.com\/ru\/articles\/531646\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
<\/div>\n
\n
\n
\n
\n
cGit-UI<\/b> \u2014 is a web interface for Git<\/b> repositories. cGit-UI<\/b> is based on CGI script written in \u0421<\/b>.  <\/p>\n
  <\/p>\n
This article covers installing and configuring cGit-UI<\/b> to work using Nginx<\/b><\/a> + uWsgi<\/b><\/a>. Setting up server components is quite simple and practically does not differ from setting up cGit<\/b><\/a>.  <\/p>\n
  <\/p>\n
cGit-UI<\/b> supports Markdown<\/b> files that are processed on the server side using the md4c<\/a> library, which has proven itself in the KDE Plasma<\/b> project. cGit-UI<\/b> provides the ability to add site verification codes and scripts from systems such as Google Analytics<\/em><\/b> and Yandex.Metrika<\/em><\/b> for trafic analysis. Users who wonder to receive donations for his projects can create and import custom donation modal dialogs.  <\/p>\n
  <\/p>\n
Instead of looking at screenshots, it is better to look at the working site<\/a> to decide on installing cGit-UI<\/b><\/a> on your own server.  <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-415909","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/415909","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=415909"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/415909\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=415909"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=415909"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=415909"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}