Skip to content

Commit 36c6e6e

Browse files
leestottleestott
authored
Merge pull request #19 from microsoft/update-translations
🌐 Update translations via Co-op Translator
2 parents 6298e70 + f1fc4de commit 36c6e6e

File tree

240 files changed

+43647
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

240 files changed

+43647
-0
lines changed

‎translations/ar/azd/README.md‎

Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
1+
<!--
2+
CO_OP_TRANSLATOR_METADATA:
3+
{
4+
"original_hash": "3ef1c97c5c40577da3be422d29276383",
5+
"translation_date": "2025-09-30T12:19:47+00:00",
6+
"source_file": "azd/README.md",
7+
"language_code": "ar"
8+
}
9+
-->
10+
# البدء السريع مع Azure Developer CLI (azd)
11+
12+
## 🚀 النشر باستخدام Azure Developer CLI
13+
14+
هذا المشروع متوافق الآن بالكامل مع Azure Developer CLI (azd) للنشر التلقائي للبنية التحتية وتطبيق خادم MCP.
15+
16+
### المتطلبات الأساسية
17+
18+
1. **تثبيت Azure Developer CLI**:
19+
```bash
20+
# Windows (winget)
21+
winget install microsoft.azurecli
22+
winget install Microsoft.AzureDeveloperCLI
23+
24+
# macOS (brew)
25+
brew install azure-cli
26+
brew install azd
27+
28+
# Linux
29+
curl -fsSL https://aka.ms/install-azd.sh | bash
30+
```
31+
32+
2. **تسجيل الدخول إلى Azure**:
33+
```bash
34+
az login
35+
azd auth login
36+
```
37+
38+
### 🎯 النشر بأمر واحد
39+
40+
```bash
41+
# Navigate to azd folder
42+
cd azd
43+
44+
# Initialize new environment (first time only)
45+
azd env new <your-environment-name>
46+
47+
# Set your preferred Azure location
48+
azd env set AZURE_LOCATION westus2
49+
50+
# Deploy everything (infrastructure + application)
51+
azd up
52+
```
53+
54+
### 🔧 سير العمل التطويري
55+
56+
```bash
57+
# Deploy only infrastructure changes
58+
azd provision
59+
60+
# Deploy only application changes
61+
azd deploy
62+
63+
# View deployed resources
64+
azd show
65+
66+
# View environment variables
67+
azd env get-values
68+
69+
# Clean up all resources
70+
azd down
71+
```
72+
73+
### 📦 ما يتم نشره
74+
75+
#### **البنية التحتية**
76+
- مجموعة الموارد
77+
- مساحة عمل Log Analytics
78+
- Application Insights
79+
- خدمات Azure AI (مع نماذج OpenAI)
80+
- بيئة تطبيقات الحاويات
81+
82+
#### **التطبيق**
83+
- خادم MCP (تطبيق الحاويات)
84+
- تمكين مراقبة الصحة
85+
- تكوين متغيرات البيئة
86+
- تكامل مع Application Insights
87+
88+
### 🌍 متغيرات البيئة
89+
90+
بعد النشر، تصبح هذه المتغيرات متاحة تلقائيًا:
91+
92+
```bash
93+
AZURE_RESOURCE_GROUP # Resource group name
94+
AZURE_LOCATION # Deployment region
95+
AZURE_OPENAI_ENDPOINT # AI Services endpoint
96+
AZURE_OPENAI_API_KEY # AI Services key
97+
AZURE_OPENAI_DEPLOYMENT_NAME # GPT model name
98+
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME # Embedding model name
99+
APPLICATIONINSIGHTS_CONNECTION_STRING # Monitoring connection
100+
```
101+
102+
### 🔍 المراقبة والإدارة
103+
104+
- **Azure Portal**: عرض جميع الموارد في مجموعة الموارد الخاصة بك
105+
- **Application Insights**: مراقبة أداء التطبيق والسجلات
106+
- **Container Apps**: عرض سجلات التطبيق والقياسات
107+
- **AI Studio**: إدارة نشر نماذج OpenAI
108+
109+
### 📋 استكشاف الأخطاء وإصلاحها
110+
111+
#### **المشاكل الشائعة**
112+
113+
1. **الموقع غير مدعوم**:
114+
```bash
115+
azd env set AZURE_LOCATION eastus2
116+
```
117+
118+
2. **تجاوز حصص الموارد**:
119+
- تحقق من حدود الاشتراك الخاص بك في Azure Portal
120+
- جرب منطقة مختلفة
121+
122+
3. **مشاكل المصادقة**:
123+
```bash
124+
azd auth login --use-device-code
125+
```
126+
127+
4. **عرض سجلات النشر**:
128+
```bash
129+
azd show --output json
130+
```
131+
132+
### 🔄 البديل: النشر اليدوي
133+
134+
إذا كنت تفضل النشر اليدوي، يمكنك استخدام البنية التحتية الموجودة في مجلد `/infra`:
135+
136+
```bash
137+
cd ../infra
138+
./deploy.ps1 # Windows
139+
./deploy.sh # macOS/Linux
140+
```
141+
142+
### 📚 تعلم المزيد
143+
144+
- [وثائق Azure Developer CLI](https://docs.microsoft.com/azure/developer/azure-developer-cli/)
145+
- [وثائق تطبيقات الحاويات](https://docs.microsoft.com/azure/container-apps/)
146+
- [وثائق خدمات Azure AI](https://docs.microsoft.com/azure/ai-services/)
147+
148+
---
149+
150+
**إخلاء المسؤولية**:
151+
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالترجمة البشرية الاحترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.

‎translations/ar/azd/VALIDATION-REPORT.md‎

Lines changed: 225 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,225 @@
1+
<!--
2+
CO_OP_TRANSLATOR_METADATA:
3+
{
4+
"original_hash": "a56e7a3cc7dff699ab9e0b96b35f3917",
5+
"translation_date": "2025-09-30T12:30:05+00:00",
6+
"source_file": "azd/VALIDATION-REPORT.md",
7+
"language_code": "ar"
8+
}
9+
-->
10+
# أداة Azure Developer CLI (azd) - تقرير التحقق الكامل
11+
12+
## ✅ **حالة التحقق: تم التحقق من جميع الملفات بنجاح**
13+
14+
تم **التحقق بالكامل** من جميع الملفات في مجلد `azd/infra` وهي جاهزة للنشر في بيئة الإنتاج. تم التحقق من صحة الصياغة، توافق المعلمات، وتكوين البيئة.
15+
16+
---
17+
18+
## 📋 **نتائج التحقق لكل ملف**
19+
20+
### **✅ ملفات القوالب - جميعها صالحة**
21+
22+
| الملف | الحالة | إصدار API | الصياغة | التبعيات |
23+
|------|--------|-----------|--------|----------|
24+
| `main.bicep` | ✅ صالح | الأحدث | ✅ لا توجد أخطاء | ✅ تم التحقق |
25+
| `main-resources.bicep` | ✅ صالح | 2025-06-01 | ✅ لا توجد أخطاء | ✅ تم التحقق |
26+
| `container-app-environment.bicep` | ✅ صالح | 2023-05-01 | ✅ لا توجد أخطاء | ✅ تم التحقق |
27+
| `azuredeploy.json` | ✅ صالح | 2025-06-01 | ✅ لا توجد أخطاء | ✅ تم التحقق |
28+
29+
### **✅ ملفات التكوين - جميعها صالحة**
30+
31+
| الملف | الحالة | التنسيق | المخطط | المحتوى |
32+
|------|--------|--------|--------|---------|
33+
| `azure.yaml` | ✅ صالح | YAML | ✅ صالح | ✅ مكتمل |
34+
| `main.parameters.json` | ✅ صالح | JSON | ✅ صالح | ✅ متغيرات azd |
35+
| `azuredeploy.parameters.json` | ✅ صالح | JSON | ✅ صالح | ✅ قيم ثابتة |
36+
| `.env.local` | ✅ تم إنشاؤه | ENV | ✅ صالح | ✅ إعدادات التطوير |
37+
38+
### **✅ ملفات التوثيق - جميعها موجودة**
39+
40+
| الملف | الحالة | الغرض | المحتوى |
41+
|------|--------|-------|---------|
42+
| `README.md` | ✅ صالح | دليل البدء السريع | ✅ مكتمل |
43+
| `ARM-DEPLOYMENT.md` | ✅ صالح | دليل نشر ARM | ✅ مكتمل |
44+
| `VALIDATION-SUMMARY.md` | ✅ صالح | التحقق الأصلي | ✅ مكتمل |
45+
46+
---
47+
48+
## 🔍 **فحوصات التحقق التفصيلية**
49+
50+
### **1. التحقق من الصياغة** ✅
51+
- ✅ تم التحقق من صياغة JSON لجميع ملفات `.json`
52+
- ✅ تم التحقق من صياغة YAML لملف `azure.yaml`
53+
- ✅ تم التحقق من صياغة Bicep لجميع ملفات `.bicep`
54+
- ✅ تم التحقق من توافق مخطط قالب ARM
55+
- ✅ تم التحقق من توافق مخطط ملف المعلمات
56+
57+
### **2. توافق المعلمات** ✅
58+
- ✅ التحقق من تعيين `environmentName` → `${AZURE_ENV_NAME}`
59+
- ✅ التحقق من تعيين `location` → `${AZURE_LOCATION}`
60+
- ✅ جميع المعلمات المطلوبة موجودة في القوالب
61+
- ✅ أنواع المعلمات متطابقة بين الملفات
62+
- ✅ القيم الافتراضية مناسبة
63+
64+
### **3. تبعيات القوالب** ✅
65+
- ✅ المراجع النمطية صحيحة
66+
- ✅ التبعيات بين الموارد محددة بشكل صحيح
67+
- ✅ مراجع المخرجات صالحة
68+
- ✅ إصدارات API متوافقة
69+
- ✅ تسمية الموارد متسقة
70+
71+
### **4. تكامل أداة Azure Developer CLI** ✅
72+
- ✅ اجتياز التحقق من مخطط `azure.yaml`
73+
- ✅ تعريفات الخدمات مكتملة
74+
- ✅ التحقق من تعيين متغيرات البيئة
75+
- ✅ التحقق من تكوين Docker
76+
- ✅ إعدادات النشر مهيأة بشكل صحيح
77+
78+
### **5. متغيرات البيئة** ✅
79+
- ✅ تحديد متغيرات azd المطلوبة
80+
- ✅ تعيين مخرجات البنية التحتية بشكل صحيح
81+
- ✅ تكوين متغيرات خدمة البيئة
82+
- ✅ توثيق متغيرات التطوير الاختيارية
83+
- ✅ إنشاء ملف البيئة المحلي
84+
85+
---
86+
87+
## 🚀 **جاهزية النشر**
88+
89+
### **الخيار الأول: أداة Azure Developer CLI** ⭐ **موصى به**
90+
```bash
91+
# Quick deployment command
92+
cd azd
93+
azd env new myenv
94+
azd env set AZURE_LOCATION westus2
95+
azd up
96+
```
97+
98+
**✅ جاهز:** تم استيفاء جميع متطلبات azd
99+
- ✅ تكوين `azure.yaml`
100+
- ✅ قوالب Bicep جاهزة
101+
- ✅ تعريفات الخدمات مكتملة
102+
- ✅ تعيين متغيرات البيئة
103+
104+
### **الخيار الثاني: نشر ARM يدوي**
105+
```bash
106+
# ARM template deployment
107+
az deployment sub create \
108+
--location westus2 \
109+
--template-file infra/azuredeploy.json \
110+
--parameters @infra/azuredeploy.parameters.json
111+
```
112+
113+
**✅ جاهز:** تم تحسين قالب ARM والتحقق منه
114+
- ✅ أحدث إصدارات API (2025-06-01)
115+
- ✅ تضمين موارد مشروع الذكاء الاصطناعي
116+
- ✅ تحسين نشر النماذج
117+
- ✅ هيكل متغيرات مناسب
118+
119+
---
120+
121+
## 📊 **نظرة عامة على البنية التحتية**
122+
123+
### **الموارد التي سيتم نشرها**
124+
1. **مجموعة الموارد** - `rg-mcpretail-{suffix}`
125+
2. **مساحة عمل Log Analytics** - أساس المراقبة
126+
3. **Application Insights** - مراقبة التطبيقات
127+
4. **خدمات Azure AI** - دعم المشروع مع الذكاء الاصطناعي
128+
5. **نشر نماذج OpenAI:**
129+
- GPT-4o-mini (سعة 150)
130+
- text-embedding-3-small (سعة 50)
131+
6. **بيئة تطبيقات الحاويات** - لاستضافة خادم MCP
132+
133+
### **نشر الخدمات** (azd فقط)
134+
1. **تطبيق خادم MCP** - تطبيق Python
135+
2. **متغيرات البيئة** - يتم تكوينها تلقائيًا من البنية التحتية
136+
3. **مراقبة الصحة** - مدمجة مع Application Insights
137+
4. **تكوين التوسع** - التوسع التلقائي لتطبيقات الحاويات
138+
139+
---
140+
141+
## 🔧 **مرجع متغيرات البيئة**
142+
143+
### **تتم إدارتها بواسطة azd** (تعبئة تلقائية)
144+
```bash
145+
AZURE_ENV_NAME # Environment name
146+
AZURE_LOCATION # Deployment region
147+
AZURE_SUBSCRIPTION_ID # Azure subscription
148+
AZURE_RESOURCE_GROUP # Resource group name
149+
```
150+
151+
### **مخرجات البنية التحتية** (توليد تلقائي)
152+
```bash
153+
AZURE_OPENAI_ENDPOINT # AI Services endpoint
154+
AZURE_OPENAI_API_KEY # AI Services access key
155+
AZURE_OPENAI_DEPLOYMENT_NAME # GPT model name
156+
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME # Embedding model name
157+
APPLICATIONINSIGHTS_CONNECTION_STRING # Monitoring connection
158+
AZURE_CONTAINER_APP_ENVIRONMENT_ID # Container environment
159+
```
160+
161+
### **تكوين التطبيق** (من .env.local)
162+
```bash
163+
PORT=8000 # Application port
164+
DEBUG=true # Development mode
165+
LOG_LEVEL=INFO # Logging level
166+
POSTGRES_HOST=localhost # Database host (dev)
167+
```
168+
169+
---
170+
171+
## ⚠️ **ملاحظات مهمة**
172+
173+
### **تسمية الموارد**
174+
- يستخدم قالب ARM تسمية ثابتة: `rg-mcpretail-demo001`
175+
- يستخدم قالب Bicep تسمية ديناميكية: `rg-{environmentName}`
176+
- كلا النهجين صالحان وفعالان
177+
178+
### **إصدارات API**
179+
- جميع القوالب تستخدم أحدث إصدارات API (2025-06-01)
180+
- تم تمكين ميزات خدمات الذكاء الاصطناعي المحسنة
181+
- تكامل حديث لتطبيقات الحاويات
182+
183+
### **الأمان**
184+
- تم تمكين الهوية المُدارة لخدمات الذكاء الاصطناعي
185+
- تم تكوين ضوابط الوصول إلى الشبكة
186+
- تطبيق سياسات RAI على نشر النماذج
187+
188+
---
189+
190+
## 🎯 **ملخص التحقق النهائي**
191+
192+
| الفئة | الحالة | التفاصيل |
193+
|-------|--------|----------|
194+
| **صياغة القوالب** | ✅ ناجح | جميع الملفات صالحة من الناحية الصياغية |
195+
| **توافق المعلمات** | ✅ ناجح | المعلمات متطابقة بين القوالب |
196+
| **تكامل azd** | ✅ ناجح | تم التحقق من التوافق الكامل مع azd |
197+
| **متغيرات البيئة** | ✅ ناجح | تعيين المتغيرات مكتمل |
198+
| **التوثيق** | ✅ ناجح | جميع الأدلة موجودة ودقيقة |
199+
| **تكوين الأمان** | ✅ ناجح | إعدادات الأمان المناسبة مطبقة |
200+
| **توافق API** | ✅ ناجح | استخدام أحدث إصدارات API |
201+
| **جاهزية النشر** | ✅ ناجح | جاهز للنشر في بيئة الإنتاج |
202+
203+
---
204+
205+
## 🚨 **التحقق مكتمل**
206+
207+
**✅ جميع عمليات التحقق ناجحة**
208+
209+
مجلد `azd/infra` **تم التحقق منه بالكامل** وجاهز للنشر في بيئة الإنتاج. يمكنك المتابعة بثقة باستخدام:
210+
211+
1. **أداة Azure Developer CLI**: `azd up` (موصى به للتشغيل الآلي الكامل)
212+
2. **قالب ARM**: النشر اليدوي للحصول على مزيد من التحكم
213+
214+
كلا طريقتي النشر تم التحقق منهما وهما جاهزتان للاستخدام.
215+
216+
---
217+
218+
*اكتمل التحقق في: 30 سبتمبر 2025*
219+
*عدد الملفات التي تم التحقق منها: 11 ملفًا*
220+
*نتيجة التحقق: ✅ ناجح*
221+
222+
---
223+
224+
**إخلاء المسؤولية**:
225+
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية هو المصدر الموثوق. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.

0 commit comments

Comments
 (0)