Bagikan melalui

Menjalankan agen yang dihost sendiri di belakang proksi web

Layanan Azure DevOps | Azure DevOps Server 2022 dan Azure DevOps Server 2019

Saat agen yang dihost sendiri memerlukan proksi web, Anda dapat memberi tahu agen tentang proksi selama konfigurasi. Ini memungkinkan agen Anda untuk terhubung ke Azure Pipelines atau TFS melalui proksi. Ini pada gilirannya memungkinkan agen untuk mendapatkan sumber dan mengunduh artefak. Terakhir, rincian proksi diteruskan ke tugas-tugas yang juga memerlukan pengaturan proksi untuk dapat mengakses web.

Azure Pipelines, TFS 2018 RTM, dan yang lebih baru

(Berlaku untuk agen versi 2.122 dan yang lebih baru.)

Untuk memungkinkan agen berjalan di belakang proksi web, masukkan --proxyurl, --proxyusername dan --proxypassword selama konfigurasi agen.

Contohnya:

./config.cmd --proxyurl http://127.0.0.1:8888 --proxyusername "myuser" --proxypassword "mypass"

Kami menyimpan kredensial proksi Anda secara bertanggung jawab di setiap platform untuk mencegah kebocoran yang tidak disengaja. Pada Linux, kredensial dienkripsi dengan kunci simetris berdasarkan ID mesin. Di macOS, kita menggunakan Rantai Kunci. Di Windows, kami menggunakan Penyimpanan Kredensial.

Nota

Versi agen 122.0, yang dirilis dengan TFS 2018 RTM, memiliki masalah yang diketahui saat dikonfigurasi sebagai layanan di Windows. Karena Penyimpanan Kredensial Windows berlaku per setiap pengguna, Anda harus mengonfigurasi agen menggunakan pengguna yang sama yang akan menjalankan layanan tersebut. Misalnya, untuk mengonfigurasi layanan agen berjalan sebagai mydomain\buildadmin, Anda harus meluncurkan config.cmd sebagai mydomain\buildadmin. Anda dapat melakukannya dengan masuk ke komputer dengan pengguna tersebut atau menggunakan Run as a different user di shell Windows.

Bagaimana agen menangani proksi dalam tugas build atau rilis

Agen akan berbicara dengan layanan Azure DevOps/TFS melalui proksi web yang ditentukan dalam .proxy file.

Karena kode untuk tugas-tugas dalam Get Source builds dan Download Artifact rilis juga terintegrasi ke dalam agen, tugas-tugas tersebut akan mengikuti konfigurasi proksi agen dari file .proxy.

Agen mengekspos konfigurasi proksi melalui variabel lingkungan untuk setiap eksekusi tugas. Penulis tugas perlu menggunakan metode azure-pipelines-task-lib untuk mengambil konfigurasi proksi dan menangani proksi dalam tugas mereka.

Perhatikan bahwa banyak alat tidak secara otomatis menggunakan pengaturan proksi yang dikonfigurasi agen. Misalnya, alat seperti curl dan dotnet dapat memerlukan variabel lingkungan proksi seperti http_proxy yang juga diatur pada mesin.

Tentukan URL untuk melewati proksi

Buat .proxybypass file di direktori akar agen yang menentukan ekspresi reguler (dalam sintaks ECMAScript) agar sesuai dengan URL yang harus melewati proksi. Contohnya:

github\.com
bitbucket\.com