변수 그룹 관리

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

이 문서에서는 Azure Pipelines에서 변수 그룹을 만들고 사용하는 방법을 설명합니다. 변수 그룹은 YAML 파이프라인에 전달하거나 프로젝트의 여러 파이프라인에서 사용할 수 있는 값과 비밀을 저장합니다.

변수 그룹의 비밀 변수는 보호되는 리소스입니다. 승인, 검사 및 파이프라인 권한의 조합을 추가하여 변수 그룹의 비밀 변수에 대한 액세스를 제한할 수 있습니다. 비보안 변수에 대한 액세스는 승인, 검사 또는 파이프라인 권한으로 제한되지 않습니다.

변수 그룹은 역할 및 권한에 대한 라이브러리 보안 모델을 따릅니다.

필수 조건

• 파이프라인 및 변수를 만들 수 있는 권한이 있는 Azure DevOps Services 조직 및 프로젝트입니다.
• Azure DevOps 조직 또는 Azure DevOps Server 컬렉션의 프로젝트입니다. 프로젝트가 없는 경우 프로젝트를 만듭니다.
• Azure DevOps CLI를 사용하는 경우 Azure DevOps CLI 확장을 사용하는 Azure CLI 버전 2.30.0 이상이 필요합니다. 자세한 내용은 Azure DevOps CLI 시작을 참조하세요.

CLI 설정

Azure DevOps CLI를 사용하는 경우 Azure DevOps 조직 및 프로젝트와 함께 작동하도록 CLI를 설정해야 합니다.

1. az login 명령을 사용하여 Azure DevOps 조직에 로그인합니다.

   az login
   

2. 메시지가 표시되면 터미널 창에 표시된 목록에서 구독을 선택합니다.

3. 다음 명령을 사용하여 최신 버전의 Azure CLI 및 Azure DevOps 확장을 실행하고 있는지 확인합니다.

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

4. Azure DevOps CLI 명령에서 다음을 사용하여 기본 조직 및 프로젝트를 설정할 수 있습니다.

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

   기본 조직 및 프로젝트를 설정하지 않은 경우 명령의 detect=true 매개 변수를 사용하여 현재 디렉터리에 따라 조직 및 프로젝트 컨텍스트를 자동으로 검색할 수 있습니다. 기본값이 구성되거나 검색되지 않은 경우 명령에서 매개 변수 및 project 매개 변수를 org 명시적으로 지정해야 합니다.

변수 그룹 만들기

프로젝트에서 파이프라인 실행에 대한 변수 그룹을 만들 수 있습니다.

참고 항목

Azure Key Vault의 비밀을 변수로 연결하는 비밀 변수 그룹을 만들려면 Azure Key Vault의 비밀에 변수 그룹 연결의 지침을 따릅니다.

Azure Pipelines UI

1. Azure DevOps 프로젝트의 왼쪽 메뉴에서 파이프라인>라이브러리를 선택합니다.

2. 라이브러리 페이지에서 + 변수 그룹을 선택합니다.

   

3. 새 변수 그룹 페이지의 속성 아래에서 변수 그룹에 대한 이름 및 선택적 설명을 입력합니다.

4. 변수에서 + 추가를 선택한 다음 그룹에 포함할 변수 이름과 값을 입력합니다. 값을 암호화하고 안전하게 저장하려면 변수 옆에 있는 잠금 아이콘을 선택합니다.

5. + 추가를 선택하여 각 새 변수를 추가합니다. 변수 추가를 마치면 저장을 선택합니다.

   

이제 프로젝트 파이프라인에서 이 변수 그룹을 사용할 수 있습니다.

Azure DevOps CLI

Azure DevOps Services에서 Azure DevOps CLI를 사용하여 변수 그룹을 만들 수 있습니다.

변수 그룹을 만들려면 az pipelines variable-group create 명령을 사용합니다.

예를 들어 다음 명령은 이름이 지정된 home-office-config변수 그룹을 만들고, 변수와 app-name=contoso변수를 app-location=home-office 추가하고, 결과를 YAML 형식으로 출력합니다.

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

출력:

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

변수 그룹 업데이트

Azure Pipelines UI

Azure Pipelines 사용자 인터페이스를 사용하여 변수 그룹을 업데이트할 수 있습니다.

1. Azure DevOps 프로젝트의 왼쪽 메뉴에서 파이프라인>라이브러리를 선택합니다.
2. 라이브러리 페이지에서 업데이트할 변수 그룹을 선택합니다. 변수 그룹 목록을 마우스로 가리키고 추가 옵션 아이콘을 선택한 다음 메뉴에서 편집을 선택할 수도 있습니다.
3. 변수 그룹 페이지에서 속성을 변경한 다음 저장을 선택합니다.

Azure DevOps CLI

Azure DevOps Services에서 Azure DevOps CLI를 사용하여 변수 그룹을 업데이트할 수 있습니다.

변수 그룹 나열

Azure DevOps CLI를 사용하여 변수 그룹 또는 변수를 업데이트하려면 변수 그룹을 group-id사용합니다.

변수 그룹 만들기 명령의 출력에서 변수 그룹 ID의 값을 가져오거나 az pipelines variable-group list 명령을 사용할 수 있습니다.

예를 들어 다음 명령은 처음 세 개의 프로젝트 변수 그룹을 오름차순으로 나열하고 변수 그룹 ID를 포함한 결과를 테이블 형식으로 반환합니다.

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

변수 그룹 업데이트

변수 그룹을 업데이트하려면 az pipelines 변수 그룹 업데이트 명령을 사용합니다.

참고 항목

Azure DevOps CLI를 사용하여 형식 AzureKeyVault 의 변수 그룹을 업데이트할 수 없습니다.

예를 들어 다음 명령은 변수 그룹을 ID 4 로 업데이트하여 name 변경하고 description결과를 테이블 형식으로 출력합니다.

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

출력:

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

변수 그룹에 대한 세부 정보 표시

az pipelines variable-group show 명령을 사용하여 변수 그룹에 대한 세부 정보를 표시할 수 있습니다. 예를 들어 다음 명령은 ID 4 가 있는 변수 그룹에 대한 세부 정보를 표시하고 YAML 형식으로 결과를 반환합니다.

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

출력:

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

변수 그룹 삭제

Azure Pipelines UI

Azure Pipelines 사용자 인터페이스에서 변수 그룹을 삭제할 수 있습니다.

1. Azure DevOps 프로젝트의 왼쪽 메뉴에서 파이프라인>라이브러리를 선택합니다.
2. 라이브러리 페이지에서 삭제할 변수 그룹을 마우스로 가리키고 기타 옵션 아이콘을 선택합니다.
3. 메뉴에서 삭제를 선택한 다음 확인 화면에서 삭제를 선택합니다.

Azure DevOps CLI

Azure DevOps Services에서 Azure DevOps CLI를 사용하여 변수 그룹을 삭제할 수 있습니다.

변수 그룹을 삭제하려면 az pipelines variable-group delete 명령을 사용합니다. 예를 들어 다음 명령은 ID 1 가 있는 변수 그룹을 삭제하고 확인을 요청하지 않습니다.

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

변수 그룹의 변수 관리

Azure Pipelines UI

Azure Pipelines 사용자 인터페이스를 사용하여 변수 그룹의 변수를 변경, 추가 또는 삭제할 수 있습니다.

1. Azure DevOps 프로젝트의 왼쪽 메뉴에서 파이프라인>라이브러리를 선택합니다.
2. 라이브러리 페이지에서 업데이트할 변수 그룹을 선택합니다. 변수 그룹 목록을 마우스로 가리키고 추가 옵션 아이콘을 선택한 다음 메뉴에서 편집을 선택할 수도 있습니다.
3. 변수 그룹 페이지에서 다음을 수행할 수 있습니다.
   • 변수 이름 또는 값을 변경합니다.
   • 변수 이름 옆에 있는 가비지 캔 아이콘을 선택하여 변수를 삭제합니다.
   • 변수 값 옆에 있는 잠금 아이콘을 선택하여 변수를 비밀 또는 비보안으로 변경합니다.
   • + 추가를 선택하여 새 변수를 추가합니다.
4. 변경한 후 저장을 선택합니다.

Azure DevOps CLI

Azure DevOps Services에서 Azure DevOps CLI를 사용하여 변수 그룹의 변수를 관리할 수 있습니다.

변수 그룹의 변수 나열

변수 그룹의 변수를 나열하려면 az pipelines 변수 그룹 변수 목록 명령을 사용합니다. 예를 들어 다음 명령은 ID 4 가 있는 변수 그룹의 모든 변수를 나열하고 결과를 테이블 형식으로 표시합니다.

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

출력:

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

변수 그룹에 변수 추가

변수 그룹에 변수를 추가하려면 az pipelines variable-group variable create 명령을 사용합니다.

예를 들어 다음 명령은 ID4가 있는 변수 그룹에 기본값 true 으로 명명된 requires-login 새 변수를 만듭니다. 결과는 테이블 형식으로 표시됩니다.

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

출력:

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

변수 그룹의 변수 업데이트

변수 그룹의 변수를 업데이트하려면 az pipelines 변수 그룹 변수 업데이트 명령을 사용합니다.

참고 항목

Azure DevOps CLI를 사용하여 변수 형식 AzureKeyVault 그룹의 변수를 업데이트할 수 없습니다. 명령을 통해 변수를 업데이트할 az keyvault 수 있습니다.

예를 들어 다음 명령은 변수 그룹의 새 값 false 으로 변수를 ID4로 업데이트 requires-login 하고 결과를 YAML 형식으로 표시합니다. 이 명령은 변수가 .임을 지정합니다 secret.

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

출력은 숨겨진 비밀 값 null 이기 때문에 값을 대신 false 표시합니다.

requires-login:
  isSecret: true
  value: null

비밀 변수 관리

비밀 변수를 관리하려면 다음 매개 변수와 함께 az pipelines 변수 그룹 변수 업데이트 명령을 사용합니다.

• secret: 변수의 값이 비밀로 유지되도록 설정 true 됩니다.
• prompt-value: 환경 변수를 사용하거나 표준 입력을 통해 프롬프트를 사용하여 비밀 변수의 값을 업데이트하도록 true 설정합니다.
• value: 비밀 변수의 경우 매개 변수를 prompt-value 사용하여 표준 입력을 통해 값을 입력하라는 메시지를 표시합니다. 비대화형 콘솔의 경우 접두사로 AZURE_DEVOPS_EXT_PIPELINE_VAR_된 환경 변수를 선택할 수 있습니다. 예를 들어 환경 변수를 사용하여 명명된 MySecret 변수 AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret를 입력할 수 있습니다.

변수 그룹에서 변수 삭제

변수 그룹에서 변수를 삭제하려면 az pipelines 변수 그룹 변수 삭제 명령을 사용합니다. 예를 들어 다음 명령은 ID4가 있는 requires-login 변수 그룹에서 변수를 삭제합니다.

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

이 명령은 기본값이므로 확인 메시지를 표시합니다. 매개 변수를 --yes 사용하여 확인 프롬프트를 건너뜁니다.

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

파이프라인에서 변수 그룹 사용

YAML 또는 클래식 파이프라인에서 변수 그룹을 사용할 수 있습니다. 변수 그룹에 대한 변경 내용은 변수 그룹이 연결된 모든 정의 또는 단계에서 자동으로 사용할 수 있습니다.

YAML

YAML 파이프라인에서 변수 그룹의 이름만 지정하는 경우 리포지토리에 코드를 푸시할 수 있는 모든 사용자는 변수 그룹의 비밀 콘텐츠를 추출할 수 있습니다. 따라서 YAML 파이프라인에서 변수 그룹을 사용하려면 그룹을 사용하도록 파이프라인에 권한을 부여해야 합니다. Azure Pipelines 사용자 인터페이스 또는 Azure DevOps CLI를 사용하여 변수 그룹을 사용하도록 파이프라인에 권한을 부여할 수 있습니다.

파이프라인 UI를 통한 권한 부여

Azure Pipelines 사용자 인터페이스를 사용하여 변수 그룹을 사용하도록 파이프라인에 권한을 부여할 수 있습니다.

1. Azure DevOps 프로젝트의 왼쪽 메뉴에서 파이프라인>라이브러리를 선택합니다.
2. 라이브러리 페이지에서 권한을 부여할 변수 그룹을 선택합니다.
3. 변수 그룹 페이지에서 파이프라인 사용 권한 탭을 선택합니다.
4. 파이프라인 사용 권한 화면에서 권한을 부여할 파이프라인을 선택한 + 다음 선택합니다. 또는 추가 작업 아이콘을 선택하고 액세스 열기를 선택한 다음 다시 열기 액세스를 선택하여 확인합니다.

파이프라인을 선택하면 해당 파이프라인에서 변수 그룹을 사용할 수 있는 권한이 부여됩니다. 다른 파이프라인에 권한을 부여하려면 아이콘을 + 다시 선택합니다. 열기 액세스를 선택하면 모든 프로젝트 파이프라인에서 변수 그룹을 사용할 수 있는 권한이 부여됩니다. 그룹에 비밀이 없는 경우 열기 액세스가 좋은 옵션일 수 있습니다.

변수 그룹에 권한을 부여하는 또 다른 방법은 파이프라인을 선택하고 편집을 선택한 다음 빌드를 수동으로 큐에 대기하는 것입니다. 리소스 권한 부여 오류가 표시되면 파이프라인을 변수 그룹의 권한 있는 사용자로 명시적으로 추가할 수 있습니다.

Azure DevOps CLI를 통한 권한 부여

Azure DevOps Services에서 Azure DevOps CLI를 사용하여 변수 그룹에 권한을 부여할 수 있습니다.

변수 그룹을 사용하도록 모든 프로젝트 파이프라인에 권한을 부여하려면 az pipelines variable-group create 명령에서 매개 변수를 true설정합니다authorize. 그룹에 비밀이 없는 경우 이 열린 액세스가 좋은 옵션일 수 있습니다.

파이프라인에 변수 그룹 연결

YAML 파이프라인에 변수 그룹을 사용하도록 권한을 부여하면 파이프라인의 그룹 내에서 변수를 사용할 수 있습니다.

변수 그룹의 변수를 사용하려면 YAML 파이프라인 파일에서 그룹 이름에 대한 참조를 추가합니다.

variables:
- group: my-variable-group

동일한 파이프라인에서 여러 변수 그룹을 참조할 수 있습니다. 여러 변수 그룹에 이름이 같은 변수가 포함된 경우 파일의 변수를 사용하는 마지막 변수 그룹은 변수의 값을 설정합니다. 변수의 우선 순위에 대한 자세한 내용은 변수 확장을 참조 하세요.

템플릿에서 변수 그룹을 참조할 수도 있습니다. 다음 variables.yml 템플릿 파일은 변수 그룹을 my-variable-group참조합니다. 변수 그룹에는 .라는 myhello변수가 포함됩니다.

variables:
- group: my-variable-group

YAML 파이프라인은 variables.yml 템플릿을 참조하고 변수 그룹의 my-variable-group변수 $(myhello) 를 사용합니다.

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

연결된 변수 그룹에서 변수 사용

파이프라인 내에서 정의한 변수에 액세스하는 것과 동일한 방식으로 연결된 변수 그룹의 변수 값에 액세스합니다. 예를 들어 파이프라인에 연결된 변수 그룹에 명명된 customer 변수의 값에 액세스하려면 작업 매개 변수 또는 스크립트에서 사용할 $(customer) 수 있습니다.

파이프라인 파일에서 독립 실행형 변수와 변수 그룹을 모두 사용하는 경우 독립 실행형 변수에 대한 구문을 사용합니다 name-value .

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

변수 그룹의 변수를 참조하려면 매크로 구문 또는 런타임 식을 사용할 수 있습니다. 다음 예제에서 그룹에 my-variable-group 는 변수가 있습니다 myhello.

런타임 식을 사용하려면:

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

매크로 구문을 사용하려면 다음을 수행합니다.

variables:
- group: my-variable-group

steps:
- script: echo $(myhello)

암호화된 변수 및 키 자격 증명 모음 변수를 포함한 비밀 변수는 스크립트에서 직접 액세스할 수 없습니다. 이러한 변수를 작업에 인수로 전달해야 합니다. 자세한 내용은 비밀 변수를 참조 하세요.

클래식

클래식 파이프라인에서 변수 그룹 사용

클래식 파이프라인은 별도의 권한 부여 없이 변수 그룹을 사용할 수 있습니다. 변수 그룹을 사용하려면 다음을 수행합니다.

1. 클래식 파이프라인을 엽니다.

2. 변수 변수>그룹을 선택한 다음, 변수 그룹 연결을 선택합니다.

   • 빌드 파이프라인에는 사용 가능한 그룹 목록이 표시됩니다. 변수 그룹을 선택하고 링크를 선택합니다. 그룹의 모든 변수는 파이프라인 내에서 사용할 수 있습니다.

   • 릴리스 파이프라인에는 파이프라인의 단계 드롭다운 목록도 표시됩니다. 변수 그룹을 파이프라인 자체 또는 릴리스 파이프라인의 하나 이상의 특정 단계에 연결합니다. 하나 이상의 스테이지에 연결하는 경우 변수 그룹의 변수는 이러한 스테이지로 범위가 지정되며 릴리스의 다른 단계에서는 액세스할 수 없습니다.

   

여러 범위에서 이름이 같은 변수를 설정하는 경우 다음 우선 순위가 가장 높은 우선 순위가 사용됩니다.

1. 큐 시간에 설정된 변수
2. 파이프라인의 변수 집합
3. 변수 그룹의 변수 집합

변수의 우선 순위에 대한 자세한 내용은 변수 확장을 참조 하세요.

참고 항목

동일한 범위(예: 작업 또는 단계)의 파이프라인에 연결된 여러 그룹의 변수가 충돌하여 결과를 예측할 수 없습니다. 모든 변수 그룹에서 변수에 다른 이름을 사용하는지 확인합니다.

관련된 문서

• 변수 정의
• 사용자 지정 변수 정의
• 변수 그룹에서 비밀 및 비보안 변수 사용
• Azure Pipelines에서 Azure Key Vault 비밀 사용
• 승인 및 검사 추가