Kullanım değişkeni grupları ekleme &
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Değişken grupları, bir YAML işlem hattına geçirilmesini isteyebileceğiniz veya birden çok işlem hattında kullanılabilir hale getirmek isteyebileceğiniz değerleri ve gizli dizileri depolar. Aynı projedeki birden çok işlem hattında değişken gruplarını paylaşabilir ve kullanabilirsiniz.
Değişken grupları korumalı kaynaklardır. Bu değişkenlere onaylar ve denetimler ekleyebilir ve işlem hattı izinlerini ayarlayabilirsiniz.
Not
Microsoft Team Foundation Server (TFS) 2018 ve önceki sürümlerde derleme ve yayın işlem hatları tanım olarak adlandırılır, çalıştırmalar derleme olarak adlandırılır, hizmet bağlantılarıhizmet uç noktaları olarak adlandırılır, aşamalarortam olarak adlandırılır ve işleraşama olarak adlandırılır.
Değişken grubu oluşturma
YAML'de değişken grupları oluşturamazsınız, ancak bunlar Değişken grubu kullanma başlığında açıklandığı gibi kullanılabilir.
Değişken grubu kullanma
Değişken grubundan bir değişken kullanmak için YAML dosyanızdaki gruba bir başvuru ekleyin:
variables:
- group: my-variable-group
Ardından değişken grubundaki değişkenler YAML dosyanızda kullanılabilir.
Hem değişkenleri hem de değişken gruplarını kullanıyorsanız, tek tek gruplandırılmamış değişkenler için söz dizimini kullanın name/value :
variables:
- group: my-variable-group
- name: my-bare-variable
value: 'value of my-bare-variable'
Değişken grubuna başvurmak için makro söz dizimi veya çalışma zamanı ifadesi kullanın. Aşağıdaki örnekte, grubun my-variable-group adlı myhellobir değişkeni vardır.
variables:
- group: my-variable-group
- name: my-passed-variable
value: $[variables.myhello] # uses runtime expression
steps:
- script: echo $(myhello) # uses macro syntax
- script: echo $(my-passed-variable)
Aynı işlem hattında birden çok değişken grubuna başvurabilirsiniz. Birden çok değişken grubu aynı değişkeni içerirse, YAML dosyanıza en son dahil edilen değişken grubu değişkenin değerini ayarlar.
variables:
- group: my-first-variable-group
- group: my-second-variable-group
Şablondaki bir değişken grubuna da başvurabilirsiniz. şablonunda variables.ymlgruba my-variable-group başvurulur. Değişken grubu adlı myhellobir değişken içerir.
# variables.yml
variables:
- group: my-variable-group
Bu işlem hattında değişken grubundaki my-variable-group değişken $(myhello) eklenir ve variables.yml buna başvurulur.
# azure-pipeline.yml
stages:
- stage: MyStage
variables:
- template: variables.yml
jobs:
- job: Test
steps:
- script: echo $(myhello)
Değişken grubunu yetkilendirme
Bir değişken grubuyla çalışmak için grubu yetkilendirmeniz gerekir. Değişken grubunu yalnızca YAML'de adlandırdığınızda, deponuza kod gönderebilen herkes değişken grubundaki gizli dizilerin içeriğini ayıklayabilir. Grubu yetkilendirmek için aşağıdaki tekniklerden birini kullanın:
Herhangi bir işlem hattını değişken grubunu kullanacak şekilde yetkilendirmek için Azure Pipelines'a gidin. Grupta gizli diziniz yoksa bu iyi bir seçenek olabilir. Kitaplık>Değişkeni grupları'nı seçin, ardından söz konusu değişken grubunu seçin ve Tüm işlem hatlarına erişime izin ver ayarını etkinleştirin.
Belirli bir işlem hattı için bir değişken grubunu yetkilendirmek için işlem hattını açın, Düzenle'yi seçin ve ardından derlemeyi el ile kuyruğa alın. Hatada bir kaynak yetkilendirme hatası ve "Kaynakları yetkile" eylemi görürsünüz. İşlem hattını değişken grubunun yetkili kullanıcısı olarak açıkça eklemek için bu eylemi seçin.
Not
bir işlem hattına değişken grubu eklerseniz ve derlemenizde beklediğiniz bir kaynak yetkilendirme hatasıyla karşılaşırsanız , Tüm işlem hatlarına erişime izin ver ayarını kapatın.
YAML derlemeleri TFS'de kullanılamaz.
Bağlı değişken grubundaki değişken değerlerine , işlem hattı içinde tanımladığınız değişkenlerle aynı şekilde erişin.
Örneğin, işlem hattına bağlı bir değişken grubundaki customer adlı değişkenin değerine erişmek için bir görev parametresinde veya betikte kullanın $(customer) . Ancak, gizli dizi değişkenlerine (şifrelenmiş değişkenler ve anahtar kasası değişkenleri) doğrudan betiklerde erişemezsiniz; bunun yerine, bunların göreve bağımsız değişken olarak geçirilmesi gerekir. Daha fazla bilgi için bkz . gizli diziler
Değişken grubunda yaptığınız değişiklikler, değişken grubunun bağlandığı tüm tanımlar veya aşamalar için otomatik olarak kullanılabilir.
Değişken gruplarını listeleme
az pipelines variable-group list komutuyla işlem hattı çalıştırmaları için değişken gruplarını listelemek için CLI'yi kullanın. CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group list [--action {manage, none, use}]
[--continuation-token]
[--group-name]
[--org]
[--project]
[--query-order {Asc, Desc}]
[--top]
İsteğe bağlı parametreler
- action: Değişken gruplarında gerçekleştirilebilecek eylemi belirtir. Kabul edilen değerler yönetilir, hiçbiri ve kullanılır.
- continuation-token: Bir devamlılık belirteci sağlandıktan sonra değişken gruplarını listeler.
- group-name: Değişken grubunun adı. Joker karakterler kabul edilir, örneğin
new-var*. - org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. - query-order: Sonuçları artan veya azalan (varsayılan) sırada listeler. Kabul edilen değerler Asc ve Desc değerleridir.
- top: Listelenecek değişken gruplarının sayısı.
Örnek
Aşağıdaki komut, ilk üç değişken grubunu artan düzende listeler ve sonuçları tablo biçiminde döndürür.
az pipelines variable-group list --top 3 --query-order Asc --output table
ID Name Type Number of Variables
---- ----------------- ------ ---------------------
1 myvariables Vsts 2
2 newvariables Vsts 4
3 new-app-variables Vsts 3
Değişken grubunun ayrıntılarını gösterme
az pipelines variable-group show komutuyla projenizdeki bir değişken grubunun ayrıntılarını görüntüleyin. CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group show --group-id
[--org]
[--project]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir.
Örnek
Aşağıdaki komut, 4 kimliğine sahip 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
authorized: false
description: Variables for my new app
id: 4
name: MyNewAppVariables
providerData: null
type: Vsts
variables:
app-location:
isSecret: null
value: Head_Office
app-name:
isSecret: null
value: Fabrikam
Değişken grubunu silme
az pipelines variable-group delete komutuyla projenizdeki bir değişken grubunu silin. CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group delete --group-id
[--org]
[--project]
[--yes]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. - Evet: İsteğe bağlı. Onay istemez.
Örnek
Aşağıdaki komut , 1 kimliğine sahip değişken grubunu siler ve onay istemez.
az pipelines variable-group delete --group-id 1 --yes
Deleted variable group successfully.
Değişken grubuna değişken ekleme
Azure DevOps CLI ile az pipelines variable-group variable create komutuyla bir işlem hattındaki değişken grubuna değişken ekleyebilirsiniz. CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group variable create --group-id
--name
[--org]
[--project]
[--secret {false, true}]
[--value]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- name: Gerekli. Eklediğiniz değişkenin adı.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. - secret: İsteğe bağlı. Değişkenin değerinin gizli dizi olup olmadığını gösterir. Kabul edilen değerler false ve true değerleridir.
- değer: Gizli dizi olmayan değişken için gereklidir. Değişkenin değeri. Gizli dizi değişkenleri için , değer parametresi sağlanmazsa ön ekli
AZURE_DEVOPS_EXT_PIPELINE_VAR_ortam değişkeninden seçilir veya kullanıcıdan standart giriş yoluyla girmesi istenir. Örneğin, MySecret adlı bir değişken ortam değişkeniAZURE_DEVOPS_EXT_PIPELINE_VAR_MySecretkullanılarak giriş yapılabilir.
Örnek
Aşağıdaki komut, değişken grubunda 4 kimliğine sahip bir değişken oluşturur. Yeni değişken requires-login olarak adlandırılır ve True değerine sahiptir ve sonuç tablo biçiminde gösterilir.
az pipelines variable-group variable create --group-id 4 --name requires-login --value True --output table
Name Is Secret Value
-------------- ----------- -------
requires-login False True
Değişken grubundaki değişkenleri listeleme
değişken grubundaki değişkenleri az pipelines variable-group variable list komutuyla listeleyebilirsiniz . CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group variable list --group-id
[--org]
[--project]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir.
Örnek
Aşağıdaki komut, değişken grubundaki 4 kimliğine sahip tüm değişkenleri listeler ve sonucu tablo biçiminde gösterir.
az pipelines variable-group variable list --group-id 4 --output table
Name Is Secret Value
-------------- ----------- -----------
app-location False Head_Office
app-name False Fabrikam
requires-login False True
Değişken grubundaki değişkenleri güncelleştirme
değişken grubundaki bir değişkeni az pipelines variable-group variable update komutuyla güncelleştirin . CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group variable update --group-id
--name
[--new-name]
[--org]
[--project]
[--prompt-value {false, true}]
[--secret {false, true}]
[--value]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- name: Gerekli. Eklediğiniz değişkenin adı.
- new-name: İsteğe bağlı. Değişkenin adını değiştirmek için belirtin.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. - prompt-value: Ortam değişkenini kullanarak veya standart giriş aracılığıyla istem kullanarak bir gizli değişkenin değerini güncelleştirmek için true olarak ayarlayın. Kabul edilen değerler false ve true değerleridir.
- secret: İsteğe bağlı. Değişkenin değerinin gizli tutulup tutulmadığını gösterir. Kabul edilen değerler false ve true değerleridir.
- value: Değişkenin değerini güncelleştirir. Gizli dizi değişkenleri için, standart giriş aracılığıyla girmeniz istenecek prompt-value parametresini kullanın. Etkileşimli olmayan konsollar için, ön ekli
AZURE_DEVOPS_EXT_PIPELINE_VAR_ortam değişkeninden seçilebilir. Örneğin, MySecret adlı bir değişken ortam değişkeniAZURE_DEVOPS_EXT_PIPELINE_VAR_MySecretkullanılarak giriş yapılabilir.
Örnek
Aşağıdaki komut requires-login değişkenini değişken grubundaki 4 kimliğine sahip yeni False değeriyle güncelleştirir. Değişkenin bir gizli dizi olduğunu belirtir ve sonucu YAML biçiminde gösterir. Gizli bir gizli değer olduğundan çıktının değeri False yerine null olarak gösterdiğine dikkat edin.
az pipelines variable-group variable update --group-id 4 --name requires-login --value False --secret true --output yaml
requires-login:
isSecret: true
value: null
Değişken grubundan değişkenleri silme
az pipelines variable-group variable delete komutuyla değişken grubundan bir değişken silin. CLI için Azure DevOps uzantısı sizin için yeniyse bkz. Azure DevOps CLI'yı kullanmaya başlama.
az pipelines variable-group variable delete --group-id
--name
[--org]
[--project]
[--yes]
Parametreler
- group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listeleme.
- name: Gerekli. Sildiğiniz değişkenin adı.
- org: Azure DevOps kuruluş URL'si. kullanarak
az devops configure -d organization=ORG_URLvarsayılan kuruluşu yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. Örnek:--org https://dev.azure.com/MyOrganizationName/. - project: Projenin adı veya kimliği. kullanarak
az devops configure -d project=NAME_OR_IDvarsayılan projeyi yapılandırın. Varsayılan olarak yapılandırılmadıysa veya kullanılarakgit configalınmadıysa gereklidir. - Evet: İsteğe bağlı. Onay istemez.
Örnek
Aşağıdaki komut , requires-login değişkenini 4 kimliğine sahip değişken grubundan siler ve onay ister.
az pipelines variable-group variable delete --group-id 4 --name requires-login
Are you sure you want to delete this variable? (y/n): y
Deleted variable 'requires-login' successfully.
Azure Key Vault'tan gizli dizilere bağlanma
Var olan bir Azure anahtar kasasını bir değişken grubuna bağlayın ve seçmeli kasa gizli dizilerini değişken grubuna eşleyin.
Değişken grupları sayfasında Azure anahtar kasasından gizli dizileri değişken olarak bağlama'yı etkinleştirin. Gizli dizilerinizi içeren mevcut bir anahtar kasasına ihtiyacınız olacaktır. Azure portalını kullanarak bir anahtar kasası oluşturun.
Azure aboneliği uç noktanızı ve gizli dizilerinizi içeren kasanın adını belirtin.
Azure hizmet bağlantısının gizli diziler için kasada en azından Alma ve Listeleme yönetimi izinlerine sahip olduğundan emin olun. Kasa adının yanındaki Yetkile'yi seçerek Azure Pipelines'ın bu izinleri ayarlamasını etkinleştirin. İstersenz Azure portalında izinleri el ile de ayarlayabilirsiniz:
- Kasa ayarları'nı açın ve erişim ilkeleri>Yeni ekle'yi seçin.
- Sorumlu seç'i seçin ve ardından istemci hesabınız için hizmet sorumlusunu seçin.
- Gizli dizi izinleri'ne tıklayın ve Al ve Liste'nin onay işaretlerine sahip olduğundan emin olun.
- Değişiklikleri kaydetmek için Tamam'ı seçin.
Değişken grupları sayfasında + Ekle'yi seçerek bu değişken grubuna eşlemek üzere kasanızdan belirli gizli dizileri seçin.
Anahtar kasası gizli dizilerini yönetme
Gizli dizileri yönetmek için aşağıdaki yararlı ipuçları listesine bakın.
Yalnızca gizli dizi adları değişken grubuna eşlenir, gizli dizi değerlerine eşlenmez. Kasadan getirilen en son gizli dizi değeri, değişken grubuna bağlı işlem hattı çalıştırmasında kullanılır.
Anahtar kasasında var olan gizli dizilerde yapılan değişiklikler, değişken grubunun içinde kullanıldığı tüm işlem hatlarında otomatik olarak kullanılabilir.
Kasaya yeni gizli diziler eklendiğinde veya kasadan silindiğinde, ilişkili değişken grupları otomatik olarak güncelleştirilmez. Değişken grubuna dahil edilen gizli diziler, değişken grubunu kullanan işlem hatlarının doğru şekilde yürütülmesi için açıkça güncelleştirilmelidir.
Azure Key Vault, Azure'da şifreleme anahtarlarının ve gizli dizilerinin depolanmasını ve yönetilmesini destekler. Şu anda Azure Pipelines değişken grubu tümleştirmesi yalnızca Azure anahtar kasasından gizli dizileri eşlemeyi destekler. Şifreleme anahtarları ve sertifikaları desteklenmez.
Gruptaki değişkenleri genişletme
Bir grupta bir değişken ayarladığınızda ve bir YAML dosyasında kullandığınızda, YAML dosyasındaki diğer tanımlı değişkenlere eşittir. Değişkenlerin önceliği hakkında daha fazla bilgi için bkz. Değişkenler.
YAML, TFS'de desteklenmez.