Klasik yayın işlem hatlarında değişkenleri kullanma

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

Klasik yayın işlem hatlarında değişkenleri kullanmak, işlem hattınız genelinde veri alışverişi ve taşımanın kullanışlı bir yoludur. Her değişken bir dize olarak depolanır ve değeri işlem hattı çalıştırmaları arasında değişebilir.

Klasik yayın işlem hattınızın her aşamasında uygulamanızı dağıtmak için görevler ayarlarken değişkenler size yardımcı olabilir:

• Özelleştirmeyi basitleştirme: Genel dağıtım işlem hattını bir kez tanımlayın ve farklı aşamalar için kolayca uyarlayın. Örneğin, bir web dağıtımının bağlantı dizesi temsil etmek için bir değişken kullanın ve her aşama için gereken değeri ayarlayın. Bunlar özel değişkenler olarak bilinir.

• Bağlamsal bilgilerden yararlanın: Yayın bağlamı hakkında aşama, yapıt veya dağıtımı çalıştıran aracı gibi ayrıntılara erişin. Örneğin, betikleriniz indirme için derleme konumunu veya geçici dosyalar oluşturmak için aracının çalışma dizinini gerektirebilir. Bunlar varsayılan değişkenler olarak adlandırılır.

Varsayılan değişkenler

Varsayılan değişkenler, çalışan görevlerinize ve betiklerinize yönelik yürütme bağlamı hakkında temel bilgiler sağlar. Bu değişkenler, çalıştırdıkları sistem, sürüm, aşama veya aracı hakkındaki ayrıntılara erişmenizi sağlar.

System.Debug dışında, varsayılan değişkenler salt okunur olur ve değerleri sistem tarafından otomatik olarak ayarlanır.

En önemli değişkenlerden bazıları aşağıdaki tablolarda açıklanmıştır. Listenin tamamını görüntülemek için bkz . Tüm değişkenlerin geçerli değerlerini görüntüleme.

Sistem değişkenleri

Yayın değişkenleri

Yayın aşaması değişkenleri

Aracı değişkenleri

Release Artifacts değişkenleri

Bir yayında başvuruda bulunan her yapıt için aşağıdaki yapıt değişkenlerini kullanabilirsiniz. Tüm değişkenlerin her yapıt türü için geçerli olmadığını unutmayın. Aşağıdaki tabloda varsayılan yapıt değişkenleri listelenmiştir ve yapıt türüne göre değerlerine ilişkin örnekler verilmiştir. Bir örnek boşsa, değişkenin bu yapıt türü için geçerli olmadığını gösterir.

Yer tutucuyu {alias} yapıt kaynağı diğer adı için belirttiğiniz değerle veya yayın işlem hattı için oluşturulan varsayılan değerle değiştirin.

Birincil Yapıt değişkenleri

Klasik yayın işlem hatlarında, birden çok yapıt kullanıyorsanız, birini birincil yapıt olarak belirleyebilirsiniz. Azure Pipelines, belirlenen birincil yapıt için aşağıdaki değişkenleri doldurur.

Varsayılan değişkenleri kullanma

Varsayılan değişkenleri iki şekilde kullanabilirsiniz: yayın işlem hattındaki veya betiklerinizdeki görevlerin parametreleri olarak.

Varsayılan değişkeni doğrudan göreve giriş olarak kullanabilirsiniz. Örneğin, diğer adı ASPNET4.CI olan bir yapıtın PowerShell görevine bağımsız değişken olarak geçirmek Release.Artifacts.{Artifact alias}.DefinitionName için kullanabilirsiniz$(Release.Artifacts.ASPNET4.CI.DefinitionName).

Betiğinizde varsayılan bir değişken kullanmak için, önce varsayılan değişken adlarındaki öğesini ile _değiştirmeniz . gerekir. Örneğin, powershell betiğinde diğer adı olarak ASPNET4.CI olan bir yapıtın değerini Release.Artifacts.{Artifact alias}.DefinitionName yazdırmak için kullanın$env:RELEASE_ARTIFACTS_ASPNET4_CI_DEFINITIONNAME. ASPNET4.CI özgün diğer adının ASPNET4_CI ile değiştirildiğini unutmayın.

Özel değişkenler

Özel değişkenler çeşitli kapsamlarda tanımlanabilir.

• Değişken Grupları: Bir projedeki tüm tanımlarda değerleri paylaşmak için değişken grupları kullanın. Bu, bir proje içindeki tanımlar, aşamalar ve görevler boyunca aynı değerleri kullanmak ve bunları tek bir konumdan yönetmek istediğinizde kullanışlıdır. İşlem Hatları>Kitaplığı'nda değişken grupları tanımlayın ve yönetin.

• Yayın İşlem Hattı Değişkenleri: Yayın işlem hattı içindeki tüm aşamalarda değerleri paylaşmak için yayın işlem hattı değişkenlerini kullanın. Bu, aşamalar ve görevler arasında tutarlı bir değere ihtiyaç duyduğunuz ve bunu tek bir konumdan güncelleştirebileceğiniz senaryolar için idealdir. Yayın işlem hattının Değişkenler sekmesinde bu değişkenleri tanımlayın ve yönetin. İşlem Hattı Değişkenleri sayfasında, Değişken eklerken Kapsam açılan listesini Yayın olarak ayarlayın.

• Aşama Değişkenleri: Yayın işlem hattının belirli bir aşamasındaki değerleri paylaşmak için aşama değişkenlerini kullanın. Bu, aşamadan aşamaya farklılık gösteren ancak bir aşama içindeki tüm görevler arasında tutarlı olan değerler için kullanışlıdır. Yayın işlem hattının Değişkenler sekmesinde bu değişkenleri tanımlayın ve yönetin. İşlem Hattı Değişkenleri sayfasında, değişken eklerken Kapsam açılan listesini uygun ortama ayarlayın.

Projede, yayın işlem hattında ve aşama düzeylerinde özel değişkenler kullanmak şunları oluşturmanıza yardımcı olur:

• Değerleri yinelemekten kaçının, böylece tüm oluşumları tek bir değişiklikle güncelleştirmeyi kolaylaştırma.

• Hassas değerlerin kullanıcılar tarafından görüntülenmesini veya değiştirilmesini engelleyerek bunların güvenliğini sağlayın. Bir değişkeni güvenli (gizli dizi) olarak işaretlemek için değişkenin yanındaki simgeyi seçin.

  Önemli

  Gizli değişkenlerin (gizli dizi) değerleri sunucuda güvenli bir şekilde depolanır ve kaydedildikten sonra kullanıcılar tarafından görüntülenemez. Dağıtım sırasında Azure Pipelines, görevler tarafından başvurulduğunda bu değerlerin şifresini çözer ve bunları güvenli bir HTTPS kanalı üzerinden aracıya geçirir.

Özel değişkenler kullanma

Görevlerinizde özel değişkenler kullanmak için değişken adını parantez içine alın ve önüne bir $ karakter koyun. Örneğin, adminUserName adlı bir değişkeniniz varsa, geçerli değerini görevine olarak $(adminUserName)ekleyebilirsiniz.

Bir betikte değişkenlerinizi tanımlama ve değiştirme

Bir betikten değişken tanımlamak veya değiştirmek için günlüğe task.setvariable kaydetme komutunu kullanın. Güncelleştirilmiş değişken değerinin kapsamı yürütülen işin kapsamıdır ve işler veya aşamalar arasında kalıcı olmaz. Değişken adlarının "." ve " " ile "_" ile değiştirildiğinde büyük harfe dönüştürüldüğünü unutmayın.

Örneğin Agent.WorkFolder, AGENT_WORKFOLDER olur.

• Windows'da bu değişkene veya $env:AGENT_WORKFOLDERolarak %AGENT_WORKFOLDER% erişin.
• Linux ve macOS'ta kullanın $AGENT_WORKFOLDER.

@echo ##vso[task.setvariable variable=sauce]crushed tomatoes
@echo ##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with garlic

"$(sauce)" "$(secret.Sauce)"

@echo off
set sauceArgument=%~1
set secretSauceArgument=%~2
@echo No problem reading %sauceArgument% or %SAUCE%
@echo But I cannot read %SECRET_SAUCE%
@echo But I can read %secretSauceArgument% (but the log is redacted so I do not spoil the secret)

Write-Host "##vso[task.setvariable variable=sauce]crushed tomatoes"
Write-Host "##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with
            garlic"

-sauceArgument "$(sauce)" -secretSauceArgument "$(secret.Sauce)"

Param(
   [string]$sauceArgument,
   [string]$secretSauceArgument
)
Write-Host No problem reading $env:SAUCE or $sauceArgument
Write-Host But I cannot read $env:SECRET_SAUCE
Write-Host But I can read $secretSauceArgument "(but the log is redacted so I do not spoil the secret)"

- pwsh: |
      Write-Host No problem reading $(sauce)
      Write-Host But I cannot read $env:SECRET_SAUCE
      Write-Host But I can read $(secret.Sauce) "(but the log is redacted so I do not spoil the secret)"

#!/bin/bash
echo "##vso[task.setvariable variable=sauce]crushed tomatoes"
echo "##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with garlic"

"$(sauce)" "$(secret.Sauce)"

#!/bin/bash
echo "No problem reading $SAUCE"
echo "But I cannot read $SECRET_SAUCE"

Değişkenlerin okunmasından konsol çıkışı:

No problem reading crushed tomatoes or crushed tomatoes
But I cannot read 
But I can read ******** (but the log is redacted so I do not spoil the secret)

Tüm değişkenlerin geçerli değerlerini görüntüleme

1. İşlem Hatları Yayınları'nın> ardından yayın işlem hattınızı seçin.

2. Yayınınızın özet görünümünü açın ve ilgilendiğiniz aşamayı seçin. Adım listesinde İşi başlat'ı seçin.

   

3. Bu işlem, bu adımın günlüklerini açar. Aracı tarafından bu iş için kullanılan değerleri görmek için aşağı kaydırın.

   

Bir sürümü hata ayıklama modunda çalıştırma

Bir sürümün hata ayıklama modunda çalıştırılması, yayın yürütme sırasında ek bilgiler görüntüleyerek sorunları veya hataları tanılamanıza ve çözmenize yardımcı olabilir. Hata ayıklama modunu tüm sürüm için veya yalnızca belirli bir yayın aşamasındaki görevler için etkinleştirebilirsiniz.

• Yayının tamamında hata ayıklama modunu etkinleştirmek için yayın işlem hattının Değişkenler sekmesine değeriyle true adlı System.Debug bir değişken ekleyin.

• Belirli bir aşama için hata ayıklama modunu etkinleştirmek için, aşamanın kısayol menüsünden Aşamayı yapılandır iletişim kutusunu açın ve Değişkenler sekmesine değeriyle true adlı System.Debug bir değişken ekleyin.

• Alternatif olarak, değerine truesahip adlı System.Debug bir değişken içeren bir değişken grubu oluşturun ve bu değişken grubunu yayın işlem hattına bağlayın.

İlgili içerik

• Klasik yayın işlem hatlarındaki yapıt kaynakları

• Çekme isteği Yapıtlarını dağıtma

• Değişken grubunda değişkenleri kullanma