Merge branch 'develop'

.gitignore

@@ -27,6 +27,7 @@
 # Icon must end with two \r
 Icon
 
+
 # Thumbnails
 ._*
 
@@ -105,3 +106,10 @@ $RECYCLE.BIN/
 
 # Custom rules (everything added below won't be overriden by 'Generate .gitignore File' if you use 'Update' option)
 
+.env
+docker-compose.yml
+Dockerfile
+
+custom/**
+
+!.keep

.gitlab-ci.yml

+.before-script-build: &before-script-build
+  - |
+    if [[ ! -z "$CI_BUILD_PLATFORMS" ]]; then
+      export OS_ARCH=`echo $CI_BUILD_PLATFORMS | tr ' ' '\n' | \
+      sed 's|\/||2' | sed 's|\/|-|' | tr '\n' ' '`
+    fi
+  - export CI_APP_REPO=${CI_APP_REPO:-$CI_REGISTRY_IMAGE}
+  - >
+    echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER
+    --password-stdin $CI_REGISTRY
+  - |
+    if [[ -z "$GIT_LFS_VERSION" ]]; then
+      export GIT_LFS_VERSION=`sed -n "s|GIT_LFS_VERSION=\(.*\)|\1|p" sample..env`
+    fi
+
+.build:
+  image: registry.gitlab.b-data.ch/docker/docker-buildx:latest
+  stage: build
+  services:
+    - docker:dind
+  variables:
+    DOCKER_DRIVER: overlay2
+    DOCKER_TLS_CERTDIR: "/certs"
+  before_script:
+    - *before-script-build
+
+build:version-linux-amd64:
+  extends: .build
+  tags:
+    - arch:amd64
+    - os:linux
+  script:
+    - >
+      docker build
+      --build-arg IMAGE
+      --build-arg GIT_LFS_VERSION
+      -t $CI_APP_REPO:$GIT_LFS_VERSION-linux-amd64
+      -f build.Dockerfile .
+    - |
+      docker push $CI_APP_REPO:$GIT_LFS_VERSION-linux-amd64
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" && $CI_BUILD_PLATFORMS =~ /(linux\/amd64)/
+      changes:
+        - build.Dockerfile
+        - sample..env
+
+build:version-linux-arm64v8:
+  extends: .build
+  tags:
+    - arch:arm64/v8
+    - os:linux
+  script:
+    - >
+      docker build
+      --build-arg IMAGE
+      --build-arg GIT_LFS_VERSION
+      -t $CI_APP_REPO:$GIT_LFS_VERSION-linux-arm64v8
+      -f build.Dockerfile .
+    - |
+      docker push $CI_APP_REPO:$GIT_LFS_VERSION-linux-arm64v8
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" && $CI_BUILD_PLATFORMS =~ /(linux\/arm64\/v8)/
+      changes:
+        - build.Dockerfile
+        - sample..env
+
+build-manifest:version-linux-multiarch:
+  extends: .build
+  stage: deploy
+  script:
+    - |
+      for i in $OS_ARCH; do
+        export CI_MANIFEST_LIST="$CI_MANIFEST_LIST $CI_APP_REPO:$GIT_LFS_VERSION-$i"
+      done
+    - |
+      docker manifest create $CI_APP_REPO:$GIT_LFS_VERSION $CI_MANIFEST_LIST
+      if echo $OS_ARCH | grep "linux-arm64v8" >/dev/null ; then
+        docker manifest annotate --variant v8 $CI_APP_REPO:$GIT_LFS_VERSION \
+          $CI_APP_REPO:$GIT_LFS_VERSION-linux-arm64v8
+      fi
+      docker manifest push $CI_APP_REPO:$GIT_LFS_VERSION
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main"
+      changes:
+        - build.Dockerfile
+        - sample..env

CODE_OF_CONDUCT.md

+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for
+moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail
+address, posting via an official social media account, or acting as an
+appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+<info@b-data.ch>. All complaints will be reviewed and investigated
+promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

README.md

+[![minimal-readme compliant](https://img.shields.io/badge/readme%20style-minimal-brightgreen.svg)](https://github.com/RichardLitt/standard-readme/blob/master/example-readmes/minimal-readme.md) [![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active) <a href="https://benz0li.b-data.io/donate?project=4"><img src="https://benz0li.b-data.io/donate/static/donate-with-fosspay.png" alt="Donate with fosspay"></a> <a href="https://liberapay.com/benz0li/donate"><img src="https://liberapay.com/assets/widgets/donate.svg" alt="Donate using Liberapay" height="20"></a>
+
+# Git LFS install
+
+[This project](https://gitlab.com/b-data/git-lfs/glfsi) is intended for system
+administrators who want to perform an installation of Git LFS on any Linux
+distribution.
+
+## Table of Contents
+
+*  [Prerequisites](#prerequisites)
+*  [Install](#install)
+*  [Usage](#usage)
+*  [Contributing](#contributing)
+*  [License](#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](https://docs.docker.com/engine/install/#supported-platforms)
+*  [Post-installation steps for Linux](https://docs.docker.com/engine/install/linux-postinstall/)
+
+### Docker Compose
+
+*  [Install Docker Compose](https://docs.docker.com/compose/install/)
+
+## Install
+
+Clone the source code of this project:
+
+```bash
+git clone https://gitlab.com/b-data/git-lfs/glfsi.git
+```
+
+## Usage
+
+Change directory and make a copy of all `sample.` files:
+
+```bash
+cd glfsi
+
+for file in sample.*; do cp "$file" "${file#sample.}"; done;
+```
+
+In `.env`, set `GIT_LFS_VERSION` to the desired version of Git LFS
+(`<major>.<minor>.<patch>`) and `PREFIX` to the location, where you want the
+`git-lfs` programm to be installed (default: `/usr/local`).
+
+Then, create and start container _glfsi_ using options `--build` (_Build images
+before starting containers_) and `-V` (_Recreate anonymous volumes instead of
+retrieving data from the previous containers_):
+
+```bash
+docker-compose up --build -V
+```
+
+## Contributing
+
+PRs accepted.
+
+This project follows the
+[Contributor Covenant](https://www.contributor-covenant.org)
+[Code of Conduct](CODE_OF_CONDUCT.md).
+
+## License
+
+[MIT](LICENSE) © 2022 b-data GmbH

build.Dockerfile

+ARG IMAGE
+ARG PREFIX=/usr/local
+
+FROM ${IMAGE} as installer
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+ARG GIT_LFS_VERSION
+ARG PREFIX
+ARG MODE=install
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends \
+  curl \
+  ca-certificates
+
+COPY scripts/*.sh /usr/bin/
+
+RUN start.sh
+
+FROM ${IMAGE}
+
+LABEL org.opencontainers.image.licenses="MIT" \
+      org.opencontainers.image.source="https://gitlab.com/b-data/git-lfs/glfsi" \
+      org.opencontainers.image.vendor="b-data GmbH" \
+      org.opencontainers.image.authors="Olivier Benz <olivier.benz@b-data.ch>"
+
+ARG PREFIX
+
+COPY --from=installer ${PREFIX} ${PREFIX}

sample..env

+IMAGE=debian:bullseye
+
+# Git LFS version
+GIT_LFS_VERSION=3.2.0
+
+# Installation prefix
+PREFIX=/usr/local
+
+# Execution mode (default: install)
+# other: uninstall
+MODE=

sample.Dockerfile

+ARG IMAGE
+
+FROM ${IMAGE}
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+ARG GIT_LFS_VERSION
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends \
+  curl \
+  ca-certificates
+
+COPY scripts/*.sh /usr/bin/
+
+CMD ["start.sh"]

sample.docker-compose.yml

+version: '3.9'
+
+services:
+  glfsi:
+    build:
+      context: .
+      args:
+        - IMAGE=${IMAGE}
+    image: glfsi
+    container_name: glfsi
+    network_mode: host
+    volumes:
+      - ${PREFIX}:${PREFIX}
+    environment:
+      - GIT_LFS_VERSION=${GIT_LFS_VERSION}
+      - PREFIX=${PREFIX}
+      - MODE=${MODE:-install}
+    userns_mode: host

scripts/start.sh

+#!/bin/bash
+# Copyright (c) 2022 b-data GmbH.
+# Distributed under the terms of the MIT License.
+
+set -e
+
+cd /tmp
+curl -sSLO https://github.com/git-lfs/git-lfs/releases/download/v${GIT_LFS_VERSION}/git-lfs-linux-$(dpkg --print-architecture)-v${GIT_LFS_VERSION}.tar.gz
+tar xfz git-lfs-linux-$(dpkg --print-architecture)-v${GIT_LFS_VERSION}.tar.gz --no-same-owner
+cd git-lfs-${GIT_LFS_VERSION}
+
+sed -i 's/git lfs install/#git lfs install/g' install.sh
+echo '
+mkdir -p $prefix/share/man/man1
+rm -rf $prefix/share/man/man1/git-lfs*
+
+pushd "$( dirname "${BASH_SOURCE[0]}" )/man/man1" > /dev/null
+  for g in git-lfs*; do
+    install -m0644 $g "$prefix/share/man/man1/$g"
+  done
+popd > /dev/null
+
+mkdir -p $prefix/share/man/man5
+rm -rf $prefix/share/man/man5/git-lfs*
+
+pushd "$( dirname "${BASH_SOURCE[0]}" )/man/man5" > /dev/null
+  for g in git-lfs*; do
+    install -m0644 $g "$prefix/share/man/man5/$g"
+  done
+popd > /dev/null' >> install.sh
+
+echo '#!/usr/bin/env bash
+set -eu
+
+prefix="/usr/local"
+
+if [ "${PREFIX:-}" != "" ] ; then
+  prefix=${PREFIX:-}
+elif [ "${BOXEN_HOME:-}" != "" ] ; then
+  prefix=${BOXEN_HOME:-}
+fi
+
+rm -rf $prefix/bin/git-lfs*
+rm -rf $prefix/share/man/man1/git-lfs*
+rm -rf $prefix/share/man/man5/git-lfs*' > uninstall.sh
+chmod +x uninstall.sh
+
+if [[ -f "${MODE}.sh" ]]; then
+  ./${MODE}.sh
+  echo "Git LFS at ${PREFIX} ${MODE}ed."
+else
+  echo "Execution mode '${MODE}' not supported!"
+fi