UseDotNet@2 - Menggunakan tugas dotnet v2

Gunakan tugas ini untuk memperoleh versi tertentu dari .NET Core SDK dari internet atau cache lokal dan menambahkannya ke PATH. Gunakan tugas ini untuk mengubah versi .NET Core yang digunakan dalam tugas berikutnya. Tugas ini juga menyediakan dukungan proksi.

Sintaksis

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Input

Paket untuk menginstal
. Nilai yang diizinkan: , (SDK (berisi runtime)). Nilai default: .

Menentukan apakah hanya akan menginstal runtime .NET atau SDK.

Menggunakan json global
. Fakultatif. Gunakan saat . Nilai default: .

Menginstal semua SDK dari file . File-file ini dicari dari . Anda dapat mengubah jalur akar pencarian dengan mengatur input direktori kerja.

Format dan (menggunakan sebagai kartubebas) yang dijelaskan dalam input adalah untuk digunakan dalam input dalam tugas, bukan parameter di .

Jika Anda menerima pesan kesalahan seperti dan Anda menggunakan , periksa di Anda.

Untuk informasi selengkapnya tentang global.json, lihat Pilih versi .NET yang akan digunakan.

Direktori Kerja
. Fakultatif. Gunakan saat .

Menentukan jalur dari tempat file harus dicari saat menggunakan . Jika nilai kosong, akan dianggap sebagai jalur akar.

Versi
. Fakultatif. Gunakan saat .

Menentukan versi .NET Core SDK atau runtime yang akan diinstal. Format nilai versi ditampilkan dengan contoh:

• : Menginstal SDK atau runtime terbaru dengan versi utama yang ditentukan, .
• : Menginstal SDK atau runtime terbaru dengan versi utama dan minor yang ditentukan, dan .
• : Menginstal SDK atau versi runtime yang ditentukan, .

Nilai versi untuk SDK atau penginstalan runtime berada dalam file . Tautan ke versi utama/minor ada dalam file indeks rilis . Misalnya, tautan ke file releases.json untuk versi 3.1.

vsVersion - Versi Visual Studio yang kompatibel
.

Menentukan versi Visual Studio yang kompatibel untuk penginstalan .NET Core SDK yang sesuai. Nilai harus berupa nomor versi lengkap, seperti , yang berisi versi utama, versi minor, dan nomor patch.

Nilai versi untuk SDK atau penginstalan runtime, yang digunakan untuk string , ada dalam file . Tautan ke versi utama/minor ada dalam file indeks rilis . Misalnya, tautan ke file releases.json untuk versi 3.1.

Periksa instalasi yang ada
. Nilai default: .

Pilih apakah Anda ingin mendeteksi apakah versi yang ditentukan sudah diinstal sebelum mencoba mengunduh. Gunakan hanya saat installationPath Kosong yaitu diatur ke nilai default.

Sertakan Versi Pratinjau
. Fakultatif. Gunakan saat . Nilai default: .

Jika diatur ke , sertakan versi pratinjau saat tugas mencari versi runtime/SDK terbaru, seperti mencari atau . Pengaturan ini diabaikan jika Anda menentukan versi yang tepat, seperti .

jalur Untuk Menginstal .Net Core
. Nilai default: .

Menentukan tempat .NET Core SDK/Runtime harus diinstal. Jalur yang berbeda dapat memiliki dampak berikut pada perilaku .NET.

• : Menggunakan jalur ini menyimpan penginstalan pada agen, karena direktori ini tidak dibersihkan di seluruh alur. Semua alur yang berjalan pada agen memiliki akses ke versi yang diinstal sebelumnya.
• $(Agent.TempDirectory): Menggunakan jalur ini memastikan bahwa alur tidak menggunakan versi cache .NET Core, karena folder ini dibersihkan setelah setiap alur.
• Jalur lain: Anda dapat menggunakan jalur apa pun jika proses agen memiliki akses ke jalur. Ini akan mengubah status komputer dan berdampak pada semua proses yang berjalan di atasnya.

Nota

Anda dapat menggunakan pengaturan Multi-Level Lookup, performMultiLevelLookup, untuk mengonfigurasi cara host .NET mencari versi.

Melakukan Pencarian Multi-Tingkat
. Nilai default: .

Mengonfigurasi perilaku proses host .NET saat mencari kerangka kerja bersama yang sesuai. Nilainya adalah:

• : Proses host hanya mencari versi yang ada di folder yang ditentukan oleh tugas.
• : Proses host akan mencari di lokasi global yang telah ditentukan sebelumnya menggunakan pencarian multi-tingkat. Lokasi global default adalah:
  • (proses 64-bit)
  • (proses 32-bit)

Pelajari selengkapnya tentang pencarian SharedFX multi-tingkat.

Nota

performMultiLevelLookup hanya berlaku untuk agen berbasis Windows.

Mengatur batas waktu untuk permintaan unduhan paket
. Nilai default: .

Berikan nilai batas waktu untuk permintaan HTTP yang dibuat tugas untuk mendapatkan paket .NET. Nilainya dalam milidetik. Defaultnya adalah 300000 milidetik (5 menit). Tidak boleh lebih dari 600000 milidetik (10 menit).

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak.

Komentar

Tugas Gunakan .NET Inti memperoleh versi tertentu .NET Core dari inte rnet atau cache alat dan menambahkannya ke PATH Agen Azure Pipelines (dihosting atau pribadi). Gunakan tugas ini untuk mengubah versi .NET Core yang digunakan dalam tugas berikutnya seperti DotNetCoreCLI@2. Menambahkan tugas ini sebelum DotNetCoreCLI@2 dalam definisi build memastikan bahwa versi akan tersedia pada saat membangun, menguji, dan menerbitkan aplikasi Anda.

Pendekatan alat penginstal juga memungkinkan Anda memisahkan dari siklus pembaruan agen. Jika versi .NET Core yang Anda cari tidak ada dari agen Azure Pipelines (Dihosting atau Pribadi), maka Anda dapat menggunakan tugas ini untuk menginstal versi yang tepat pada agen.

Persyaratan

Syarat	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak
Kemampuan	Menjalankan tugas ini memenuhi tuntutan berikut untuk tugas berikutnya dalam pekerjaan yang sama: DotNetCore
pembatasan Perintah	Apa pun
variabel yang Dapat Diatur	Apa pun
Versi agen	2.144.0 atau lebih tinggi
Kategori tugas	Alat