Установка Gradle на Ubuntu 22.04

Логотип Gradle и схема процесса сборки проекта

Кратко

В этом руководстве показано, как установить Gradle на Ubuntu 22.04 двумя способами: через snap и вручную (скачивание дистрибутива). Приведены команды, проверка установки, советы по переменным окружения и краткие сценарии устранения неполадок.

Почему это важно

Gradle — гибкий инструмент автоматизации сборки для проектов на Java и других языках. Правильная установка упрощает сборку, управление зависимостями и интеграцию в CI/CD.

Содержание

Требования
Обновление системы
Установка Java (JDK)
Установка Gradle через snap
Установка Gradle вручную (из архива)
Настройка переменных окружения
Проверка установки
Устранение неполадок и альтернативные варианты
Контрольные списки и критерии приёмки
Итог

Требования

Сервер или рабочая станция с Ubuntu 22.04.
Доступ root или пользователь с правами sudo.

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

Сначала обновите пакеты системы до последних версий:

apt update -y  
apt upgrade -y

Затем установите необходимые утилиты:

apt install wget unzip -y

После этого можно переходить к установке Java и Gradle.

Установка Java JDK

Gradle работает поверх JVM, поэтому требуется установленный JDK. На Ubuntu проще всего установить системную версию по умолчанию:

apt install default-jdk -y

Проверьте установку:

java -version

Пример ожидаемого вывода:

openjdk version "11.0.17" 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

Если версия не отображается или команда не найдена, проверьте установку пакета default-jdk и переменные PATH/JAVA_HOME.

Установка Gradle через Snap

Установка через snap — самый быстрый способ получить Gradle и автоматически получать обновления от snap-репозитория.

Установите snapd (если ещё не установлен):

apt install snapd -y

Затем установите Gradle:

snap install gradle --classic

Проверьте версию:

gradle -v

Ожидаемый краткий вывод:

Welcome to Gradle 7.6!

Important: snap-пакеты запускаются в собственной среде; если вы используете изолированные CI-агенты или контейнеры, убедитесь, что snap поддерживается в вашей среде.

Установка Gradle вручную (из архива)

Ручная установка полезна, если нужен конкретный релиз Gradle или если вы работаете в окружении без snap.

Скачивание Gradle

Перейдите в /opt и скачайте архив с официального зеркала. В примере используется Gradle 7.6 (как в исходном руководстве):

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

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

unzip gradle-7.6-bin.zip

Переименуйте директорию для более удобного пути:

mv gradle-7.6 gradle

Проверьте содержимое:

ls /opt/gradle

Ожидаемый вывод:

bin  init.d  lib  LICENSE  NOTICE  README

Настройка переменных окружения

Создайте файл /etc/profile.d/gradle.sh для системного размещения переменных (будут доступны всем пользователям):

nano /etc/profile.d/gradle.sh

Добавьте строки:

export GRADLE_HOME=/opt/gradle
export PATH=${GRADLE_HOME}/bin:${PATH}

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

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

Если вы предпочитаете настраивать Gradle только для одного пользователя, поместите аналогичные строки в ~/.profile или ~/.bashrc.

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

После установки проверьте Gradle:

gradle -v

Пример расширенного вывода для Gradle 7.6:

Welcome to Gradle 7.6!

Here are the highlights of this release:
 - Added support for Java 19.
 - Introduced `--rerun` flag for individual task rerun.
 - Improved dependency block for test suites to be strongly typed.
 - Added a pluggable system for Java toolchains provisioning.

For more details see https://docs.gradle.org/7.6/release-notes.html


------------------------------------------------------------
Gradle 7.6
------------------------------------------------------------

Build time:   2022-11-25 13:35:10 UTC
Revision:     daece9dbc5b79370cc8e4fd6fe4b2cd400e150a8

Kotlin:       1.7.10
Groovy:       3.0.13
Ant:          Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM:          11.0.17 (Ubuntu 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OS:           Linux 5.15.0-53-generic amd64

Если вывод похож на приведённый, установка успешна.

Устранение неполадок — типовые ошибки и решения

gradle: команда не найдена
- Убедитесь, что GRADLE_HOME/bin добавлен в PATH и вы выполнили source /etc/profile.d/gradle.sh или перезашли в сеанс терминала.
Неверная версия Java или несовместимость
- Gradle требует JDK; проверьте java -version. Для некоторых проектов может требоваться OpenJDK 17 или выше.
Проблемы с правами в /opt
- Убедитесь, что директория /opt/gradle доступна для чтения всем пользователям. Для записи используйте sudo при установке.
Snap не устанавливается в контейнере
- В контейнеризированных средах snapd часто не поддерживается; используйте ручную установку или SDKMAN (см. раздел «Альтернативы»).

Альтернативные способы установки

SDKMAN!: менеджер версий для JVM-инструментов (удобен для переключения между версиями Gradle и JDK).
Менеджер пакетов дистрибутива: apt обычно содержит устаревшие версии Gradle — не рекомендуется для последних релизов.
Docker-контейнер с предустановленным Gradle: подходит для CI-пайплайнов.

Пример установки через SDKMAN!: (установите SDKMAN! по инструкции на https://sdkman.io/, затем)

sdk install gradle 7.6

Контрольные списки (роли)

Для разработчика:
- Проверить java -version и gradle -v.
- Убедиться, что сборка проекта gradle build выполняется локально.
Для администратора системы:
- Проверить права на /opt/gradle и содержимое /etc/profile.d/gradle.sh.
- Настроить автоматическое обновление при необходимости (snap) или план обновления при ручной установке.
Для инженера CI/CD:
- Решить, использовать ли системную установку, snap, SDKMAN! или Docker-образ для агентa
- Убедиться, что агенты сборки используют одинаковую версию Gradle.

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

gradle -v возвращает информацию о версии без ошибок.
gradle build успешно проходит для простого Java-проекта (пример: gradle init; gradle build).
Переменные окружения GRADLE_HOME и PATH настроены корректно для необходимых пользователей.

Фактбокс — ключевые сведения

Пример релиза, упомянутого в руководстве: Gradle 7.6
JVM: пример вывода показывает OpenJDK 11.0.17
Связанные компоненты: Kotlin 1.7.10, Groovy 3.0.13

Краткие рекомендации по безопасности и сопровождению

Проверяйте подписи и контрольные суммы скачиваемых архивов Gradle на официальном сайте при установке вручную.
В корпоративной среде используйте зеркала и прокси для управления зависимостями.
Для автоматических обновлений предпочитайте snap или контейнеры с управлением версиями.

Итог

Вы успешно установили и проверили Gradle на Ubuntu 22.04. Выберите способ установки (snap, ручной, SDKMAN!, Docker) в зависимости от требований окружения и политики обновлений. Если возникнут вопросы или ошибки, проверьте раздел «Устранение неполадок» и контрольные списки.