CI कमांड

npx intlayer ci <command...>

CI कमांड स्वचालन और CI/CD पाइपलाइन के लिए डिज़ाइन किया गया है। यह स्वचालित रूप से INTLAYER_PROJECT_CREDENTIALS environment variable से क्रेडेंशियल इंजेक्ट करता है और मोनोरेपो में कई प्रोजेक्ट पर Intlayer कमांड चला सकता है।

यह कैसे काम करता है

CI कमांड दो मोड में काम करता है:

1. एकल प्रोजेक्ट मोड: यदि वर्तमान working directory INTLAYER_PROJECT_CREDENTIALS में प्रोजेक्ट पथों में से एक से मेल खाता है, तो यह केवल उस विशिष्ट प्रोजेक्ट के लिए कमांड चलाता है।

2. पुनरावृत्ति मोड: यदि कोई विशिष्ट प्रोजेक्ट context का पता नहीं चलता है, तो यह सभी configured प्रोजेक्ट पर iterate करता है और प्रत्येक के लिए कमांड चलाता है।

Environment Variable

कमांड के लिए INTLAYER_PROJECT_CREDENTIALS environment variable सेट होना आवश्यक है। इस variable में एक JSON object होना चाहिए जो प्रोजेक्ट पथों को उनके क्रेडेंशियल से map करता है:

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

Package Manager Detection

CI कमांड स्वचालित रूप से पता लगाता है कि कौन सा package manager उपयोग किया जा रहा है (npm, yarn, pnpm, या bun) npm_config_user_agent environment variable के आधार पर और Intlayer को execute करने के लिए उपयुक्त कमांड का उपयोग करता है।

Arguments

• <command...>: execute करने के लिए Intlayer कमांड (उदाहरण के लिए, fill, push, build)। आप कोई भी Intlayer कमांड और उसके arguments पास कर सकते हैं।

  उदाहरण: npx intlayer ci fill --verbose

  उदाहरण: npx intlayer ci push

  उदाहरण: npx intlayer ci build

उदाहरण

एकल प्रोजेक्ट मोड में कमांड चलाएं

यदि आप एक प्रोजेक्ट directory में हैं जो INTLAYER_PROJECT_CREDENTIALS में paths में से एक से मेल खाता है:

cd packages/app
npx intlayer ci fill

यह packages/app प्रोजेक्ट के लिए स्वचालित रूप से injected क्रेडेंशियल के साथ fill कमांड चलाएगा।

सभी प्रोजेक्ट पर कमांड चलाएं

यदि आप एक directory में हैं जो किसी भी प्रोजेक्ट path से मेल नहीं खाता है, तो कमांड सभी configured प्रोजेक्ट पर iterate करेगा:

cd /path/to/monorepo
npx intlayer ci push

यह INTLAYER_PROJECT_CREDENTIALS में configured प्रत्येक प्रोजेक्ट के लिए push कमांड चलाएगा।

अतिरिक्त flags पास करें

आप underlying Intlayer कमांड में कोई भी flags पास कर सकते हैं:

npx intlayer ci fill --verbose --mode complete

CI/CD pipelines में उपयोग करें

intlayer init को चलाने से आपके लिए दो ready-to-use GitHub Actions workflows scaffold होते हैं (नीचे Scaffolded GitHub Actions देखें)। यहां का उदाहरण monorepo के लिए ci command का उपयोग करके equivalent setup दिखाता है, जहां credentials को INTLAYER_PROJECT_CREDENTIALS से प्रति project inject किया जाता है।

अपने CI/CD configuration में (उदाहरण के लिए, GitHub Actions, GitLab CI), INTLAYER_PROJECT_CREDENTIALS को secret के रूप में सेट करें:

# GitHub Actions उदाहरण
env:
  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}

steps:
  - name: शब्दकोश भरें
    run: npx intlayer ci fill

Scaffolded GitHub Actions

जब आप intlayer init चलाते हैं, तो Intlayer आपके package manager (npm, yarn, pnpm, या bun) को detect करता है और .github/workflows/ के अंतर्गत दो GitHub Actions workflows को scaffold करता है, जिनमें उस package manager से मेल खाने वाली commands होती हैं:

• intlayer-fill.yml — हर pull request पर, dictionaries को build करता है और intlayer fill --git-diff --mode complete चलाता है ताकि बदली हुई dictionaries के लिए missing translations generate हो सकें, फिर परिणाम को PR branch में commit करता है।
• intlayer-test.yml — हर pull request पर, dictionaries को build करता है और intlayer test चलाता है, जब required locales में translations missing हों तो check को fail करता है।

Existing workflow files को कभी overwrite नहीं किया जाता है। Scaffolding को पूरी तरह skip करने के लिए, यह चलाएँ:

npx intlayer init --no-github-actions

Fill workflow को AI access प्रदान करना

Scaffolded intlayer-fill.yml को AI access की आवश्यकता है। दो विकल्प उपलब्ध हैं (workflow के env block में कॉन्फ़िगर किए गए):

1. आपकी अपनी AI provider key — अपनी repository settings में एक AI_API_KEY secret जोड़ें (Settings → Secrets and variables → Actions)। Workflow इसे --provider, --model, और --api-key के माध्यम से forward करता है।
2. Intlayer CMS access keys — INTLAYER_CLIENT_ID और INTLAYER_CLIENT_SECRET secrets जोड़ें और उन्हें अपने intlayer.config editor section में wire करें। CMS access keys Intlayer backend के माध्यम से AI access प्रदान करती हैं।

intlayer-test.yml workflow को किसी भी AI access की आवश्यकता नहीं है।

Error Handling

• यदि INTLAYER_PROJECT_CREDENTIALS सेट नहीं है, तो कमांड error के साथ exit होगा।
• यदि INTLAYER_PROJECT_CREDENTIALS valid JSON नहीं है, तो कमांड error के साथ exit होगा।
• यदि कोई प्रोजेक्ट path मौजूद नहीं है, तो इसे warning के साथ skip किया जाएगा।
• यदि कोई प्रोजेक्ट fail होता है, तो कमांड non-zero status code के साथ exit होगा।

Use Cases

• मोनोरेपो स्वचालन: मोनोरेपो में कई प्रोजेक्ट पर Intlayer कमांड चलाएं
• CI/CD pipelines: continuous integration workflows में शब्दकोश प्रबंधन को स्वचालित करें
• बल्क operations: एक साथ कई Intlayer प्रोजेक्ट पर एक ही operation perform करें
• Secret management: environment variables का उपयोग करके कई प्रोजेक्ट के लिए क्रेडेंशियल को सुरक्षित रूप से manage करें

Security Best Practices

• अपने CI/CD platform में INTLAYER_PROJECT_CREDENTIALS को encrypted secrets के रूप में store करें
• कभी भी क्रेडेंशियल को version control में commit न करें
• विभिन्न deployment environments के लिए environment-specific क्रेडेंशियल का उपयोग करें
• नियमित रूप से क्रेडेंशियल rotate करें