Hızlı başlangıç

Bu rehber sıfır makineden deploy edilmiş bir siteye götürür. Bir podmaker control plane’ine ve en az bir bağlı bulut hesabına erişimin olduğunu varsayar.

1. CLI’ı kur

# Homebrew (macOS / Linux)
brew install podmaker/tap/podmakerctl

# veya bir release binary indir ve PATH’ine koy
curl -fsSL https://get.podmaker.sh/install.sh | sh

Doğrula:

podmakerctl --version
pdctl --help        # pdctl kısa alias

Tüm yöntemler ve shell completion için CLI kurulumu.

2. Kimlik doğrula

pdctl login --url https://panel.podmaker.sh
pdctl whoami

Bu, ~/.podmaker/credentials.toml içine bir Sanctum bearer token ve ~/.podmaker/config.toml içine panel URL’ini saklar.

3. Plan üret

pdctl plan generate

Kısa mülakatı yanıtla. CLI üç maliyet arketipinde — ECONOMY, BALANCED, PERFORMANCE — inceleyip düzenleyebileceğin bir YAML dosyası olarak topoloji planı üretir.

pdctl plan estimate plan.yaml     # aylık maliyet dökümü
pdctl plan validate plan.yaml     # şema kontrolü
pdctl plan inspect  plan.yaml     # ayrıntılı analiz

4. Uygula

pdctl plan apply plan.yaml
pdctl plan watch <topology-id>    # SSE ile canlı yayılım

5. Bir site deploy et

Bir deploy manifest’i yaz ve uygula:

apiVersion: podmaker.sh/v1alpha
kind: Site
metadata:
  name: hello
targets:
  - server: demo-01
source:
  type: git
  repo: https://github.com/podmaker/hello-static.git
runtime:
  type: static

pdctl validate site.yml
pdctl apply -f site.yml

Siten canlı. Buradan sonra:

Bir özel domain ve SSL ekle.
Bir private depo bağla.
Secret’ları vault’undan referansla.