다음을 통해 공유


Azure Pipelines 에이전트에서 Node.js 러너

Azure Pipelines 에이전트는 다양한 Node.js 처리기를 사용할 수 있는 대상 작업을 지원하기 위해 여러 버전의 Node.js 라이브러리와 함께 제공됩니다.

비고

Azure Pipelines 에이전트는 2026년 1월부터 Node.js 24와 함께 제공될 예정입니다. 확장/사용자 지정 태스크 작성자는 Node.js 24로 작업을 업데이트/테스트해야 합니다.

Node.js 버전 지원

다음 표에서는 지원 종료 날짜 및 제거 날짜와 함께 Azure Pipelines에서 지원되는 Node.js 버전을 나열합니다.

Node.js 버전 Azure Pipelines에서 지원 종료 Azure Pipelines의 제거 날짜
24(2026년 1월 중개인에서 사용 가능) 2028년 4월1일 2028년10월 1일
20 2026년 4월 2027년 4월
16 2021년 9월 2026년 11월
10 2021년 4월 2026년 11월
6 2019년 4월 2026년 11월
  • Azure Pipelines에서 지원 종료 - 지원 종료 날짜에 도달하면 Node.js 버전이 Azure Pipelines 에이전트에서 업데이트되지 않습니다. 지원 종료 날짜는 공식 Node.js 지원 일정을 기반으로 합니다.
  • Azure Pipelines의 제거 날짜 - 제거 날짜에 도달하면 Node.js 버전이 새 에이전트 버전에서 제거되고 이러한 Node.js 버전이 필요한 작업이 실행되지 않을 수 있습니다. 제거 날짜는 항상 지원 종료 날짜 이후 6개월 이상입니다.

파이프라인은 사용자에게 예정된 지원 종료 또는 제거 날짜를 알리는 경고를 내보낸다.

Azure Pipelines 에이전트에는 Node.js 24로 예정된 Azure Pipeline Agent 릴리스부터 LTS(대체 장기 지원) 버전의 Node.js만 포함됩니다.

1Node.js 24에 대한 지원 종료는 2025년 11월부터 공식 Node.js 지원 일정 과 일치합니다. 이러한 날짜는 Node.js 팀의 향후 공지 사항에 따라 변경될 수 있습니다.

Node.js 6, 10 및 16의 제거 날짜

Node.js 6, 10 및 16은 해당 지원 종료 날짜부터 파이프라인에서 지원되지 않으며, 이러한 Node.js 버전에 종속된 작업이 있는 파이프라인은 현재 실행될 때 경고를 내보낸다. 그러나 고객에게 사용자 지정 작업을 지원되는 Node.js 버전으로 마이그레이션할 수 있는 충분한 시간을 제공하기 위해 제거 날짜를 2026년 11월로 연장했습니다.

사용자 지정 작업을 현재 버전의 Node.js업데이트하고 테스트하는 방법에 대한 자세한 내용은 작업을 최신 Node.js 버전으로 업그레이드하는 방법을 참조하세요.

지원되지 않는 Node.js 버전에서 작업을 실행하는 방법

더 이상 지원되지 않거나 제거된 Node.js 버전을 사용하여 사용자 지정 작업에 대한 이전 버전과의 호환성을 유지하기 위해 필요한 Node.js 실행기를 설치할 수 있도록 다음과 같은 셀프 서비스 옵션을 제공합니다.

  • 원하는 Node.js 실행기를 수동으로 설치합니다. 자세한 내용은 Node.js Runner 지원을 참조하세요.

  • NodeTaskRunnerInstaller@0 작업을 사용하여 오래된 Node.js 라이브러리가 필요한 당신의 파이프라인을 구성합니다.

  • 원하는 Node.js 라이브러리를 포함하는 에이전트 패키지를 설치합니다.

    Azure Pipelines는 두 가지 버전의 에이전트 패키지를 제공합니다.

    • vsts-agent-\: Node.js 6 및 Node.js 10개의 라이브러리를 지원하는 패키지입니다.
    • pipelines-agent-\: Node.js 6 및 Node.js 10개의 라이브러리를 지원하지 않는 패키지입니다. 나중에 이 버전의 패키지는 기본 에이전트 패키지가 됩니다.

    비고

    pipelines-agent 는 2026년 1월부터 Node.js 16과 함께 배송되지 않습니다. 확장/사용자 지정 태스크 작성자는 Node.js 24로 작업을 업데이트/테스트해야 합니다.

    작업에 Node.js 6 또는 Node.js 10 라이브러리가 필요하지 않고 에이전트 컴퓨터에 Node.js 6 또는 Node.js 10 라이브러리를 설치하지 않으려는 경우 대체 에이전트 다운로드 아래의 이 설명서에서 에이전트를 설치할 수 있습니다.