Разработка и Git

Архив релиза из Git

Создаёт tar.gz только из отслеживаемых файлов указанного тега или коммита и считает SHA-256.

Shell Linux macOS Средний
Скачать release-archive.sh
Описание

Что делает скрипт

Скрипт использует git archive, поэтому в архив не попадают ignored-файлы, локальные секреты и мусор сборки. По умолчанию показывается ссылка, число файлов и имя архива. С флагом --apply создаётся tar.gz и файл контрольной суммы, существующий архив не перезаписывается без --force.

Перед запуском
  • С --apply в папке dist появятся tar.gz и файл .sha256.
Запуск

Быстрый старт

bash release-archive.sh --repo . --ref v1.2.0 --out dist --apply

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash release-archive.sh --repo . --ref HEAD
  • bash release-archive.sh --repo . --ref v1.2.0 --version 1.2.0 --out dist --apply
Зависимости

Что понадобится

Git 2.40+ Система контроля версий
Linux sudo apt install git
macOS brew install git
Bash 4+ Стандартные find, sed, sort и awk
Linux sudo apt install bash
macOS brew install bash
Исходник

release-archive.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    cat <<'EOF'
Использование: release-archive.sh [--repo ПАПКА] [--ref ССЫЛКА]
                                  [--version ВЕРСИЯ] [--out ПАПКА]
                                  [--apply] [--force]
Без --apply архив не создаётся.
EOF
}

repo="."
ref="HEAD"
version=""
out="dist"
apply=0
force=0

while [[ $# -gt 0 ]]; do
    case "$1" in
        --repo) repo="${2:-}"; shift 2 ;;
        --ref) ref="${2:-}"; shift 2 ;;
        --version) version="${2:-}"; shift 2 ;;
        --out) out="${2:-}"; shift 2 ;;
        --apply) apply=1; shift ;;
        --force) force=1; shift ;;
        -h|--help) usage; exit 0 ;;
        *) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
    esac
done

die() { echo "$1" >&2; exit 2; }

[[ -d "$repo" ]] || die "Папка не найдена: $repo"
command -v git >/dev/null 2>&1 || die "Не найден git."
git -C "$repo" rev-parse --is-inside-work-tree >/dev/null 2>&1 || die "Это не git-репозиторий."
git -C "$repo" rev-parse --verify "$ref^{commit}" >/dev/null 2>&1 || die "Не найдена ссылка: $ref"

root="$(git -C "$repo" rev-parse --show-toplevel)"
name="$(basename "$root")"
if [[ -z "$version" ]]; then
    version="$(git -C "$repo" describe --tags --always --dirty 2>/dev/null || git -C "$repo" rev-parse --short HEAD)"
fi

version="${version//\//-}"
version="${version// /-}"
archive="$name-$version.tar.gz"

case "$out" in
    /*) out_abs="$out" ;;
    *) out_abs="$(pwd)/$out" ;;
esac
target="$out_abs/$archive"

files="$(git -C "$repo" ls-tree -r --name-only "$ref" | wc -l | tr -d ' ')"
echo "Репозиторий: $root"
echo "Ссылка:      $ref ($(git -C "$repo" rev-parse --short "$ref"))"
echo "Файлов:      $files"
echo "Архив:       $target"

if [[ -e "$target" && "$force" -eq 0 ]]; then
    die "Архив уже существует. Добавьте --force для замены."
fi

if [[ "$apply" -eq 0 ]]; then
    echo
    echo "Это предпросмотр. Для создания архива добавьте --apply."
    exit 0
fi

mkdir -p "$out_abs"
git -C "$repo" archive --format=tar.gz --prefix="$name-$version/" -o "$target" "$ref"

if command -v sha256sum >/dev/null 2>&1; then
    (cd "$out_abs" && sha256sum "$archive" > "$archive.sha256")
elif command -v shasum >/dev/null 2>&1; then
    (cd "$out_abs" && shasum -a 256 "$archive" > "$archive.sha256")
else
    echo "Не найден sha256sum или shasum, контрольная сумма не создана." >&2
fi

echo
echo "Готово: $target"
du -h "$target" | awk '{print "Размер: " $1}'

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get dev-release-archive
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Разработка и Git

Git, сборка, тесты, зависимости, логи и обслуживание проектов.