Aracılığıyla paylaş


İlk işlem hattınızı oluşturma

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Bu, Git deposundan örnek uygulama oluşturmak için Azure Pipelines'ı kullanmaya yönelik adım adım bir kılavuzdur. Bu kılavuzda YAML işlem hattı düzenleyicisiyle yapılandırılmış YAML işlem hatları kullanılır.

YAML işlem hattındaki farklı bölümler hakkında daha fazla bilgi için bkz. Azure Pipelines YAML şemasındakiişlem hattı ve YAML işlem hattınızı özelleştirme.

Bunun yerine Klasik işlem hatlarını kullanmak isterseniz bkz . Klasik işlem hattınızı tanımlama. TFVC kullanma hakkında yönergeler için bkz . TFVC depoları derleme.

Önkoşullar - Azure DevOps

Aşağıdaki öğelere sahip olduğunuzdan emin olun:

  • Depo oluşturabileceğiniz bir GitHub hesabı. Ücretsiz bir tane oluşturun.

  • Bir Azure DevOps kuruluşu. Ücretsiz bir tane oluşturun. Ekibinizde zaten varsa kullanmak istediğiniz Azure DevOps projesinin yöneticisi olduğunuzdan emin olun.

  • Microsoft tarafından barındırılan aracılarda işlem hatlarını çalıştırma olanağı. Microsoft tarafından barındırılan aracıları kullanmak için Azure DevOps kuruluşunuzun Microsoft tarafından barındırılan paralel işlere erişimi olmalıdır. Paralel bir satın alabilir veya ücretsiz izin isteyebilirsiniz.

İlk işlem hattınızı oluşturma

Java örnek kodunu alma

Başlamak için aşağıdaki depoyu GitHub hesabınıza çatal yapın.

https://github.com/MicrosoftDocs/pipelines-java

İlk Java işlem hattınızı oluşturma

  1. Azure DevOps projenizde sol gezinti menüsünden İşlem Hatları'nı seçin.

  2. Bu işlem hattı projedeki ilk işlem hattıysa Yeni işlem hattı veya İşlem hattı oluştur'u seçin.

  3. Kodunuz nerede ekranında GitHub'ı seçin.

  4. Oturum açmak için GitHub'a yönlendirilebilirsiniz. Öyleyse GitHub kimlik bilgilerinizi girin.

  5. Depo seçin ekranında.NET uygulamanızın içinde olduğu depoyu seçin.

  6. Azure Pipelines uygulamasını yüklemek için GitHub'a yönlendirilebilirsiniz. Öyleyse Onayla ve yükle'yi seçin.

  1. Azure Pipelines deponuzu analiz eder ve Maven işlem hattı şablonunu önerir.

  2. Yeni işlem hattınız görüntülendiğinde, ne yaptığını görmek için YAML'ye göz atın. Hazır olduğunuzda Kaydet ve çalıştır'ı seçin.

  3. Deponuza yeni azure-pipelines.yml bir dosya işlemeniz istenir. İletiden memnun olduktan sonra Kaydet'i seçin ve yeniden çalıştırın .

    İşlem hattınızın nasıl çalıştığını izlemek istiyorsanız derleme işini seçin.

    Kodunuz Maven şablonuna uygun göründüğünden sizin için otomatik olarak oluşturduğumuz bir işlem hattı oluşturdunuz ve çalıştırıldınız.

    Artık deponuzda özelleştirmeniz için hazır çalışan bir YAML işlem hattı (azure-pipelines.yml) var!

  4. İşlem hattınızda değişiklik yapmaya hazır olduğunuzda İşlem Hatları sayfasından seçin

İşlem hattınızda Java ile çalışma hakkında daha fazla bilgi edinin.

İşlem hatlarınızı görüntüleme ve yönetme

İşlem hatları giriş sayfasına gitmek için sol taraftaki menüden İşlem Hatları'nı seçerek işlem hatlarınızı görüntüleyebilir ve yönetebilirsiniz.

İşlem hatları giriş sayfasının ekran görüntüsü.

İşlem hatları ana sayfasından, işlem hatlarını ve işlem hattı çalıştırmalarını görüntüleyebilir, işlem hatları oluşturup içeri aktarabilir, güvenliği yönetebilir ve işlem hattı ile çalışma detaylarına inebilirsiniz.

Son çalıştırılacak işlem hatlarını görüntülemek için En Son'u seçin (varsayılan görünüm) veya tüm işlem hatlarını görüntülemek için Tümü'nü seçin.

İşlem hattı ana sayfasında işlem hattı işlemlerini görüntüleme seçeneklerinin ekran görüntüsü.

Bu işlem hattını yönetmek ve çalıştırmaları görüntülemek için bir işlem hattı seçin. Bu derlemenin sonuçlarını görüntülemek için son çalıştırmanın derleme numarasını seçin, o çalıştırmanın dalını görüntülemek için dal adını seçin veya bağlam menüsünü seçerek işlem hattını çalıştırın ve diğer yönetim eylemlerini gerçekleştirin.

Son çalıştırılmış işlem hatlarının ekran görüntüsü.

Tüm işlem hattı çalıştırmalarını görüntülemek için Çalıştırmalar'ı seçin. İsteğe bağlı olarak görüntülenen çalıştırmaları filtreleyebilirsiniz.

İşlem hattı çalıştırmalarının ekran görüntüsü.

Bu çalıştırma hakkındaki bilgileri görüntülemek için bir işlem hattı çalıştırması seçin.

Bağlam menüsünden çalıştırmayı korumayı veya silmeyi seçebilirsiniz. Çalıştırma saklama hakkında daha fazla bilgi için Derleme ve sürüm bekletme ilkeleri başlıklı belgeyi inceleyebilirsiniz.

İşlem hattı çalıştırma bağlam menüsünün ekran görüntüsü.

İşlem hattı ayrıntılarını görüntüleme

İşlem hattının ayrıntılar sayfası, bu işlem hattını görüntülemenize ve yönetmenize olanak tanır.

İşlem hattı ayrıntıları sayfasının ekran görüntüsü.

İşlem hattınızı düzenlemek için Düzenle'yi seçin. Daha fazla bilgi için bkz . YAML işlem hattı düzenleyicisi. İşlem hattınızı, azure-pipelines.yml dosyasını doğrudan işlem hattını barındıran depoda değiştirerek de düzenleyebilirsiniz.

İşlem hattı çalıştırma ayrıntılarını görüntüleme

İşlem hattı çalıştırması özetinden, hem çalışırken hem de tamamlandığında çalıştırmanızın durumunu görüntüleyebilirsiniz.

İşlem hattı çalıştırma özetinin ekran görüntüsü.

Özet bölmesinden görev ve evre ayrıntılarını görüntüleyebilir, artefaktleri indirebilir ve bağlantılı commit'lere, test sonuçlarına ve iş öğelerine gidebilirsiniz.

İşler ve aşamalar

İşler bölmesinde aşamalarınızın ve işlerinizin durumuyla ilgili genel bir bakış görüntülenir. Bu bölmede işlem hattınızın aşamaları ve işleri veya yalnızca işleri olmasına bağlı olarak birden çok sekme olabilir. Bu örnekte işlem hattının Derleme ve Dağıtma adlı iki aşaması vardır. İşi, Aşamalar veya İşler bölmesinden seçerek işlem hattı adımlarının detaylarına inebilirsiniz.

İşlem hattı işlerinin ve aşamalarının ekran görüntüsü.

Bu işin adımlarını görmek için bir iş seçin.

İşlem hattı görevlerinin ekran görüntüsü.

Adımlar görünümünde, her adımın durumunu ve ayrıntılarını gözden geçirebilirsiniz. Diğer eylemler'den zaman damgalarını değiştirebilir veya işlem hattındaki tüm adımların ham günlüğünü görüntüleyebilirsiniz.

İşlem hattı görevleri içerik menüsünün ekran görüntüsü.

İşlem hattını iptal et ve yeniden çalıştır

İşlem hattı çalışıyorsa İptal seçeneğini işaretleyerek iptal edebilirsiniz. Çalıştırma tamamlandıysa, Yeni çalıştır'ı seçerek işlem hattını yeniden çalıştırabilirsiniz.

İşlem hattı çalıştırmasını iptal etme işleminin ekran görüntüsü.

İşlem hattı daha fazla eylem çalıştır menüsü

Diğer eylemler menüsünden günlükleri indirebilir, etiketler ekleyebilir, işlem hattını düzenleyebilir, çalıştırmayı silebilir ve çalıştırma için bekletmeyi yapılandırabilirsiniz.

İşlem hattı çalıştırma özet sayfası diğer eylemler menüsünün ekran görüntüsü.

Not

Saklanmış olan bir çalıştırmayı silemezsiniz. Sil'i görmüyorsanız Çalıştırmayı korumayı durdur'u seçin ve ardından çalıştırmayı silin. Hem Sil hem de Saklama sürümlerini görüntüle seçeneklerini görüyorsanız çalıştırmanız için bir veya daha fazla yapılandırılmış saklama ilkesi geçerli olmaya devam eder. Saklama sürümlerini görüntüle’yi seçin, ilkeleri silin (yalnızca seçili çalıştırmanın ilkeleri kaldırılır) ve çalıştırmayı silin.

Deponuza bir durum rozeti ekleyin

Birçok geliştirici, depolarında durum rozeti görüntüleyerek kod kalitelerini yüksek tuttuğunu göstermek ister.

Durum rozeti Azure işlem hattının başarılı olduğunu gösteriyor

Durum rozetini panonuza kopyalamak için:

  1. Azure Pipelines'da İşlem Hatları sayfasına giderek işlem hatlarının listesini görüntüleyin. Önceki bölümde oluşturduğunuz işlem hattını seçin.

  2. seçin, ardından Durum rozeti'ni seçin.

  3. Durum rozeti'ni seçin.

  4. Örnek markdown bölümünden örnek markdown'u kopyalayın.

Panonuzda Markdown rozetiyle GitHub'da aşağıdaki adımları uygulayın:

  1. Dosya listesine gidin ve öğesini seçin Readme.md. Düzenlemek için kalem simgesini seçin.

  2. Dosyanın başına durum rozeti Markdown'ı yapıştırın.

  3. Değişikliği main şubesine işleyin.

  4. Durum rozetinin deponuzun açıklamasında göründüğüne dikkat edin.

Özel projeler için rozetlere anonim erişimi yapılandırmak için:

  1. Sayfanın sol alt köşesindeki Proje Ayarları'na gidin

  2. İşlem Hatları sekmesinin altındaki Ayarlar sekmesini açın

  3. Genel altındaki Rozetlere anonim erişimi devre dışı bırak kaydırıcısını açma/kapatma

Not

Özel bir projede bile anonim rozet erişimi varsayılan olarak etkinleştirilir. Anonim rozet erişimi etkinleştirildiğinde, kuruluşunuzun dışındaki kullanıcılar rozet durumu API'sini kullanarak proje adları, dal adları, iş adları ve derleme durumu gibi bilgileri sorgulayabilir.

Bu depodaki dosyayı yeni değiştirdiğinizden Readme.md Azure Pipelines, deponuzun kökündeki dosyadaki azure-pipelines.yml yapılandırmaya göre kodunuzu otomatik olarak oluşturur. Azure Pipelines'a döndüğünüzde yeni bir çalıştırmanın göründüğüne dikkat edin. Her düzenleme yaptığınızda Azure Pipelines yeni bir çalıştırma başlatır.

Azure DevOps Server 2019'da klasik düzenleyiciyi kullanarak "Hello world" yazdıran bir derleme ve yayın oluşturmayı göstereceğiz.

  1. Azure Repos'a gidin. Önceki gezintideki Kod Hub'ı

    Depo dosyaları

  2. Projeniz boşsa, deponuza kod eklemenize yardımcı olacak bir ekranla karşılanırsınız. Deponuzu bir dosyayla başlatmakreadmeen alttaki seçimi seçin:

    Depo başlatma

  1. Azure Repos'a gidin.

  2. Dosya ekleyin.

    Dosyalar sekmesinde, depo düğümünden Yeni Dosya seçeneğini belirleyin

  3. İletişim kutusunda, yeni dosyanızı adlandırın ve oluşturun.

    HelloWorld.ps1
    
  4. Bu betiği kopyalayıp yapıştırın.

    Write-Host "Hello world"
    
  5. Dosyayı işleyin (kaydedin).

  1. Azure Pipelines'ı seçtiğinizde sizi otomatik olarak Derlemeler sayfasına götürür.

    Derlemeler sekmesine gidin

  2. Yeni bir ardışık düzen oluştur.

    Derleme sekmesi düğmesini seçin

    Yeni Azure DevOps kullanıcıları için bu, sizi otomatik olarak YAML işlem hattı oluşturma deneyimine götürür. Klasik düzenleyiciye ulaşmak ve bu kılavuzu tamamlamak için Yeni YAML işlem hattı oluşturma deneyimi için önizleme özelliğini kapatmanız gerekir:

    Ekranın sağ üst kısmındaki ayarlar'a tıklayın ve önizleme özelliklerine tıklayın

    Yaml önizleme özelliğini kapatmak için geçiş düğmesine tıklayın

  3. Kaynak, proje, depo ve varsayılan dalın betiği oluşturduğunuz konumla eşleştiğinden emin olun.

  4. Boş bir ile başlayın.

  5. Sol tarafta İşlem Hattı'nı seçin ve kullanmak istediğiniz Adı belirtin. Aracı Havuzu için Barındırılan VS2017'yi seçin.

  6. Sol tarafta artı işaretini ( + ) seçerek İş 1'e görev ekleyin. Sağ tarafta Yardımcı Program kategorisini seçin, listeden PowerShell görevini seçin ve ardından Ekle'yi seçin.

    Derleme görevini işe ekleme

  7. Sol tarafta yeni PowerShell betik görevinizi seçin.

  8. Betik Yolu bağımsız değişkeni için, deponuza göz atmak ve oluşturduğunuz betiği seçmek üzere butonuna tıklayın.

    Senaryonuzu seçin

  9. Kaydet ve kuyruk'a tıklayın ve ardından Kaydet'e tıklayın.

  1. Görevler sekmesinde artı işaretini ( + ) seçerek İş 1'e görev ekleyin.

  2. Yardımcı Program kategorisini seçin, Derleme Yapıtlarını Yayımla görevini seçin ve ardından Ekle'yi seçin.

    Yapıt yayımlama görevini ekleme

    Yayımlama rotası: Oluşturduğunuz betiği seçmek için göz at düğmesine basın.

    Yapıt adı: girin drop.

    Yapıt yayımlama konumu: Azure Artifacts/TFS'yi seçin.

  1. Kaydet ve kuyruk'a ve ardından Kaydet ve kuyruk'a tıklayın.

  2. İletişim kutusunda Kaydet ve kuyruğu bir kez daha seçin.

    Bu, Microsoft tarafından barındırılan aracıda yeni bir derlemeyi kuyruğa alır.

  3. Sayfanın üst kısmında yeni derlemenin bağlantısını görürsünüz.

    konsol oluşturma

    Yeni derlemeyi olduğu gibi izlemek için bağlantıyı seçin. Aracı tahsis edildikten sonra derlemenin canlı günlüklerini görmeye başlayacaksınız. PowerShell betiğinin derlemenin bir parçası olarak çalıştırıldığına ve konsola "Merhaba dünya" yazdırıldığına dikkat edin.

    Derleme konsolunda izleyin

  4. Derleme özetine git. Derleme işleminin Artifaktlar sekmesinde, betiğin bir çıktı olarak yayımlandığına dikkat edin.

    Yapıtı görmek için derleme konsolunu açın

Derleme konsolunda PowerShell görevini açma

Artık değişikliklerinizin sonuçlarını görebilirsiniz. Azure Pipelines'a gidin ve Kuyruğa Alındı'yı seçin. Kuyruğa alınan veya çalıştırılan bölümünün altında, bir derlemenin işlediğiniz değişiklik tarafından otomatik olarak tetiklendiğine dikkat edin.

PowerShell betik özet günlüğü oluştur

  1. Pipelines sekmesine gidin ve ardından Yayınlar'ı seçin.

  2. Yeni işlem hattı oluşturmak için seçeneği seçin. Yayın işlem hattı zaten oluşturulduysa artı işaretine ( + ) tıklayın ve ardından Yayın işlem hattı oluştur'u seçin.

  3. Boş bir işle başlamak için eylemi seçin.

  4. Aşamaya QA adını verin.

  5. Yapıtlar panelinde + Ekle'yi seçin ve bir Kaynak (Derleme işlem hattı) belirtin. Ekle'yi seçin.

  6. Sürekli dağıtımı tetikleyen Şimşek'i seçin ve ardından sağ tarafta Sürekli dağıtım tetikleyicisini etkinleştirin.

    Sürekli dağıtımı tetikleme için şimşek simgesini seçin

  7. Görevler sekmesini seçin ve Soru-Cevap aşamanızı seçin.

  8. İşe görev eklemek için işin artı işaretini ( + ) seçin.

  9. Görev ekle iletişim kutusunda Yardımcı Program'ı seçin, PowerShell görevini bulun ve ekle düğmesini seçin.

  10. Sol tarafta yeni PowerShell betik görevinizi seçin.

  11. Betik Yolu bağımsız değişkeni için yapıtlarınıza göz atmak için düğmeyi seçin ve oluşturduğunuz betiği seçin.

  12. Şu Argümanları ekleyin:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    
  13. İşlem Hattı sekmesinde Soru-Cevap aşamasını ve ardından Kopyala'yı seçin.

    Soru-Cevap'ta yayın ortamını kopyalama

  14. Kopyalanan aşama Üretim'i yeniden adlandırın.

  15. Yayın işlem hattını Hello world olarak yeniden adlandırın.

    Yayın işlem hattı hello dünyasını yeniden adlandırın

  16. Yayın işlem hattını kaydedin.

  1. Yeni bir sürüm oluşturun.

    Sürüm oluşturma - DevOps 2019 ve 2020

    Yeni sürüm oluştur göründüğünde Oluştur'u seçin.

  2. Oluşturduğunuz sürümü açın.

    sürüm oluşturuldu - DevOps 2019 ve 2020

  3. Yayın hakkındaki gerçek zamanlı verileri almak için günlükleri görüntüleyin.

    sürüm günlükleri - DevOps 2019 ve 2020

sürüm betiği adımının son günlüğü - DevOps 2019 ve 2020

Sonraki adımlar

Azure'da ilk işlem hattınızı oluşturmayı öğrendiniz. Şimdi işlem hatlarını seçtiğiniz dilde yapılandırma hakkında daha fazla bilgi edinin:

İsterseniz, oluşturduğunuz işlem hattını özelleştirmeye devam edebilirsiniz.

İşlem hattınızı bir kapsayıcıda çalıştırmak için Kapsayıcı işleri'ne bakın.

GitHub depoları oluşturma hakkında ayrıntılı bilgi için bkz . GitHub depoları oluşturma.

İşlem Hattı Yapıtlarının nasıl yayımlanacağını öğrenmek için İşlem Hattı Yapıtlarını Yayımlama'ya bakın.

YAML işlem hatlarında başka neler yapabileceğinizi öğrenmek için bkz . YAML şema başvurusu.

Temizleme

Herhangi bir test işlem hattı oluşturduysanız, bunları bitirdiğinizde kolayca silebilirsiniz.

İşlem hattını silmek için, bu işlem hattının özet sayfasına gidin ve sayfanın sağ üst kısmındaki ... menüsünden Sil'i seçin. Onaylamak için işlem hattının adını yazın ve Sil'i seçin.

İşlem hattını silme

SSS

DevOps ve CI/CD hakkındaki makaleleri nereden okuyabilirim?

Sürekli Tümleştirme nedir?

Sürekli Teslim nedir?

DevOps nedir?

Hangi sürüm denetim sistemini kullanabilirim?

Uygulamanız için CI/CD kullanmaya hazır olduğunuzda, istediğiniz sürüm denetim sistemini kullanabilirsiniz:

Bir boru hattını nasıl çoğaltırım?

İşlem hattınızın diğer işlem hatlarında çoğaltmak istediğiniz bir deseni varsa, kopyalayın, dışarı aktarın veya şablon olarak kaydedin.

tüm-tanımlar-oluştur-hareket-menüsü-çoğaltma-eylemleri

İşlem hattını kopyaladıktan sonra değişiklik yapabilir ve ardından kaydedebilirsiniz.

Bir işlem hattını dışarı aktardıktan sonra Tüm işlem hatları sekmesinden içeri aktarabilirsiniz.

Bir şablon oluşturduktan sonra, ekip üyeleriniz şablonu kullanarak yeni işlem hatlarındaki deseni izleyebilir.

İpucu

Yeni Derleme Düzenleyicisi'ni kullanıyorsanız, özel şablonlarınız listenin en altında gösterilir.

Taslaklarla çalışmak Nasıl yaparım??

Derleme işlem hattını düzenliyorsanız ve henüz üretim için hazır olmayan bazı değişiklikleri test etmek istiyorsanız, bunu taslak olarak kaydedebilirsiniz.

taslak olarak kaydet

taslak düzenleme - DevOps 2019 ve 2020

taslak yayımlama - DevOps 2019 ve 2020

İşlem hattını nasıl silebilirim?

İşlem hattını silmek için bu işlem hattının özet sayfasına gidin ve sayfanın sağ üst kısmındaki ... menüsünden Sil'i seçin. Onaylamak için işlem hattının adını yazın ve Sil'i seçin.

Bir derlemeyi kuyruğa alırsam başka ne yapabilirim?

Derlemeleri otomatik veya manuel olarak kuyruğa alabilirsiniz.

Bir derlemeyi el ile kuyruğa aldığınızda, derlemenin tek bir çalıştırması için şunları yapabilirsiniz:

İşlem hattı ayarları hakkında nereden daha fazla bilgi edinebilirim?

İşlem hattı ayarları hakkında daha fazla bilgi edinmek için bkz:

Program aracılığıyla bir derleme işlem hattını nasıl oluşturabilirim?

REST API Referansı: Derleme işlem hattı oluşturma

Not

Komut satırından veya betiklerden Azure Pipelines CLI kullanarak derlemeleri ve derleme işlem hatlarını da yönetebilirsiniz.