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/appnpx 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/monoreponpx 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:

# GitHub Actions örneğienv:  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