CLI referansı

@primdb/cli’yi kur, kimlik doğrula ve projeleri, deployları, veriyi, env’i, logları ve notları terminalden sür.

primdb CLI, projeleri, deployları, ortam değişkenlerini, logları, veri servislerini ve geri bildirim notlarını yönetmek için birincil geliştirici arayüzüdür. Hedef makinede çalışma zamanı bağımlılığı olmayan, tek bir Bun-derlemeli ikili dosyadır.

Kurulum

npm install -g @primdb/cli
# or
bun install -g @primdb/cli

Yapılandırma ve kimlik bilgileri ~/.primdb/ altında yaşar (token makineye özel bir anahtarla beklemede şifreli, dosyalar chmod 600, asla buluta senkronlanmaz).

Auth

primdb login                 # interactive browser login
primdb login --token primdb_...  # non-interactive (CI/CD)
primdb logout                # delete stored credentials
primdb whoami                # print the authenticated user

Projeler

Her komut etkin projeyi şu sırayla çözer: --project bayrağı, sonra geçerli dizindeki .primdb.json, sonra ~/.primdb/config.json içindeki defaultProject.

primdb init                  # create a new project + write .primdb.json
primdb link                  # link an existing project (picker)
primdb link --project <id|slug>  # link non-interactively

Komut grupları

Grup	Ne yapar
`deploy` / `deployments` / `promote` / `rollback`	Buildleri tetikle, deployları listele, önizlemeleri onayla, geri al. Deploy bölümüne bak.
`dev`	Geri bildirim katmanı enjekte edilmiş şekilde yerel bir porta açık bir tünel aç. Önizleme geri bildirimi bölümüne bak.
`env`	Ortam değişkenlerini ayarla, listele, kaldır, çek ve it.
`logs`	Üretim ya da deploy başına logları akıt (SSE) ya da son N satırı yazdır.
`db` / `redis` / `storage`	Postgres, Redis ve nesne depolama ile çalış. Veri bölümüne bak.
`notes`	Geri bildirim notlarını listele, çöz ve dışa aktar. Önizleme geri bildirimi bölümüne bak.
`domains`	Özel alan adları ekle, doğrula ve kaldır (DNS doğrulandığında Let’s Encrypt ile TLS).
`users`	Deploy ettiğin uygulamanın son kullanıcılarını yönet. Auth bölümüne bak.

Ortam değişkenleri

primdb env set KEY=VALUE            # set a variable
primdb env set KEY=VALUE --secret   # mark as secret (masked in dashboard + logs)
primdb env list                     # list all vars (values masked)
primdb env list --reveal            # list with values visible
primdb env rm KEY                   # delete a variable
primdb env pull                     # download all vars to .env.local
primdb env push                     # upload vars from .env.local

Global bayraklar

Bayrak	Kısa	Açıklama
`--project <id\|slug>`	`-p`	Projeyi geçersiz kıl (varsayılan: `.primdb.json`’dan)
`--token <token>`		Auth token’ını geçersiz kıl (varsayılan: `~/.primdb/credentials.json`’dan)
`--json`		Biçimli metin yerine ham JSON çıkışı (betikleme/CI için)
`--no-color`		ANSI renk kodlarını kapat
`--debug`		Ayrıntılı loglama (istekler, yanıtlar, zamanlama)

Çıkış kodları

Kod	Anlam
`0`	Başarılı
`1`	Genel hata (build başarısız, kaynak bulunamadı vb.)
`2`	Auth hatası (giriş yapılmadı, token süresi doldu ya da iptal edildi)
`3`	Ağ hatası (röleye ulaşılamıyor, zaman aşımı)
`4`	Doğrulama hatası (kötü argümanlar, eksik zorunlu bayraklar)

CI/CD

Bir depo gizli anahtarıyla etkileşimsiz kimlik doğrula, sonra deploy et ve bekle. Çıkış kodu build sonucunu yansıtır.

- name: Deploy to PrimDB
  env:
    PRIMDB_TOKEN: ${{ secrets.PRIMDB_TOKEN }}
  run: |
    primdb login --token $PRIMDB_TOKEN
    primdb deploy --wait

Markdown olarak görüntüle