تشغيل سيناريوهات الاختبار مع تكوين اتصال قاعدة البيانات السحابية عبر سطر الأوامر

💡

Apidog هي منصة شاملة لتطوير واختبار واجهات برمجة التطبيقات (API) تبسط سير عمل واجهات برمجة التطبيقات بالكامل. بفضل إمكانيات واجهة سطر الأوامر (CLI) المتقدمة، وتكامل قواعد البيانات السحابية، وميزات الأتمتة القوية، يساعد Apidog فرق التطوير على بناء واختبار ونشر واجهات برمجة التطبيقات بكفاءة أكبر. استمتع باختبار قواعد البيانات بسلاسة من خلال إدارة التكوين السحابية لدينا - لا مزيد من عمليات تصدير الملفات اليدوية أو عمليات الإعداد المعقدة.

زر

فوائد استخدام تكوين اتصال قاعدة البيانات السحابية

قبل إدخال وظيفة تكوين اتصال قاعدة البيانات السحابية، كان تشغيل سيناريو اختبار يتضمن عمليات قاعدة البيانات عبر واجهة سطر الأوامر (CLI) يتطلب إكمال عدة خطوات مرهقة:

عملية التصدير اليدوية: تحديد موقع إدخال تصدير تكوين اتصال قاعدة البيانات في واجهة المنتج وتصديره كملف
إدارة الملفات: نقل ملف تكوين اتصال قاعدة البيانات المصدر إلى جهاز تنفيذ واجهة سطر الأوامر (CLI)
تكوين المسار: نسخ مسار الملف على الجهاز
تعديل الأمر: تحديث خيارات سطر الأوامر بقيم المسار الفعلية، على سبيل المثال:

apidog run --access-token $APIDOG_ACCESS_TOKEN -t 123456 -e 123456 -n 1 -r html,cli --database-connection /Users/xxx/yyy/database-connections.json

تضمنت هذه العملية العديد من المهام التحضيرية، وأي تغييرات في تكوين اتصال قاعدة البيانات تطلبت تكرار كل هذه الخطوات. كانت تجربة المستخدم الإجمالية غير فعالة ومملة.

مع تكوين اتصال قاعدة البيانات السحابية، يمكنك التخلص تمامًا من الحاجة إلى تصدير ملفات التكوين، ونقلها إلى أجهزة تنفيذ واجهة سطر الأوامر (CLI)، وتحديد قيم الخيارات يدويًا في أسطر الأوامر. ما عليك سوى تعيين القيم الفعلية للمتغيرات في تكوين اتصال قاعدة البيانات السحابية لتشغيلها بنجاح، مما يحسن تجربة المستخدم بشكل كبير.

الطريقة الأولى: استخدام القيم المحلية + تكوين اتصال قاعدة البيانات السحابية

عندما تستخدم جميع اتصالات قاعدة البيانات في سيناريوهات الاختبار الخاصة بك التكوينات المحفوظة في السحابة، لن يظهر خيار تصدير تكوين اتصال قاعدة البيانات (لأنه لم يعد مطلوبًا). أثناء تنفيذ واجهة سطر الأوامر (CLI)، يمكن للنظام استرداد المتغيرات المطلوبة مباشرة من تكوين اتصال قاعدة البيانات السحابية والعثور على قيم المتغيرات الفعلية وفقًا لقواعد استبدال المتغيرات لإنشاء الاتصالات.

التطبيق خطوة بخطوة:

تكوين متغيرات البيئة: في إدارة البيئة، قم بتعيين قيم اتصال قاعدة البيانات الفعلية في القيم المحلية للمتغيرات المقابلة لكل بيئة تحتاج إلى استخدامها.

ضمان التكوين القائم على المتغيرات: تأكد من أن تكوين اتصال قاعدة البيانات الخاص بك يستخدم المتغيرات بالكامل (باستثناء المنافذ)، مما يضمن حفظه كاتصال قاعدة بيانات سحابية.

التحقق من تكوين سيناريو الاختبار: تأكد من أن جميع سيناريوهات الاختبار التي ترغب في تشغيلها عبر واجهة سطر الأوامر (CLI) تستخدم "تكوين اتصال قاعدة البيانات السحابية" (أي التكوينات المحفوظة بمتغيرات).

تصدير القيم المحلية: انتقل إلى صفحة CI/CD، حدد "تصدير القيم المحلية للاستخدام" ضمن متغيرات البيئة/العامة، ثم انقر فوق زر التصدير.

مراجعة وتعديل ملف التصدير: في الملف المصدر، سترى قيم متغيرات البيئة المستخدمة بواسطة تكوين اتصال قاعدة البيانات. يمكنك تعديل هذه القيم يدويًا في الملف إذا لزم الأمر. ضع الملف على جهاز واجهة سطر الأوامر (CLI) وانسخ مسار الملف.

تكوين أمر CI/CD: في صفحة CI/CD، أدخل رمز الوصول الخاص بك (Access Token)، انسخ الأمر، والصق المسار الفعلي لملف المتغيرات في قيمة الخيار:

apidog run --access-token $APIDOG_ACCESS_TOKEN -t 123456 -e 123456 -n 1 -r html,cli --variables /Users/xxx/yyy/pptest_variables.json

التنفيذ والتحقق: قم بتشغيل أمر واجهة سطر الأوامر (CLI) أعلاه. يجب أن يعمل اتصال قاعدة البيانات بشكل صحيح ويتم تنفيذه بنجاح.

مراجعة النتائج: إذا تم تكوين طباعة النتائج، يمكنك عرض تفاصيل تنفيذ اتصال قاعدة البيانات في تفاصيل التقرير المحمل.

اعتبارات هامة:

⚠️ ملاحظة أمنية: لا تزال القيم المحلية تستخدم تخزين الملفات المحلية لتكوينات اتصال قاعدة البيانات الفعلية لضمان أمان البيانات. إذا كنت بحاجة إلى تغيير تكوينات الاتصال، قم بتعديل قيم المتغيرات المقابلة يدويًا في هذا الملف.

⚠️ تحذير بشأن القيم البعيدة: بينما يمكن أن يؤدي استخدام القيم البعيدة لمتغيرات تكوين اتصال قاعدة البيانات إلى تجنب العمليات الإضافية لتصدير ملفات القيم المحلية وإضافة خيارات سطر أوامر إضافية (ويسمح بالتعديل المباشر للقيم البعيدة في عميل Apidog)، فإن هذا النهج يشكل مخاطر أمنية للبيانات و ❌ لا يُنصح به.

⚠️ استخدام النص العادي: إذا كنت تستخدم نصًا عاديًا بالكامل أو جزئيًا (باستثناء حقول المنفذ) في تكوين اتصالك، فستظل بحاجة إلى تصدير ملفات التكوين واستخدامها عبر --database-connection في الأوامر. نمط الاستخدام هذا ❌ لا يُنصح به.

الطريقة الثانية: استخدام متغيرات Vault + تكوين اتصال قاعدة البيانات السحابية

إذا كنت تستخدم قيمًا بعيدة لمتغيرات البيئة + متغيرات Vault للحفاظ على اتصالات قاعدة البيانات السحابية، وترغب في استخدام هذه الاتصالات المحفوظة سحابيًا في واجهة سطر الأوامر (CLI)، فاتبع هذه الخطوات:

التطبيق خطوة بخطوة:

تكوين متغيرات Vault: في إدارة البيئة، قم بتعيين متغيرات Vault لاتصال قاعدة البيانات في القيم البعيدة للمتغيرات المقابلة، مع الاحتفاظ بالقيم المحلية بعد القيم البعيدة. قم بتكوين هذا لكل بيئة تحتاج إلى استخدامها.

تكوين إعدادات CI/CD: انتقل إلى صفحة CI/CD، حدد "استخدام القيم البعيدة" ضمن متغيرات البيئة/العامة، قم بالتكوين وفقًا لوضعك الفعلي، ثم انسخ أمر واجهة سطر الأوامر (CLI).

تعيين متغيرات Vault: على الجهاز الذي تحتاج إلى تشغيل واجهة سطر الأوامر (CLI) عليه، في مسار عملك أو طرفيتك، أدخل أولاً export APIDOG_VAULT_KEY=VALUE لاستخدام متغيرات Vault فعليًا. افصل بين متغيرات Vault المتعددة بمسافات.

بناء الجملة الخاص بنظام التشغيل:

لينكس وماك أو إس	ويندوز
تعيين المتغيرات: استخدم `export`، افصل المتغيرات بمسافات `export APIDOG_VAULT_KEY1=VALUE1 APIDOG_VAULT_KEY2=VALUE2 APIDOG_VAULT_KEY3=VALUE3`	تعيين المتغيرات: استخدم `set`، افصل المتغيرات بـ `&` `set APIDOG_VAULT_KEY1=VALUE1&APIDOG_VAULT_KEY2=VALUE2&APIDOG_VAULT_KEY3=VALUE3`
استعلام المتغيرات: استخدم `echo $VARIABLE_NAME` `echo $APIDOG_VAULT_KEY1`	استعلام المتغيرات: استخدم `echo %VARIABLE_NAME%` `echo %APIDOG_VAULT_KEY1%`

تنفيذ أمر واجهة سطر الأوامر (CLI): قم بتشغيل أمر واجهة سطر الأوامر الخاص بك لبدء التنفيذ.

التحقق من النتائج: عند الانتهاء، يمكنك رؤية نتائج اتصال قاعدة البيانات في التقرير، مما يؤكد نجاح اتصال قاعدة البيانات وتنفيذ العملية.

مراجعة تفاصيل التنفيذ: إذا تم تكوين طباعة النتائج، يمكنك عرض تفاصيل تنفيذ اتصال قاعدة البيانات في تفاصيل التقرير المحمل.

تذكيرات هامة:

⚠️ متطلب ما قبل التنفيذ: قبل تنفيذ أوامر واجهة سطر الأوامر (CLI) التي تحتوي على متغيرات Vault لاتصالات قاعدة البيانات، استخدم دائمًا export/set لإدخال قيم متغيرات Vault الفعلية. وإلا، ستفشل اتصالات قاعدة البيانات بسبب عدم القدرة على استرداد التكوينات الفعلية.

⚠️ نطاق المتغير المؤقت: قيم متغيرات Vault الفعلية المدخلة عبر export/set تكون فعالة فقط للتنفيذ الحالي، وتعمل كمتغيرات مؤقتة. ستحتاج إلى إعادة إدخالها باستخدام هذه الطريقة لعمليات التشغيل اللاحقة.

الخاتمة

يعمل تكوين اتصال قاعدة البيانات السحابية على تبسيط سير عمل اختبار واجهة سطر الأوامر (CLI) بشكل كبير عن طريق التخلص من إدارة الملفات اليدوية وتقليل تعقيد التكوين. سواء باستخدام القيم المحلية أو متغيرات Vault، يوفر هذا النهج حلاً أكثر أمانًا وفعالية وقابلية للصيانة لتشغيل سيناريوهات الاختبار المتصلة بقاعدة البيانات في بيئات CI/CD.

القيم المحلية: أفضل للسيناريوهات التي تتطلب أقصى درجات أمان البيانات مع التحكم في الملفات المحلية
متغيرات Vault: مثالية لخطوط أنابيب CI/CD المؤتمتة مع إدارة الأسرار المركزية

يضمن كلا النهجين بقاء اتصالات قاعدة البيانات الخاصة بك آمنة مع توفير المرونة والكفاءة اللازمة لسير عمل الاختبار الحديث.

زر