다음을 통해 공유


DotNetCoreInstaller@1 - .NET Core SDK/런타임 설치 관리자 v1 작업

이 작업을 사용하여 인터넷 또는 로컬 캐시에서 특정 버전의 .NET Core SDK를 획득하고 PATH에 추가합니다.

중요

이 작업은 더 이상 사용되지 않으며 2024년 1월 31일에 사용 중지됩니다. UseDotNet@2 사용합니다.

이 작업을 사용하여 인터넷 또는 로컬 캐시에서 특정 버전의 .NET Core SDK를 획득하고 PATH에 추가합니다.

중요

TThis 작업은 더 이상 사용되지 않습니다. @UseDotNet2 사용합니다.

인터넷 또는 로컬 캐시에서 특정 버전의 .NET Core SDK를 획득하고 PATH에 추가합니다.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

입력

packageType - 설치할 패키지
string. 필수 요소. 허용되는 값: runtime (런타임만), sdk (SDK(런타임 포함)) 기본값은 sdk입니다.

런타임 또는 전체 SDK만 설치할지 여부를 지정합니다.


version - 버전
string. 필수 요소. 기본값은 2.2.x입니다.

설치할 .NET Core SDK 또는 런타임의 버전을 지정합니다.

다음 형식을 사용하여 버전을 지정합니다.

  • 2.x: 주 버전에서 최신 버전을 설치합니다.
  • 2.2.x: 주 버전과 부 버전에서 최신 버전을 설치합니다.
  • 2.2.104: 정확한 버전을 설치합니다.

releases-index 파일에서 SDK/런타임을 설치하기 위한 값을 version 찾습니다.


includePreviewVersions - 미리 보기 버전 포함
boolean. 기본값은 false입니다.

최신 버전을 검색하는 동안 미리 보기 버전을 포함할지를 지정합니다. 와 같은 3.0.100-preview3-010431정확한 버전을 지정하면 이 설정이 무시됩니다.


installationPath - 설치 경로 .NET Core
string. 기본값은 $(Agent.ToolsDirectory)/dotnet입니다.

.NET Core SDK/런타임을 설치할 위치를 지정합니다. 경로가 다르면 에 다음과 같은 영향을 미칠 수 있습니다. NET의 동작:

  • $(Agent.ToolsDirectory): 이 디렉터리가 파이프라인 간에 정리되지 않으므로 에이전트에 캐시할 버전을 결정합니다. 에이전트에서 실행되는 모든 파이프라인은 에이전트를 사용하여 이전에 설치된 버전에 액세스할 수 있습니다.
  • $(Agent.TempDirectory): 각 파이프라인 이후에 이 폴더가 정리되므로 파이프라인에서 캐시된 버전의 .NET Core를 사용하지 않도록 할 수 있습니다.
  • 다른 경로: 에이전트 프로세스에서 경로에 액세스할 수 있는 경우 다른 경로를 구성할 수 있습니다. 이렇게 하면 컴퓨터의 상태가 변경되고 컴퓨터에서 실행되는 모든 프로세스에 영향을 줍니다.

다단계 조회 설정을 구성할 수도 있습니다. 이 설정은 적절한 버전을 검색하도록 .NET 호스트를 구성할 수 있습니다.


performMultiLevelLookup - 다중 수준 조회 수행
boolean. 기본값은 false입니다.

이 입력은 Windows 기반 에이전트에만 적용됩니다. 이 입력은 적절한 공유 프레임워크를 조회하기 위한 .NET 호스트 프로세스의 동작을 구성합니다. False 는 이 작업에 지정된 폴더에 있는 버전만 호스트 프로세스에서 확인됨을 의미합니다. True 는 호스트가 다중 수준 조회를 사용하여 미리 정의된 전역 위치를 확인하려고 시도한다는 의미입니다.

Windows의 경우 기본 전역 위치는 다음과 같습니다.

  • C:\Program Files\dotnet (64비트 프로세스)
  • C:\Program Files (x86)\dotnet (32비트 프로세스)

자세한 내용은 다중 수준 SharedFX 조회를 참조하세요.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

이 작업은 더 이상 사용되지 않습니다. @UseDotNet2 사용합니다.

이 작업 버전의 새로운 기능

  • 여러 버전을 나란히 설치할 수 있습니다.
  • 부 버전/주 버전에서 최신을 가져오는 버전 패턴 지원.
  • 다중 수준 조회를 제한합니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업을 실행하면 동일한 작업의 후속 작업에 대한 다음 요구 사항이 충족됩니다. DotNetCore
명령 제한 사항 모두
Settable 변수 모두
에이전트 버전 지원되는 모든 에이전트 버전입니다.
작업 범주 도구