Değişken gruplarını yönetme

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

Bu makalede, Azure Pipelines'da değişken gruplarının nasıl oluşturulacağı ve kullanılacağı açıklanmaktadır. Değişken gruplar, bir YAML işlem hattına geçirebileceğiniz veya bir projedeki birden çok işlem hattında kullanılabilir hale getirebileceğiniz değerleri ve gizli dizileri depolar.

Değişken gruplarındaki gizli dizi değişkenleri korumalı kaynaklardır. Bir değişken grubundaki gizli dizi değişkenlerine erişimi sınırlamak için onay, denetim ve işlem hattı izinlerinin birleşimlerini ekleyebilirsiniz. Güvenli olmayan değişkenlere erişim onaylar, denetimler veya işlem hattı izinleriyle sınırlı değildir.

Değişken grupları, roller ve izinler için kitaplık güvenlik modelini izler.

Önkoşullar

• İşlem hatları ve değişkenler oluşturma izinlerinizin olduğu bir Azure DevOps Services kuruluşu ve projesi.
• Azure DevOps kuruluşunuzdaki veya Azure DevOps Server koleksiyonunuzdaki bir proje. Projeniz yoksa proje oluşturun.
• Azure DevOps CLI kullanıyorsanız, Azure DevOps CLI uzantısıyla Azure CLI sürüm 2.30.0 veya üzeri gerekir. Daha fazla bilgi için bkz . Azure DevOps CLI'yı kullanmaya başlama.

CLI’yi ayarlama

Azure DevOps CLI kullanıyorsanız, CLI'yi Azure DevOps kuruluşunuz ve projenizle çalışacak şekilde ayarlamanız gerekir.

1. az login komutunu kullanarak Azure DevOps kuruluşunuzda oturum açın .

   az login
   

2. İstenirse, terminal pencerenizde görüntülenen listeden aboneliğinizi seçin.

3. Aşağıdaki komutları kullanarak Azure CLI ve Azure DevOps uzantısının en son sürümünü çalıştırdığınızdan emin olun.

   az upgrade
   az extension add --name azure-devops --upgrade
   

4. Azure DevOps CLI komutlarında, aşağıdakileri kullanarak varsayılan kuruluşu ve projeyi ayarlayabilirsiniz:

   az devops configure --defaults organization=<YourOrganizationURL> project=<Project Name or ID>`
   

   Varsayılan kuruluşu ve projeyi ayarlamadıysanız, geçerli dizininize göre kuruluş ve proje bağlamını detect=true otomatik olarak algılamak için komutlarınızdaki parametresini kullanabilirsiniz. Varsayılanlar yapılandırılmadıysa veya algılanmıyorsa, komutlarınızda ve project parametrelerini açıkça belirtmeniz org gerekir.

Değişken grubu oluşturma

Projenizdeki işlem hattı çalıştırmaları için değişken grupları oluşturabilirsiniz.

Not

Azure anahtar kasasından gizli dizileri değişken olarak bağlamak üzere gizli dizi değişken grubu oluşturmak için Azure Key Vault'ta bir değişken grubunu gizli dizilere bağlama başlığındaki yönergeleri izleyin.

Azure Pipelines Kullanıcı Arabirimi

1. Azure DevOps projenizde soldaki menüden İşlem Hatları>Kitaplığı'nı seçin.

2. Kitaplık sayfasında + Değişken grubu'nu seçin.

   

3. Yeni değişken grubu sayfasındaki Özellikler'in altında, değişken grubu için bir ad ve isteğe bağlı bir açıklama girin.

4. Değişkenler'in altında + Ekle'yi seçin ve ardından gruba eklenecek değişken adını ve değerini girin. Değeri şifrelemek ve güvenli bir şekilde depolamak istiyorsanız değişkenin yanındaki kilit simgesini seçin.

5. Her yeni değişkeni eklemek için + Ekle'yi seçin. Değişken eklemeyi bitirdiğinizde Kaydet'i seçin.

   

Artık bu değişken grubunu proje işlem hatlarında kullanabilirsiniz.

Azure DevOps CLI

Azure DevOps Services'da, Azure DevOps CLI kullanarak değişken grupları oluşturabilirsiniz.

Değişken grubu oluşturmak için az pipelines variable-group create komutunu kullanın.

Örneğin, aşağıdaki komut adlı home-office-configbir değişken grubu oluşturur, ve app-name=contosodeğişkenlerini app-location=home-office ekler ve sonuçları YAML biçiminde çıkışlar.

az pipelines variable-group create --name home-office-config
                                   --variables app-location=home-office app-name=contoso
                                   --output yaml

Çıktı:

authorized: false
description: null
id: 5
name: home-office-config
providerData: null
type: Vsts
variables:
  app-location:
    isSecret: null
    value: home-office
  app-name:
    isSecret: null
    value: contoso

Değişken gruplarını güncelleştirme

Azure Pipelines Kullanıcı Arabirimi

Azure Pipelines kullanıcı arabirimini kullanarak değişken gruplarını güncelleştirebilirsiniz.

1. Azure DevOps projenizde soldaki menüden İşlem Hatları>Kitaplığı'nı seçin.
2. Kitaplık sayfasında, güncelleştirmek istediğiniz değişken grubunu seçin. Ayrıca değişken grubu listesinin üzerine gelebilir, Diğer seçenekler simgesini ve menüden Düzenle'yi seçebilirsiniz.
3. Değişken grubu sayfasında, özelliklerden herhangi birini değiştirin ve kaydet'i seçin.

Azure DevOps CLI

Azure DevOps Services'da, Azure DevOps CLI'yı kullanarak değişken gruplarını güncelleştirebilirsiniz.

Değişken gruplarını listeleme

Azure DevOps CLI kullanarak bir değişken grubunu veya içindeki değişkenleri güncelleştirmek için değişken grubunu group-idkullanırsınız.

Değişken grubu oluşturma komutunun çıkışından değişken grubu kimliğinin değerini alabilir veya az pipelines variable-group list komutunu kullanabilirsiniz.

Örneğin, aşağıdaki komut ilk üç proje değişken grubunu artan sırada listeler ve değişken grubu kimliği de dahil olmak üzere sonuçları tablo biçiminde döndürür.

az pipelines variable-group list --top 3 --query-order Asc --output table

Çıktı:

ID    Name               Type    Number of Variables
----  -----------------  ------  ---------------------
1     myvariables        Vsts    2
2     newvariables       Vsts    4
3     new-app-variables  Vsts    3

Değişken grubunu güncelleştirme

Değişken grubunu güncelleştirmek için az pipelines variable-group update komutunu kullanın.

Not

Azure DevOps CLI kullanarak değişken grubu türünü AzureKeyVault güncelleştiremezsiniz.

Örneğin, aşağıdaki komut değişken grubunu id 4 ile güncelleştirerek ve descriptiondeğerlerini değiştirir name ve sonuçları tablo biçiminde verir.

az pipelines variable-group update --group-id 4
                                   --name my-new-variables
                                   --description "New home office variables"
                                   --output table

Çıktı:

ID    Name              Description               Is Authorized  Number of Variables
----  ----------------  ------------------------- -------------  -------------------
4     my-new-variables  New home office variables false          2

Değişken grubunun ayrıntılarını gösterme

Bir değişken grubunun ayrıntılarını göstermek için az pipelines variable-group show komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut id 4 ile değişken grubunun ayrıntılarını gösterir ve sonuçları YAML biçiminde döndürür.

az pipelines variable-group show --group-id 4 --output yaml

Çıktı:

authorized: false
description: Variables for my new app
id: 4
name: my-new-variables
providerData: null
type: Vsts
variables:
  app-location:
    isSecret: null
    value: home-office
  app-name:
    isSecret: null
    value: contoso

Değişken grubunu silme

Azure Pipelines Kullanıcı Arabirimi

Azure Pipelines kullanıcı arabiriminde değişken gruplarını silebilirsiniz.

1. Azure DevOps projenizde soldaki menüden İşlem Hatları>Kitaplığı'nı seçin.
2. Kitaplık sayfasında, silmek istediğiniz değişken grubunun üzerine gelin ve Diğer seçenekler simgesini seçin.
3. Menüden Sil'i ve ardından onay ekranında Sil'i seçin.

Azure DevOps CLI

Azure DevOps Services'te, Azure DevOps CLI'yı kullanarak değişken gruplarını silebilirsiniz.

Değişken grubunu silmek için az pipelines variable-group delete komutunu kullanın. Örneğin, aşağıdaki komut id 1 ile değişken grubunu siler ve onay istemez.

az pipelines variable-group delete --group-id 1 --yes

Değişken gruplarındaki değişkenleri yönetme

Azure Pipelines Kullanıcı Arabirimi

Azure Pipelines kullanıcı arabirimini kullanarak değişken gruplarındaki değişkenleri değiştirebilir, ekleyebilir veya silebilirsiniz.

1. Azure DevOps projenizde soldaki menüden İşlem Hatları>Kitaplığı'nı seçin.
2. Kitaplık sayfasında, güncelleştirmek istediğiniz değişken grubunu seçin. Ayrıca değişken grubu listesinin üzerine gelebilir, Diğer seçenekler simgesini ve menüden Düzenle'yi seçebilirsiniz.
3. Değişken grubu sayfasında şunları yapabilirsiniz:
   • Değişken adlarından veya değerlerinden herhangi birini değiştirin.
   • Değişken adının yanındaki çöp kutusu simgesini seçerek değişkenlerden herhangi birini silin.
   • Değişken değerinin yanındaki kilit simgesini seçerek değişkenleri gizli veya güvenli olmayan olarak değiştirin.
   • + Ekle'yi seçerek yeni değişkenler ekleyin.
4. Değişiklik yaptıktan sonra Kaydet'i seçin.

Azure DevOps CLI

Azure DevOps Services'da, Azure DevOps CLI kullanarak değişken gruplarındaki değişkenleri yönetebilirsiniz.

Değişken grubundaki değişkenleri listeleme

Değişken grubundaki değişkenleri listelemek için az pipelines variable-group variable list komutunu kullanın. Örneğin, aşağıdaki komut id 4 ile değişken grubundaki tüm değişkenleri listeler ve sonucu tablo biçiminde gösterir.

az pipelines variable-group variable list --group-id 4 --output table

Çıktı:

Name            Is Secret    Value
--------------  -----------  -----------
app-location    False        home-office
app-name        False        contoso

Değişken grubuna değişken ekleme

Değişken grubuna değişken eklemek için az pipelines variable-group variable create komutunu kullanın.

Örneğin, aşağıdaki komut, id 4ile değişken grubunda varsayılan değeri true ile adlı requires-login yeni bir değişken oluşturur. Sonuç tablo biçiminde gösterilir.

az pipelines variable-group variable create --group-id 4
                                            --name requires-login
                                            --value true
                                            --output table

Çıktı:

Name            Is Secret    Value
--------------  -----------  -------
requires-login  False        true

Değişken grubundaki değişkenleri güncelleştirme

Değişken grubundaki değişkenleri güncelleştirmek için az pipelines variable-group variable update komutunu kullanın.

Not

Azure DevOps CLI kullanarak değişken grubundaki AzureKeyVault değişkenleri güncelleştiremezsiniz. Komutları kullanarak az keyvault değişkenleri güncelleştirebilirsiniz.

Örneğin, aşağıdaki komut değişkenini requires-login kimliğine 4sahip değişken grubundaki yeni değerle false güncelleştirir ve sonucu YAML biçiminde gösterir. komutu değişkeninin bir secretolduğunu belirtir.

az pipelines variable-group variable update --group-id 4
                                            --name requires-login
                                            --value false
                                            --secret true
                                            --output yaml

Çıkış, gizli bir gizli değer olduğundan değerini yerine olarak null false gösterir.

requires-login:
  isSecret: true
  value: null

Gizli dizi değişkenlerini yönetme

Gizli dizi değişkenlerini yönetmek için aşağıdaki parametrelerle az pipelines variable-group variable update komutunu kullanın:

• secret: değişkenin değerinin gizli tutulduğunu belirtmek için olarak ayarlayın true .
• prompt-value: Bir ortam değişkeni kullanarak veya standart giriş aracılığıyla istem kullanarak gizli dizi değişkeninin değerini güncelleştirmek için olarak ayarlayın true .
• value: Gizli dizi değişkenleri için, standart giriş aracılığıyla değerin girilmesi istenecek parametresini kullanın prompt-value . Etkileşimsiz konsollar için ön ekli AZURE_DEVOPS_EXT_PIPELINE_VAR_ortam değişkenini alabilirsiniz. Örneğin, ortam değişkenini kullanarak adlı MySecret bir değişken AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecretekleyebilirsiniz.

Değişken grubundan değişkenleri silme

Değişken grubundan bir değişkeni silmek için az pipelines variable-group variable delete komutunu kullanın. Örneğin, aşağıdaki komut değişkeni id 4ile değişken grubundan silerrequires-login.

az pipelines variable-group variable delete --group-id 4 --name requires-login

Komut, varsayılan olduğu için onay ister. Onay istemini --yes atlamak için parametresini kullanın.

Are you sure you want to delete this variable? (y/n): y
Deleted variable 'requires-login' successfully.

İşlem hatlarında değişken grupları kullanma

YAML veya Klasik işlem hatlarında değişken grupları kullanabilirsiniz. Değişken grubunda yaptığınız değişiklikler, değişken grubunun bağlı olduğu tüm tanımlar veya aşamalar için otomatik olarak kullanılabilir.

YAML

Değişken grubunu yalnızca YAML işlem hatlarında adlandırıyorsanız, deponuza kod gönderebilen herkes değişken grubundaki gizli dizilerin içeriğini ayıklayabilir. Bu nedenle, yaml işlem hatları ile bir değişken grubu kullanmak için grubu kullanmak için işlem hattını yetkilendirmeniz gerekir. İşlem hattını Azure Pipelines kullanıcı arabiriminde veya Azure DevOps CLI'sini kullanarak değişken grubu kullanma yetkisi vekleyebilirsiniz.

İşlem Hatları kullanıcı arabirimi aracılığıyla yetkilendirme

Azure Pipelines kullanıcı arabirimini kullanarak işlem hatlarını değişken gruplarınızı kullanacak şekilde yetkilendirilebilirsiniz.

1. Azure DevOps projenizde soldaki menüden İşlem Hatları>Kitaplığı'nı seçin.
2. Kitaplık sayfasında, yetkilendirmek istediğiniz değişken grubunu seçin.
3. Değişken grubu sayfasında İşlem hattı izinleri sekmesini seçin.
4. İşlem hattı izinleri ekranında yetkilendirmek + için bir işlem hattı seçin. Alternatif olarak, Diğer eylemler simgesini seçin, Erişimi aç'ı seçin ve onaylamak için Erişimi yeniden aç'ı seçin.

İşlem hattı seçildiğinde bu işlem hattı değişken grubunu kullanma yetkisine sahip olur. Başka bir işlem hattını yetkilendirmek için simgeyi + yeniden seçin. Açık erişim seçildiğinde tüm proje işlem hatları değişken grubunu kullanma yetkisine sahip olur. Grupta gizli diziniz yoksa açık erişim iyi bir seçenek olabilir.

Değişken grubunu yetkilendirmenin bir diğer yolu da işlem hattını seçmek, Düzenle'yi seçmek ve ardından derlemeyi el ile kuyruğa almaktır. Kaynak yetkilendirme hatası görürsünüz ve ardından işlem hattını değişken grubunun yetkili kullanıcısı olarak açıkça ekleyebilirsiniz.

Azure DevOps CLI aracılığıyla yetkilendirme

Azure DevOps Services'da, Azure DevOps CLI'yı kullanarak değişken gruplarını yetkilendirilebilirsiniz.

Tüm proje işlem hatlarını değişken grubunu kullanacak şekilde yetkilendirmek için az pipelines variable-group create komutundaki parametresini olarak trueayarlayınauthorize. Grupta gizli diziniz yoksa bu açık erişim iyi bir seçenek olabilir.

Değişken grubunu işlem hattına bağlama

YAML işlem hattını değişken grubu kullanma yetkisi verdikten sonra, işlem hattındaki grubun içindeki değişkenleri kullanabilirsiniz.

Değişken grubundaki değişkenleri kullanmak için YAML işlem hattı dosyanızda grup adına bir başvuru ekleyin.

variables:
- group: my-variable-group

Aynı işlem hattında birden çok değişken grubuna başvurabilirsiniz. Birden çok değişken grubu aynı ada sahip değişkenleri içerirse, dosyadaki değişkeni kullanan son değişken grubu değişkenin değerini ayarlar. Değişkenlerin önceliği hakkında daha fazla bilgi için bkz . Değişkenleri genişletme.

Şablondaki bir değişken grubuna da başvurabilirsiniz. Aşağıdaki variables.yml şablon dosyası değişken grubuna my-variable-groupbaşvurur. Değişken grubu adlı myhellobir değişken içerir.

variables:
- group: my-variable-group

YAML işlem hattı variables.yml şablonuna başvurur ve değişken grubundan my-variable-groupdeğişkenini $(myhello) kullanır.

stages:
- stage: MyStage
  variables:
  - template: variables.yml
  jobs:
  - job: Test
    steps:
    - script: echo $(myhello)

Bağlı değişken grubunda değişkenleri kullanma

Bağlı değişken grubundaki değişken değerlerine, işlem hattı içinde tanımladığınız değişkenlere eriştiginiz gibi erişebilirsiniz. Örneğin, işlem hattına bağlı bir değişken grubundaki adlı customer değişkenin değerine erişmek için bir görev parametresinde veya betikte kullanabilirsiniz $(customer) .

İşlem hattı dosyanızda hem tek başına değişkenleri hem de değişken gruplarını kullanıyorsanız, tek başına değişkenler için söz dizimini kullanın name-value .

variables:
- group: my-variable-group
- name: my-standalone-variable
  value: 'my-standalone-variable-value'

Değişken grubundaki bir değişkene başvurmak için makro söz dizimi veya çalışma zamanı ifadesi kullanabilirsiniz. Aşağıdaki örneklerde, grubun my-variable-group adlı myhellobir değişkeni vardır.

Çalışma zamanı ifadesi kullanmak için:

variables:
- group: my-variable-group
- name: my-passed-variable
  value: $[variables.myhello]
- script: echo $(my-passed-variable)

Makro söz dizimlerini kullanmak için:

variables:
- group: my-variable-group

steps:
- script: echo $(myhello)

Şifrelenmiş değişkenler ve anahtar kasası değişkenleri dahil olmak üzere gizli dizi değişkenlerine doğrudan betiklerde erişemezsiniz. Bu değişkenleri bir göreve bağımsız değişken olarak geçirmelisiniz. Daha fazla bilgi için bkz . Gizli dizi değişkenleri.

Klasik

Klasik işlem hatlarında değişken grupları kullanma

Klasik işlem hatları, ayrı yetkilendirme olmadan değişken grupları kullanabilir. Değişken grubu kullanmak için:

1. Klasik işlem hattınızı açın.

2. Değişkenler>Değişken grupları'nın ardından Değişken grubunu bağla'yı seçin.

   • Derleme işlem hattında kullanılabilir grupların listesini görürsünüz. Bir değişken grubu seçin ve Bağlantı'ya tıklayın. Gruptaki tüm değişkenler işlem hattı içinde kullanılabilir.

   • Yayın işlem hattında işlem hattındaki aşamaların açılan listesini de görürsünüz. Değişken grubunu işlem hattının kendisine veya yayın işlem hattının belirli bir veya daha fazla aşamasına bağlayın. Bir veya daha fazla aşamaya bağlantı verirseniz, değişken grubundaki değişkenlerin kapsamı bu aşamalara göre belirlenmiştir ve yayının diğer aşamalarında erişilebilir değildir.

   

Birden çok kapsamda aynı ada sahip bir değişken ayarladığınızda, en yüksek öncelik olan aşağıdaki öncelik kullanılır:

1. Kuyruk zamanında ayarlanan değişken
2. İşlem hattında değişken kümesi
3. Değişken grubunda değişken kümesi

Değişkenlerin önceliği hakkında daha fazla bilgi için bkz . Değişkenleri genişletme.

Not

Aynı kapsamdaki bir işlem hattına (örneğin, iş veya aşama) bağlı olan farklı gruplardaki değişkenler çakılır ve sonuç öngörülemez olabilir. Tüm değişken gruplarınızda değişkenler için farklı adlar kullandığınızdan emin olun.

İlgili makaleler

• Değişkenleri tanımlama
• Özel değişkenleri tanımlama
• Değişken gruplarında gizli dizi ve güvensiz değişkenleri kullanma
• Azure Pipelines’da Azure Key Vault Gizli Dizilerini Kullanma
• Onay ve denetim ekleme