에이전트 소프트웨어 버전 3

아티클
12/12/2024

파이프라인 팀은 에이전트 소프트웨어를 버전 2.x(.NET Core 3.1 사용)에서 버전 3.x(.NET 6 사용)로 업그레이드하고 있습니다. 새 에이전트 버전은 새로운 Apple 실리콘 하드웨어 및 Ubuntu 22.04 또는 ARM64의 Windows와 같은 최신 운영 체제를 지원합니다.

참고 항목

이 기능은 Azure DevOps Server 2022.1부터 사용할 수 있습니다.

지원되는 운영 체제에서 3.x 에이전트로 업그레이드

.NET 6에서 지원하는 최신 운영 체제에서 자체 호스팅 에이전트를 실행하는 경우 새 에이전트 버전으로의 업그레이드는 자동으로 수행됩니다.

다음 운영 체제는 3.x 에이전트에서 지원됩니다.

Linux
- x64
  - Debian 10 이상
  - Fedora 36+
  - openSUSE 15 이상
  - Red Hat Enterprise Linux 7 이상
    - 더 이상 별도의 패키지가 필요하지 않습니다.
  - SUSE Enterprise Linux 12 SP2 이상
  - Ubuntu 22.04, 20.04, 18.04, 16.04
  - Azure Linux 2.0
  - Oracle Linux 7 이상
- ARM64
  - Debian 10 이상
  - Ubuntu 22.04, 20.04, 18.04
- Alpine x64
  - Alpine Linux 3.13 이상(에이전트 3.227 이상 필요)
macOS
- x64
  - macOS 10.15 “Catalina”
  - macOS 11.0 “Big Sur”
  - macOS 12.0 "Monterey"
  - macOS 13.0 "Ventura"
  - macOS 14.0 "Sonoma"
  - macOS 15.0 "Sequoia"
- ARM64
  - macOS 11.0 “Big Sur”
  - macOS 12.0 "Monterey"
  - macOS 13.0 "Ventura"
  - macOS 14.0 "Sonoma"
  - macOS 15.0 "Sequoia"
Windows
- 클라이언트 OS
  - Windows 7 SP1 ESU
  - Windows 8.1
  - Windows 10
  - Windows 11
- 서버 OS
  - Windows Server 2012 이상

지원되지 않는 운영 체제에서 3.x 에이전트로 업그레이드

.NET 6에서 지원되지 않는 운영 체제에서 자체 호스팅 에이전트를 실행하는 경우 .NET 6에서 지원하는 최신 지원 운영 체제를 사용하도록 컴퓨터를 업데이트해야 합니다.

다음 운영 체제 목록은 일반적으로 자체 호스팅 2.x 에이전트에 사용됩니다. 이러한 운영 체제는 .NET 6에서 지원되지 않으며 새 .NET 6 기반 버전 3.x 에이전트를 실행하는 데 사용할 수 없습니다.

시스템/배포	.NET 6에서 지원되지 않는 버전
Debian	<= 4.9
Fedora	<= 32
RedHat Enterprise Linux	<= 6
Ubuntu	< 18.04 LTS
macOS	< 10.15

스크립트를 사용하여 자체 호스팅 풀의 에이전트가 2.x에서 3.x로 업그레이드할 수 있는지 여부를 예측할 수 있습니다.

에이전트 버전 2.218(또는 RHEL 6의 경우 2.214)에서 파이프라인을 실행하려고 하면 여기에 나열된 지원되지 않는 운영 체제 중 하나에서 실행되는 파이프라인은 다음 오류 메시지와 함께 실패합니다. This operating system will stop receiving updates of the Pipelines Agent in the future. To be able to continue to run pipelines please upgrade the operating system or set an environment variable or agent knob "AGENT_ACKNOWLEDGE_NO_UPDATES" to "true". See https://aka.ms/azdo-pipeline-agent-v2-eos for more information.

이 오류를 해결하려면 다음을 수행할 수 있습니다.

에이전트 컴퓨터를 업그레이드하거나 이 문서의 앞에 나열된 지원되는 운영 체제 중 하나로 이동합니다. 이 솔루션은 기본 설정 솔루션이며 향후 에이전트 업데이트를 받을 수 있습니다.
AGENT_ACKNOWLEDGE_NO_UPDATES 환경 변수 또는 파이프라인 변수를 설정하여 에이전트에 변수를 설정합니다.

에이전트에서 환경 변수(예: /etc/environmentAGENT_ACKNOWLEDGE_NO_UPDATES=true

파이프라인 변수를 설정할 수 있습니다.

jobs:
- job: 'agentWithVariables'
  displayName: 'Agent with variables'

  variables:
    AGENT_ACKNOWLEDGE_NO_UPDATES: 'true' # Required to not fail job on operating system that is not supported by .NET 6

FAQ

2.x 에이전트와 3.x 에이전트의 차이점은 무엇인가요?

2.x 에이전트(예: 2.212)는 .NET Core 3.1이고 3.x 에이전트(예: 3.212)는 .NET 6입니다. 1단계 및 II 단계에서는 두 버전을 모두 사용할 수 있으며 3.x 버전은 시험판에 있습니다.

에이전트가 3.x로 업그레이드할 수 있는지 확인하려면 어떻게 해야 하나요?

스크립트를 사용하여 자체 호스팅 풀의 에이전트가 2.x에서 3.x로 업그레이드할 수 있는지 여부를 예측할 수 있습니다.

에이전트의 보안 문제는 앞으로 어떻게 패치되나요?

2023년 1분기 자체 호스팅 풀에 .NET 6 에이전트를 일반적으로 사용할 수 있게 되면 일반적으로 2.x 에이전트에 대해 패치가 수행되지 않습니다. 패치는 3.x 에이전트에 대해서만 수행됩니다. 그러나 2.x 에이전트를 계속 사용하는 Azure DevOps Server 고객도 있습니다. 따라서 사례별로 보안 문제를 검토하여 결정할 것입니다.

지원되지 않는 OS를 사용하는 경우 어떻게 해야 하나요?

이제 .NET 6에서 지원하는 최신 운영 체제로 마이그레이션해야 합니다. 그렇지 않으면 에이전트가 업그레이드를 시도할 수 있으며 OS에 .NET 6을 설치할 수 없으므로 실패합니다. 에이전트의 자동 업그레이드를 방지하는 후속 블로그 게시물에 몇 가지 지침을 게시합니다. 그러나 이는 에이전트 컴퓨터를 업그레이드하는 데 더 많은 시간을 제공하기 위한 임시 솔루션일 뿐입니다.

프로젝트의 변경 내용을 더 이상 작업하지 않는 경우 2.x 에이전트를 유지할 수 있나요?

아니요. 파이프라인 팀은 정기적으로 Azure Pipelines에 새 기능을 추가하고 있으며, 그 중 일부는 파이프라인이 해당 기능에 명시적으로 의존하지 않더라도 에이전트에 대한 업데이트가 필요할 수 있습니다. 후속 블로그의 지침을 사용하여 에이전트의 자동 업그레이드를 방지하는 경우 해당 에이전트를 사용하여 파이프라인을 예약할 수 없습니다. 필요한 기능을 가진 에이전트를 찾을 수 없는 경우 파이프라인 실행이 실패합니다.

3.x 에이전트 소프트웨어를 설치하기 전에 .NET 6을 설치해야 하나요?

3.x 에이전트 소프트웨어를 설치하고 구성하기 전에 에이전트 컴퓨터에 .NET 6을 설치할 필요가 없습니다. 3.x 에이전트에 필요한 모든 .NET 종속성은 에이전트 자체의 일부입니다.

3.x 에이전트를 사용하는 경우 .NET 6을 사용하여 코드를 빌드해야 하나요?

3.x 에이전트를 실행하는 데 사용되는 .NET 버전은 에이전트 설치에 자체 포함되며 코드를 빌드하는 데 사용되지 않습니다. 코드를 빌드하는 데 사용되는 .NET 버전은 에이전트 컴퓨터에 설치한 .NET의 버전 및 파이프라인에 따라 달라집니다.

Azure DevOps Services가 아닌 Azure DevOps Server를 사용합니다. 이 변경이 저에게 영향을 미치나요?

예, 다음 섹션에 나열된 Azure DevOps Server 버전을 사용하는 경우입니다.

파이프라인 팀은 나중에 Azure DevOps Server 릴리스를 계속 사용하려는 경우 지금부터 .NET 6에서 지원하는 최신 운영 체제로 에이전트 컴퓨터를 업데이트하는 것이 좋습니다.

Azure DevOps Server에서 3.x 에이전트를 지원하나요?

Azure DevOps Server 버전은 해당 버전과 함께 배포된 에이전트 버전을 지원합니다. 다음 표에는 지원되는 각 Azure DevOps Server 버전 과 지원되는 에이전트 버전이 나와 있습니다.

Azure DevOps Server 버전	에이전트 버전
Azure DevOps Server 2022.2	3.238.0
Azure DevOps Server 2020.1.2	3.225.0
Azure DevOps Server 2019.1.2	3.225.0

Azure DevOps Server는 제품의 기존 기능에 대한 대상 누적 버그 수정을 제공하는 보안 또는 서비스 패치를 통해 서비스됩니다. 최상의 가장 안전한 제품 환경을 위해 모든 고객이 Azure DevOps Server의 가장 안전한 최신 릴리스를 사용하는 것이 좋습니다. Azure DevOps Server 다운로드 페이지에서 최신 버전의 제품을 다운로드할 수 있습니다.

Azure DevOps Server 업데이트 또는 새 버전을 설치한 후 에이전트를 업데이트합니다.

다음 표에는 3.x 에이전트의 버전이 처음 포함된 Azure DevOps Server 버전이 나와 있습니다.

에이전트 버전 3 배포의 타임라인은 무엇인가요?

에이전트 버전 3은 2023년 3월에 릴리스되었습니다.

태스크에서 에이전트를 에이전트 버전 3으로 업데이트해야 하는 경우 어떻게 되나요?

일반적으로 태스크에 최신 버전의 에이전트가 필요한 경우 자동으로 업데이트됩니다. 지금은 에이전트 버전 2가 계속 업데이트되는 동안 에이전트 버전 2에서 에이전트 버전 3으로 자동 업데이트를 사용하지 않도록 설정했습니다. 사용하도록 설정하면 에이전트 버전 3과 호환되지 않는 운영 체제의 경우 에이전트 버전 2.217 이상에서는 v3 에이전트로 자체 업데이트를 시도하지 않습니다. 대신 사용자에게 먼저 운영 체제를 업그레이드해야 한다는 경고가 표시됩니다. The operating system the agent is running on is <OS>, which will not be supported by the .NET 6 based v3 agent. Please upgrade the operating system of this host to ensure compatibility with the v3 agent. See https://aka.ms/azdo-pipeline-agent-version

다음을 통해 공유