Agen yang dihosting Microsoft

  • Artikel

Azure DevOps

Agen yang dihosting Microsoft hanya tersedia dengan Layanan Azure DevOps, yang dihosting di cloud. Anda tidak dapat menggunakan agen yang dihosting Microsoft atau kumpulan agen Azure Pipelines dengan TFS lokal atau Azure DevOps Server. Dengan versi lokal ini, Anda harus menggunakan agen yang dihost sendiri.

Penting

Pilih versi dari pemilih Versi Konten Azure DevOps.

Pilih versi artikel ini yang sesuai dengan platform dan versi Anda. Pemilih versi berada di atas daftar isi. Cari platform dan versi Azure DevOps Anda.

Jika alur Anda berada di Azure Pipelines, maka Anda memiliki opsi yang nyaman untuk menjalankan pekerjaan Anda menggunakan agen yang dihosting Microsoft. Dengan agen yang di-host Microsoft, pemeliharaan dan peningkatan akan dilakukan untuk Anda. Anda selalu mendapatkan versi terbaru gambar VM yang Anda tentukan di alur Anda. Setiap kali Anda menjalankan alur, Anda mendapatkan komputer virtual baru untuk setiap pekerjaan di alur. Komputer virtual dibuang setelah satu pekerjaan (yang berarti setiap perubahan yang dilakukan pekerjaan pada sistem file komputer virtual, seperti memeriksa kode, tidak akan tersedia untuk pekerjaan berikutnya). Agen yang dihosting Microsoft dapat menjalankan pekerjaan langsung di VM atau dalam kontainer.

Azure Pipelines menyediakan kumpulan agen yang telah ditentukan sebelumnya bernama Azure Pipelines dengan agen yang dihosting Microsoft.

Bagi banyak tim, ini adalah cara paling sederhana untuk menjalankan pekerjaan Anda. Anda dapat mencobanya terlebih dahulu dan melihat apakah itu berfungsi untuk build atau penyebaran Anda. Jika tidak, Anda dapat menggunakan agen set skala atau agen yang dihost sendiri.

Tip

Anda dapat mencoba agen yang dihosting Microsoft tanpa biaya.

Perangkat lunak

Kumpulan agen Azure Pipelines menawarkan beberapa gambar komputer virtual untuk dipilih, masing-masing termasuk berbagai alat dan perangkat lunak.

Gambar Spesifikasi Agen Editor Klasik Label Gambar VM YAML Perangkat Lunak yang Disertakan
Windows Server 2022 dengan Visual Studio 2022 windows-2022 windows-latest OR windows-2022 Tautan
Windows Server 2019 dengan Visual Studio 2019 windows-2019 windows-2019 Tautan
Ubuntu 22.04 ubuntu-22.04 ubuntu-latest OR ubuntu-22.04 Tautan
Ubuntu 20.04 ubuntu-20.04 ubuntu-20.04 Tautan
macOS 13 Ventura macOS-13 macOS-13 Tautan
macOS 12 Monterey macOS-12 macOS-latest OR macOS-12 Tautan
macOS 11 Big Sur (tidak digunakan lagi) macOS-11 macOS-11 Tautan

Gambar agen default untuk alur build klasik adalah windows-2019, dan gambar agen default untuk alur build YAML adalah ubuntu-latest. Untuk informasi selengkapnya, lihat Menunjuk kumpulan di alur Anda.

Anda dapat melihat perangkat lunak yang diinstal untuk setiap agen yang dihosting dengan memilih tautan Perangkat Lunak yang Disertakan dalam tabel. Saat menggunakan gambar macOS, Anda dapat memilih dari versi alat secara manual. Baca selengkapnya.

Pembaruan terkini

Pelanggan didorong untuk bermigrasi ke versi yang lebih baru atau agen yang dihost sendiri.

Untuk informasi selengkapnya dan instruksi tentang cara memperbarui alur Anda yang menggunakan gambar tersebut, lihat Menghapus gambar lama di kumpulan yang dihosting Azure Pipelines.

Catatan

Kapasitas macOS saat ini terbatas. Tidak seperti gambar Linux dan Windows, di mana kapasitas kami dibatasi oleh kapasitas Azure yang sudah habis, kapasitas macOS dibatasi oleh jumlah perangkat keras yang kami miliki. Meskipun kami berupaya membuat kapasitas tambahan tersedia selama Spring 2024, beberapa pekerjaan mungkin mengalami penundaan eksekusi. Jika memungkinkan, misalnya untuk pekerjaan yang tidak membuat aplikasi ekosistem Apple, pelanggan harus memilih gambar Linux atau Windows.

Catatan

Kumpulan yang dihosting Azure Pipelines menggantikan kumpulan yang dihosting sebelumnya yang memiliki nama yang dipetakan ke gambar yang sesuai. Pekerjaan apa pun yang Anda miliki di kumpulan yang dihosting sebelumnya secara otomatis dialihkan ke gambar yang benar di kumpulan yang dihosting Azure Pipelines baru. Dalam beberapa keadaan, Anda mungkin masih melihat nama kumpulan lama, tetapi di belakang layar pekerjaan yang dihosting dijalankan menggunakan kumpulan Azure Pipelines. Untuk informasi selengkapnya tentang pembaruan ini, lihat Catatan rilis kumpulan tunggal yang dihosting dari catatan rilis 1 Juli 2019 - Sprint 154.

Penting

Untuk meminta perangkat lunak tambahan diinstal pada agen yang dihosting Microsoft, jangan membuat permintaan umpan balik pada dokumen ini atau membuka tiket dukungan. Sebagai gantinya, buka masalah di repositori kami, di mana kami mengelola skrip untuk menghasilkan berbagai gambar.

Cara mengidentifikasi alur menggunakan gambar yang dihosting yang tidak digunakan lagi

Untuk mengidentifikasi alur yang menggunakan gambar yang tidak digunakan lagi, telusuri ke lokasi berikut di organisasi Anda: https://dev.azure.com/{organization}/{project}/_settings/agentqueues, dan filter nama gambar untuk diperiksa. Contoh berikut memeriksa vs2017-win2016 gambar.

Cuplikan layar pemfilteran alur menurut nama gambar.

Anda juga dapat meminta riwayat pekerjaan untuk gambar yang tidak digunakan lagi di seluruh proyek menggunakan skrip yang terletak di sini, seperti yang ditunjukkan dalam contoh berikut.

./QueryJobHistoryForRetiredImages.ps1 -accountUrl https://dev.azure.com/{org} -pat {pat}

Menggunakan agen yang dihosting Microsoft

Di alur YAML, jika Anda tidak menentukan kumpulan, alur default ke kumpulan agen Azure Pipelines. Anda hanya perlu menentukan gambar komputer virtual mana yang ingin Anda gunakan.

jobs:
- job: Linux
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo hello from Linux
- job: macOS
  pool:
    vmImage: 'macOS-latest'
  steps:
  - script: echo hello from macOS
- job: Windows
  pool:
    vmImage: 'windows-latest'
  steps:
  - script: echo hello from Windows

Catatan

Spesifikasi kumpulan dapat dilakukan pada beberapa tingkat dalam file YAML. Jika Anda melihat bahwa alur Anda tidak berjalan pada gambar yang diharapkan, pastikan Anda memverifikasi spesifikasi kumpulan di tingkat alur, tahap, dan pekerjaan.

Hindari referensi yang dikodekan secara permanen

Saat Anda menggunakan agen yang dihosting Microsoft, selalu gunakan variabel untuk merujuk ke lingkungan build dan sumber daya agen. Misalnya, jangan mengkodekan huruf atau folder drive yang berisi repositori. Tata letak yang tepat dari agen yang dihosting dapat berubah tanpa peringatan.

Perangkat Keras

Agen yang dihosting Microsoft yang menjalankan gambar Windows dan Linux disediakan pada komputer virtual tujuan umum Azure dengan CPU inti 2, RAM 7 GB, dan ruang disk SSD 14 GB. Komputer virtual ini terletak di lokasi yang sama dengan organisasi Azure DevOps Anda.

Agen yang menjalankan gambar macOS disediakan pada pro Mac dengan CPU inti 3, RAM 14 GB, dan ruang disk SSD 14 GB. Agen ini selalu berjalan di AS terlepas dari lokasi organisasi Azure DevOps Anda. Jika kedaulatan data penting bagi Anda dan jika organisasi Anda tidak berada di AS, maka Anda tidak boleh menggunakan gambar macOS. Pelajari selengkapnya.

Semua komputer ini memiliki setidaknya 10 GB ruang disk kosong yang tersedia untuk dijalankan alur Anda. Ruang kosong ini digunakan ketika alur Anda memeriksa kode sumber, mengunduh paket, menarik gambar docker, atau menghasilkan file perantara.

Penting

Kami tidak dapat memenuhi permintaan untuk meningkatkan ruang disk pada agen yang dihosting Microsoft, atau untuk menyediakan komputer yang lebih kuat. Jika spesifikasi agen yang dihosting Microsoft tidak memenuhi kebutuhan Anda, maka Anda harus mempertimbangkan agen yang dihost sendiri atau agen set skala.

Jaringan

Dalam beberapa penyiapan, Anda mungkin perlu mengetahui rentang alamat IP tempat agen disebarkan. Misalnya, jika Anda perlu memberikan akses agen yang dihosting melalui firewall, Anda mungkin ingin membatasi akses tersebut dengan alamat IP. Karena Azure DevOps menggunakan jaringan global Azure, rentang IP bervariasi dari waktu ke waktu. Microsoft menerbitkan rentang IP daftar file JSON mingguan untuk pusat data Azure, yang dipecah menurut wilayah. File ini diperbarui setiap minggu dengan rentang IP terencana baru. Hanya versi terbaru file yang tersedia untuk diunduh. Jika Anda memerlukan versi sebelumnya, Anda harus mengunduh dan mengarsipkannya setiap minggu saat tersedia. Rentang IP baru menjadi efektif pada minggu berikutnya. Kami menyarankan agar Anda sering memeriksa kembali (setidaknya sekali setiap minggu) untuk memastikan Anda menyimpan daftar terbaru. Jika pekerjaan agen mulai gagal, langkah pemecahan masalah utama pertama adalah memastikan konfigurasi Anda cocok dengan daftar alamat IP terbaru. Rentang alamat IP untuk agen yang dihosting tercantum dalam file mingguan di bawah AzureCloud.<region>, seperti AzureCloud.westus untuk wilayah US Barat.

Agen yang dihosting Anda berjalan di geografi Azure yang sama dengan organisasi Anda. Setiap geografi berisi satu atau beberapa wilayah. Meskipun agen Anda dapat berjalan di wilayah yang sama dengan organisasi Anda, agen Anda tidak dijamin untuk melakukannya. Untuk mendapatkan daftar lengkap kemungkinan rentang IP untuk agen Anda, Anda harus menggunakan rentang IP dari semua wilayah yang terkandung dalam geografi Anda. Misalnya, jika organisasi Anda terletak di geografi Amerika Serikat, Anda harus menggunakan rentang IP untuk semua wilayah dalam geografi tersebut.

Untuk menentukan geografi Anda, navigasi ke https://dev.azure.com/<your_organization>/_settings/organizationOverview, dapatkan wilayah Anda, dan temukan geografi terkait dari tabel geografi Azure. Setelah Anda mengidentifikasi geografi Anda, gunakan rentang IP dari file mingguan untuk semua wilayah dalam geografi tersebut.

Penting

Anda tidak dapat menggunakan koneksi privat seperti ExpressRoute atau VPN untuk menyambungkan agen yang dihosting Microsoft ke jaringan perusahaan Anda. Lalu lintas antara agen yang dihosting Microsoft dan server Anda akan melalui jaringan publik.

Untuk mengidentifikasi kemungkinan rentang IP untuk agen yang dihosting Microsoft

  1. Identifikasi wilayah untuk organisasi Anda di pengaturan Organisasi.
  2. Identifikasi Azure Geography untuk wilayah organisasi Anda.
  3. Petakan nama wilayah dalam geografi Anda ke format yang digunakan dalam file mingguan AzureCloud.<region>, mengikuti format , seperti AzureCloud.westus. Anda dapat memetakan nama wilayah dari daftar Azure Geography ke format yang digunakan dalam file mingguan dengan meninjau nama wilayah yang diteruskan ke konstruktor wilayah yang ditentukan dalam kode sumber untuk kelas Wilayah, dari Pustaka Manajemen Azure untuk .NET.

    Catatan

    Karena tidak ada API di Pustaka Manajemen Azure untuk .NET untuk mencantumkan wilayah untuk geografi, Anda harus mencantumkannya secara manual seperti yang ditunjukkan dalam contoh berikut.

  4. Ambil alamat IP untuk semua wilayah di geografi Anda dari file mingguan. Jika wilayah Anda adalah Brasil Eropa Selatan atau Barat, Anda harus menyertakan rentang IP tambahan berdasarkan geografi fallback Anda, seperti yang dijelaskan dalam catatan berikut.

Catatan

Karena pembatasan kapasitas, beberapa organisasi di wilayah Brasil Selatan atau Eropa Barat terkadang mungkin melihat agen yang dihosting mereka yang terletak di luar geografi yang diharapkan. Dalam kasus ini, selain menyertakan rentang IP untuk semua wilayah dalam geografi Anda seperti yang dijelaskan di bagian sebelumnya, rentang IP tambahan harus disertakan untuk wilayah dalam geografi fallback kapasitas.

Jika organisasi Anda berada di wilayah Brasil Selatan, geografi fallback kapasitas Anda Amerika Serikat.

Jika organisasi Anda berada di wilayah Eropa Barat, geografi fallback kapasitas adalah Prancis.

Rentang IP Mac kami tidak disertakan dalam IP Azure di atas, karena dihosting di cloud macOS GitHub. Rentang IP dapat diambil menggunakan API metadata GitHub menggunakan instruksi yang disediakan di sini.

Contoh

Dalam contoh berikut, rentang alamat IP agen yang dihosting untuk organisasi di wilayah US Barat diambil dari file mingguan. Karena wilayah AS Barat berada dalam geografi Amerika Serikat, alamat IP untuk semua wilayah dalam geografi Amerika Serikat disertakan. Dalam contoh ini, alamat IP ditulis ke konsol.

using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

namespace WeeklyFileIPRanges
{
    class Program
    {
        // Path to the locally saved weekly file
        const string weeklyFilePath = @"C:\MyPath\ServiceTags_Public_20230904.json";

        static void Main(string[] args)
        {
            // United States geography has the following regions:
            // Central US, East US, East US 2, East US 3, North Central US, 
            // South Central US, West Central US, West US, West US 2, West US 3
            // This list is accurate as of 9/8/2023
            List<string> USGeographyRegions = new List<string>
            {
                "centralus",
                "eastus",
                "eastus2",
                "eastus3",
                "northcentralus",
                "southcentralus",
                "westcentralus",
                "westus",
                "westus2",
                "westus3"
            };

            // Load the weekly file
            JObject weeklyFile = JObject.Parse(File.ReadAllText(weeklyFilePath));
            JArray values = (JArray)weeklyFile["values"];

            foreach (string region in USGeographyRegions)
            {
                string tag = $"AzureCloud.{region}";
                Console.WriteLine(tag);

                var ipList =
                    from v in values
                    where tag.Equals((string)v["name"], StringComparison.OrdinalIgnoreCase)
                    select v["properties"]["addressPrefixes"];

                foreach (var ip in ipList.Children())
                {
                    Console.WriteLine(ip);
                }
            }
        }
    }
}

Tag layanan

Agen yang dihosting Microsoft tidak dapat dicantumkan menurut tag layanan. Jika Anda mencoba memberikan akses agen yang dihosting ke sumber daya, Anda harus mengikuti rentang IP yang mengizinkan metode daftar.

Keamanan

Agen yang dihosting Microsoft berjalan di platform Azure yang aman. Namun, Anda harus mengetahui pertimbangan keamanan berikut.

  • Meskipun agen yang dihosting Microsoft berjalan di jaringan publik Azure, agen tersebut tidak diberi alamat IP publik. Jadi, entitas eksternal tidak dapat menargetkan agen yang dihosting Microsoft.
  • Agen yang dihosting Microsoft dijalankan di masing-masing VM, yang di-image ulang setelah setiap eksekusi. Setiap agen didedikasikan untuk satu organisasi, dan setiap VM hanya menghosting satu agen.
  • Ada beberapa manfaat untuk menjalankan alur Anda di agen yang dihosting Microsoft, dari perspektif keamanan. Jika Anda menjalankan kode yang tidak tepercaya di alur Anda, seperti kontribusi dari fork, lebih aman untuk menjalankan alur pada agen yang dihosting Microsoft daripada pada agen yang dihost sendiri yang berada di jaringan perusahaan Anda.
  • Saat alur perlu mengakses sumber daya perusahaan Anda di belakang firewall, Anda harus mengizinkan rentang alamat IP untuk geografi Azure. Ini dapat meningkatkan paparan Anda karena rentang alamat IP agak besar dan karena mesin dalam rentang ini juga dapat menjadi milik pelanggan lain. Cara terbaik untuk mencegah hal ini adalah dengan menghindari kebutuhan untuk mengakses sumber daya internal. Untuk informasi tentang menyebarkan artefak ke sekumpulan server, lihat Komunikasi untuk menyebarkan ke server target.
  • Gambar yang dihosting tidak sesuai dengan tolok ukur pengerasan CIS. Untuk menggunakan gambar yang diperkuat CIS, Anda harus membuat agen yang dihost sendiri atau agen set skala.

Kemampuan dan batasan

Agen yang dihosting Microsoft:

  • Memiliki perangkat lunak di atas. Anda juga dapat menambahkan perangkat lunak selama build atau rilis menggunakan tugas alat penginstal.
    • Anda mendapatkan agen yang baru disortir untuk setiap pekerjaan di alur Anda.
  • Menyediakan penyimpanan 10 GB untuk sumber dan output build Anda.
  • Berikan tingkat gratis:
    • Proyek publik: 10 pekerjaan paralel gratis yang dihosting Microsoft yang dapat berjalan hingga 360 menit (6 jam) setiap kali, tanpa batas waktu keseluruhan per bulan. Hubungi kami untuk meningkatkan batas tingkat gratis Anda.
    • Proyek privat: Satu pekerjaan paralel gratis yang dapat berjalan hingga 60 menit setiap kali, hingga Anda menggunakan 1.800 menit (30 jam) per bulan. Anda dapat membayar kapasitas tambahan per pekerjaan paralel. Pekerjaan paralel berbayar menghapus batas waktu bulanan dan memungkinkan Anda menjalankan setiap pekerjaan hingga 360 menit (6 jam). Beli pekerjaan paralel yang dihosting Microsoft.
    • Saat membuat organisasi Azure DevOps baru, Anda tidak diberi hibah gratis ini secara default. Untuk meminta pemberian gratis untuk proyek publik atau privat, kirimkan permintaan.
  • Jalankan di komputer virtual tujuan umum Microsoft Azure Standard_DS2_v2.
  • Jalankan sebagai administrator di Windows dan pengguna sudo tanpa kata sandi di Linux.
  • (Hanya Linux) Jalankan langkah-langkah dalam yang cgroup menawarkan memori fisik 6 GB dan memori total 13 GB.
  • Gunakan gambar VM yang diperbarui secara teratur (setiap 3 minggu).

Agen yang dihosting Microsoft tidak menawarkan:

  • Kemampuan untuk terhubung dari jarak jauh.
  • Kemampuan untuk menghilangkan artefak ke berbagi file UNC.
  • Kemampuan untuk bergabung dengan mesin langsung ke jaringan perusahaan Anda.
  • Kemampuan untuk mendapatkan mesin build yang lebih besar atau lebih kuat.
  • Kemampuan untuk memuat perangkat lunak kustom terlebih dahulu. Anda dapat menginstal perangkat lunak selama eksekusi alur, seperti melalui tugas alat penginstal atau dalam skrip.
  • Potensi keuntungan performa yang mungkin Anda dapatkan dengan menggunakan agen yang dihost sendiri yang mungkin memulai dan menjalankan build lebih cepat. Pelajari lebih lanjut
  • Kemampuan untuk menjalankan build XAML.
  • Kemampuan untuk mengembalikan ke versi gambar VM sebelumnya. Anda selalu menggunakan versi terbaru.

Jika agen yang dihosting Microsoft tidak memenuhi kebutuhan Anda, maka Anda dapat menyebarkan agen yang dihost sendiri atau menggunakan agen set skala.

FAQ

Bagaimana cara melihat perangkat lunak apa yang disertakan dalam gambar?

Anda dapat melihat perangkat lunak yang diinstal untuk setiap agen yang dihosting dengan memilih tautan Perangkat Lunak yang Disertakan dalam tabel Perangkat Lunak .

Catatan

Secara default, agen Windows menggunakan versi Git yang dibundel dengan perangkat lunak agen. Microsoft merekomendasikan penggunaan versi Git yang dibundel dengan agen, tetapi Anda memiliki beberapa opsi untuk mengambil alih perilaku default ini dan menggunakan versi Git yang telah diinstal mesin agen di jalur.

Untuk melihat versi Git yang digunakan oleh alur, Anda dapat melihat log untuk checkout langkah di alur Anda, seperti yang ditunjukkan dalam contoh berikut.

Syncing repository: PathFilter (Git)
Prepending Path environment variable with directory containing 'git.exe'.
git version
git version 2.26.2.windows.1

Bagaimana Microsoft memilih perangkat lunak dan versi yang akan diletakkan pada gambar?

Informasi selengkapnya tentang versi perangkat lunak yang disertakan pada gambar dapat ditemukan di Panduan untuk apa yang diinstal.

Kapan gambar diperbarui?

Gambar biasanya diperbarui setiap minggu. Anda dapat memeriksa lencana status yang dalam format 20200113.x di mana bagian pertama menunjukkan tanggal gambar diperbarui.

Apa yang dapat saya lakukan jika perangkat lunak yang saya butuhkan dihapus atau diganti dengan versi yang lebih baru?

Anda dapat memberi tahu kami dengan mengajukan masalah GitHub dengan memilih tautan Perangkat Lunak yang Disertakan dalam tabel Gunakan agen yang dihosting Microsoft.

Anda juga dapat menggunakan agen yang dihost sendiri yang menyertakan versi perangkat lunak yang tepat yang Anda butuhkan. Untuk informasi selengkapnya, lihat Agen yang dihost sendiri.

Bagaimana jika saya membutuhkan mesin yang lebih besar dengan lebih banyak daya pemrosesan, memori, atau ruang disk?

Kami tidak dapat meningkatkan memori, daya pemrosesan, atau ruang disk untuk agen yang dihosting Microsoft, tetapi Anda dapat menggunakan agen yang dihost sendiri atau agen set skala yang dihosting di komputer dengan spesifikasi yang Anda inginkan.

Saya tidak dapat memilih agen yang dihosting Microsoft dan saya tidak dapat mengantrekan build atau penyebaran saya. Apa yang harus saya lakukan?

Agen yang dihosting Microsoft hanya tersedia di Azure Pipelines dan tidak di TFS atau Azure DevOps Server.

Secara default, semua kontributor proyek dalam organisasi memiliki akses ke agen yang dihosting Microsoft. Namun, administrator organisasi Anda dapat membatasi akses agen yang dihosting Microsoft untuk memilih pengguna atau proyek. Minta pemilik organisasi Azure DevOps Anda untuk memberi Anda izin untuk menggunakan agen yang dihosting Microsoft. Lihat keamanan kumpulan agen.

Alur saya yang berjalan di agen yang dihosting Microsoft membutuhkan lebih banyak waktu untuk diselesaikan. Bagaimana cara saya mempercepatnya?

Jika alur Anda baru-baru ini menjadi lebih lambat, tinjau halaman status kami untuk mengetahui setiap gangguan. Kami mungkin mengalami masalah terkait layanan kami. Atau, tinjau perubahan apa pun yang Anda buat dalam kode aplikasi atau alur Anda. Ukuran repositori Anda selama check-out mungkin telah meningkat, Anda mungkin mengunggah artefak yang lebih besar, atau Anda mungkin menjalankan lebih banyak pengujian.

Jika Anda hanya menyiapkan alur dan membandingkan performa agen yang dihosting Microsoft dengan komputer lokal atau agen yang dihosting sendiri, perhatikan spesifikasi perangkat keras yang kami gunakan untuk menjalankan pekerjaan Anda. Kami tidak dapat memberi Anda mesin yang lebih besar atau kuat. Anda dapat mempertimbangkan untuk menggunakan agen yang dihosting sendiri atau agen set skala jika performa ini tidak dapat diterima.

Aku butuh lebih banyak agen. Apa yang bisa saya lakukan?

Semua organisasi Azure DevOps disediakan dengan beberapa pekerjaan paralel gratis untuk proyek sumber terbuka, dan satu pekerjaan paralel gratis dan menit terbatas setiap bulan untuk proyek privat. Jika Anda memerlukan menit tambahan atau pekerjaan paralel untuk proyek sumber terbuka Anda, hubungi dukungan. Jika Anda memerlukan menit tambahan atau pekerjaan paralel untuk proyek privat Anda, maka Anda dapat membeli lebih banyak.

Alur saya berhasil pada agen yang dihost sendiri, tetapi gagal pada agen yang dihosting Microsoft. Apa yang harus saya lakukan?

Agen yang dihost sendiri mungkin memiliki semua dependensi yang tepat yang terinstal di dalamnya, sedangkan dependensi, alat, dan perangkat lunak yang sama tidak diinstal pada agen yang dihosting Microsoft. Pertama, tinjau dengan cermat daftar perangkat lunak yang diinstal pada agen yang dihosting Microsoft dengan mengikuti tautan ke Perangkat lunak yang disertakan dalam tabel di atas. Kemudian, bandingkan dengan perangkat lunak yang diinstal pada agen yang dihost sendiri. Dalam beberapa kasus, agen yang dihosting Microsoft mungkin memiliki alat yang Anda butuhkan (misalnya, Visual Studio), tetapi semua komponen opsional yang diperlukan mungkin belum diinstal. Jika Anda menemukan perbedaan, maka Anda memiliki dua opsi:

  • Anda dapat membuat masalah baru di repositori, di mana kami melacak permintaan untuk perangkat lunak tambahan. Menghubungi dukungan tidak dapat membantu Anda menyiapkan perangkat lunak baru di agen yang dihosting Microsoft.

  • Anda dapat menggunakan agen yang dihost sendiri atau agen set skala. Dengan agen ini, Anda sepenuhnya memegang kendali atas gambar yang digunakan untuk menjalankan alur Anda.

Build saya berhasil di komputer lokal saya, tetapi gagal pada agen yang dihosting Microsoft. Apa yang harus saya lakukan?

Komputer lokal Anda mungkin memiliki semua dependensi yang tepat yang terinstal di dalamnya, sedangkan dependensi, alat, dan perangkat lunak yang sama tidak diinstal pada agen yang dihosting Microsoft. Pertama, tinjau dengan cermat daftar perangkat lunak yang diinstal pada agen yang dihosting Microsoft dengan mengikuti tautan ke Perangkat lunak yang disertakan dalam tabel di atas. Kemudian, bandingkan dengan perangkat lunak yang diinstal pada komputer lokal Anda. Dalam beberapa kasus, agen yang dihosting Microsoft mungkin memiliki alat yang Anda butuhkan (misalnya, Visual Studio), tetapi semua komponen opsional yang diperlukan mungkin belum diinstal. Jika Anda menemukan perbedaan, maka Anda memiliki dua opsi:

  • Anda dapat membuat masalah baru di repositori, di mana kami melacak permintaan untuk perangkat lunak tambahan. Ini adalah taruhan terbaik Anda untuk menginstal perangkat lunak baru. Menghubungi dukungan tidak akan membantu Anda menyiapkan perangkat lunak baru di agen yang dihosting Microsoft.

  • Anda dapat menggunakan agen yang dihost sendiri atau agen set skala. Dengan agen ini, Anda sepenuhnya memegang kendali atas gambar yang digunakan untuk menjalankan alur Anda.

Alur saya gagal dengan kesalahan: "tidak ada ruang yang tersisa di perangkat".

Agen yang dihosting Microsoft hanya memiliki 10 GB ruang disk yang tersedia untuk menjalankan pekerjaan Anda. Ruang ini digunakan saat Anda memeriksa kode sumber, saat Anda mengunduh paket, saat Anda mengunduh gambar docker, atau saat Anda menghasilkan file perantara. Sayangnya, kami tidak dapat meningkatkan ruang kosong yang tersedia pada gambar yang dihosting Microsoft. Anda dapat merestrukturisasi alur Anda sehingga dapat masuk ke ruang ini. Atau, Anda dapat mempertimbangkan untuk menggunakan agen yang dihost sendiri atau agen set skala.

Alur saya yang berjalan di agen yang dihosting Microsoft memerlukan akses ke server di jaringan perusahaan kami. Bagaimana cara mendapatkan daftar alamat IP untuk diizinkan di firewall kami?

Lihat bagian Rentang IP agen

Alur kami yang berjalan di agen yang dihosting Microsoft tidak dapat menyelesaikan nama server di jaringan perusahaan kami. Bagaimana kita bisa memperbaikinya?

Jika Anda merujuk ke server dengan nama DNS-nya, pastikan server Anda dapat diakses secara publik di Internet melalui nama DNS-nya. Jika Anda merujuk ke server Anda dengan alamat IP-nya, pastikan alamat IP dapat diakses secara publik di Internet. Dalam kedua kasus, pastikan bahwa firewall apa pun di antara agen dan jaringan perusahaan Anda memiliki rentang IP agen yang diizinkan.

Saya mendapatkan kesalahan otorisasi IP SAS dari akun Azure Storage

Jika Anda mendapatkan kode kesalahan SAS, kemungkinan besar karena alamat IP berkisar dari agen yang dihosting Microsoft tidak diizinkan karena aturan Azure Storage Anda. Ada beberapa solusinya:

  1. Kelola aturan jaringan IP untuk akun Azure Storage Anda dan tambahkan rentang alamat IP untuk agen yang dihosting.
  2. Di alur Anda, gunakan Azure CLI untuk memperbarui set aturan jaringan untuk akun Azure Storage Anda tepat sebelum Anda mengakses penyimpanan, lalu pulihkan set aturan sebelumnya.
  3. Gunakan agen yang dihost sendiri atau Agen set skala.

Bagaimana cara memilih versi alat secara manual di Agen macOS yang dihosting?

Xamarin

Agen macOS yang dihosting menyimpan versi Xamarin SDK dan versi Mono terkait sebagai sekumpulan symlink ke lokasi Xamarin SDK yang tersedia oleh satu symlink bundel.

Untuk memilih versi Xamarin SDK secara manual untuk digunakan pada agen macOS yang dihosting, jalankan perintah bash berikut sebelum tugas build Xamarin Anda sebagai bagian dari build Anda, tentukan bundel versi symlink ke Xamarin yang Anda butuhkan.

/bin/bash -c "sudo $AGENT_HOMEDIRECTORY/scripts/select-xamarin-sdk.sh <symlink>"

Daftar semua versi dan symlink Xamarin SDK yang tersedia dapat ditemukan dalam dokumentasi agen:

Perintah ini tidak memilih versi Mono di luar Xamarin SDK. Untuk memilih versi Mono secara manual, lihat instruksi di bawah ini.

Jika Anda menggunakan versi Xcode non-default untuk membangun aplikasi Xamarin.iOS atau Xamarin.Mac, Anda juga harus menjalankan baris perintah ini:

/bin/bash -c "echo '##vso[task.setvariable variable=MD_APPLE_SDK_ROOT;]'$(xcodeRoot);sudo xcode-select --switch $(xcodeRoot)/Contents/Developer"

Mana $(xcodeRoot) = /Applications/Xcode_13.2.app

Versi Xcode pada kumpulan agen macOS yang dihosting dapat ditemukan di sini untuk macos-11 agen dan di sini untuk macos-12 agen.

Xcode

Jika Anda menggunakan tugas Xcode yang disertakan dengan Azure Pipelines dan TFS, Anda dapat memilih versi Xcode di properti tugas tersebut. Jika tidak, untuk mengatur versi Xcode secara manual untuk digunakan pada kumpulan agen macOS yang dihosting, sebelum tugas build Andaxcodebuild, jalankan baris perintah ini sebagai bagian dari build Anda, ganti versi Xcode nomor 13.2 sesuai kebutuhan:

/bin/bash -c "sudo xcode-select -s /Applications/Xcode_13.2.app/Contents/Developer"

Versi Xcode pada kumpulan agen macOS yang dihosting dapat ditemukan di sini untuk macos-11 agen dan di sini untuk macos-12 agen.

Perintah ini tidak berfungsi untuk aplikasi Xamarin. Untuk memilih versi Xcode secara manual untuk membangun aplikasi Xamarin, lihat instruksi di atas.

Mono

Untuk memilih versi Mono secara manual untuk digunakan pada kumpulan agen macOS yang dihosting, jalankan skrip ini di setiap pekerjaan build Anda sebelum tugas build Mono Anda, tentukan symlink dengan versi Mono yang diperlukan (daftar semua symlink yang tersedia dapat ditemukan di bagian Xamarin di atas):

SYMLINK=<symlink>
MONOPREFIX=/Library/Frameworks/Mono.framework/Versions/$SYMLINK
echo "##vso[task.setvariable variable=DYLD_FALLBACK_LIBRARY_PATH;]$MONOPREFIX/lib:/lib:/usr/lib:$DYLD_LIBRARY_FALLBACK_PATH"
echo "##vso[task.setvariable variable=PKG_CONFIG_PATH;]$MONOPREFIX/lib/pkgconfig:$MONOPREFIX/share/pkgconfig:$PKG_CONFIG_PATH"
echo "##vso[task.setvariable variable=PATH;]$MONOPREFIX/bin:$PATH"