Klasik yayın ve yapıt değişkenleri

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015

uygulamanızı DevOps cı/CD işlemlerinizde her bir aşamaya dağıtmaya yönelik görevleri oluştururken, değişkenler şunları yapmanıza yardımcı olur:

• Daha genel bir dağıtım işlem hattını bir kez tanımlayıp her aşama için kolayca özelleştirin. Örneğin, bir değişken Web dağıtımı için bağlantı dizesini temsil etmek için kullanılabilir ve bu değişkenin değeri bir aşamadan diğerine değiştirilebilir. Bunlar özel değişkenlerdir.

• Dağıtım ardışık düzeninin çalıştırıldığı belirli bir yayın, aşama, yapıtveya aracının bağlamı hakkındaki bilgileri kullanın. Örneğin, betiğinizin indirmek için derleme konumuna veya geçici dosyalar oluşturmak için aracıdaki çalışma dizinine erişmesi gerekebilir. Bunlar varsayılan değişkenlerdir.

Varsayılan değişkenler

Yürütme bağlamı hakkındaki bilgiler, görevleri varsayılan değişkenlerle çalıştırmak için kullanılabilir hale getirilir. Görevleriniz ve betikleriniz, üzerinde çalıştıkları sistem, yayın, aşama veya aracı hakkında bilgi bulmak için bu değişkenleri kullanabilir. System. Debugdışında, bu değişkenler salt okunurdur 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. Tam listeyi görüntülemek için, bkz. tüm değişkenlerin geçerli değerlerini görüntüleme.

Sistem

Yayınla

Yayın aşaması

Aracı

Genel Yapıt

Bir yayında başvurulan her yapıt için aşağıdaki yapıt değişkenlerini kullanabilirsiniz. Her yapıt türü için tüm değişkenler anlamlı değildir. Aşağıdaki tabloda varsayılan yapıt değişkenleri listelenmiştir ve yapıt türüne bağlı olarak sahip olduğu değerlerin örnekleri verilmiştir. Bir örnek boşsa, değişkenin bu yapıt türü için doldurulmaması anlamına gelir.

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

Ayrıca bkz. Yapıt kaynağı diğer adı

Birincil Yapıt

Yapıtlardan birini yayın işlem hattında birincil yapıt olarak siz olarak atamayız. Belirlenen birincil yapıt için Azure Pipelines aşağıdaki değişkenleri doldurmak için kullanılır.

Varsayılan değişkenleri kullanma

Varsayılan değişkenleri iki şekilde kullanabilirsiniz: bir yayın işlem hattında veya betikleri kullanarak görevlere parametre olarak.

Varsayılan değişkeni bir göreve giriş olarak doğrudan kullanabilirsiniz. Örneğin, diğer adı Release.Artifacts.{Artifact alias}.DefinitionName ASPNET4 olan yapıt kaynağı Release.Artifacts.{Artifact alias}.DefinitionName göreve CI kullanır, kullanır. $(Release.Artifacts.ASPNET4.CI.DefinitionName)

Betiğinize varsayılan bir değişken kullanmak için önce varsayılan değişken . adlarında değerini ile değiştirmeniz _ gerekir. Örneğin, diğer adı Release.Artifacts.{Artifact alias}.DefinitionName ASPNET4 olan yapıt kaynağı için yapıt değişkeninin Release.Artifacts.{Artifact alias}.DefinitionName betiğinde CI $env:RELEASE_ARTIFACTS_ASPNET4_CI_DEFINITIONNAME kullanabilirsiniz.

Yapıt kaynağı diğer adının özgün adının ile ASPNET4.CI değiştir olduğunu ASPNET4_CI unutmayın.

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

1. Yayın özetinin işlem hatları görünümünü açın ve ilgilendiğinizi aşamayı seçin. Adım listesinde Işi başlat'ı seçin.

   

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

   

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

Yayın yürütülürken ve günlük dosyalarında, sürümün tamamını veya yalnızca tek bir yayın aşamasındaki görevleri hata ayıklama modunda çalıştırarak ek bilgileri göster. Bu, sorunları ve hataları çözmenize yardımcı olabilir.

• Bir sürümün tamamına hata ayıklama modunu başlatmak için, bir yayın işlem hattının Değişkenler sekmesine değeriyle System.Debugtrue adlı bir değişken ekleyin. System.Debug

• Tek bir aşamada hata ayıklama modunu başlatmak 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 adlı bir truetrue ekleyin.

• Alternatif olarak, değerine sahip adlı bir değişken içeren bir değişken grubu oluşturun ve bu değişken grubunu bir yayın işlem true hattına bağlamanız gerekir.

Özel değişkenler

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

• Değişken gruplarını kullanarak bir proje içinde tüm tanımlar arasında değerleri paylaşın. Bir proje içinde tüm tanımlar, aşamalar ve görevler arasında aynı değerleri kullanmak ve değerleri tek bir yerde değiştirmek istediğiniz bir değişken grubu seçin. Değişken gruplarını Kitaplık sekmesinde tanımlar ve yönetirsiniz.

• Yayın işlem hattı değişkenlerini kullanarak tüm aşamalarda değerleri paylaşın. Yayın işlem hattında tüm aşamalarda ve görevlerde aynı değeri kullanmak ve değeri tek bir yerde değiştirmek istediğiniz bir yayın işlem hattı değişkeni seçin. Bu değişkenleri bir yayın işlem hattında Değişkenler sekmesinde tanımlar ve yönetirsiniz. İşlem Hattı Değişkenleri sayfasında Kapsam açılan listesini açın ve "Yayın"ı seçin. Varsayılan olarak, bir değişken eklerken bu değişken Yayın kapsamı olarak ayarlanır.

• Aşama değişkenlerini kullanarak belirli bir aşamadaki tüm görevlerin değerlerini paylaşın. Aşamadan aşamaya farklılık gösterir (ve bir aşamadaki tüm görevler için aynıdır) değerler için aşama düzeyinde bir değişken kullanın. Bu değişkenleri bir yayın işlem hattının Değişkenler sekmesinde tanımlar ve yönetirsiniz. İşlem Hattı Değişkenleri sayfasında Kapsam açılan listesini açın ve gerekli aşamayı seçin. Bir değişken eklerken Kapsam'ın uygun ortam olarak ayarlayın.

Proje, yayın işlem hattı ve aşama kapsamında özel değişkenleri kullanmak şunları sağlar:

• Değerlerin çoğaltılmasından kaçının, bu da tüm oluşumların tek bir işlem olarak güncelleştirilsini kolaylaştırır.

• Hassas değerleri yayın işlem hatlarının kullanıcıları tarafından görüle veya değiştirilene bir şekilde depolar. Değişkenin yanındaki asma kilit (asma kilit) simgesini seçerek bir yapılandırma özelliğini güvenli (gizli) değişken olarak atama.

  Önemli

  Gizli (gizli) değişkenlerin değerleri sunucuda güvenli bir şekilde depolanır ve kaydedildikten sonra kullanıcılar tarafından görüntü olamaz. Dağıtım sırasında, Azure Pipelines yayın hizmeti, görevler tarafından başvurulsa bu değerlerin şifresini çözebilir ve güvenli bir HTTPS kanalı üzerinden aracıya iletir.

Özel değişkenleri kullanma

Derleme ve sürüm görevlerinize özel değişkenler kullanmak için, değişken adını parantez içine atayın ve önüne bir karakter $ ekleyin. Örneğin, adminUserNameadlı bir değişkeniniz varsa, bu değişkenin geçerli değerini bir görevin parametresine olarak eklersiniz.

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ük task.setvariable komutunu kullanın. Güncelleştirilmiş değişken değerinin kapsamı yürütülen işin kapsamına göredir ve işler veya aşamalar arasında akmaz. Değişken adları büyük harfe dönüştürülerek "." ve " " karakterleri "_" ile değiştirilir.

Örneğin, Agent.WorkFolderAGENT_WORKFOLDER olur. Bu Windows veya olarak %AGENT_WORKFOLDER%$env:AGENT_WORKFOLDER erişin. Linux ve macOS'ta $AGENT_WORKFOLDER kullanırsanız.

@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)"

#!/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şkenleri okumaktan konsol çıktısı:

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)