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
• Install
• Usage
• Contributing
• License

Prerequisites

This projects requires an installation of docker and docker compose.

Docker

To install docker, follow the instructions for your platform:

• Install Docker Engine | Docker Documentation > Supported platforms
• Post-installation steps for Linux

Docker Compose

• Install Docker Compose

Debian Packages

The latest version of Git (currently 2.45.2) 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.

License

Copyright © 2021 b-data GmbH

Distributed under the terms of the MIT License.