İçeriğe geç
Proxmox'un Türkiye'deki tek yetkili partneri Proxmox'ta doğrulayın ↗ +90 212 639 45 43 [email protected]
Ana sayfa / Rehberler / Otomasyon
Otomasyon rehberi

Proxmox API ve otomasyon

REST API, API anahtarları, pvesh, cloud-init şablonları, Ansible ve Terraform ile tekrarlanabilir altyapı.

GTM Open Source mühendislik ekibi · 16 Kasım 2026 · 8 dakikalık okuma

Neden otomasyon?

  • Hız: Yeni bir sanal makine ya da ortam dakikalar yerine saniyelerde.
  • Tutarlılık: Her ortam aynı ayarlarla; elle yapılan yanlışlar azalır.
  • Kayıt: Altyapı kod olarak saklanır; kim neyi ne zaman değiştirdi görünür.
  • Felaket kurtarma: Ortam yeniden kurulması gerektiğinde aynı kod çalıştırılır.

REST API

Proxmox VE'nin tüm yönetimi bir REST API üzerinden yapılır; web arayüzü de bu API'yi kullanır. Veri biçimi JSON'dur ve API'nin tamamı belgelenmiştir: Proxmox'un çevrim içi API görüntüleyicisi, her uç noktayı ve parametrelerini listeler.

# küme durumunu sorgula (API anahtarıyla)
curl -s -H "Authorization: PVEAPIToken=otomasyon@pve!terraform=ANAHTAR" \
  https://pve1.ornek.local:8006/api2/json/cluster/status

API anahtarları

Otomasyon araçlarında kullanıcı parolası yerine API anahtarı kullanın:

  • Her araç ya da ekip için ayrı kullanıcı ve ayrı anahtar.
  • Ayrı yetki (privilege separation) açık: anahtar, kullanıcının tüm yetkilerini değil, ona ayrıca verilen yetkileri taşır.
  • Son kullanma tarihi ve yalnız gereken kaynaklarda yetki.
  • Anahtarlar kod deposuna yazılmaz; gizli bilgi yöneticisinde ya da ortam değişkeninde tutulur.

Yetkiler ve API anahtarları

pvesh ile komut satırı

pvesh, API'yi sunucunun komut satırından çağırmayı sağlar; betiklerde kullanışlıdır:

pvesh get /nodes --output-format json-pretty
pvesh get /cluster/resources --type vm
pvesh create /nodes/pve1/qemu/100/snapshot --snapname guncelleme-oncesi

cloud-init şablonları

cloud-init, sanal makinenin ilk açılışta ana bilgisayar adı, IP adresi, kullanıcı ve SSH anahtarı gibi ayarları almasını sağlar. Otomasyonun temel taşıdır:

  1. Linux dağıtımının cloud-init destekli bulut imajını indirin.
  2. Bir sanal makineye disk olarak içe aktarın, cloud-init sürücüsü ekleyin ve şablona dönüştürün.
  3. Yeni makineleri bu şablondan klonlayıp IP, kullanıcı ve SSH anahtarını cloud-init ayarlarıyla verin.
qm set 9000 --ide2 local-lvm:cloudinit --ciuser yonetici \
  --sshkeys /root/anahtar.pub --ipconfig0 ip=dhcp
qm template 9000
qm clone 9000 201 --name web01 --full

Terraform ve Ansible

AraçNe içinNot
Terraform / OpenTofuSanal makineleri, ağları ve depolamayı kod olarak tanımlamakProxmox sağlayıcıları topluluk tarafından geliştirilir
AnsibleSanal makinelerin içini yapılandırmak; Proxmox'u yönetmekProxmox modülleri topluluk koleksiyonlarında
PackerAltın imaj ve şablon üretmekTopluluk eklentisi

Tipik akış: Packer ile şablon, Terraform ile sanal makineler, Ansible ile yazılım kurulumu. Topluluk araçlarının Proxmox sürümünüzle uyumunu test ortamında doğrulayın; Proxmox yükseltmelerinden önce de bu testi tekrarlayın. Kubernetes için örnek akış: Proxmox üzerinde Kubernetes

Gözetimsiz kurulum

Proxmox VE kurulumu bir yanıt dosyasıyla otomatikleştirilebilir: disk düzeni, ağ ayarları, parola ve diğer seçimler dosyadan okunur. Çok sayıda sunucunun (ör. şubeler) aynı ayarlarla kurulmasını sağlar. Şube altyapısı

Kodla yönetilen Proxmox altyapısı

Şablonlar, Terraform/Ansible akışı ve API anahtar yapısını ekibinizle birlikte kuruyor, eğitimle devrediyoruz.

Eğitim

Sık sorulan sorular

Proxmox'un API'si her şeyi yapabiliyor mu?

Web arayüzünde yapılabilen işlemlerin neredeyse tamamı REST API ile de yapılabilir; arayüzün kendisi de aynı API'yi kullanır.

Terraform ve Ansible desteği resmi mi?

Proxmox, Terraform/OpenTofu ve Ansible ile otomasyonu destekler; ancak bu araçlar için kullanılan Proxmox eklentileri ve modülleri topluluk tarafından geliştirilir. Kullanmadan önce sürüm uyumluluğunu test edin.

Sunucu kurulumu da otomatikleştirilebilir mi?

Evet. Proxmox VE, yanıt dosyasıyla gözetimsiz kurulumu destekler; yeni sunucular elle müdahale olmadan aynı ayarlarla kurulabilir.

Otomasyon projeniz için yazın

Kullandığınız araçları ve otomatikleştirmek istediğiniz işleri yazın; kurulum ve eğitim önerisiyle dönelim.

  • Global fiyatla aynı fiyat, fark ödemeden yerel fatura
  • Proxmox sertifikalı mühendislerle ön görüşme
  • Proxmox aboneliği + isteğe bağlı GTM kurulum/destek tek tekliften

Telefon: +90 212 639 45 43
E-posta: [email protected]