Сервер тестирования LFS

Сервер тестирования LFS — это пример сервера, реализующий API Git LFS. Он предназначен для использования в целях тестирования клиента Git LFS и не находится в состоянии готовности к выпуску.

Сервер тестирования LFS написан на Go с предварительно скомпилированными бинарниками для Mac, Windows, Linux и FreeBSD.

Дополнительная информация о работе над Сервером тестирования LFS и отправке патчей содержится в файле CONTRIBUTING.md.

Установка

Загрузите последнюю версию. Это одиночный бинарный файл.

Альтернативно, используйте установщик Go:

$ go install github.com/github/lfs-test-server

Кроссскомпиляция

Чтобы скомпилировать из исходников, используйте инструменты Go:

$ go get github.com/github/lfs-test-server

Запуск

Запуск бинарника запустит сервер LFS по умолчанию на localhost:8080. Несколько параметров можно настроить через переменные окружения: LFS_LISTEN # Адрес:порт, на котором сервер прослушивает соединения, по умолчанию: "tcp://:8080" LFS_HOST # Хост, используемый сервером при генерации URL, по умолчанию: "localhost" LFS_METADB # Файл базы данных, который сервер использует для хранения метаданных, по умолчанию: "lfs.db" LFS_CONTENTPATH # Путь, где хранятся файлы LFS, по умолчанию: "lfs-content" LFS_ADMINUSER # Логин администратора, по умолчанию: не установлен LFS_ADMINPASS # Пароль администратора, по умолчанию: не установлен LFS_CERT # Файл сертификата для TLS LFS_KEY # Ключ TLS LFS_SCHEME # Установите значение 'https', чтобы переопределить значение по умолчанию 'http' LFS_USETUS # Установите значение 'true', чтобы включить сервер загрузки tusd (tus.io); tusd должен находиться в PATH и быть установлен отдельно LFS_TUSHOST # Хост, используемый для запуска сервера загрузки tusd, по умолчанию "localhost:1080"Если переменные LFS_ADMINUSER и LFS_ADMINPASS установлены, примитивный интерфейс администрирования может быть доступен по адресу http://$LFS_HOST/mgmt. Здесь вы можете добавлять и удалять пользователей, что должно быть сделано до использования сервера с клиентом. Если хотя бы одна из этих переменных не установлена (что является значением по умолчанию), интерфейс администрирования будет отключен.

Чтобы использовать сервер тестирования LFS с клиентом Git LFS, настройте его в файле .gitconfig репозитория:

[lfs]
    url = "http://localhost:8080/"

HTTPS:

Замечание: При использовании HTTPS с самоподписанным сертификатом также отключите проверку сертификата в клиентском репозитории.

[lfs]
    url = "https://localhost:8080/"

[http]
    sslverify = false

Пример использования:

Сгенерировать пару ключей

openssl req -x509 -sha256 -nodes -days 2100 -newkey rsa:2048 -keyout mine.key -out mine.crt

Создайте скрипт запуска

#!/bin/bash

set -eu
set -o pipefail

LFS_LISTEN="tcp://:9999"
LFS_HOST="127.0.0.1:9999"
LFS_CONTENTPATH="content"
LFS_ADMINUSER="<cool admin user name>"
LFS_ADMINPASS="<better admin password>"
LFS_CERT="mine.crt"
LFS_KEY="mine.key"
LFS_SCHEME="https"

export LFS_LISTEN LFS_HOST LFS_CONTENTPATH LFS_ADMINUSER LFS_ADMINPASS LFS_CERT LFS_KEY LFS_SCHEME

./lfs-test-server

Сборка сервера

go build

Запустить

bash run.sh

Проверьте страницу управления

браузер: https://localhost:9999/mgmt