better-i18n Publish Pipeline: CDN & GitHub Deployment

better-i18n trennt das Bearbeiten vom Deployment. Sie erstellen und aktualisieren Übersetzungen frei — nichts wird live geschaltet, bis Sie explizit veröffentlichen. Wenn Sie es tun, werden Änderungen als nachverfolgter Sync-Job an Ihren CDN-Endpunkt und/oder Ihr GitHub-Repository deployed.

Diese Seite erklärt, wie die Publish Pipeline funktioniert, was Sie überwachen können und wie Sie das Veröffentlichen in Ihren Workflow integrieren.

So funktioniert das Veröffentlichen

1. Ausstehende Änderungen in der Vorschau anzeigen

Überprüfen Sie vor dem Veröffentlichen genau, was deployed wird:

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

Gibt zurück:

hasPendingChanges — Ob etwas in der Warteschlange steht
summary — Übersetzungsanzahl, gelöschte Keys, Gesamtänderungen
byLanguage — Aufschlüsselung nach Sprachcode
deletedKeys — Keys, die dauerhaft entfernt werden
publishDestination — "github", "cdn" oder "none"

2. Veröffentlichen

Alle ausstehenden Änderungen oder bestimmte Übersetzungen deployen:

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

// Oder bestimmte Übersetzungen veröffentlichen
{
  "project": "your-org/your-project",
  "translations": [
    { "keyId": "uuid-1", "languageCode": "tr" },
    { "keyId": "uuid-2", "languageCode": "de" }
  ]
}

Das Veröffentlichen ist asynchron — es gibt sofort Sync-Job-IDs zurück.

3. Deployment verfolgen

Sync-Job-Fortschritt überwachen:

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

Gibt Status (pending, in_progress, completed, failed), Zeitstempel, Logs und betroffene Keys zurück.

Publish-Ziele

CDN Deployment

Übersetzungen werden in Cloudflares Edge-Netzwerk deployed:

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

Ihre Anwendung ruft Übersetzungen von diesem Endpunkt ab. Updates sind innerhalb von Sekunden nach einer erfolgreichen Veröffentlichung live — kein erneutes App-Deployment erforderlich.

GitHub Deployment

Wenn Sie ein GitHub-Repository verbunden haben, erstellt das Veröffentlichen einen Pull Request oder pusht direkt in Ihren konfigurierten Branch. Übersetzungsdateien werden in den von Ihnen konfigurierten Mustern aktualisiert (z. B. locales/**/*.json).

Sie steuern den Merge — better-i18n erstellt den PR, Ihr Team prüft und merged
Nur konfigurierte Dateimuster werden berührt
Vollständiger Commit-Verlauf jeder Übersetzungsänderung

Sync-Job-Typen

Typ	Was er tut
`initial_import`	Erster Sync beim Verbinden eines Repository
`source_sync`	Sync ausgelöst durch einen GitHub-Push-Event
`cdn_upload`	Übersetzungen in CDN deployen
`batch_publish`	Mehrere Übersetzungen gleichzeitig veröffentlichen

Letzte Sync-Operationen auflisten:

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

GitHub Webhook-Integration

better-i18n empfängt GitHub-Push-Events über Webhooks, um automatische Syncs auszulösen:

Sie pushen Code mit aktualisierten Übersetzungsdateien
GitHub sendet einen Webhook an better-i18n
better-i18n synchronisiert die Änderungen in Ihr Projekt
Übersetzungen werden aktualisiert im Dashboard

Dadurch bleibt Ihr Cloud-Projekt ohne manuelles Eingreifen mit Ihrem Repository synchronisiert.

REST API-Veröffentlichung

Der gleiche Publish-Workflow ist über die REST API unter dash.better-i18n.com/api verfügbar:

# Ausstehende Änderungen auflisten
curl -H "Authorization: Bearer $API_KEY" \
  https://dash.better-i18n.com/api/projects/your-org/your-project/pending-changes

# Alle ausstehenden Änderungen veröffentlichen
curl -X POST -H "Authorization: Bearer $API_KEY" \
  https://dash.better-i18n.com/api/projects/your-org/your-project/publish

Integrieren Sie das Veröffentlichen in Ihre CI/CD-Pipeline — deployen Sie Übersetzungen als Teil Ihres Release-Prozesses.

MCP Workflow

Mit dem MCP Server verwaltet Ihr AI-Assistent den gesamten Publish-Zyklus:

"Prüfe, was für das Landing-Projekt aussteht, dann veröffentliche alle türkischen Übersetzungen."

Die AI ruft getPendingChanges auf, zeigt Ihnen die Zusammenfassung und ruft mit Ihrer Bestätigung publishTranslations auf. Verfolgen Sie die Fertigstellung mit getSyncs.

Best Practices

Immer zuerst Vorschau — Rufen Sie getPendingChanges vor jeder Veröffentlichung auf
Inkrementell veröffentlichen — Deployen Sie bestimmte Sprachen oder Keys statt alles auf einmal
Fertigstellungen verfolgen — Verwenden Sie getSync, um zu überprüfen, ob Jobs erfolgreich abgeschlossen wurden
Mit CI automatisieren — Fügen Sie Veröffentlichungsschritte über die REST API zu Ihrer Release-Pipeline hinzu
GitHub PRs verwenden — Lassen Sie Ihr Team Übersetzungsänderungen vor dem Merge prüfen

Die Publish Pipeline gibt Ihnen die volle Kontrolle darüber, wann und wie Übersetzungen Ihre Nutzer erreichen. Nichts wird ohne Ihre explizite Aktion deployed.

better-i18n Publish Pipeline: CDN & GitHub Deployment