• Русский

    • Работа с Maven

    CodeScoring.Save поддерживает Maven 2 layout и совместим с любым JVM-инструментарием поверх него: mvn, gradle, ant + Ivy / maven-ant-tasks, sbt и т. д.

    Proxy-репозиторий

    curl -X POST https://save.example.com/api/v1/repos \
  -H "Content-Type: application/json" \
  -u "<username>:<password>" \
  -d '{
    "project": "backend",
    "name": "maven-central-proxy",
    "format": "maven",
    "repository_type": "proxy",
    "remote_url": "https://repo1.maven.org/maven2/"
  }'

    Hosted-репозиторий

    curl -X POST https://save.example.com/api/v1/repos \
  -H "Content-Type: application/json" \
  -u "<username>:<password>" \
  -d '{
    "project": "backend",
    "name": "internal-maven",
    "format": "maven",
    "repository_type": "hosted"
  }'

    Настройка клиента

    mvn

    В ~/.m2/settings.xml:

    <settings>
  <mirrors>
    <mirror>
      <id>save-maven</id>
      <name>CodeScoring Save Maven</name>
      <url>https://save.example.com/maven/<project>/maven-central-proxy/</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

  <servers>
    <server>
      <id>save-maven</id>
      <username><username></username>
      <password><password></password>
    </server>
  </servers>
</settings>

    Публикация артефактов (deploy в hosted) — добавьте в pom.xml:

    <distributionManagement>
  <repository>
    <id>save-maven</id>
    <url>https://save.example.com/maven/<project>/internal-maven/</url>
  </repository>
</distributionManagement>
    mvn deploy

    gradle

    В build.gradle:

    repositories {
    maven {
        url 'https://save.example.com/maven/<project>/maven-central-proxy/'
        credentials {
            username = project.findProperty('saveUser') ?: System.getenv('SAVE_USER')
            password = project.findProperty('savePassword') ?: System.getenv('SAVE_PASSWORD')
        }
    }
}

publishing {
    repositories {
        maven {
            name = 'codescoring-save'
            url = 'https://save.example.com/maven/<project>/internal-maven/'
            credentials {
                username = project.findProperty('saveUser') ?: System.getenv('SAVE_USER')
                password = project.findProperty('savePassword') ?: System.getenv('SAVE_PASSWORD')
            }
        }
    }
}

    Или в Kotlin DSL (build.gradle.kts):

    repositories {
    maven {
        url = uri("https://save.example.com/maven/<project>/maven-central-proxy/")
        credentials {
            username = (findProperty("saveUser") ?: System.getenv("SAVE_USER")) as String
            password = (findProperty("savePassword") ?: System.getenv("SAVE_PASSWORD")) as String
        }
    }
}

    Credentials удобно хранить в ~/.gradle/gradle.properties:

    saveUser=<username>
savePassword=<password>
    Robot-аккаунты в CI

    Для CI/CD используйте robot-аккаунт: username = sa$<robot-name>, password = <api-key>. Структура settings.xml и gradle.properties не меняется — отличаются только значения. Подробнее — в общем разделе Аутентификация.

    ant

    Подход 1 — через maven-ant-tasks:

    <project xmlns:artifact="urn:maven-artifact-ant">
  <typedef resource="org/apache/maven/artifact/ant/antlib.xml"
           uri="urn:maven-artifact-ant"
           classpathref="maven-ant-tasks.classpath" />

  <artifact:remoteRepository id="codescoring"
                              url="https://save.example.com/maven/<project>/maven-central-proxy/">
    <authentication username="<username>" password="<password>" />
  </artifact:remoteRepository>

  <artifact:dependencies pathId="dependency.classpath">
    <remoteRepository refid="codescoring" />
    <dependency groupId="org.apache.commons" artifactId="commons-lang3" version="3.12.0" />
  </artifact:dependencies>
</project>

    Подход 2 — через Apache Ivy с ivysettings.xml:

    <ivysettings>
  <settings defaultResolver="codescoring" />
  <credentials host="save.example.com"
               realm="Sonatype Nexus Repository Manager"
               username="<username>"
               passwd="<password>" />
  <resolvers>
    <ibiblio name="codescoring"
             m2compatible="true"
             root="https://save.example.com/maven/<project>/maven-central-proxy/" />
  </resolvers>
</ivysettings>

    sbt

    В ~/.sbt/1.0/global.sbt:

    resolvers += "codescoring" at "https://save.example.com/maven/<project>/maven-central-proxy/"
credentials += Credentials(
  "CodeScoring Save",
  "save.example.com",
  sys.env.getOrElse("SAVE_USER", ""),
  sys.env.getOrElse("SAVE_PASSWORD", "")
)

    Миграция URL репозитория

    Сценарий использования: миграция Maven-репозитория с Nexus / Artifactory на CodeScoring.Save.

    ИсточникURL в settings.xml до миграцииURL в settings.xml после миграции
    Nexushttps://nexus.host.ru/repository/maven-remotehttps://save.example.com/maven/<project>/maven-central-proxy/
    Artifactoryhttps://jfrog.host.ru/artifactory/maven-remotehttps://save.example.com/maven/<project>/maven-central-proxy/
    Официальный репозиторийhttps://repo.maven.apache.org/maven2https://save.example.com/maven/<project>/maven-central-proxy/

    Параметры аутентификации (имя пользователя, пароль) и <servers>-блок переносятся без изменений.

    Устранение неполадок

    Проверка метаданных пакета

    curl -u "<username>:<password>" \
  https://save.example.com/maven/<project>/maven-central-proxy/org/apache/commons/commons-lang3/maven-metadata.xml

    Состояние сервиса

    curl https://save.example.com/health

    Аудит по репозиторию

    curl -u "<username>:<password>" \
  "https://save.example.com/api/v1/admin/audit?resource_type=repository&q=maven-central-proxy&limit=50"
    Страница была полезна?