Установка Gradle на Debian 11 — пошагово

Кратко (TL;DR)

Установите JDK, скачайте дистрибутив Gradle в /opt/gradle, распакуйте и добавьте каталог bin в PATH через /etc/profile.d/gradle.sh. Проверьте установку командами java -version и gradle -v. В статье — команды, проверка, варианты установки и отладка.

Gradle — универсальный инструмент сборки, ориентированный на проекты на Java, но поддерживающий и другие языки. Он использует DSL на Groovy или Kotlin и умеет инкрементально собирать, параллельно выполнять задачи и анализировать зависимости через build scans.

Зачем использовать Gradle

• Инкрементальные сборки: Gradle определяет, какие артефакты устарели, и пересобирает только их. Короткое определение: инкрементальная сборка — пересборка только изменённых частей.
• Параллельное выполнение задач: ускоряет сборку на многоядерных системах.
• Гибкость: DSL на Groovy/Kotlin даёт расширяемость и интеграцию с CI/CD.

Важно: инструкция рассчитана на Debian 11 и совместимые дистрибутивы, для корректной работы нужна версия Gradle ≥ 3.0.

Основные варианты установки (обзор)

• Ручная установка (этот гайд): скачать ZIP, распаковать в /opt, добавить в PATH — полностью контролируемый способ.
• Через пакетный менеджер apt (не всегда содержит последние версии).
• Через SDKMAN! — удобный менеджер версий для Java-экосистемы (альтернатива для разработчиков).

Требования

• Непривилегированный пользователь с sudo.
• Как минимум 1 ГБ ОЗУ.
• Установленный JDK (Java Development Kit).

Обновление системы

Перед установкой обновите пакеты:

sudo apt update && sudo apt upgrade -y

Это гарантирует, что зависимости и менеджер пакетов актуальны.

Проверка и установка Java (JDK)

Gradle требует JDK. Проверьте наличие Java:

java -version

Если Java не установлена, установите стандартный пакет JDK:

sudo apt install default-jdk -y

После установки снова выполните java -version, чтобы убедиться в корректной установке и узнать версию JDK.

Примечание: Gradle работает с разными версиями JDK; для современных версий Gradle рекомендуется JDK 8 или выше. Если вам нужна конкретная версия JDK для проекта — устанавливайте её явно (openjdk-11-jdk и т. п.).

Установка Gradle (ручной метод, рекомендуемый для контролируемых окружений)

1. Создайте каталог для установки:

sudo mkdir /opt/gradle

2. Перейдите в каталог и загрузите дистрибутив (пример для Gradle 7.2):

cd /opt/gradle
wget https://downloads.gradle-dn.com/distributions/gradle-7.2-bin.zip

3. Распакуйте архив:

unzip gradle-7.2-bin.zip

4. Убедитесь, что распаковка прошла успешно:

ls /opt/gradle/

Вы увидите каталог типа gradle-7.2 в списке.

5. Добавьте Gradle в PATH для всех пользователей, создав файл /etc/profile.d/gradle.sh:

echo "export PATH=/opt/gradle/gradle-7.2/bin:${PATH}" | sudo tee /etc/profile.d/gradle.sh

Важно: в примере выше мы явно указываем папку gradle-7.2. Если вы распаковали в каталог с другим именем, замените его соответственно.

6. Сделайте скрипт исполняемым и загрузите переменные окружения:

sudo chmod +x /etc/profile.d/gradle.sh
source /etc/profile.d/gradle.sh

После следующего входа в систему переменная PATH будет применяться автоматически.

Проверка установки Gradle

Запустите:

gradle -v

Ожидаемый вывод содержит версию Gradle, информацию о JVM и окружении.

Если команда возвращает версию — установка успешна.

Частые проблемы и их решения

• gradle: команда не найдена — проверьте путь в /etc/profile.d/gradle.sh и что вы запустили source или перезашли в сессию.
• Неверная версия Java — Gradle может требовать другую версию JDK. Проверьте java -version и, при необходимости, переключите JDK (update-alternatives или установите другую версию).
• Ошибка прав доступа при создании /opt/gradle — используйте sudo для операций, требующих прав root.
• Если unzip отсутствует: установите его sudo apt install unzip -y.

Важно: при обновлении Gradle вручную удалите старый каталог или обновите символьную ссылку, чтобы /opt/gradle/ указывал на актуальную версию.

Альтернативный способ: SDKMAN!

SDKMAN! упрощает установку и переключение между версиями Gradle и JDK для разработчика:

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle 7.2

Плюсы: лёгкое переключение версий. Минусы: устанавливается в домашний каталог пользователя, не глобально для всех.

Безопасность и привилегии

• Установка в /opt с правами root безопасна, если пакеты загружены с официального сайта.
• Проверяйте контрольные суммы (если доступны) для дистрибутивов перед распаковкой.
• Для CI-серверов предпочтительнее использовать контейнеры или системные пакеты, чтобы обеспечить воспроизводимость.

Совместимость и миграция версий

• Минимальная поддерживаемая версия Gradle по этому гайду — 3.0, но лучше использовать актуальные мажорные релизы (6.x, 7.x и выше) для новых проектов.
• При миграции между крупными версиями (например, 6→7) проверьте документацию изменений и выполните ./gradlew wrapper –gradle-version X для проектов с wrapper.

Роль‑ориентированные чек‑листы

Для разработчика:

• Установлен JDK и gradle -v возвращает версию.
• IDE настроена на использование установленного JDK/Gradle.
• В проекте есть gradle wrapper (recommended).

Для администратора CI:

• Gradle доступен для CI-пользователя.
• Проверены права доступа к /opt/gradle.
• Есть план обновления и отката версий Gradle.

Плейбук: быстрый SOP для развёртывания Gradle на сервере

1. apt update && apt upgrade -y
2. sudo apt install default-jdk unzip wget -y
3. sudo mkdir /opt/gradle && cd /opt/gradle
4. wget && unzip <архив>
5. echo “export PATH=/opt/gradle/gradle-/bin:${PATH}” | sudo tee /etc/profile.d/gradle.sh
6. sudo chmod +x /etc/profile.d/gradle.sh && source /etc/profile.d/gradle.sh
7. gradle -v — проверка

Критерии приёмки

• gradle -v возвращает корректную версию и JVM.
• Команды сборки проекта (например, gradle build) выполняются без ошибок в текущем окружении.
• CI-скрипты успешно запускают сборку с новой версией.

Краткая справка (1‑строчная глоссарий)

• Gradle: инструмент сборки для JVM-проектов с поддержкой DSL на Groovy/Kotlin.
• JDK: Java Development Kit, необходим для запуска Gradle.
• PATH: системная переменная окружения, указывающая папки для поиска исполняемых файлов.

Заключение

Вы научились: проверять/устанавливать JDK, вручную устанавливать Gradle в /opt, добавлять Gradle в PATH и проверять установку. Для разработчиков рекомендован gradle wrapper и, при необходимости, SDKMAN! для локальных переключений версий. Если возникли вопросы — оставьте комментарий с описанием ошибки и выводом команд.

Важно: перед массовым развёртыванием протестируйте процесс обновления и отката на изолированной машине.

Сводка действий:

• Обновить систему → установить JDK → скачать/распаковать Gradle → добавить в PATH → проверить gradle -v.