Skip to content
/ gsi Public

Containerised Git source installation. Please submit Pull Requests to the GitLab repository. Mirror of

License

Notifications You must be signed in to change notification settings

b-data/gsi

Repository files navigation

minimal-readme compliant Project Status: Active – The project has reached a stable, usable state and is being actively developed. Donate using Liberapay

Containerised Git source installation

This project is intended for system administrators who want to perform a source installation of Git. It is meant for installing tagged Git releases on Debian-based Linux distributions, e.g. Ubuntu, using a docker container.

To perform a source installation of Git in your own home directory, see USER_INSTALL.md

Table of Contents

Prerequisites

This projects requires an installation of docker and docker compose.

Docker

To install docker, follow the instructions for your platform:

Docker Compose

Debian Packages

The latest version of Git (currently 2.47.1) requires the following packages at runtime:

  • libc6
  • libcurl3-gnutls
  • liberror-perl
  • libexpat1
  • libpcre2-8-0
  • perl
  • zlib1g

These packages, as well as tar and curl, must be available on the host.

Install

Download and extract the source code of this project:

curl -sSL https://gitlab.com/b-data/git/gsi/-/archive/main/gsi-main.tar.gz \
  -o gsi.tar.gz

tar -zxf gsi.tar.gz --one-top-level --strip-components=1

Usage

Change directory and make a copy of all sample. files:

cd gsi

for file in sample.*; do cp "$file" "${file#sample.}"; done;

Set IMAGE according to the host's Debian-based Linux distribution (<distribution>:<release>), GIT_VERSION to the desired version of Git (<major>.<minor>.<patch>) and PREFIX to the location, where you want the git programs to be installed (default: /usr/local).

Then, create and start container gsi using options --build (Build images before starting containers) and -V (Recreate anonymous volumes instead of retrieving data from the previous containers):

docker-compose up --build -V

Do not forget to add PREFIX[/SUBDIR]/bin to PATH when using a PREFIX within /opt.

Contributing

PRs accepted.

This project follows the Contributor Covenant Code of Conduct.

Support

Community support: Open a new discussion here.

Commercial support: Contact b-data by email.

License

Copyright © 2021 b-data GmbH

Distributed under the terms of the MIT License.