Bagikan melalui

Versi 3 perangkat lunak agen

  • Artikel

Tim alur meningkatkan perangkat lunak agen dari versi 2.x (menggunakan .NET Core 3.1) ke versi 3.x (menggunakan .NET 6). Versi agen baru mendukung perangkat keras silikon Apple baru dan sistem operasi yang lebih baru seperti Ubuntu 22.04, atau Windows di ARM64.

Catatan

Fitur ini tersedia mulai di Azure DevOps Server 2022.1.

Tingkatkan ke agen 3.x pada sistem operasi yang didukung

Jika Anda menjalankan agen yang dihost sendiri pada sistem operasi yang lebih baru yang didukung oleh .NET 6, peningkatan ke versi agen baru bersifat otomatis.

Sistem operasi berikut didukung oleh agen 3.x.

  • Linux
    • x64
      • Debian 10+
      • Fedora 36+
      • openSUSE 15+
      • Red Hat Enterprise Linux 7+
        • Tidak lagi memerlukan paket terpisah
      • SUSE Enterprise Linux 12 SP2 atau yang lebih baru
      • Ubuntu 22.04, 20.04, 18.04, 16.04
      • Azure Linux 2.0
      • Oracle Linux 7 dan yang lebih tinggi
    • ARM64
      • Debian 10+
      • Ubuntu 22.04, 20.04, 18.04
    • Alpine x64
  • macOS
    • x64
      • macOS 10.15 "Catalina"
      • macOS 11.0 "Big Sur"
      • macOS 12.0 "Monterey"
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
    • ARM64
      • macOS 11.0 "Big Sur"
      • macOS 12.0 "Monterey"
      • macOS 13.0 "Ventura"
      • macOS 14.0 "Sonoma"
  • Windows
    • OS Klien
      • Windows 7 SP1 ESU
      • Windows 8.1
      • Windows 10
      • Windows 11
    • Server OS
      • Windows Server 2012 atau yang lebih tinggi

Tingkatkan ke agen 3.x pada sistem operasi yang tidak didukung

Jika Anda menjalankan agen yang dihost sendiri pada sistem operasi yang tidak didukung oleh .NET 6, Anda harus memperbarui komputer Anda untuk menggunakan sistem operasi yang didukung lebih baru yang didukung oleh .NET 6.

Daftar sistem operasi berikut umumnya digunakan untuk agen 2.x yang dihost sendiri. Sistem operasi ini tidak didukung oleh .NET 6 dan tidak dapat digunakan untuk menjalankan agen berbasis .NET 6 versi 3.x baru.

Sistem/Distribusi Versi tidak didukung oleh .NET 6
Debian <= 4,9
Fedora <= 32
RedHat Enterprise Linux <= 6
Ubuntu < 18.04 LTS
macOS < 10.15

Anda dapat menggunakan skrip untuk memprediksi apakah agen di kumpulan host Anda dapat ditingkatkan dari 2.x ke 3.x.

Saat mencoba menjalankan alur pada agen versi 2.218 (atau 2.214 pada RHEL 6), alur yang berjalan di salah satu sistem operasi yang tidak didukung yang tercantum di sini akan gagal dengan pesan kesalahan berikut: 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.

Untuk mengatasi kesalahan ini, Anda dapat:

  1. Tingkatkan atau pindahkan komputer agen Anda ke salah satu sistem operasi yang didukung yang tercantum sebelumnya dalam artikel ini. Ini adalah solusi yang disukai dan memungkinkan Anda untuk mendapatkan pembaruan agen di masa mendatang,
  2. AGENT_ACKNOWLEDGE_NO_UPDATES Atur variabel pada agen, baik dengan mengatur variabel lingkungan atau variabel alur.

  • Anda dapat mengatur AGENT_ACKNOWLEDGE_NO_UPDATES dengan mengonfigurasi variabel lingkungan pada agen, misalnya di /etc/environment atau etc/profile.d: AGENT_ACKNOWLEDGE_NO_UPDATES=true.

  • Anda dapat mengatur variabel alur.

    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

Apa perbedaan antara agen 2.x dan 3.x?

Agen 2.x (misalnya 2.212) adalah .NET Core 3.1 dan agen 3.x (misalnya 3.212) adalah .NET 6. Selama Fase I dan II, kedua versi tersedia, dengan versi 3.x sedang dalam prarilis.

Bagaimana cara memeriksa agen saya untuk melihat apakah mereka dapat meningkatkan ke 3.x?

Anda dapat menggunakan skrip untuk memprediksi apakah agen di kumpulan yang dihost sendiri akan dapat ditingkatkan dari 2.x ke 3.x.

Bagaimana masalah keamanan dalam agen akan di-patch ke depannya?

Ketika agen .NET 6 menjadi tersedia secara umum untuk kumpulan yang dihost sendiri pada Q1 2023, tidak akan ada patch yang dilakukan, secara umum, untuk agen 2.x. Patch hanya akan dilakukan untuk agen 3.x. Namun, kami juga memiliki pelanggan Azure DevOps Server yang masih akan mengandalkan agen 2.x. Jadi, kami akan meninjau masalah keamanan berdasarkan kasus per kasus untuk memutuskan.

Apa yang perlu saya lakukan ketika saya menggunakan OS yang tidak didukung?

Anda harus bermigrasi ke sistem operasi yang lebih baru yang didukung oleh .NET 6 sekarang. Jika tidak, agen Anda dapat mencoba meningkatkan, dan akan gagal karena .NET 6 tidak dapat diinstal pada OS Anda. Kami akan menerbitkan beberapa panduan dalam posting blog tindak lanjut yang akan mencegah peningkatan otomatis agen. Namun, itu hanya dimaksudkan untuk menjadi solusi sementara untuk memberi Anda lebih banyak waktu untuk meningkatkan mesin agen Anda.

Dapatkah saya tetap berada di agen 2.x jika saya tidak mengerjakan perubahan apa pun dalam proyek saya lagi?

Tidak. Tim alur secara teratur menambahkan fitur baru ke Azure Pipelines dan beberapa di antaranya mungkin memerlukan pembaruan ke agen meskipun alur Anda tidak secara eksplisit bergantung pada fitur tersebut. Ketika Anda mencegah peningkatan otomatis agen menggunakan panduan dalam blog tindak lanjut, agen tersebut tidak dapat digunakan untuk menjadwalkan alur. Jika tidak ada agen dengan kemampuan yang diperlukan yang dapat ditemukan, eksekusi alur akan gagal.

Apakah saya harus menginstal .NET 6 sebelum menginstal perangkat lunak agen 3.x?

Anda tidak perlu menginstal .NET 6 di komputer agen Anda sebelum menginstal dan mengonfigurasi perangkat lunak agen 3.x. Semua dependensi .NET yang diperlukan agen 3.x adalah bagian dari agen itu sendiri.

Apakah saya harus membuat kode saya menggunakan .NET 6 jika saya menggunakan agen 3.x?

Versi .NET yang digunakan untuk menjalankan agen 3.x mandiri dalam penginstalan agen, dan tidak digunakan untuk membangun kode Anda. Versi .NET yang digunakan untuk membangun kode Anda tergantung pada alur dan versi atau versi .NET yang telah Anda instal ke komputer agen Anda.

Saya menggunakan Azure DevOps Server dan bukan Azure DevOps Service. Apakah perubahan ini berdampak pada saya?

Ya, jika Anda menggunakan salah satu versi Azure DevOps Server yang tercantum di bagian berikut.

Tim alur merekomendasikan agar Anda memperbarui komputer agen ke sistem operasi yang lebih baru yang didukung oleh .NET 6 mulai sekarang, jika Anda berencana untuk mengikuti rilis Azure DevOps Server di masa mendatang.

Apakah Azure DevOps Server mendukung agen 3.x

Versi Azure DevOps Server mendukung versi agen yang disebarkan dengan versi tersebut. Tabel berikut mencantumkan setiap versi Azure DevOps Server yang didukung dan versi agen yang didukung.

Versi Azure DevOps Server Versi agen
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 dilayankan melalui patch keamanan atau layanan yang menyediakan perbaikan bug kumulatif yang ditargetkan untuk fitur yang ada dalam produk. Untuk pengalaman produk terbaik dan paling aman, kami sangat mendorong dan menyarankan agar semua pelanggan menggunakan rilis terbaru dan paling aman dari Azure DevOps Server. Anda dapat mengunduh versi terbaru produk, dari halaman unduhan Azure DevOps Server.

Setelah menginstal pembaruan Azure DevOps Server atau versi baru, perbarui agen Anda.

Tabel berikut mencantumkan versi Azure DevOps Server yang pertama kali menyertakan versi agen 3.x.

Apa garis waktu untuk penyebaran agen versi 3?

Agen versi 3 dirilis Maret 2023.

Apa yang akan terjadi ketika tugas mengharuskan agen diperbarui ke agen versi 3?

Biasanya, ketika tugas memerlukan versi agen yang lebih baru, tugas akan secara otomatis memperbarui dirinya sendiri. Untuk saat ini, sementara agen versi 2 terus diperbarui, kami telah menonaktifkan pembaruan otomatis dari agen versi 2 ke agen versi 3. Setelah kami mengaktifkannya, untuk Sistem Operasi yang tidak kompatibel dengan agen versi 3, agen versi 2.217 dan yang lebih baru tidak akan mencoba memperbarui dirinya ke agen v3. Sebagai gantinya, peringatan akan ditampilkan yang memberi tahu pengguna bahwa mereka perlu meningkatkan Sistem Operasi terlebih dahulu: 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