Как передать Maven, чтобы он работал без подключения к интернету?

Организация работы Maven без интернета

Перевод Maven в режим работы без подключения к интернету (offline mode) — это комплексная задача, требующая подготовки локальной инфраструктуры для управления зависимостями и плагинами. Режим полезен для изолированных сред, обеспечения стабильных сборок или работы в строго контролируемых сетях.

Основные подходы

Ключевые стратегии включают:

1. Локальный репозиторий Nexus/Artifactory: Настройка корпоративного репозитория в локальной сети.
2. Полная предварительная загрузка зависимостей: Использование mvn dependency:go-offline и копирование всего .m2 репозитория.
3. Официальный offline режим Maven: Использование флага -o при наличии полностью заполненного локального репозитория.

Подробная реализация

1. Настройка корпоративного репозитория (рекомендуемый способ)

Установка Nexus или Artifactory в локальной сети создает централизованный источник артефактов. После настройки необходимо:

• Перенести все необходимые зависимости из публичных репозиториев (Maven Central) в локальный репозиторий через проксирование или ручную загрузку.
• Настроить settings.xml для указания только локальных репозиториев.

Пример минимального settings.xml для работы только с локальным Nexus:

<settings>
  <mirrors>
    <mirror>
      <id>nexus-mirror</id>
      <url>http://localhost:8081/repository/maven-public/</url>
      <mirrorOf>*</mirrorOf>
    </mirror>
  </mirrors>
  <profiles>
    <profile>
      <id>nexus</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>http://localhost:8081/repository/maven-public/</url>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>
</settings>

2. Полная подготовка локального репозитория пользователя (~/.m2)

Если корпоративный репозиторий недоступен, можно подготовить локальный репозиторий пользователя:

# Предварительно, при наличии интернета, загружаем все зависимости проекта и плагины
mvn dependency:go-offline

# Дополнительно можно агрегировать все артефакты из нескольких проектов
mvn dependency:copy-dependencies -DoutputDirectory=/path/to/offline-repo

# Для использования: копируем весь каталог ~/.m2/repository на целевые машины

После этого на целевой машине можно запускать Maven с флагом -o:

mvn clean install -o

3. Использование зависимостей из локальной директории (альтернативный метод)

Можно настроить Maven на использование артефактов из локальной файловой системы через специальный репозиторий file://:

<!-- В pom.xml -->
<repositories>
  <repository>
    <id>local-offline</id>
    <url>file:///opt/maven-offline-repository</url>
  </repository>
</repositories>

Критические замечания и лучшие практики

• Плагины Maven: Команда dependency:go-offline загружает только зависимости проектов, но не все плагины Maven. Для полной offline работы необходимо также предварительно выполнить полный цикл сборки (mvn clean install) всех проектов в онлайн-режиме, чтобы плагины скачались в локальный репозиторий.
• Версионность: Локальный репозиторий должен содержать точные версии всех артефактов, используемых в проектах. Использование динамических версий (например, 1.0-SNAPSHOT) или диапазонов версий в offline режиме недопустимо.
• Процесс обновления: Для обновления зависимостей в offline режиме необходим управляемый процесс: новые артефакты добавляются в локальный репозиторий через скрипты или центральный сервер, затем происходит распространение на рабочие машины.

Типичный сценарий DevOps

В DevOps-практике обычно создается Docker образ, содержащий:

• Предварительно заполненный каталог .m2/repository
• Настроенный settings.xml с указанием только локальных репозиториев
• Сам Maven

Пример Dockerfile для offline Maven:

FROM maven:3.8-openjdk-11 AS builder

# Копируем предварительно подготовленный репозиторий
COPY offline-repository /root/.m2/repository

# Копируем настроенный settings.xml
COPY settings-offline.xml /root/.m2/settings.xml

# Дальше можно выполнять сборку в offline режиме
CMD ["mvn", "clean", "install", "-o"]

Таким образом, организация работы Maven без интернета требует предварительного планирования и инфраструктурных инвестиций. Наиболее надежный способ — использование локального репозитория Nexus/Artifactory, который также обеспечивает контроль версий, безопасность и эффективное управление артефактами в корпоративной среде.