CI Komutu

npx intlayer ci <command...>

CI komutu otomasyon ve CI/CD pipeline'ları için tasarlanmıştır. INTLAYER_PROJECT_CREDENTIALS ortam değişkeninden kimlik bilgilerini otomatik olarak enjekte eder ve bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırabilir.

Nasıl çalışır

CI komutu iki modda çalışır:

1. Tek Proje Modu: Mevcut çalışma dizini INTLAYER_PROJECT_CREDENTIALS içindeki proje yollarından biriyle eşleşiyorsa, komutu yalnızca o belirli proje için çalıştırır.

2. Yineleme Modu: Belirli bir proje bağlamı algılanmazsa, yapılandırılmış tüm projeler üzerinde yineler ve her biri için komutu çalıştırır.

Ortam Değişkeni

Komut, INTLAYER_PROJECT_CREDENTIALS ortam değişkeninin ayarlanmış olmasını gerektirir. Bu değişken, proje yollarını kimlik bilgilerine eşleyen bir JSON nesnesi içermelidir:

{
  "packages/app": {
    "clientId": "your-client-id-1",
    "clientSecret": "your-client-secret-1"
  },
  "packages/admin": {
    "clientId": "your-client-id-2",
    "clientSecret": "your-client-secret-2"
  }
}

Paket Yöneticisi Algılama

CI komutu, npm_config_user_agent ortam değişkenine dayalı olarak hangi paket yöneticisinin kullanıldığını (npm, yarn, pnpm veya bun) otomatik olarak algılar ve Intlayer'ı çalıştırmak için uygun komutu kullanır.

Argümanlar

• <command...>: Çalıştırılacak Intlayer komutu (örneğin, fill, push, build). Herhangi bir Intlayer komutunu ve argümanlarını iletebilirsiniz.

  Örnek: npx intlayer ci fill --verbose

  Örnek: npx intlayer ci push

  Örnek: npx intlayer ci build

Örnekler

Tek proje modunda komut çalıştırma

INTLAYER_PROJECT_CREDENTIALS içindeki yollardan biriyle eşleşen bir proje dizinindeyken:

cd packages/app
npx intlayer ci fill

Bu, packages/app projesi için kimlik bilgileri otomatik olarak enjekte edilerek fill komutunu çalıştıracaktır.

Tüm projelerde komut çalıştırma

Herhangi bir proje yoluyla eşleşmeyen bir dizindeyken, komut yapılandırılmış tüm projeler üzerinde yineleyecektir:

cd /path/to/monorepo
npx intlayer ci push

Bu, INTLAYER_PROJECT_CREDENTIALS içinde yapılandırılmış her proje için push komutunu çalıştıracaktır.

Ek bayraklar iletme

Temel Intlayer komutuna herhangi bir bayrak iletebilirsiniz:

npx intlayer ci fill --verbose --mode complete

CI/CD pipeline'larında kullanma

CI/CD yapılandırmanızda (örneğin, GitHub Actions, GitLab CI), INTLAYER_PROJECT_CREDENTIALS'i bir sır olarak ayarlayın:

AI erişimi: fill komutu, çevirileri oluşturmak için AI erişimine ihtiyaç duyar. INTLAYER_PROJECT_CREDENTIALS içinden ci tarafından enjekte edilen kimlik bilgileri (Intlayer CMS erişim anahtarları) Intlayer backend aracılığıyla AI erişimi sağlar, bu nedenle ayrı bir AI sağlayıcı anahtarı gerekli değildir. Bunun yerine kendi sağlayıcı anahtarınızı kullanmayı tercih ederseniz, intlayer ci fill komutuna --provider, --model ve --api-key seçeneklerini geçin. test komutu AI erişimi gerektirmez.

# GitHub Actions örneği
env:
  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}

steps:
  - name: Sözlükleri doldur
    run: npx intlayer ci fill

İskele Kurulu GitHub Actions

intlayer init komutunu çalıştırdığınızda, Intlayer paket yöneticinizi (npm, yarn, pnpm veya bun) algılar ve .github/workflows/ klasörü altında iki GitHub Actions iş akışı oluşturur; komutlar paket yöneticinizle eşleşir:

• intlayer-fill.yml — Her pull request'te sözlükleri derler ve değiştirilen sözlükler için eksik çevirileri oluşturmak üzere intlayer fill --git-diff --mode complete komutunu çalıştırır, ardından sonucu PR dalına geri kaydeder.
• intlayer-test.yml — Her pull request'te sözlükleri derler ve intlayer test komutunu çalıştırır; gerekli localelar çevirilerden yoksun olduğunda kontrolü başarısız kılar.

Mevcut iş akışı dosyaları asla üzerine yazılmaz. İskele kurmayı tamamen atlamak için şu komutu çalıştırın:

npx intlayer init --no-github-actions

Fill workflow'una AI erişimi sağlama

Scaffold edilen intlayer-fill.yml AI erişimi gerektirir. İki seçenek mevcuttur (workflow'un env bloğunda yapılandırılır):

1. Kendi AI sağlayıcı anahtarınız — Repository ayarlarınıza bir AI_API_KEY secret'i ekleyin (Settings → Secrets and variables → Actions). Workflow bunu --provider, --model ve --api-key aracılığıyla iletir.
2. Intlayer CMS erişim anahtarları — INTLAYER_CLIENT_ID ve INTLAYER_CLIENT_SECRET secret'lerini ekleyin ve bunları intlayer.config dosyanızdaki editor bölümüne bağlayın. CMS erişim anahtarları Intlayer backend'i aracılığıyla AI erişimi sağlar.

intlayer-test.yml workflow'u herhangi bir AI erişimi gerektirmez.

Hata İşleme

• INTLAYER_PROJECT_CREDENTIALS ayarlanmamışsa, komut bir hata ile çıkacaktır.
• INTLAYER_PROJECT_CREDENTIALS geçerli bir JSON değilse, komut bir hata ile çıkacaktır.
• Bir proje yolu mevcut değilse, bir uyarı ile atlanacaktır.
• Herhangi bir proje başarısız olursa, komut sıfır olmayan bir durum kodu ile çıkacaktır.

Kullanım Durumları

• Monorepo otomasyonu: Bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırma
• CI/CD pipeline'ları: Sürekli entegrasyon iş akışlarında sözlük yönetimini otomatikleştirme
• Toplu işlemler: Birden fazla Intlayer projesinde aynı işlemi aynı anda gerçekleştirme
• Gizli yönetimi: Ortam değişkenlerini kullanarak birden fazla proje için kimlik bilgilerini güvenli bir şekilde yönetme

Güvenlik En İyi Uygulamaları

• INTLAYER_PROJECT_CREDENTIALS'i CI/CD platformunuzda şifrelenmiş sırlar olarak saklayın
• Kimlik bilgilerini asla sürüm kontrolüne commit etmeyin
• Farklı dağıtım ortamları için ortama özel kimlik bilgileri kullanın
• Kimlik bilgilerini düzenli olarak döndürün