better-i18n Publish Pipeline: CDN ve GitHub Deployment

better-i18n Publish Pipeline: CDN ve GitHub Deployment

better-i18n, düzenlemeyi Deployment'tan ayırır. Çevirileri özgürce oluşturur ve güncellersiniz — siz açıkça Publish etmedikçe hiçbir şey canlıya geçmez. Publish ettiğinizde, değişiklikler CDN endpoint'inize ve/veya GitHub reponuza izlenen bir Sync Job olarak deploy edilir.

Bu sayfa, Publish Pipeline'ın nasıl çalıştığını, neleri takip edebileceğinizi ve Publish'i iş akışınıza nasıl entegre edeceğinizi kapsar.

Publish Nasıl Çalışır

1. Bekleyen Değişiklikleri Önizleme

Publish etmeden önce tam olarak neyin deploy edileceğini inceleyin:

// MCP tool: getPendingChanges
{
  "project": "your-org/your-project"
}

Döndürür:

• hasPendingChanges — Sıraya alınmış bir şey olup olmadığı
• summary — Çeviri sayıları, silinen Key'ler, toplam değişiklikler
• byLanguage — Dil koduna göre dağılım
• deletedKeys — Kalıcı olarak kaldırılacak Key'ler
• publishDestination — "github", "cdn" veya "none"

2. Publish

Bekleyen tüm değişiklikleri veya belirli çevirileri deploy edin:

// MCP tool: publishTranslations
{
  "project": "your-org/your-project"
}

// Veya belirli çevirileri Publish edin
{
  "project": "your-org/your-project",
  "translations": [
    { "keyId": "uuid-1", "languageCode": "tr" },
    { "keyId": "uuid-2", "languageCode": "de" }
  ]
}

Publish asenkrondur — hemen Sync Job ID'lerini döndürür.

3. Deployment'ı Takip Etme

Sync Job ilerlemenizi izleyin:

// MCP tool: getSync
{
  "project": "your-org/your-project",
  "syncId": "sync-job-uuid"
}

Durum (pending, in_progress, completed, failed), zaman damgaları, log'lar ve etkilenen Key'leri döndürür.

Publish Hedefleri

CDN Deployment

Çeviriler Cloudflare'in edge ağına deploy edilir:

https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json

Uygulamanız çevirileri bu endpoint'ten getirir. Başarılı bir Publish'in ardından güncellemeler saniyeler içinde canlıya geçer — uygulamanın yeniden deploy edilmesine gerek yoktur.

GitHub Deployment

Bir GitHub reposu bağladıysanız, Publish bir Pull Request oluşturur veya yapılandırdığınız branch'e doğrudan push eder. Çeviri dosyaları, yapılandırdığınız pattern'lara göre güncellenir (örn. locales/**/*.json).

• Merge'ü siz kontrol edersiniz — better-i18n PR'ı oluşturur, ekibiniz inceler ve merge eder
• Yalnızca yapılandırılmış dosya pattern'ları etkilenir
• Her çeviri değişikliğinin tam Commit geçmişi

Sync Job Türleri

Son Sync işlemlerini listeleyin:

// MCP tool: getSyncs
{
  "project": "your-org/your-project",
  "limit": 10,
  "status": "completed"
}

GitHub Webhook Entegrasyonu

better-i18n, otomatik Sync'i tetiklemek için Webhook'lar aracılığıyla GitHub Push event'lerini alır:

1. Kodu push edersiniz güncel çeviri dosyalarıyla
2. GitHub bir Webhook gönderir better-i18n'e
3. better-i18n değişiklikleri Sync'ler projenize
4. Çeviriler güncellenir dashboard'da

Bu, manuel müdahale olmadan bulut projenizi reponuzla Sync'de tutar.

REST API ile Publish

Aynı Publish iş akışı dash.better-i18n.com/api adresindeki REST API aracılığıyla da kullanılabilir:

# Bekleyen değişiklikleri listele
curl -H "Authorization: Bearer $API_KEY" \
  https://dash.better-i18n.com/api/projects/your-org/your-project/pending-changes

# Bekleyen tüm değişiklikleri Publish et
curl -X POST -H "Authorization: Bearer $API_KEY" \
  https://dash.better-i18n.com/api/projects/your-org/your-project/publish

Publish'i CI/CD pipeline'ınıza entegre edin — çevirileri release sürecinizin bir parçası olarak deploy edin.

MCP Workflow

MCP Server ile AI asistanınız tam Publish döngüsünü yönetir:

"Landing projesi için bekleyenleri kontrol et, ardından tüm Türkçe çevirileri Publish et."

AI, getPendingChanges'i çağırır, size özeti gösterir ve onayınızla publishTranslations'ı çağırır. Tamamlanmayı getSyncs ile takip edin.

En İyi Uygulamalar

1. Her zaman önce önizleyin — Her Publish'ten önce getPendingChanges'i çağırın
2. Kademeli olarak Publish edin — Her şeyi bir anda değil, belirli diller veya Key'ler deploy edin
3. Tamamlanmaları takip edin — Job'ların başarıyla bittiğini doğrulamak için getSync kullanın
4. CI ile otomatikleştirin — REST API aracılığıyla release pipeline'ınıza Publish adımları ekleyin
5. GitHub PR'larını kullanın — Ekibinizin çeviri değişikliklerini merge etmeden önce incelemesine izin verin

Publish Pipeline, çevirilerin kullanıcılarınıza ne zaman ve nasıl ulaşacağı konusunda tam kontrol sağlar. Açık eyleminiz olmadan hiçbir şey deploy edilmez.