Azure DevOps Self-Hosted Agent Kurulumu (Windows)
Bu yazıda, Windows üzerinde Azure DevOps self-hosted agent kurulumunu nasıl yaptığımı adım adım anlatacağım. Kurulum sırasında Personal Access Token (PAT) ile kimlik doğrulaması ve servisi Windows hizmeti olarak çalıştırma gibi detayları da paylaşacağım.
1. Kurulum Dizini Oluşturma
İlk olarak agent dosyalarının duracağı bir klasör oluşturdum ve içine girdim:
mkdir agent
cd agent
2. Agent Paketini İndirme ve Açma
Azure DevOps’tan agent’ın uygun sürümünü (benim örneğimde vsts-agent-win-x64-4.258.1.zip (güncel agent bulmanız lazım) indirdikten sonra, zip arşivini bu klasöre çıkardım:
Add-Type -AssemblyName System.IO.Compression.FileSystem ; `
[System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win-x64-4.258.1.zip", "$PWD")
3. Agent’ı Konfigüre Etme
Agent’ı konfigüre ederken, Azure DevOps organizasyonuma bağlamak için aşağıdaki bilgileri kullandım:
- <agent-name> → Agent’a vereceğim isim
- <agent-pool-name> → Azure DevOps’ta daha önce oluşturduğum veya kullanacağım pool’un adı
- <azure-dev-ops-organization-url> → Örneğin: https://dev.azure.com/benimorganizasyonum
- <token> → PAT (Personal Access Token)
- <domain\user-name> → Agent’ın çalışacağı Windows hesabı (örneğin: DESKTOP\Yakup)
- <windows-password> → Bu hesabın şifresi
.\config.cmd --unattended `
--agent '<agent-name>' `
--pool '<agent-pool-name>' `
--url '<azure-dev-ops-organization-url>' `
--auth 'PAT' `
--token '<token>' `
--runAsService `
--runAsAutoLogon `
--windowsLogonAccount '<domain\user-name>' `
--windowsLogonPassword '<windows-password>'
- –unattended → Etkileşimsiz kurulum sağlar.
- –runAsService → Agent’ı Windows servisi olarak kaydeder.
- –runAsAutoLogon → Sunucu yeniden başladığında otomatik oturum açmayı sağlar.
4. Agent’ı Kaldırma
Agent’ı kaldırmak gerekirse (örneğin yeniden kurulum veya taşıma için), yine PAT kullanarak hızlıca silebilirim:
.\config.cmd remove --unattended --auth 'PAT' --token '<token>'
Sonuç
Bu adımlarla, Windows üzerinde self-hosted Azure DevOps agent’ımı başarıyla kurup çalıştırmış oldum.
Bu yöntem özellikle CI/CD süreçlerinde build veya deploy işleri için kendi makineni ya da sunucunu agent olarak kullanmak isteyenler için çok kullanışlı.
