Maven 프로젝트의 버전 관리를 단순화하기 위해 flatten-maven-plugin을 사용한 경험

회사 소개

1C에서는 플랫폼뿐만 아니라 개발합니다. 1C: 기업 에 C ++ и 자바 스크립트, Java 애플리케이션, 특히 새로운 개발 환경 엔터프라이즈 개발 도구 Eclipse 기반 및 플랫폼과 긴밀하게 통합된 메신저 서버 - 상호작용 시스템.

기입

우리는 Java 애플리케이션의 빌드 시스템으로 Maven을 가장 자주 사용합니다. 이 짧은 기사에서는 개발을 구성하는 과정에서 직면해야 했던 문제 중 하나와 이를 극복할 수 있는 접근 방식에 대해 이야기하고 싶습니다. 문제.

필수 구성 요소 및 워크플로

Maven 프로젝트의 개발 특성으로 인해 우리는 꽤 많은 모듈, 종속성 및 하위 프로젝트를 사용합니다. 한 트리의 pom 파일 수는 수십 또는 수백 개가 될 수 있습니다.

그것은 별것 아닌 것처럼 보일 것입니다. 그들은 그것을 한 번 만들고 잊어 버렸습니다. 한 번에 모든 파일의 내용을 변경하거나 추가해야 하는 경우 편집기와 IDE에 편리한 도구가 많이 있습니다. pom.xml에 대한 가장 일반적인 정기적 변경 사항은 무엇입니까? 우리는 프로젝트 버전 및 종속성이 변경되었다고 믿습니다. 아마도 누군가는 이것에 대해 논쟁하고 싶을 것입니다. 그러나 이것이 바로 우리의 상황입니다. 그 이유는 커널과 함께 많은 자체 라이브러리를 동시에 개발하고 있으며 빌드 및 테스트 결과의 지속적인 재현성을 위해 스냅샷을 사용하는 것이 편리한 접근 방식이 아닌 것 같습니다. 이러한 이유로 각 빌드마다 프로젝트의 버전 번호를 높여야 합니다.

또한 때때로 개발자는 자신의 라이브러리 분기를 구축하고 모든 종속성에 대해 해당 기능을 확인해야 하며, 이 경우 모든 라이브러리의 버전을 수동으로 변경해야 합니다.

초기 솔루션

이처럼 빈번하고 다양한 버전 변경으로 인해 CI 내 프로세스를 단순화하고 자동화하고 싶습니다. 편리하고 잘 알려진 플러그인이 구출되는 곳입니다. 버전-maven-플러그인 - 연결하고 실행하세요

mvn -N 버전:set -DnewVersion=2.0.1

그리고 Maven은 필요한 대로 모든 작업을 수행합니다. 계층 구조를 위에서 아래로 실행하여 모든 버전을 대체합니다. 이제 남은 것은 끌어오기 요청을 제출하는 것뿐입니다. 그러면 동료들이 변경 사항을 검토하고 신속하게 트렁크에 참여할 수 있습니다. 빠르게? 그것이 어떻든 상관 없습니다. 이백 pom.xml 검토용이며 이는 코드를 계산하지 않습니다. 또한 이렇게 많은 변경된 파일로 인한 병합 충돌로부터 누구도 안전하지 않습니다. CI 프로세스에서 버전 변경은 기능 변경과 함께 자동으로 발생하며 별도로 발생하지 않는다는 점에 유의해야 합니다.

새로운 기능

한동안 우리는 진정하고 사임하고 그 사람들이 나올 때까지 그렇게 살았습니다. 메이븐 아파치 프로젝트 버전 3.5.0-beta-1부터 Maven에는 소위 "자리 표시자"에 대한 지원이 포함되지 않았습니다. 이 대체품의 핵심은 다음과 같습니다. pom.xml 프로젝트 버전을 구체적으로 표시하는 대신 변수가 사용됩니다. ${개정}, ${sha1} и ${변경 목록}. 이러한 속성 자체의 값은 요소에서 설정됩니다.속성> 또는 시스템 속성을 통해 정의할 수 있습니다.

mvn -Drevision=2.0.0 클린 패키지

시스템 속성 값은 다음에 정의된 값보다 우선합니다.속성>.

부모의

  4.0.0
  
    org.apache
    아파치
    18
  
  org.apache.maven.ci
  친부모
  첫 번째 CI 친화적
  ${개정}${sha1}${변경 목록}
  ...
  
    1.3.1
    -스냅 사진
    
  


후손

  4.0.0
  
    org.apache.maven.ci
    친부모
    ${개정}${sha1}${변경 목록}
  
  org.apache.maven.ci
  ci-child
   ...

버전 2.0.0-SNAPSHOT을 빌드하려면 다음을 사용하세요.

    mvn -Drevision=2.0.0 클린 패키지

출시하고 싶다면 SNAPSHOT을 재설정하세요.

    mvn -Dchangelist= 패키지 정리

*위의 예시는 다음에서 발췌한 것입니다. 조항 Maven Apache Project 웹사이트

가혹한 현실

모든 것이 좋고 건강하며 이제 만족감을 느낄 때이지만 그렇지 않습니다. 이 방법은 저장소에 게시된 아티팩트 설명에서 대체되지 않으므로 설치 및 배포에는 작동하지 않는 것으로 나타났습니다. ${개정} 그 의미에 대해 알아보면 메이븐은 더 이상 그것이 무엇인지 이해하지 못할 것입니다.

    org.apache
    아파치
    ${개정}

터널 끝의 빛

우리는 문제에 대한 해결책을 찾아야 합니다. 상황을 살릴 수도 있었을 텐데 flatten-maven-플러그인. 이 플러그인은 pom의 모든 변수를 확인하지만 동시에 어셈블리 중에만 필요하고 게시된 아티팩트를 다른 프로젝트로 가져올 때는 필요하지 않은 많은 정보를 잘라냅니다. 플러그인은 또한 모든 부모-자식 종속성을 "정리"하므로 결과적으로 필요한 모든 것을 포함하는 플랫 폼을 얻을 수 있습니다. 불편한 점은 "추가"를 너무 많이 잘라내는 것인데, 이는 우리에게 전혀 적합하지 않았습니다. 이 플러그인 개발에 대한 정보를 연구한 결과, 우주에 우리가 유일한 것이 아니라는 사실이 밝혀졌으며, 이를 가능하게 하려는 목적으로 2018년 1.1.0월 Github의 플러그인 저장소에 풀 요청이 생성되었습니다. pom.xml을 "훼손"하는 방법을 스스로 결정합니다. 개발자들은 고통받는 사람들의 목소리에 귀를 기울였고, 이미 XNUMX월 새 버전 XNUMX의 출시와 함께 새로운 모드인solveCiFriendliesOnly가 flatten-maven-plugin에 등장했는데, 이는 그 어느 때보다 적합했습니다. pom.xml 요소를 제외하고 있는 그대로 그리고 허용 ${개정}, ${sha1} и ${변경 목록}.

프로젝트에 플러그인 추가

  
    org.codehaus.mojo
    flatten-maven-플러그인
    1.1.0
    
      진실
      해결CiFriendlies만
    
    
      
        단조롭게 하다
        프로세스 리소스
        
          단조롭게 하다
        
      
      
        평평하게 하다.청소하다
        깨끗한
        
          깨끗한
        
      
    
  

완료!

행복한 결말

이제부터 전체 프로젝트의 버전을 변경하고 모든 종속성에 이를 알리려면 요소를 편집하면 됩니다.개정> 루트에만 있음 pom.xml. 동일한 변경 사항이 포함된 파일 중 백두 개가 아닌 하나가 검토에 도착합니다. 뭐, 쓸 필요는 없지 버전-maven-플러그인.

출처 : habr.com