Aracılığıyla paylaş

Azure Pipelines ile sembol yayımlama

  • Makale

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Pipelines ile, Dizin kaynaklarını kullanarak sembollerinizi Azure Artifacts sembol sunucusuna yayımlayabilir ve sembolleri görevi yayımlayabilirsiniz. Ürün adlarını, derleme numaralarını veya paket adlarını bilmeden doğru sembol dosyalarına bağlanmak ve bunları otomatik olarak almak için hata ayıklayıcısını kullanabilirsiniz. Azure Pipelines'ı kullanarak, sembollerinizi dosya paylaşımlarına ve taşınabilir PDB'lere de yayımlayabilirsiniz.

Uyarı

Dizin kaynakları ve yayımlama simgeleri görev yayın işlem hatlarında desteklenmez.

Azure Artifacts sembol sunucusuna sembol yayımlama

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Önce İşlem hatlarıseçin, işlem hattınızı seçin ve ardından işlem hattınızı değiştirmek için Düzenle seçin.

  3. İşlem hattı tanımınızdan +'i seçerek yeni bir görev ekleyin.

  4. Dizini kaynaklarını arayın ve görev sembolleri yayımlayın. İşlem hattınıza eklemek için ekle'yi seçin.

  5. Gerekli alanları aşağıdaki gibi doldurun:

    • Görev sürümü: 2.\*.

    • Görünen ad: görev adı.

    • Semboller klasörü yolu: sembol dosyalarını barındıran klasörün yolu.

    • Arama deseni: semboller içinYolu altında belirlemiş olduğunuz klasördeki .pdb dosyalarını bulmak için kullanılan desen. Tek klasör joker karakteri (*) ve tekrarlayan joker karakterler (**) desteklenir. Örnek: *\bin**.pdb: adlı tüm alt dizinler içindeki tüm .pdb dosyalarını arar.

    • Dizin kaynakları: kaynak sunucu bilgilerinin PDB dosyalarına eklenip eklenmeyeceğini gösterir.

    • Simge yayımla: sembol dosyalarının yayımlanıp yayımlanmayacağını gösterir.

      • Sembol sunucusu türü: Simgelerinizi Azure Artifacts sembol sunucusuna yayımlamak için bu kuruluşta/koleksiyonda (Azure Artifacts gerektirir) Sembol Sunucusu'nu seçin.

    • Ayrıntılı günlük: günlüklerinize daha fazla bilgi ekleyin.

Azure Artifacts sembol sunucusuna sembol yayımlamak için dizin kaynaklarını yapılandırma ve sembolleri yayımlama görevini gösteren ekran görüntüsü.

Simgelerini dosya paylaşımında yayımlama

Azure Artifacts sembol sunucusunun yanı sıra, Dizin Kaynakları ve Simgeleri Yayımla görevini kullanarak da simgelerinizi bir dosya paylaşımında yayımlayabilirsiniz.

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Önce İşlem hatlarıseçin, sonra işlem hattınızı seçin ve değiştirmek için Düzenle'yi seçin.

  3. İşlem hattı tanımınızdan +'i seçerek yeni bir görev ekleyin.

  4. Dizini kaynaklarını arayın ve görev sembollerini yayımlayın. İşlem hattınıza eklemek için ekle'yi seçin.

  5. Gerekli alanları aşağıdaki gibi doldurun:

    • Görev sürümü: 2.\*.

    • Görev adı: görev görüntüleme adı.

    • Semboller klasörü yolu: sembol dosyalarını barındıran klasörün yolu.

    • Arama deseni: semboller içinYolu altında belirlemiş olduğunuz klasördeki .pdb dosyalarını bulmak için kullanılan desen.

    • Dizin kaynakları: kaynak sunucu bilgilerinin PDB dosyalarına eklenip eklenmeyeceğini gösterir.

    • Simge yayımla: sembol dosyalarının yayımlanıp yayımlanmayacağını gösterir.

      • Sembol sunucu türü: Simgelerinizi bir dosya paylaşımında yayımlamak için Dosya paylaşımı seçin.
      • Sembolleri yayımlama yolu: simgelerinizi barındıracak dosya paylaşımı.

    • Ayrıntılı günlük: günlüklerinize daha fazla bilgi eklemek için seçeneğini işaretleyin.

    Bir dosya paylaşımında sembol yayımlamak için dizin kaynaklarını yapılandırma ve sembolleri yayımlama görevini gösteren ekran görüntüsü.

Taşınabilir PDB'leri Azure Artifacts sembol sunucusuna yayımlama

Taşınabilir PDB'ler, yalnızca Windows'ta kullanılan geleneksel PDB'lerin aksine tüm platformlarda oluşturulabilen ve kullanılabilen sembol dosyalarıdır. Taşınabilir PDB'ler için derleme dizin oluşturmayı yapar, ancak yine de simgelerinizi yayımlamak için Dizin Kaynakları ve Simgeleri Yayımla görevini kullanmanız gerekir.

Kaynak Bağlantı, geliştiricilerin .NET derlemelerinden kaynak koduna geri eşleyerek kaynak kodlarında hata ayıklamasına olanak sağlayan bir araç kümesidir. dotnet/sourcelink GitHub deposuna göz atın, dahil edilen farklı paketler hakkında bilgi edinin.

  • GitHub'da barındırılan projeler için proje dosyanıza Microsoft.SourceLink.GitHub paketi başvurusunu ekleyin.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

  • Azure Repos'ta barındırılan projeler için (eski Visual Studio Team Services), proje dosyanıza Microsoft.SourceLink.AzureRepos.Git paketi başvuruyu ekleyin.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.AzureRepos.Git" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

  • Azure DevOps Server'da (eski Team Foundation Server) barındırılan projeler için proje dosyanıza Microsoft.SourceLink.AzureDevOpsServer.Git paketi başvuruyu ekleyin.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.AzureDevOpsServer.Git" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

Yayımlama görevini ayarlama

Kaynak kodunuzu dizine almak ve simgelerinizi Azure Artifacts sembolleri sunucusuna ve dosya paylaşımlarına yayımlamak için Dizin Kaynakları & Yayımlama Simgeleri görevi kullanılır. Kaynak Bağlantısıkullandığımız için yayımlama görevinde dizin oluşturma devre dışı bırakmamız gerekir.

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Önce İşlem Hatlarınıseçin, işlem hattınızı seçin ve sonra işlem hattınızı değiştirmek için Düzenle seçin.

  3. İşlem hattı tanımınızdan +'i seçerek yeni bir görev ekleyin.

  4. Dizini kaynaklarını arayın ve sembollerini yayımlama görevini gerçekleştirin. İşlem hattınıza eklemek için ve'i ekle'yi seçin.

  5. Gerekli alanları doldurun ve Sembol Sunucusu türü olarak sembol sunucusunuseçin. Dizin oluşturmayı devre dışı bırakmak için Dizin kaynakları işaretini kaldırdığınızdan emin olun.

    Taşınabilir PDB'leri Azure Artifacts sembol sunucusuna yayımlamak için yayımlama görevini yapılandırmayı gösteren ekran görüntüsü.

Önemli

Dizin Kaynakları & Simgeleri Yayımla görevi aracılığıyla yayımlanan simgeleri silmek için önce bu simgeleri oluşturan derlemeyi silmeniz gerekir. Bu, saslama politikaları kullanılarak veya çalıştırmayı el ile silinerek gerçekleştirilebilir.

Visual Studio'yu ayarlama

Uyarı

Mac için Visual Studio, sembol sunucuları kullanılarak hata ayıklamayı desteklemez.

Azure Artifacts sembol sunucusundan sembollerimizi tüketmeye başlamadan önce Visual Studio'nun düzgün ayarlandığından emin olalım:

  1. Visual Studio'da Araçlar ardından Seçenekler'iseçin.

  2. Hata Ayıklama menüsünden Simgeleri seçin.

  3. Yeni bir sembol sunucusu konumu eklemek için + işaretini seçin.

    Yeni sembol sunucusu konumunun nasıl ekleneceğini gösteren ekran görüntüsü.

  4. Yeni bir iletişim kutusu görüntülenir, açılan menüden hesabınızı seçin ve ardından bağlanmak istediğiniz kuruluşu seçin. İşiniz bittiğinde 'ı seçin ve'e bağlanın.

  5. Aynı Hata Ayıklama bölümünden Genel'i seçin. Aşağı kaydırın ve taşınabilir PDB'ler için desteği etkinleştirmek amacıyla Kaynak Bağlantısı Desteğini Etkinleştir'i işaretleyin.

    Visual Studio'da kaynak bağlantı desteğini etkinleştirmeyi gösteren ekran görüntüsü.

Uyarı

Kaynak sunucu desteğini etkinleştir seçeneğinin işaretlenmesi, kaynak kodun yerel olarak kullanılamadığı veya sembol dosyasının kaynak kodla eşleşmediği durumlarda kaynak sunucu kullanmanıza olanak tanır. Üçüncü taraf kaynak kodu için hata ayıklamayı etkinleştirmek istiyorsanız, Yalnızca Kodum Etkinleştir onay kutusunun seçimini kaldırın.

Sıkça Sorulan Sorular

S: Simgelerin saklanma süresi nedir?

Y: Simge dosyası, onu oluşturan derlemeyle aynı saklama süresine sahiptir. Bir derlemeyi el ile veya bekletme ilkelerini kullanarak sildiğinizde, bu derleme tarafından oluşturulan simgeler de silinir.

S: .NET Core derlemesinden oluşturulan taşınabilir bir PDB'de kaynak dizinleme kullanabilir miyim?

Y: Şu anda bu mümkün değildir. Kaynak dizin oluşturma şu anda taşınabilir PDB'ler için desteklenmiyor. Önerilen yaklaşım, derlemenizi dizin oluşturmayı yapacak şekilde yapılandırmaktır.