Tüm komutlar --help kabul eder. Tanımlayıcılar belirtilen yerlerde UUID veya
kısa isimdir. Sürümü podmakerctl --version ile yazdır.
Kimlik doğrulama
Kimlik doğrulama komutları top-level’dır.
| Komut | Açıklama |
|---|
pdctl login --url <panel> | Kimlik doğrula ve bearer token sakla |
pdctl whoami | Mevcut kullanıcıyı göster |
pdctl logout | Saklanan credential’ları temizle |
plan
Planlama akışı. Uçtan uca akış için plan yaşam döngüsü.
| Komut | Açıklama |
|---|
pdctl plan generate | Mülakat tabanlı plan (ECONOMY / BALANCED / PERFORMANCE) |
pdctl plan validate <file> | Planı şema doğrula |
pdctl plan estimate <file> | Aylık maliyet dökümü |
pdctl plan inspect <file> | Ayrıntılı plan analizi |
pdctl plan render <file> | Terminal / JSON render |
pdctl plan customise <file> | Etkileşimli editör |
pdctl plan compare <a> <b> | Node bazında diff + maliyet farkı |
pdctl plan diff --git-a <ref> --git-b <ref> | İki plan YAML’ı veya iki Git ref’i diff’le (--repo, --path) |
pdctl plan budget <topology-id> | Canlı topoloji için bütçeye karşı maliyet projeksiyonu |
pdctl plan apply <file> | Planı control plane’e uygula |
pdctl plan deploy | Uygulanmış plandan deploy et |
pdctl plan watch <topology-id> | Yayılım durumunu akıt (SSE) |
pdctl plan dashboard <topology-id> | Canlı TUI dashboard (--tail-logs, --ai özet) |
pdctl plan show <topology-id> | Uygulanmış topolojiyi incele |
pdctl plan releases <topology-id> | Release geçmişi |
pdctl plan rollback <topology-id> | Bir deploy’u geri al |
pdctl plan tour | Plan akışının rehberli turu |
pdctl plan repo <git-url> | Bir repoyu tara ve plan öner |
pdctl plan publish <file> | Plan + manifest.sha256 + provenance bundle, cosign-imzalı |
pdctl plan replay <bundle-dir> | Yayınlanmış bir bundle’ı yeniden uygula |
pdctl plan verify <bundle-dir> | Bundle bütünlüğünü manifest’e karşı doğrula |
plan template
Yeniden kullanılabilir planların kataloğu.
| Komut | Açıklama |
|---|
pdctl plan template list | Mevcut template’leri listele |
pdctl plan template search <query> | Katalogda ara |
pdctl plan template show <slug> | Bir template’i göster |
pdctl plan template install <slug> | Template’i yeni plan olarak kur |
pdctl plan template create <plan-file> | Bir planı template olarak yayınla |
pdctl plan template update <slug> <plan-file> | Template güncelle |
pdctl plan template diff <slug-a> <slug-b> | İki template’i diff’le |
pdctl plan template stats | Katalog kullanım istatistikleri |
İmzalama ve provenance
plan publish, manifest.sha256 + provenance.json yazar ve cosign PATH’te
olduğunda manifest’i imzalar:
| Flag | Etki |
|---|
--keyless | Sigstore keyless modu (Fulcio + Rekor); GitHub Actions OIDC otomatik algılanır |
--oidc-issuer <url> | OIDC issuer’ı değiştir |
--no-sign | manifest.sha256, provenance ve cosign imzalamayı atla |
plan verify her dosyayı manifest.sha256’a karşı kontrol eder ve drift raporlar.
server
| Komut | Açıklama |
|---|
pdctl server list | Sunucuları / node’ları listele |
pdctl server add | Yeni sunucu kur |
pdctl server adopt | Mevcut bir makineyi adopt et |
pdctl server destroy <id> | Bir sunucuyu yok et |
k8s
Tam Kubernetes yaşam döngüsü.
| Komut | Açıklama |
|---|
pdctl k8s cluster create / destroy / list | Cluster yaşam döngüsü |
pdctl k8s nodepool add / remove | Node pool’lar |
pdctl k8s deploy <app> | Bir workload deploy et |
pdctl k8s scale / logs / exec | Workload işlet |
pdctl k8s ingress / secret / set | Ingress, secret, config |
pdctl k8s adopt | Mevcut bir cluster’ı adopt et |
topology
| Komut | Açıklama |
|---|
pdctl topology init / install / list | Topoloji template’lerini gözat ve materyalize et |
pdctl topology migrate <topology-id> | Sıfır-kesinti migration başlat |
pdctl topology migration list / show / pause / resume / rollback | Aktif migration’ları incele ve kontrol et |
releases & rollback
Deploy geçmişi ve rollback top-level’dır (ve plan altında da yansıtılır).
| Komut | Açıklama |
|---|
pdctl releases <site> | Bir sitenin deploy geçmişi |
pdctl rollback <site> | Bir siteyi önceki release’e geri al |
provider
| Komut | Açıklama |
|---|
pdctl provider list | Cloud-provider credential’larını listele |
pdctl provider add <provider> | Credential ekle (Hetzner / DigitalOcean / AWS / Azure / GCP / Cloudflare / Route 53) |
pdctl provider remove <id> | Credential kaldır |
Proje ve çeşitli
| Komut | Açıklama |
|---|
pdctl scan [path] | Yerel projeyi analiz et ve topoloji öner |
pdctl validate <setup.yml> | Bir v1alpha manifest’i doğrula |
pdctl apply -f <spec.yml> | Deklaratif bir spec bundle uygula |
pdctl init | Yeni bir site başlat |
pdctl agents list | Kurulu AI agent’ları algıla |
pdctl completion <shell> | Shell completion script’i |