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 변수 | 모두 |
에이전트 버전 | 지원되는 모든 에이전트 버전입니다. |
작업 범주 | 도구 |