Импорт стороннего проекта в хранилище артефактов Maven

Tweet Для проектов, артефакты которых не доступны в публичных хранилищах, можно хранить артефакты в собственном хранилище. Собственно задача делится на два этапа - изготовление артефакта и деплой его в хранилище.

Изготовление одиночного артефакта вполне можно выполнить и вручную, равно как и задеплоить его в хранилище используя mvn deploy:deploy-file.

Для регулярного импорта стороннего проекта гораздо удобнее создать собственный проект импорта.

Для примера могу привести проект который создает артефакт - архив tar.gz, используя последнюю версию кода доступную на github.com и деплоит его в хранилище в локальной сети.

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  4.0.0
  local.test.import
  githubtest
  pom
  1.0
  githubtest
  

    scm:git:git://github.com/<путь к проекту>.git
    http://github.com/<адрес>
  
  
    
      

        org.apache.maven.plugins
        maven-scm-plugin
        1.3
        
          
            checkout

            generate-sources
            

              checkout
            


          
        
      
      

        org.apache.maven.plugins
        maven-assembly-plugin
        2.2-beta-5
        
          

            assembly.xml
          

          
            ${project.build.directory}/checkout
          
        
        
          
            make-assembly
            package
            
              single
            
          
        
      
      

        maven-deploy-plugin
        

            true
        
        
          
            deploy-assembly

            deploy
            

              deploy-file
            
            

              releases
              http://beast-server/nexus/content/repositories/releases

                
${project.build.directory}/${project.artifactId}-${project.version}.tar.gz
                

              tar.gz
              ${project.groupId}
              ${project.artifactId}
              ${project.version}
            
          
        
      
    
  
   
        
            releases
            http://beast-server/nexus/content/repositories/releases
        
        
            snapshots
            http://beast-server/nexus/content/repositories/snapshots
        
    

assembly.xml содержить простой набор правил - cоздать архив tar.gz в который включить все что находится в текущей директории.

xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0
http://maven.apache.org/xsd/assembly-1.1.0.xsd">
  

    tar.gz
  
  false
  
    
      ./
    
  

Итог - Пример проекта который создает артефакт из исходников и деплоит его в хранилище.

Дистрибутив Erlang в хранилище Maven

Tweet Для начала необходимо получить дистрибутив Erlang для целевой системы в виде артефакта. Erlang уже присутствует в хранилищах пакетов для многих дистрибутивов Linux, но может содержать патчи значительно усложняющие мобильность дистрибутива. Для этого примера я собрал "чистый" экземпляр основанный на исходных кода с офф. сайта http://www.erlang.org/download.html

$ ./configure --prefix=/tmp/erlang
$ make install
$ cd /tmp/erlang/lib/erlang/

Архиватор используемый Maven по умолчанию некорректно распаковывает ссылки из tar.gz. Для распаковки можно воспользоваться Exec Maven Plugin или не включать их в архив. Ссылка будет создана при вызове скрипта Install, так что я ее просто удаляю.

$ rm ./bin/epmd

Потом архивирую всю директорию и деплою получившийся архив в свое хранилище.

$ tar -czf ../erlang-R13B4-linux_x86_64.tar.gz ./
$ mvn deploy:deploy-file -DartifactId=erlang-otp -Dpackaging=tar.gz \
-DgroupId=local.test.erlang.linux-x86-64 -Dversion=R13B4 \
-Dfile=../erlang-R13B4-linux_x86_64.tar.gz \
-Durl=http://beast-server/nexus/content/repositories/releases  \
-DrepositoryId=releases

Подключение не составляет проблемы, но развертывание дистрибутива Erlang будет производиться каждый раз при прохождении фазы обработки ресурсов. Что бы дистрибутив разворачивался только один раз, операции относящиеся к развертыванию можно вынести в профиль, который активируется основываясь на отсутствии файлов. Подробности о профилях Maven можно узнать из Introduction to Build Profiles.

  4.0.0
  local.erlang.test
  test-erlang-maven
  erlang-otp
  1.0-SNAPSHOT
  A custom Erlang project
  http://www.myorganization.org

  
    
      local.test.erlang.linux-x86-64
      erlang-otp
      R13B4
      tar.gz
      compile
    
  

  
    
      
        net.sf.maven-erlang
        erlang-plugin
        true
        
          
          
          ${project.build.directory}/erlang
          
          
          
          true
          
          
          
          true
          
          
          
          false
          
          
          
          
          
          
          
          true
          
          
          
          
          
          true
          
          
          
          
          
          
        
      
    
  

  
    
      
        net.sf.maven-erlang
        erlang-plugin
        
          
          
          
          
          
          
        
      
      
        maven-surefire-report-plugin
      
    
  
  
    
      setup_erlang_dist
      
        
          target/erlang/Install
        
      
      
        
          
            org.apache.maven.plugins
            maven-dependency-plugin
            
              
                unpack-erlang-dist
                process-resources
                
                  unpack
                
                
                  
                    
                      local.test.erlang.linux-x86-64
                      erlang-otp
                      R13B4
                      tar.gz
                      false
                      
                        ${project.build.directory}/erlang
                      
                    
                  
                
              
            
          
          
            org.codehaus.mojo
            exec-maven-plugin
            1.1
            
              
                configure-erlang-dist
                process-resources
                
                  exec
                
                
                  ${project.build.directory}/erlang/Install
                  
                    -sasl
                    ${project.build.directory}/erlang
                  
                
              
            
          
        
      
    
  

Теперь можно проверить работу:

$ mvn package

При первом запуске будет развернут дистрибутив Erlang, что потребует некоторое время. При последующих запусках дистрибутив Erlang уже будет существовать и они будут выполняться гораздо быстрее.

Итог: Дистрибутив Erlang добавлен в хранилище артефактов как артефакт и доступен любому хосту использующему это хранилище. Дистрибутив Erlang может быть подключен к проекту и развернут при необходимости. Кроме распаковки можно так же произвести дополнительную настройку используя, к примеру, Exec Maven Plugin.

Maven для Erlang

Tweet Maven 2 - это система сборки изначально ориентированная на Java приложения.
Однако благодаря системе плагинов Maven способен работать с любым языком и на любой платформе (где запустится Java). Именно это делает Maven весьма интересным кандидатом на роль основной системы сборки при старте мультиязычного проекта или нескольких связанных проектов на разных языка программирования.
К достоинствам Maven так же можно понятие репозитария артефактов - хранилища в котором можно разместить что угодно. Все что доступно в хранилище, легко подключается к проекту.
К тому же для многих Continuous Integration серверов уже есть готовые плагины/расширения для взаимодействия с Maven.
Подробности установки Maven доступны на официальном сайте - здесь.

А краткая инструкция выглядит так:

1. Установить JDK
2. Скачать и распаковать архив Maven
3. Создать или обновить системные переменные так, чтобы JAVA_HOME указывал на JDK и PATH включал в себя путь к директории /bin распакованного Maven.

Nexus - это одна из реализаций хранилища артефактов. Nexus доступен в двух версиях - Open Source и Professional. Подробное сравнение этих версий доступно здесь. Впрочем даже Nexus Open Source способен проксировать удаленные и хостить местные хранилища.
Подробности установки и настройки Nexus превосходно описаны в Nexus Book.

Краткая инструкция для Nexus Open Source:

1. Установить Tomcat
2. Скачать последнюю версию Nexus в виде war
3. Переименовать nexus-webapp-x.x.x.war в nexus.war
4. Задеплоить nexus.war используя менеджер Tomcat

После этого необходимо настроить Maven на его использование. Это делается добавлением в ~/.m2/settings.xml следующих строк:

   
       
           
           nexus
           *
           http://beast-server/nexus/content/groups/public
       
   
   
       
           nexus
           
           
           
               
                   central
                   http://central
                   true
                   true
               
           
           
               
                   central
                   http://central
                   true
                   true
               
           
       
   
   
       
       nexus
   
   
       
           releases
           deployment
           deployment123
       
       
           snapshots
           deployment
           deployment123
       
   

Более подробно это описано в Nexus Book.

Теперь можно приступить к Erlang. Для взаимодействия с Erlang у Maven есть плагин - Erlang Maven Plugin
Его нет в публичных хранилищах, так что надо будет собрать его из исходников:

$ svn co https://maven-erlang.svn.sourceforge.net/svnroot/maven-erlang maven-erlang

Чтобы не повторять эти операции на каждом хосте который будет использовать этот плагин, его необходимо задеплоить в хранилище. Для этого необходимо добавить в pom.xml информацию о нашем хранилище в секцию distributionManagement:

$ cd ./maven-erlang/maven-erlang/trunk/
$ vim ./pom.xml

       
           releases
           http://beast-server/nexus/content/repositories/releases
       
       
           snapshots
           http://beast-server/nexus/content/repositories/snapshots
       

Теперь необходимо запустить

$ mvn deploy -Dmaven.test.skip=true

-Dmaven.test.skip=true необходим поскольку некоторые юнит тесты не проходят с последними версиями Erlang. В качестве альтернативы можно прописать версии kernel, stdlib и mnesia из вашего екземпляра Erlang в erlang-plugin/trunk/src/test/resources/mojo-test-release-1/src/main/erlang/release_name.rel и использовать

$ mvn deploy

Итог:

• Установлен Maven
• Развернуто хранилище артефактов
• В хранилище добавлен Erlang Maven Plugin

Portius - сервер репозитария для Faxien

Tweet Portius согласно документации это инструмент копирующий пакеты из одного репозитария в другой, фильтрующий битые/неправильные пакеты, извлекающий документацию и т.п. вещи из пакета и размещающий извлеченные вещи по местам.

Звучит страшно, поэтому мне больше нравится формулировка Portius - это сервер хранилища артефактов Faxien. К тому же это гораздо лучше описывает текущий функционал Portius.

Установка элементарна:

$ faxien ir portius

Опций командной строки на данный момент всего три: путь к корневой директории репозитария и номер порта или use_config - использовать путь и порт из sys.config

portius <document-root> <port-number>

Скринкаст от Мартина Логана (Martin Logan) - Как создать репозитарий Erlware используя Portius.

Faxien/Sinan для Erlang

Tweet Для удобной разработки приложений Erlang существуют следующие инструменты:

• Faxien - система управления пакетами Erlang/OTP
• Sinan - система сборки
  

Сначала надо получить faxien-launcher-universal-x.x.x.py c http://code.google.com/p/faxien/

И запустить его:

$ python ./faxien-launcher-universal-0.3.5.py

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

$ ~/lib/erlang/bin/faxien help

Faxien is a powerful package manager for the Erlang language. This
message is the gateway into further Faxien help.

Usage:
faxien help
faxien version
faxien  [options|arguments...]

More Help:
faxien help commands: Lists all faxien commands
faxien help <command>: Gives help on an individual command
faxien help examples: Lists example usages of faxien
faxien alias: lists faxien command aliases

Short Examples:
faxien install-release sinan
faxien search yaws
faxien help search
ok

$ ~/lib/erlang/bin/faxien help commands

Commands:
help                    print help information
search                  search for remote packages
installed               list the packages installed on the local system
describe-app            print more information about a specific
                      application package
install-release         install a release package
fetch-release           fetch a release package into the specified
                      directory
install-app             install an application package
fetch-app               fetch an application package into the specified
                      directory
publish                 publish a package to remote repositories
remove-release          uninstall a release package
remove-app              uninstall an application package
upgrade-release         upgrade a release package installed on the
                      local system
upgrade-all-releases    upgrade all the release packages installed on
                      the local system
upgrade-app             upgrade an application package installed on the
                      local system
upgrade-all-apps        upgrade all the application packages installed
                      on the local system
translate-version       translate one version type to another such as
                      an erts version to an erlang release version
version                 display the current Faxien version installed on
                      the local system
diff-config             diff the configuration between two installed
                      versions of a release

Configuration Management Commands:
environment             display information about the current Faxien
                      environment settings.
add-repo                add a repo to search for packages in
remove-repo             remove one of the repos Faxien is set to search
                      for packages in
show-repos              display the repos Faxien is set to search for
                      packages in
add-publish-repo        add a repo to publish packages to
remove-publish-repo     remove one of the repos Faxien is set to
                      publish to
show-publish-repos      display the repos Faxien is set to publish to
set-request-timeout     set the timeout faxien uses for requests to
                      remote repositories
show-request-timeout    display the timeout faxien uses for requests to
                      remote repositories
set-preferred-erts-vsn  set the erts vsn faxien will search first
show-preferred-erts-vsn display the erts vsn faxien will search first
ok

Теперь можно поставить Erlang:

$ ~/lib/erlang/bin/faxien ir erl

ir - это install-release

И проверить его:

$ ~/lib/erlang/bin/erl
Erlang R13B04 (erts-5.7.5) [source] [64-bit] [smp:4:4]
[rq:4] [async-threads:0] [hipe] [kernel-poll:false]

Eshell V5.7.5  (abort with ^G)
1> q().
ok
2>

Теперь необходимо установить Sinan:

$ ~/lib/erlang/bin/faxien ir sinan

И проверить:

$ ~/lib/erlang/bin/sinan help
starting server now.
Unable to connect after 0 seconds. Waiting 1 second(s)
Describing tasks ...
release
 Creates the *.rel, *.boot and *.script into the <build-area>/realeases/<vsn>
 directory. It also builds up a release tar bal into the <build-area>/tar/ directory
depends on: build


clean
 Removes the build area and everything underneath
depends on:


shell
 Starts an erlang shell with all of the correct paths preset so the developer
 can noodle with the code to his hearts content
depends on: build


gen
 Generates a buildable default project layout
depends on:


build
 Compiles all of the compilable files in the project
depends on: depends


version
 Provides sinan server version information
depends on:


test
 Runs all of the existing eunit unit tests in the project
depends on: build


dist
 Creates an tarball of the distribution including release information.
 Check documentation for the dist task for configuration information
depends on: release


depends
 Analyzes all of the dependencies in the project and pulls down those that
 arn't curently available locally
depends on:


doc
 Runs edoc across all sources in the project and outputs it into the build area
depends on: build


help
 Provides help information for the available tasks
depends on:


[help] stop

Итог:

Установлены Erlang, Faxien - система управления пакетам и Sinan - система сборки.