feat: install Compose v2 when apt plugin is missing

Add lib-compose-v2.sh: try docker-compose-plugin from APT only if indexed,
otherwise download official CLI plugin from GitHub Releases. quick-install
bootstraps via curl before clone; install/update reuse the helper from repo.

Co-authored-by: Cursor <cursoragent@cursor.com>

scripts/install.sh

@@ -5,6 +5,8 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 COMPOSE_FILE="${ROOT_DIR}/docker-compose.yml"
 ENV_FILE="${ENV_FILE:-${ROOT_DIR}/.env}"
+# shellcheck disable=SC1091
+source "${ROOT_DIR}/scripts/lib-compose-v2.sh"
 
 need_root() {
   if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
@@ -24,23 +26,10 @@ need_docker() {
   }
 }
 
-# Не используем legacy docker-compose 1.x (Python): KeyError ContainerConfig на новых образах.
-need_compose_v2() {
-  if docker compose version >/dev/null 2>&1; then
-    COMPOSE=(docker compose)
-    return 0
-  fi
-  echo "Ошибка: нужен Docker Compose v2 — команда «docker compose», не старый «docker-compose» 1.x из apt." >&2
-  echo "" >&2
-  echo "Установка плагина (Ubuntu/Debian):" >&2
-  echo "  sudo apt-get update && sudo apt-get install -y docker-compose-plugin" >&2
-  echo "Проверка: docker compose version" >&2
-  exit 1
-}
-
 need_root
 need_docker
-need_compose_v2
+ensure_compose_v2 || exit 1
+COMPOSE=(docker compose)
 
 if [[ ! -f "${ENV_FILE}" ]]; then
   echo "Создайте файл .env из .env.example и вставьте GHCR_* из закрытого поста Boosty:"

scripts/lib-compose-v2.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+# Функции для проверки и установки Docker Compose v2 («docker compose»).
+# Файл предназначен для source из quick-install (через curl) и из install/update.
+
+compose_plugin_download_name_for_arch() {
+  case "$(uname -m)" in
+    x86_64 | amd64)
+      printf '%s' docker-compose-linux-x86_64
+      ;;
+    aarch64 | arm64)
+      printf '%s' docker-compose-linux-aarch64
+      ;;
+    armv7l)
+      printf '%s' docker-compose-linux-armv7
+      ;;
+    *)
+      printf '%s' ''
+      ;;
+  esac
+}
+
+compose_v2_ok() {
+  docker compose version >/dev/null 2>&1
+}
+
+print_compose_v2_help_text() {
+  cat <<'EOF'
+
+Нужен Docker Compose v2 — команда «docker compose».
+
+• Быстро (если хотите ставить только плагин, без нашего автозагрузчика):
+
+  sudo mkdir -p /usr/local/lib/docker/cli-plugins
+  ARCH=$(uname -m)
+  case "$ARCH" in x86_64|amd64) N=docker-compose-linux-x86_64 ;; aarch64|arm64) N=docker-compose-linux-aarch64 ;; *) echo "Архитектура не поддерживается: $ARCH"; exit 1 ;; esac
+  sudo curl -fsSL "https://github.com/docker/compose/releases/download/v2.36.0/${N}" -o /usr/local/lib/docker/cli-plugins/docker-compose
+  sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
+  docker compose version
+
+• Если удобнее через репозиторий Docker CE (Ubuntu):
+
+  см. https://docs.docker.com/engine/install/ubuntu/
+
+  После добавления repo: sudo apt-get update && sudo apt-get install -y docker-compose-plugin
+
+• Принудительно отключить авто‑скачивание плагина из quick-install/install:
+
+  DISABLE_STANDALONE_COMPOSE_DOWNLOAD=1
+
+• Версия релиза GitHub задаётся переменной COMPOSE_CLI_VERSION (по умолчанию v2.36.0).
+EOF
+}
+
+try_apt_install_docker_compose_plugin() {
+  command -v apt-get >/dev/null 2>&1 || return 1
+  if ! apt-cache show docker-compose-plugin >/dev/null 2>&1; then
+    return 1
+  fi
+  local cand=""
+  cand="$(apt-cache policy docker-compose-plugin 2>/dev/null | awk '/^  Candidate:/ {print $2; exit}')"
+  if [[ -z "${cand}" || "${cand}" == "(none)" ]]; then
+    return 1
+  fi
+
+  echo "→ APT: устанавливаю docker-compose-plugin..." >&2
+  DEBIAN_FRONTEND=noninteractive apt-get update -qq ||
+    DEBIAN_FRONTEND=noninteractive apt-get update
+  DEBIAN_FRONTEND=noninteractive apt-get install -y docker-compose-plugin
+}
+
+install_compose_v2_cli_plugin_standalone() {
+  local name version url plugin_dir tmp target
+
+  name="$(compose_plugin_download_name_for_arch)"
+  if [[ -z "${name}" ]]; then
+    echo "Ошибка: архитектура $(uname -m) не поддерживается авто‑установкой Compose v2." >&2
+    return 1
+  fi
+
+  version="${COMPOSE_CLI_VERSION:-v2.36.0}"
+  url="https://github.com/docker/compose/releases/download/${version}/${name}"
+  plugin_dir="${COMPOSE_CLI_PLUGIN_DIR:-/usr/local/lib/docker/cli-plugins}"
+  target="${plugin_dir}/docker-compose"
+  tmp="${target}.tmp.$$"
+
+  echo "→ Скачиваю Docker Compose ${version} → ${target}" >&2
+  mkdir -p "${plugin_dir}"
+  curl -fsSL "${url}" -o "${tmp}"
+  chmod +x "${tmp}"
+  mv -f "${tmp}" "${target}"
+}
+
+# Требует root для APT/записи в /usr/local (у standalone).
+ensure_compose_v2() {
+  if compose_v2_ok; then
+    return 0
+  fi
+
+  echo "Не найдена команда «docker compose» (Compose v2)." >&2
+  echo "Старый «docker-compose» 1.x из apt здесь не подходит (ошибка ContainerConfig на новых образах)." >&2
+
+  if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
+    print_compose_v2_help_text >&2
+    return 1
+  fi
+
+  if try_apt_install_docker_compose_plugin && compose_v2_ok; then
+    docker compose version | head -n1 >&2
+    return 0
+  fi
+
+  if [[ "${DISABLE_STANDALONE_COMPOSE_DOWNLOAD:-}" == "1" ]]; then
+    print_compose_v2_help_text >&2
+    return 1
+  fi
+
+  if ! install_compose_v2_cli_plugin_standalone || ! compose_v2_ok; then
+    print_compose_v2_help_text >&2
+    return 1
+  fi
+
+  docker compose version | head -n1 >&2
+}

scripts/update.sh

@@ -3,19 +3,16 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 ENV_FILE="${ENV_FILE:-${ROOT_DIR}/.env}"
 COMPOSE_FILE="${ROOT_DIR}/docker-compose.yml"
+# shellcheck disable=SC1091
+source "${ROOT_DIR}/scripts/lib-compose-v2.sh"
 
 if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
   echo "Запустите от root."
   exit 1
 fi
 
-if docker compose version >/dev/null 2>&1; then
-  COMPOSE=(docker compose)
-else
-  echo "Ошибка: нужен Docker Compose v2 («docker compose»). Старый docker-compose 1.x не поддерживается." >&2
-  echo "  sudo apt-get update && sudo apt-get install -y docker-compose-plugin" >&2
-  exit 1
-fi
+ensure_compose_v2 || exit 1
+COMPOSE=(docker compose)
 
 set -a
 # shellcheck disable=SC1090