Maven akışlarını ve Artifacts kullanmaya başlayın

Azure DevOps Services | TFS 2018

bu hızlı başlangıç, akışınızdan Artifacts yayımlamak ve kullanmak için maven ayarlama konusunda size rehberlik edecektir.

Bu kılavuzda Azure Artifacts ayarlamış olduğunuz varsayılmaktadır. uzantının nasıl lisanslayacağınızı öğrenmek için bkz. Azure Artifacts kullanmaya başlama .

Not

Azure Artifacts, TFS 2017 veya daha yeni bir sürüme önceden yüklenmiş olarak gelen bir uzantıdır (maven yalnızca 2018 veya daha yeni sürümlerde mevcuttur), kuruluşunuzda kaldırılırsa, Visual studio marketi'nden yükleyebilirsiniz.

Önkoşullar

  1. Apache Maven yüklendi. Bunu Apache Maven projesindenindirebilirsiniz.

  2. Azure Artifacts kuruluşunuzda yüklü olmalıdır.

Akış oluşturma

Zaten bir akışınız var mı?Sonraki adıma atlayın.

  1. Projenizin içinden Azure Artifacts' a gidin.

    Azure Artifacts git

  2. Akış oluştur' u seçin.

    Yeni akış düğmesi

  3. Akışınıza bir ad verin ve görünürlüğünü, yukarı akış kaynaklarınıve kapsam ayarlarını seçin.

    Yeni akış iletişim kutusu

  4. İşiniz bittiğinde Oluştur ' u seçin.

Azure Artifacts TFS 2017 müşterileri için varsayılan olarak yüklenir. Azure Artifacts kullanmak için TFS 2017 ' e yükseltmeniz gerekir. Akışınızı ilk kez kullanıyorsanız, bir lisans atamanız istenebilir

  1. Derleme sürümü ' ne gidin ve paketler' i seçin.

    Azure Artifacts TFS 'ye git

  2. + Yeni akış' ı seçin.

    Yeni akış düğmesi TFS

  3. Akışa bir ad, Açıklamaverin ve kimler okuyabilen, dış paketleri dahiletmek istiyorsanız kimlerin katkıda bulunabileceğini ve bunları okuyabilirler.

    Yeni akış iletişim kutusu TFS

  4. İşiniz bittiğinde Oluştur ' u seçin.

Kimlik doğrulamasını ayarlama

Azure Artifacts akışlarıyla konuşmak için yerel makinenizde, maven 'nin Azure DevOps Services seçip geçebilecek bir belirteç gerekir.

  1. Azure Artifacts sayfasında, akışa Bağlan' yı seçin.

    sayfanın sağ üst köşesindeki akışa Bağlan düğmesi

  1. paketler sayfasında, akışa Bağlan' yi seçin.

    sayfanın sağ üst köşesindeki akışa Bağlan düğmesi

  1. Maven üst bilgisi altındaki Maven sekmesini açın.

    • Maven settings.xml dosyanızdaki kimlik bilgilerini çeker.

    • Linux 'ta dosya yolu genellikle olur "${user.home}/.m2/settings.xml" .

    • MacOS 'ta dosya yolu genellikle olur "~/.m2/settings.xml" .

    • Windows, genellikle dosya yolu olur "%USERPROFILE%/.m2/settings.xml" .

    • Dosya yoksa, şimdi bir tane oluşturun.

    İpucu

    Yeni XML dosyanızı doğru biçimde oluşturup kaydettiğinizden emin olmak için dosya Gezgini ' ni dosya adı uzantılarını gösterecek şekilde ayarlayın:

    1. Dosya Gezgini 'nde Görünüm sekmesini seçin.
    2. Dosya Gezgini 'nde dosya uzantılarınızı görmek için Göster/Gizlebölümünde dosya adı uzantıları onay kutusunu seçin.
  2. Maven 'yi makinenize yüklemediyseniz, indirmek ve yüklemek için araçları al seçeneğini belirleyebilirsiniz.

  3. kişisel erişim belirteci oluşturma da dahil olmak üzere Project kurulum bölümünü izleyin.

    Maven kimlik doğrulamasını ayarlama

settings.xml başvurusundasettings.xml dosyası hakkında daha fazla bilgi edinebilirsiniz.

Yapıt yayımlama

Akışınızdaki bir Maven yapıtı yayımlamak için şu adımları izleyin:

  1. Maven paketiniz yoksa, aşağıdaki komutu çalıştırarak bir tane oluşturabilirsiniz:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="myFirstApp"
    

    Aşağıdaki hatayı alırsanız, önceki komutu yürüttükten sonra geçerli bir yaşam döngüsü aşaması veya bir hedef (..) belirtmeniz gerekir , çalıştırma yapılandırmanıza bir hedef eklemek için aşağıdaki adımları izleyin:

    Projenize sağ tıklayın, ardından Maven Buildolarak çalıştır ' ı seçin. Hedefler metin kutusuna paket girin ve ardından Çalıştır' ı seçin.

  2. Maven istemcisini akışınıza ayarlayın.

  3. pom.xml dosyanızın dizinine gidin. Varsayılan olarak, pom.xml dosyası projenin kök yoludur.

  4. Maven yapıtı derlemek ve dağıtmak için aşağıdaki komutları çalıştırın:

    • Paketinizi oluşturun:
    • Paketinizi dağıtın:

Üçüncü taraf yapay bir yapı yayımlamak istiyorsanız Dağıt: Deploy-File Mojo ' yı kullanabilirsiniz. Bu, paketlerinizi dağıtmak için bir pod dosyası olmadan veya olmadan kullanılabilir.

mvn deploy:deploy-file -Dpackaging="jar" -DrepositoryId="MyFeedName" -Durl="MyFeedURL" -DgroupId="MyGroup" -DartifactId="myFirstApp" -Dversion="jarFileVersion" -Dfile="jarFileLocalPath"

Not

Akışınızdaki en fazla 30 Maven anlık görüntüsünü saklayabilirsiniz. maksimum sınıra ulaştığınızda Azure Artifacts, anlık görüntüleri otomatik olarak 25 ' e siler. Bu işlem, akışınızdaki her 30 ve anlık görüntü yayımlandığında otomatik olarak tetiklenir. Daha fazla ayrıntı için bkz. Maven anlık görüntülerini işleme .

Not

Maven anlık görüntüleri yukarı akış kaynaklarında desteklenmez.

ÖNEMLI Maven akışınızdaki kimliğini otomatik olarak doğrulamak için, mavenAuthenticateFeedmavenAuthenticateFeedbağımsız değişkeni true olarak ayarlamanız gerekir.

Akışınızdan yapıt yüklemesi

Maven istemcisini kullanarak akışınızdan Maven yapılarını yüklemeyin.

Maven yapıtı yüklemenin en yaygın yolu, başka bir yapıtın bağımlılığı olarak yapılır.

  1. Aşağıdaki komutu kullanarak bir Maven yapıtı oluşturun:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="mySecondApp"
    
  2. Azure Artifacts, yüklemek istediğiniz yapıya gidin ve öğenin içeriğini kopyalayın .

  3. <dependency>Öğe içeriğini <dependencies> pom.xml dosyanızın öğesi içine yapıştırın.

  4. mvn installpom.xml dosyanızı içeren dizinden çalıştırın.

Daha fazla yükleme seçeneği için bkz. Maven CLI belgeleri .

  1. Aşağıdaki komutu kullanarak bir Maven yapıtı oluşturun:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="mySecondApp"
    
  2. TFS 'deki akışa Bağlan iletişim kutusunda, bilgileri kopyalayın. pom.xml dosyanıza iki kez yapıştırın (önceki örnek dosyasına bakın):

    • Etiketler arasında <repositories>
    • Etiketler arasında <distributionManagement>
  3. Paketler sayfasında, yüklemek istediğiniz yapıya gidin ve öğenin içeriğini kopyalayın .

  4. <dependency>Öğe içeriğini <dependencies> pom.xml dosyanızın öğesi içine yapıştırın.

  5. mvn installpom.xml dosyanızı içeren dizinden çalıştırın.

Daha fazla yükleme seçeneği için bkz. Maven CLI belgeleri .

Sırada ne var?

diğer konular hakkında bilgi edinmek için Azure Artifacts giriş sayfasına göz atın.