Azure Data Factory 및 Synapse Analytics에서 CI-CD, Azure DevOps, GitHub 문제 해결

아티클
11/12/2023

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 Azure Data Factory 및 Synapse Analytics에서 CI-CD(연속 통합-연속 배포), Azure DevOps, GitHub 문제에 대한 일반적인 문제 해결 방법을 살펴봅니다.

소스 제어 또는 DevOps 기술 사용에 대한 질문이나 문제가 있는 경우 다음과 같은 몇 가지 문서를 참조하세요.

원본 제어를 참조하여 서비스에서 원본 제어를 구현하는 방법을 알아봅니다.
서비스에서 DevOps CI-CD가 수행되는 방법은 CI-CD를 참조하세요.

일반적인 오류 및 메시지

다른 테넌트로 인해 Git 리포지토리에 커넥트 실패했습니다.

문제

경우에 따라 HTTP 상태 401과 같은 인증 문제가 발생할 수 있습니다. 특히 게스트 계정이 있는 테넌트가 여러 개 있는 경우 상황이 더 복잡해질 수 있습니다.

원인

원래 테넌트에서 토큰을 가져왔지만 서비스가 게스트 테넌트에 있고 이 토큰을 사용하여 게스트 테넌트의 DevOps에 연결하려고 시도하는 중입니다. 이러한 유형의 토큰 액세스는 예상된 동작이 아닙니다.

권장

게스트 테넌트에서 발급된 토큰을 사용해야 합니다. 예를 들어 동일한 Microsoft Entra ID를 게스트 테넌트 및 DevOps로 할당해야 토큰 동작을 올바르게 설정하고 올바른 테넌트 사용이 가능합니다.

매개 변수 파일의 템플릿 매개 변수가 유효하지 않습니다.

문제

동일한 구성(예: 빈도 및 간격)으로 테스트 또는 프로덕션 분기에서 이미 사용할 수 있는 Dev 분기에서 트리거를 삭제하면 릴리스 파이프라인 배포가 성공하고 해당 트리거가 해당 환경에서 삭제됩니다. 그러나 테스트/프로덕션 환경에서 트리거에 대한 구성(빈도 및 간격 등)이 다르고 Dev에서 동일한 트리거를 삭제하는 경우 오류와 함께 배포가 실패합니다.

원인

다음 오류로 CI/CD 파이프라인이 실패합니다.

2020-07-20T11:19:02.1276769Z ##[error]Deployment template validation failed: 'The template parameters 'Trigger_Salesforce_properties_typeProperties_recurrence_frequency, Trigger_Salesforce_properties_typeProperties_recurrence_interval, Trigger_Salesforce_properties_typeProperties_recurrence_startTime, Trigger_Salesforce_properties_typeProperties_recurrence_timeZone' in the parameters file are not valid; they are not present in the original template and can therefore not be provided at deployment time. The only supported parameters for this template are 'factoryName, PlanonDWH_connectionString, PlanonKeyVault_properties_typeProperties_baseUrl

권장

이 오류는 매개 변수가 있는 트리거를 삭제하는 경우가 많기 때문에 ARM(Azure Resource Manager) 템플릿에서 매개 변수를 사용할 수 없기 때문에 발생합니다(트리거가 더 이상 존재하지 않기 때문). 매개 변수가 ARM 템플릿에 더 이상 없으므로 DevOps 파이프라인에서 재정의된 매개 변수를 업데이트해야 합니다. 그렇지 않으면 ARM 템플릿에서 매개변수가 변경될 때마다 DevOps 파이프라인(배포 작업)에서 재정의된 매개변수를 업데이트해야 합니다.

속성 형식 업데이트는 지원되지 않습니다.

문제

다음 오류와 함께 CI/CD 릴리스 파이프라인이 실패합니다.

2020-07-06T09:50:50.8716614Z There were errors in your deployment. Error code: DeploymentFailed.
2020-07-06T09:50:50.8760242Z ##[error]At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/DeployOperations for usage details.
2020-07-06T09:50:50.8771655Z ##[error]Details:
2020-07-06T09:50:50.8772837Z ##[error]DataFactoryPropertyUpdateNotSupported: Updating property type is not supported.
2020-07-06T09:50:50.8774148Z ##[error]DataFactoryPropertyUpdateNotSupported: Updating property type is not supported.
2020-07-06T09:50:50.8775530Z ##[error]Check out the troubleshooting guide to see if your issue is addressed: https://learn.microsoft.com/azure/devops/pipelines/tasks/deploy/azure-resource-group-deployment#troubleshooting
2020-07-06T09:50:50.8776801Z ##[error]Task failed while creating or updating the template deployment.

원인

이 오류는 대상 서비스 인스턴스에서 이름이 같지만 형식이 다른 통합 런타임 때문입니다. 통합 런타임은 배포 중에 동일한 형식이어야 합니다.

권장

CI/CD에 대한 모범 사례를 참조하세요.
통합 런타임은 자주 변경되지 않으며 CI/CD의 모든 스테이지에서 비슷합니다. 따라서 서비스는 모든 CI/CD 스테이지에서 통합 런타임의 이름과 유형이 동일할 것으로 예상합니다. 이름 및 형식 및 속성이 다른 경우 원본 및 대상 통합 런타임 구성과 일치하는지 확인한 다음 릴리스 파이프라인을 배포합니다.
모든 단계에서 통합 런타임을 공유하려면 공유 통합 런타임을 포함하기 위해 3개로 구성된 팩터리를 사용하는 것이 좋습니다. 모든 환경에서 이 공유 팩터리를 연결된 통합 런타임 형식으로 사용할 수 있습니다.

잘못된 참조로 인해 문서를 만들거나 업데이트하지 못했습니다.

문제

변경 사항을 게시하려고 시도할 때 다음 오류 메시지가 표시됩니다.

"error": { "code": "BadRequest", "message": "The document creation or update failed because of invalid reference '<entity>'.", "target": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/<rgname>/providers/Microsoft.DataFactory/factories/<datafactory>/pipelines/<pipeline>", "details": null }

원인

Git 구성을 분리하고 “리소스 가져오기” 플래그가 선택된 상태로 다시 설정하여 서비스가 “동기화 상태”로 설정되었습니다. 즉, 게시하는 동안 변경되지 않습니다.

해결

Git 구성을 분리하고 다시 설정하고, “기존 리소스 가져오기” 확인란을 선택하지 않아야 합니다.

한 리소스 그룹에서 다른 리소스로 Data Factory 이동 실패

문제

데이터 팩터리를 한 리소스 그룹에서 다른 리소스 그룹으로 이동할 수 없으므로 다음 오류와 함께 실패합니다. { "code": "ResourceMoveProviderValidationFailed", "message": "Resource move validation failed. Please see details. Diagnostic information: timestamp 'xxxxxxxxxxxxZ', subscription id 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', tracking id 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', request correlation id 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.", "details": [ { "code": "BadRequest", "target": "Microsoft.DataFactory/factories", "message": "One of the resources contain integration runtimes that are either SSIS-IRs in starting/started/stopping state, or Self-Hosted IRs which are shared with other resources. Resource move is not supported for those resources." } ] }

해결

SSIS-IR 및 공유 IR을 삭제하여 이동 작업을 허용할 수 있습니다. 통합 런타임을 삭제하지 않으려는 경우 최선의 방법은 복사 및 클론 문서에 따라 복사를 수행하고 완료되면 이전 데이터 팩터리를 삭제하는 것입니다.

ARM 템플릿을 내보내고 가져올 수 없음

문제

ARM 템플릿을 내보내고 가져올 수 없습니다. 포털에 오류가 없지만 브라우저 추적에서 다음 오류가 표시될 수 있습니다.

Failed to load resource: the server responded with a status code of 401 (Unauthorized)

원인

사용자로 고객 역할을 만들었으며 필요한 권한이 없습니다. UI에서 로드되면 일련의 노출 제어 값이 확인됩니다. 이 경우 사용자의 액세스 역할에 queryFeaturesValue API에 액세스할 수 있는 권한이 없습니다. 이 API에 액세스하기 위해 전역 매개 변수 기능이 해제됩니다. ARM 템플릿 내보내기 코드 경로는 부분적으로 전역 매개 변수 기능에 의존합니다.

해결

이 문제를 해결하려면 역할에 다음 권한을 추가해야 합니다. Microsoft.DataFactory/factoryies/queryFeaturesValue/action. 이 권한은 기본적으로 Data Factory의 Data Factory 기여자 역할 및 Synapse Analytics의 기여자 역할에 포함됩니다.

CI/CD에 대한 게시를 자동화할 수 없습니다.

원인

최근까지 포털에서 UI를 클릭하여 배포용 파이프라인만 게시할 수 있었습니다. 이제 이 프로세스를 자동화할 수 있습니다.

해결

CI/CD 프로세스가 향상되었습니다. 자동화된 게시 기능은 UI에서 모든 ARM 템플릿 기능을 가져오고, 유효성을 검사하고, 내보냅니다. 이렇게 해서 공개적으로 사용 가능한 npm 패키지 @microsoft/azure-data-factory-utilities를 통해 논리를 사용할 수 있게 만듭니다. 이 메서드를 사용하면 UI로 이동하여 단추를 선택하는 대신 프로그래밍 방식으로 이러한 작업을 트리거할 수 있습니다. 이 방법은 CI/CD 파이프라인에 진정한 연속 통합 환경을 제공합니다. 자세한 내용은 CI/CD 게시 향상을 참조하세요.

4MB ARM 템플릿 제한으로 인해 게시할 수 없음

문제

Azure Resource Manager의 4MB 총 템플릿 크기 제한에 도달하여 배포할 수 없습니다. 제한을 초과한 후 배포할 솔루션이 필요합니다.

원인

Azure Resource Manager는 템플릿 크기를 4MB로 제한합니다. 템플릿의 크기를 4MB로 제한하고 각 매개 변수 파일을 64KB로 제한합니다. 4MB의 제한은 반복적인 리소스 정의로 확장된 후 템플릿의 마지막 상태와 변수 및 매개 변수 값에 적용됩니다. 하지만 이 제한이 초과되었습니다.

해결

중소기업에게는 단일 템플릿이 더 간편하게 이해하고 유지 관리할 수 있습니다. 모든 리소스 및 값을 단일 파일에서 볼 수 있습니다. 고급 시나리오의 경우 연결된 템플릿을 사용하여 솔루션을 대상 구성 요소로 분할할 수 있습니다. 연결된 템플릿 및 중첩된 템플릿 사용의 모범 사례를 따르세요.

20MB의 DevOps API 제한으로 인해 ADF 트리거가 한 번이 아닌 두 번 이상 발생합니다.

문제

리소스를 게시하는 동안 Azure 파이프라인은 한 번이 아닌 두 번 이상 트리거합니다.

원인

Azure DevOps에는 20MB REST API 제한이 있습니다. ARM 템플릿이 이 크기를 초과하면 ADF는 내부적으로 템플릿 파일을 연결된 템플릿이 있는 여러 파일로 분할하여 이 문제를 해결합니다. 부작용으로, 이 분할로 인해 고객의 트리거가 두 번 이상 실행될 수 있습니다.

해결

ADF 자동 게시(기본 설정) 또는 수동 트리거 방법을 사용하여 두 번 이상 트리거하는 대신 한 번만 트리거합니다.

GIT Enterprise에 연결할 수 없음

문제

권한 문제로 인해 GIT Enterprise에 연결할 수 없습니다. 422 - 처리할 수 없는 엔터티와 같은 오류를 볼 수 있습니다.

원인

서비스에 Oauth를 구성하지 않았습니다.
URL이 잘못 구성되었습니다. repoConfiguration은 FactoryGitHubConfiguration 형식 이어야 합니다.

해결

먼저 서비스에 Oauth 액세스 권한을 부여합니다. 그런 다음 올바른 URL을 사용하여 GIT Enterprise에 연결해야 합니다. 구성은 고객 조직으로 설정해야 합니다. 예를 들어 서비스는 처음에는 고객 자격 증명>을 시도하고 https://hostname/api/v3/search/repositories?q=user%3<실패합니다. 그런 다음 조직>/리포지토리>를 시도하고 https://hostname/api/v3/orgs/<성공<합니다.

삭제된 인스턴스에서 복구할 수 없습니다.

문제

서비스의 인스턴스 또는 해당 인스턴스가 포함된 리소스 그룹이 삭제되었으며 복구해야 합니다.

원인

원본 제어가 DevOps 또는 Git을 사용하여 구성된 경우에만 인스턴스를 복구할 수 있습니다. 이 작업은 게시된 모든 리소스를 가져오지만 게시되지 않은 파이프라인, 데이터 세트 또는 연결된 서비스를 복원하지는 않습니다 . 원본 제어가 없으면 서비스에서 delete 명령을 받으면 백업 없이 인스턴스가 영구적으로 삭제되므로 Azure 백 엔드에서 삭제된 인스턴스를 복구할 수 없습니다.

해결

원본 제어가 구성된 삭제된 서비스 인스턴스를 복구하려면 아래 단계를 참조하세요.

서비스의 새 인스턴스를 만듭니다.
동일한 설정으로 Git을 다시 구성하지만 기존 리소스를 선택한 리포지토리로 가져오고 새 분기를 선택해야 합니다.
끌어오기 요청을 만들어 변경 내용을 공동 작업 분기에 병합하고 게시합니다.
삭제된 데이터 팩터리 또는 Synapse 작업 영역에 자체 호스팅 통합 런타임이 있는 경우 새 팩터리 또는 작업 영역에 IR의 새 인스턴스를 만들어야 합니다. 온-프레미스 또는 가상 머신 IR 인스턴스를 제거하고 다시 설치하고 새 키를 가져와야 합니다. 새 IR 설정이 완료되면 연결된 서비스를 업데이트하여 새 IR을 가리키고 연결된 IR을 다시 테스트해야 합니다. 그렇지 않으면 잘못된 참조 오류로 실패합니다.

자동 게시 방법을 사용하여 다른 스테이지에 배포할 수 없음

문제

고객은 NPM 패키지를 설치하고 Azure DevOps를 사용하여 더 높은 단계를 설정하는 등 필요한 모든 단계를 수행했지만 배포는 여전히 실패합니다.

원인

npm 패키지는 다양한 방식으로 사용될 수 있지만 Azure 파이프라인을 통해 주요 이점 중 하나가 사용되고 있습니다. 협업 분기에 대한 각 병합에서는 먼저 모든 코드의 유효성을 검사한 다음 릴리스 파이프라인에서 사용될 수 있는 빌드 아티팩트로 ARM 템플릿을 내보내는 파이프라인을 트리거할 수 있습니다. Starter 파이프라인에서 YAML 파일은 유효하고 완전해야 합니다.

해결

package.json 폴더가 유효하지 않으므로 다음 섹션은 유효하지 않습니다.

- task: Npm@1
  inputs:
    command: 'custom'
    workingDir: '$(Build.Repository.LocalPath)/<folder-of-the-package.json-file>' #replace with the package.json folder
    customCommand: 'run build validate $(Build.Repository.LocalPath) /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testResourceGroup/providers/Microsoft.DataFactory/factories/yourFactoryName'
  displayName: 'Validate'

'run build validate $(Build.Repository.LocalPath)/DataFactory/subscriptions/xxxxxxxx-xxxx-xxxx-xx/resourceGroups/testResourceGroup/providers/Microsoft.DataFactory/factories/yourFactoryName'과 같은 DataFactory가 customCommand에 포함되어 있어야 합니다. 상위 단계에 대해 생성된 YAML 파일에 필요한 JSON 아티팩트가 있어야 합니다.

게시된 JSON 파일에 왼쪽에 추가 “[”가 표시됨

문제

DevOps를 사용하여 게시할 때 추가 "["가 표시됩니다. 이 서비스는 DevOps의 ARM 템플릿에 자동으로 "["를 하나 더 추가합니다. JSON 파일에 "[["와 같은 식이 표시됩니다.

원인

[는 ARM 템플릿의 예약 문자이므로 "["를 이스케이프하기 위해 추가 [가 자동으로 추가됩니다.

해결

이는 CI/CD에 대한 게시 프로세스 중에 일반적으로 나타나는 동작입니다.

파이프라인 실행의 진행 중/대기 중 스테이지에서 CI/CD를 수행합니다.

문제

파이프라인 실행의 진행 중 및 대기 스테이지 중에 CI/CD를 수행하려고 합니다.

원인

파이프라인이 진행 중/대기 중 스테이지인 경우 먼저 파이프라인 및 작업을 모니터링해야 합니다. 그런 다음 파이프라인이 완료될 때까지 기다리거나 파이프라인 실행을 취소할 수 있습니다.

해결

SDK, Azure Monitor 또는 Monitor를 사용하여 파이프라인을 모니터링할 수 있습니다. 그런 다음, CI/CD 모범 사례에 따라 추가 지침을 확인할 수 있습니다.

개발 및 배포 동안 단위 테스트를 수행합니다.

문제

파이프라인을 개발 및 배포하는 동안 단위 테스트를 수행하려고 합니다.

원인

개발 및 배포 주기 동안 파이프라인을 수동으로 또는 자동으로 게시하기 전에 파이프라인을 단위 테스트하는 것이 좋습니다. 테스트 자동화를 사용하면 반복성을 보장하면서 더 적은 시간 안에 더 많은 테스트를 실행할 수 있습니다. 배포 전에 모든 파이프라인을 자동으로 다시 테스트하면 회귀 오류를 방지할 수 있습니다. 자동화된 테스트는 CI/CD 소프트웨어 개발 방법의 핵심 구성 요소입니다. CI/CD 배포 파이프라인에 자동화된 테스트를 포함하면 품질을 크게 향상시킬 수 있습니다. 장기적으로 테스트된 파이프라인 아티팩트가 재사용되어 비용과 시간을 절약할 수 있습니다.

해결

고객은 서로 다른 기술 집합을 사용하여 서로 다른 단위 테스트 요구 사항을 가질 수 있으므로 일반적인 방법은 다음 단계를 수행하는 것입니다.

Azure DevOps CI/CD 프로젝트를 설정하거나 .NET/PYTHON/REST 유형 SDK 기반 테스트 전략을 개발합니다.
CI/CD의 경우 모든 스크립트를 포함하는 빌드 아티팩트를 만들고 릴리스 파이프라인에 리소스를 배포합니다. SDK 기반 접근 방식의 경우 Python의 PyTest, .NET SDK를 사용한 C#의 Nunit 등을 사용하여 테스트 단위를 개발합니다.
릴리스 파이프라인의 일부로 또는 ADF Python/PowerShell/.NET/REST SDK를 사용하여 독립적으로 단위 테스트를 실행합니다.

예를 들어 파일에서 중복 항목을 삭제한 다음 큐레이팅된 파일을 데이터베이스에 테이블로 저장하려고 합니다. 파이프라인을 테스트하려면 Azure DevOps를 사용하여 CI/CD 프로젝트를 설정합니다. 개발된 파이프라인을 배포하는 TEST 파이프라인 단계를 설정합니다. 테이블 데이터가 예상한 데이터인지 확인하기 위해 Python 테스트를 실행하도록 테스트 스테이지를 구성합니다. CI/CD를 사용하지 않는 경우 Nunit를 사용하여 원하는 테스트로 배포된 파이프라인을 트리거합니다. 결과에 만족하면 마지막으로 파이프라인을 프로덕션 인스턴스에 게시할 수 있습니다.

CI/CD 배포 또는 업데이트 작성 후 파이프라인 실행이 일시적으로 실패

문제

일정 시간이 지나면 임시 실패 후 사용자 작업 없이 새 파이프라인 실행이 성공하기 시작합니다.

원인

이 동작을 트리거할 수 있는 몇 가지 시나리오가 있습니다. 이 모든 시나리오에는 이전 버전의 부모 리소스에서 호출되는 종속 리소스의 새 버전이 포함됩니다. 예를 들어 “파이프라인 실행”에서 호출하는 기존 자식 파이프라인이 필수 매개 변수를 사용하도록 업데이트되고 기존 부모 파이프라인이 이러한 매개 변수를 전달하도록 업데이트된 경우를 가정해 보겠습니다. 부모 파이프라인 실행 중에 배포가 발생하지만 파이프라인 실행 작업 전에 이전 버전의 파이프라인이 새 버전의 자식 파이프라인을 호출하면 예상 매개 변수가 전달되지 않습니다. 이로 인해 UserError로 인해 파이프라인이 실패합니다. 이를 참조하는 파이프라인 실행 중에 연결된 서비스에 호환성이 손상되는 변경이 발생하는 경우와 같은 다른 유형의 종속성에서도 발생할 수 있습니다.

해결

부모 파이프라인의 새 실행은 자동으로 성공하기 시작하므로 일반적으로 아무 작업도 필요하지 않습니다. 그러나 이러한 오류를 방지하기 위해 고객은 호환성이 손상되는 변경을 방지하기 위해 배포를 작성하고 계획하는 동안 종속성을 고려해야 합니다.

연결된 서비스에서 통합 런타임을 매개 변수화할 수 없습니다.

문제

연결된 서비스 통합 런타임을 매개 변수화해야 함

원인

이 기능은 지원되지 않습니다.

해결

수동으로 선택하고 통합 런타임을 설정해야 합니다. PowerShell API를 사용하여 변경할 수도 있습니다. 이 변경은 다운스트림에 영향을 줄 수 있습니다.

CI/CD 중에 통합 런타임을 업데이트/변경합니다.

문제

CI/CD 배포 중 통합 런타임 이름 변경입니다.

원인

엔터티 참조 매개 변수화(연결된 서비스의 통합 런타임, 작업의 데이터 세트, 데이터 세트의 연결된 서비스)는 지원되지 않습니다. 배포 중에 런타임 이름을 변경하면 잘못된 참조로 인해 신뢰할 수 있는 리소스(통합 런타임을 참조하는 리소스)의 형식이 잘못되었습니다.

해결

Data Factory를 사용하려면 CI/CD의 모든 단계에서 동일한 이름 및 유형의 통합 런타임이 있어야 합니다.

DataFactoryPropertyUpdateNotSupported 오류로 ARM 템플릿 배포 실패

문제

DataFactoryPropertyUpdateNotSupported와 같은 오류로 ARM 템플릿 배포가 실패합니다. 속성 형식 업데이트는 지원되지 않습니다.

원인

ARM 템플릿 배포에서 기존 통합 런타임의 형식을 변경하려고 합니다. 이는 허용되지 않으며, 데이터 팩터리의 모든 CI/CD 단계에서 동일한 이름 및 유형의 통합 런타임이 필요하기 때문에 배포 오류가 발생합니다.

해결

모든 단계에서 통합 런타임을 공유하려면 공유 통합 런타임을 포함하기 위해 3개로 구성된 팩터리를 사용하는 것이 좋습니다. 모든 환경에서 이 공유 팩터리를 연결된 통합 런타임 형식으로 사용할 수 있습니다. 자세한 내용은 연속 통합 및 배달 - Azure Data Factory를 참조 하세요.

PartialTempTemplates 파일로 인해 GIT 게시가 실패할 수 있음

문제

PartialTemplates 폴더에 1000개의 이전 임시 ARM 템플릿 json 파일이 있는 경우 게시가 실패할 수 있습니다.

원인

게시할 때 ADF는 공동 작업 분기의 각 폴더 내의 모든 파일을 가져옵니다. 과거에 게시는 게시 분기에 PartialArmTemplates 및 LinkedTemplates라는 두 개의 폴더를 생성했습니다. PartialArmTemplates 파일은 더 이상 생성되지 않습니다. 그러나 PartialArmTemplates 폴더에 이전 파일(수천 개)이 많을 수 있으므로 게시 시 GitHub 요청이 많고 속도 제한에 도달할 수 있습니다.

해결

PartialTemplates 폴더를 삭제하고 다시 게시합니다. 해당 폴더의 임시 파일도 삭제할 수 있습니다.

ARM 템플릿 옵션에 전역 매개 변수 포함이 작동하지 않음

문제

이전 기본 매개 변수화 템플릿을 사용하는 경우 관리 허브의 전역 매개 변수를 포함하는 새로운 방법이 작동하지 않습니다.

원인

기본 매개 변수화 템플릿에는 전역 매개 변수 목록의 모든 값이 포함되어야 합니다.

해결

전역 매개 변수를 포함하는 새 메서드에 대한 일회성 마이그레이션으로 업데이트된 기본 매개 변수화 템플릿을 사용합니다. 이 템플릿은 전역 매개 변수 목록의 모든 값을 참조합니다. 또한 이미 템플릿 매개 변수를 재정의하는 경우 릴리스 파이프라인에서 배포 작업을 업데이트해야 합니다.
템플릿 매개 변수를 이미 재정의하는 경우(전역 매개 변수의 경우) CI/CD 파이프라인에서 템플릿 매개 변수 이름을 업데이트합니다.

오류 코드: InvalidTemplate

문제

식을 구문 분석할 수 없음이라는 메시지가 표시됩니다. 작업의 동적 콘텐츠에 전달된 식은 구문 오류로 인해 올바르게 처리되지 않습니다.

원인

동적 콘텐츠는 식 언어 요구 사항에 따라 작성되지 않습니다.

해결

디버그 실행의 경우 현재 git 분기 내의 파이프라인에서 식을 확인합니다.
트리거된 실행의 경우 라이브 모드 내에서 파이프라인의 식을 확인합니다.

문제 해결에 대한 도움이 필요한 경우 다음 리소스를 참조하세요.