Как настроить Maven для использования локального репозитория компании

# Как настроить Maven для использования локального репозитория компании

1. Базовая конфигурация в settings.xml

Максимально важный файл — это ~/.m2/settings.xml. Вот как его настроить:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
    
    <!-- Локальный кеш артефактов -->
    <localRepository>/home/user/.m2/repository</localRepository>
    
    <!-- Профили с разными репозиториями -->
    <profiles>
        <profile>
            <id>company-repo</id>
            <repositories>
                <!-- Основной репозиторий компании -->
                <repository>
                    <id>company-nexus</id>
                    <name>Company Nexus Repository</name>
                    <url>https://maven.company.com/nexus/repository/maven-public/</url>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>daily</updatePolicy>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                    </snapshots>
                </repository>
                
                <!-- Central как fallback -->
                <repository>
                    <id>central</id>
                    <url>https://repo.maven.apache.org/maven2</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
            </repositories>
            
            <!-- Плагины также могут быть в компании -->
            <pluginRepositories>
                <pluginRepository>
                    <id>company-plugins</id>
                    <name>Company Plugin Repository</name>
                    <url>https://maven.company.com/nexus/repository/maven-plugins/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>
    
    <!-- Активировать профиль по умолчанию -->
    <activeProfiles>
        <activeProfile>company-repo</activeProfile>
    </activeProfiles>
    
    <!-- Аутентификация для приватного репозитория -->
    <servers>
        <server>
            <id>company-nexus</id>
            <username>maven_user</username>
            <password>{jAKVOutfBDXQLM4iWHXJ8zz7P2G0fQsKXpBXXSY6OWg=}</password>
            <!-- Пароль должен быть зашифрован! -->
        </server>
    </servers>
</settings>

2. Шифрование пароля (безопасность)

Не храни пароли в открытом виде! Maven позволяет их шифровать:

# Сначала создай master password
mvn --encrypt-master-password your-secure-password
# Результат скопируй в ~/.m2/settings-security.xml:

<settingsSecurity>
    <master>{jAKVOutfBDXQLM4iWHXJ8zz7P2G0fQsKXpBXXSY6OWg=}</master>
</settingsSecurity>

# Затем шифруй пароль сервера
mvn --encrypt-password maven_password
# Результат используй в settings.xml

3. Конфигурация в pom.xml (альтернатива)

Можно также настроить репозитории прямо в проекте:

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.company</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0</version>
    
    <repositories>
        <repository>
            <id>company-nexus</id>
            <name>Company Private Repository</name>
            <url>https://maven.company.com/nexus/repository/maven-public/</url>
            <releases>
                <enabled>true</enabled>
                <updatePolicy>daily</updatePolicy>
                <checksumPolicy>warn</checksumPolicy>
            </releases>
            <snapshots>
                <enabled>true</enabled>
                <updatePolicy>always</updatePolicy>
                <checksumPolicy>warn</checksumPolicy>
            </snapshots>
        </repository>
    </repositories>
    
    <distributionManagement>
        <!-- Куда загружать собственные артефакты -->
        <repository>
            <id>company-nexus</id>
            <name>Company Releases</name>
            <url>https://maven.company.com/nexus/repository/maven-releases/</url>
        </repository>
        <snapshotRepository>
            <id>company-nexus</id>
            <name>Company Snapshots</name>
            <url>https://maven.company.com/nexus/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>
    
    <!-- Зависимости -->
    <dependencies>
        <dependency>
            <groupId>com.company.internal</groupId>
            <artifactId>company-core-lib</artifactId>
            <version>2.1.0</version>
        </dependency>
    </dependencies>
</project>

4. Использование profiles для разных окружений

<settings>
    <profiles>
        <!-- Профиль для разработки -->
        <profile>
            <id>dev</id>
            <repositories>
                <repository>
                    <id>company-snapshots</id>
                    <url>https://maven.company.com/nexus/repository/maven-snapshots/</url>
                    <snapshots>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
        
        <!-- Профиль для production -->
        <profile>
            <id>prod</id>
            <repositories>
                <repository>
                    <id>company-releases</id>
                    <url>https://maven.company.com/nexus/repository/maven-releases/</url>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>never</updatePolicy>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
    </profiles>
    
    <activeProfiles>
        <activeProfile>dev</activeProfile> <!-- По умолчанию dev -->
    </activeProfiles>
</settings>

5. Наложение зеркала (Mirror) для всех репозиториев

Если хочешь, чтобы ВСЕ запросы ходили через корпоративный Nexus/Artifactory:

<settings>
    <mirrors>
        <mirror>
            <id>company-mirror</id>
            <mirrorOf>*,!company-internal</mirrorOf>
            <!-- Все репозитории кроме company-internal будут идти через зеркало -->
            <url>https://maven.company.com/nexus/repository/maven-public/</url>
        </mirror>
    </mirrors>
    
    <servers>
        <server>
            <id>company-mirror</id>
            <username>ci_user</username>
            <password>{encrypted_password}</password>
        </server>
    </servers>
</settings>

6. Публикация своих артефактов

Когда вы создаёте библиотеку и хотите её залить в компанейский репозиторий:

# pom.xml должен содержать distributionManagement (см выше)

# Затем просто
mvn clean deploy

# Maven автоматически найдёт server с id="company-nexus" и загрузит туда

7. Проверка конфигурации

# Показать активный профиль
mvn help:active-profiles

# Показать все репозитории
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-help-plugin:3.2.0 -Dmojo=active-profiles -Dfull=true

# Скачать artмфакт в verbose режиме
mvn dependency:get -Dartifact=com.company:lib:1.0.0 -Dverbose

# Очистить локальный кеш
rm -rf ~/.m2/repository/com/company

8. Nexus или Artifactory: различия

Sonatype Nexus

<url>https://nexus.company.com/nexus/repository/maven-public/</url>

JFrog Artifactory

<url>https://artifactory.company.com/artifactory/maven-repo/</url>

Azure DevOps Artifacts

<!-- Требует особой аутентификации -->
<repository>
    <id>azure-devops</id>
    <url>https://pkgs.dev.azure.com/company/_packaging/maven-feed/maven/v1</url>
</repository>

9. Практический пример: многоуровневая конфигурация

<settings>
    <profiles>
        <profile>
            <id>company</id>
            <repositories>
                <!-- 1. Первый пробуем компанейский Nexus -->
                <repository>
                    <id>company-nexus</id>
                    <name>Company Nexus</name>
                    <url>https://maven.company.com/nexus/repository/maven-public/</url>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>daily</updatePolicy>
                    </releases>
                </repository>
                
                <!-- 2. Fallback на Maven Central -->
                <repository>
                    <id>maven-central</id>
                    <url>https://repo.maven.apache.org/maven2</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
    </profiles>
    
    <activeProfiles>
        <activeProfile>company</activeProfile>
    </activeProfiles>
    
    <servers>
        <server>
            <id>company-nexus</id>
            <username>${env.NEXUS_USER}</username>
            <password>${env.NEXUS_PASSWORD}</password>
        </server>
    </servers>
</settings>

10. Использование CI/CD переменных

Для безопасной работы сCredentialsуя в CI/CD:

#!/bin/bash
# В CI/CD pipeline (GitHub Actions, GitLab CI, Jenkins)

echo "\${NEXUS_USER}:${NEXUS_PASSWORD}" | base64

# Затем в settings.xml можно подставлять переменные:
# <username>${env.NEXUS_USER}</username>

mvn clean deploy \
  -Dusername=$NEXUS_USER \
  -Dpassword=$NEXUS_PASSWORD

Checklist: правильная конфигурация

• ✅ ~/.m2/settings.xml настроен
• ✅ Пароль зашифрован (settings-security.xml)
• ✅ ID репозитория в settings.xml совпадает с ID в pom.xml
• ✅ URL репозитория проверен на опечатки
• ✅ Учётные данные имеют права на скачивание/загрузку
• ✅ mvn clean install работает без ошибок аутентификации
• ✅ Профиль правильно активирован

Всё это делает Maven работоспособным в корпоративной среде с приватными и локальными репозиториями!