تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
تطوير موفري StackQL
راجع أيضًا: [ StackQL Provider Registry ] [ استخدام موفر ] [ REGISTRY ] [ البنية المعمارية ]
نظرة عامة
موفر StackQL هو مجموعة ذات إصدارات من مستندات OpenAPI بالإضافة إلى ملحقات x-stackQL-*، يحولها المحرك omnisdk إلى جداول SQL: SELECT لعمليات القراءة، وINSERT وUPDATE وREPLACE وDELETE لعمليات دورة الحياة، وEXEC للإجراءات. تخبر مستندات الموفر StackQL بما يمكن لواجهة API الخاصة بالموفر القيام به وكيفية استدعائها بدلالات SQL. وهي مستندات YAML عادية، لذا يمكن بناء الموفر واختباره وإدارة إصداراته مثل أي تعليمات برمجية أخرى.
يتكون النظام البيئي للموفرين من ثلاثة مستودعات وطبقة توزيع واحدة:
| المكون | الدور |
|---|---|
stackql-provider-TEMPLATE | نقطة البداية لمشروع موفر جديد: خط أنابيب make حتمي يبدأ من مواصفات أصلية مقفلة الإصدار وينتهي بموفر يتم إنشاؤه، وطبقات اختبار لا تتطلب بيانات اعتماد، ومجموعة اختبارات دخان مباشرة، وموقع مصغر للوثائق، وCI. يتضمن مهارة تطوير الموفرين الخاصة بـ Claude Code. |
omnisdk | المحرك الذي يقرأ مستندات الموفرين وينفذ الطلبات، بدءًا من StackQL v1.0. ولا يزال سابقه، any-sdk، يستضيف المرجع الخاص بعقد مستند الموفر وملحقات x-stackQL-* والمصادقة والتقسيم إلى صفحات والتحويلات ودفع الشروط إلى المصدر، ومخططات JSON المرتبطة أدناه. |
stackql-provider-registry | المصدر الموثوق للموفرين المنشورين. تتم إدارة إصدارات المستندات ضمن providers/src/<provider>/<version>/، ثم يوقعها GitHub Actions رقميًا ويحزمها وينشرها. |
| طبقة التوزيع عبر Cloudflare | يقدم Cloudflare Worker الملفات الناتجة المحزمة للموفرين على الحافة من Cloudflare R2 على registry.stackql.app (بيئة الإنتاج) وregistry-dev.stackql.app (بيئة التطوير). وهذا هو ما تتصل به الجملتان REGISTRY LIST وREGISTRY PULL. |
يوضح الرسم التخطيطي التالي المسار من مشروع موفر إلى تثبيت StackQL:
بنية مستند الموفر
تتبع كائنات StackQL التسلسل الهرمي provider.service.resource.method، على سبيل المثال google.compute.instances.list. وتعكس المستندات هذا التسلسل الهرمي:
provider.yaml # provider metadata, providerServices, provider-level config
services/
<service>.yaml # an OpenAPI 3 document per service, plus
components.x-stackQL-resources
<resource> # id, name, methods, sqlVerbs, optional config
methods.<method> # operation $ref, response, request, optional config
- مستند الموفر (
provider.yaml):idوnameوtitleوversionوproviderServices(لكل منهاservice.$refيشير إلى مستند الخدمة الخاص بها وعلامةpreferredاختيارية)، والحقول الاختياريةdescriptionوprotocolType(القيمة الافتراضية هيhttp) وconfig. - مستند الخدمة: مستند OpenAPI 3 قياسي. الإضافة المطلوبة الوحيدة هي
components.x-stackQL-resources، التي تعلن عن الموارد المعروضة كجداول. - المورد:
idوnameوmethodsوsqlVerbs. كل مورد هو جدول؛ وتأتي أعمدته من مخطط الاستجابة للأسلوبselectالأساسي الخاص به. - الأسلوب: حقل
operationوهو مؤشر JSON إلىpaths(على سبيل المثال$ref: '#/paths/~1orgs~1{org}~1repos/get')، وكتلةresponse(mediaTypeوopenAPIDocKeyوobjectKey) تخبر المحرك بموضع الصفوف، وكتلةrequestوconfigاختياريتان. - تعيين أفعال SQL:
sqlVerbs.selectوinsertوupdateوreplaceوdeleteهي قوائم مرتبة من مراجع الأساليب. يأخذ StackQL في الاعتبار الأساليب المشار إليها التي توفر عبارةWHEREجميع معلماتها المطلوبة، ويختار الأسلوب الذي يحتوي على أكبر عدد من المعلمات المطلوبة، بصرف النظر عن ترتيب القائمة: يتم توجيه الاستعلام الذي يوفر المعرف الذي يتطلبهgetإلىget، والاستعلام الذي لا يوفره إلىlist، ويتم الإبلاغ عن الأسلوبين المتعادلين كخطأ بدلًا من الاختيار بينهما. ويمكن استدعاء أي أسلوب لا تشير إليه قائمة أفعال عبرEXEC.
يبدو المورد في أبسط صوره على النحو التالي:
components:
x-stackQL-resources:
repos:
id: github.repos.repos
name: repos
title: Repos
methods:
list_for_org:
operation:
$ref: '#/paths/~1orgs~1{org}~1repos/get'
response:
mediaType: application/json
openAPIDocKey: '200'
create_in_org:
operation:
$ref: '#/paths/~1orgs~1{org}~1repos/post'
response:
mediaType: application/json
openAPIDocKey: '201'
config:
requestBodyTranslate:
algorithm: naive
sqlVerbs:
select:
- $ref: '#/components/x-stackQL-resources/repos/methods/list_for_org'
insert:
- $ref: '#/components/x-stackQL-resources/repos/methods/create_in_org'
يوجد العقد الكامل، بما في ذلك كل مفتاح ومعناه، في مواصفات الموفر ضمن any-sdk. توجد مخططات JSON لكل من provider.yaml ومستندات الخدمات وكتلة التكوين في any-sdk/cicd/schema-definitions؛ ويرفض مخطط التكوين المفاتيح غير المعروفة، لذا يفشل التحقق من صحة المفتاح المكتوب بشكل خاطئ بدلًا من تجاهله بصمت.
ملحقات OpenAPI
| الملحق | الموضع | الغرض |
|---|---|---|
x-stackQL-resources | components | قاموس الموارد لمستند الخدمة (مطلوب) |
x-stackQL-config | الخدمة أو المورد أو الأسلوب أو العملية | كتلة تكوين (راجع أدناه) تطبق على ذلك المستوى |
x-stackQL-envVar | متغير الخادم | يحدد اسم متغير البيئة الذي يوفر قيمة متغير الخادم عندما لا يتم توفيرها في عبارة WHERE. الغرض منه تحديد نطاق واجهة API حسب المستأجر أو المؤسسة أو المشروع أو النشر |
x-stackQL-alias | معلمة أو خاصية مخطط | اسم بديل مقبول في SQL لاسم على مستوى الاتصال |
x-stackQL-stringOnly | خاصية مخطط | إجراء تسلسل للخاصية كسلسلة نصية بغض النظر عن نوعها المعلن |
x-stackQL-graphQL | العملية | يبني الأسلوب على استعلام GraphQL عندما تفتقر واجهة REST API إلى البيانات |
x-alwaysRequired | معلمة | يميز المعلمة على أنها مطلوبة دائمًا |
x-protocol | info | تلميح بروتوكول الاتصال (query وec2 وrest-xml) لمعالجة استجابات XML المستندة إلى المخطط |
كتلة التكوين
يشترك المفتاح config في provider.yaml والملحق x-stackQL-config في مستندات الخدمات في مخطط واحد. المفاتيح المسموح بها هي auth وpagination وqueryParamPushdown وqueryParamTranspose وrequestTranslate وrequestBodyTranslate وvariations وviews وsqlExternalTables وretry وminStackQLVersion وsnake_case_aliases. يُحل التكوين من المستوى الأخص إلى المستويات الأعم، الأسلوب -> المورد -> الخدمة -> خدمة الموفر -> الموفر، لذا يمكن تجاوز القيمة الافتراضية على مستوى الموفر لمورد واحد أو أسلوب واحد.
ما يتولاه الموفرون
يتولى الموفرون المهام التي تخفي تعقيد واجهات API، ليحصل المستخدمون على واجهة SQL متسقة دون إدارة محادثة HTTP الأساسية.
المصادقة
يأتي كل موفر بكتلة auth افتراضية تحدد أسماء متغيرات البيئة التي تحمل بيانات الاعتماد الخاصة به، لذا لا تحتاج البيئة التي تم تعيين هذه المتغيرات فيها إلى أي تكوين للمصادقة في وقت التشغيل. لا يقبل مستند الموفر إلا الإشارات غير المباشرة (أسماء متغيرات البيئة ومسارات الملفات)؛ أما القيم الحرفية لبيانات الاعتماد فمكانها حصريًا سياق --auth في وقت التشغيل. يجب أن تتبع أسماء متغيرات البيئة موفر Terraform الخاص بالجهة المزودة حيثما وجد.
auth.type | الحقول المعتادة |
|---|---|
bearer | credentialsenvvar |
api_key | credentialsenvvar وvaluePrefix، والحقلان الاختياريان location (header أو query) وname |
basic | username_var وpassword_var |
custom | location وname وcredentialsenvvar، وvaluePrefix الاختياري؛ اربط بيانات اعتماد ثانية بالأولى باستخدام successor |
oauth2 | client_id_env_var وclient_secret_env_var وgrant_type: client_credentials وtoken_url وscopes |
service_account | credentialsenvvar أو credentialsfilepathenvvar، وscopes |
aws_signing_v4، aws_assume_role | keyIDenvvar وcredentialsenvvar |
azure_default | لا يوجد |
oci_signing_v1 | tenancy_ocid_envvar وuser_ocid_envvar وoci_fingerprint_envvar وoci_private_key_envvar وoci_region_envvar |
interactive | لا يوجد |
null_auth | لا يوجد (بدون مصادقة بشكل صريح) |
على سبيل المثال:
config:
auth:
type: api_key
credentialsenvvar: OKTA_API_TOKEN
valuePrefix: 'SSWS '
يمكن للمستخدمين تجاوز المصادقة الخاصة بالموفر في وقت التشغيل باستخدام --auth='{"<provider>": {...}}'.
التقسيم إلى صفحات
يعلن الموفرون عن نظام التقسيم إلى صفحات الخاص بالجهة المزودة، ويمر المحرك على كل صفحة، ليحصل المستخدمون على مجموعات نتائج كاملة. الأنظمة المدعومة:
- رمز مميز أو مؤشر في نص الاستجابة:
requestToken: {key: cursor, location: query}وresponseToken: {key: $.cursor, location: body}؛ يتوقف عند غياب الرمز المميز أو خلوه من أي قيمة. - عنوان URL للصفحة التالية في نص الاستجابة:
requestToken: {key: '', location: request}وresponseToken: {key: $.next, location: body}؛ وalgorithm: odata_next_linkلحقل@odata.nextLinkفي OData. - رأس
Linkوفق RFC 5988:responseToken: {key: Link, location: header}. - رقم الصفحة مع عدد الصفحات:
algorithm: page_numberمعresponseToken(الصفحة الحالية) وresponseTerminator(إجمالي الصفحات).
واجهات API التي تعتمد على الإزاحة والحد دون مؤشر للصفحة التالية لا تعد من أنظمة التقسيم إلى صفحات؛ اعرض offset وlimit كمعلمات WHERE بدلًا من ذلك. تحدد العلامة العامة --http.response.pageLimit مدى التنقل بين الصفحات.
دفع الشروط إلى المصدر
تتم مطابقة مفاتيح WHERE مع المعلمات المعلنة للعملية حسب الاسم (المسار، ثم الاستعلام والرأس وملف تعريف الارتباط) وإرسالها إلى واجهة API، لذا تتم التصفية عند المصدر. وأي مفتاح WHERE يتبقى دون معلمة مطابقة تتم إضافته كمعلمة استعلام.
إلى جانب المعلمات العادية، يعيد المفتاح queryParamPushdown كتابة أعمدة SELECT وWHERE وORDER BY وLIMIT وOFFSET وCOUNT في صورة معلمات API. يملأ dialect: odata القيم الافتراضية $select و$filter و$orderby و$top و$skip و$count التي تستخدمها Microsoft Graph وواجهات API على نمط Azure؛ ويستخدم dialect: custom قيمة paramName حرفيًا، وفي الغالب يكون ذلك top: {paramName: limit, maxValue: 1000} بحيث تصبح LIMIT n هي ?limit=n. أما الشروط التي لا يمكن دفعها فلا يزال يتم تقييمها على جانب العميل.
تحويل الاستجابات والطلبات
- المفتاح
response.objectKeyهو تعبير JSONPath (أو XPath لواجهات API بتنسيق XML) يحدد العناصر الحاملة للصفوف من المغلف، على سبيل المثال$.data[*]أو$.value. - يطبق المفتاح
response.transformقالب نصوص بلغة Go على نص الاستجابة قبل تخزينه مرحليًا كصفوف؛ وتشمل أنواع التحويل JSON وXML والنص العادي، وهكذا تصبح واجهات AWS API بتنسيق XML وإخراج CLI جداول. - يتيح
requestBodyTranslate: {algorithm: naive}لجملةINSERTقبول حقول نص الطلب كأسماء أعمدة عادية بدلًا من الشكل المسبوق بالبادئةdata__. - يعرض
snake_case_aliases: trueعلى مستوى الموفر أسماء camelCase على مستوى الاتصال كأعمدة ومعلمات بصيغة snake_case. - يعين المفتاح
retryسياسة تراجع أسي (max_attemptsوinitial_delay_msوmax_delay_msوmultiplierوjitter_fractionوretryable_methodsوretryable_conditions.status_codes). يسري أول مستوى يعلن عنها؛ راجع سياسة إعادة المحاولة في any-sdk.
تتبع أنواع الأعمدة مخطط OpenAPI: string -> text، وinteger -> integer، وnumber -> numeric، وboolean -> boolean. يتم تخزين خصائص object وarray كنص JSON، ولهذا تتم قراءة الحقول المتداخلة باستخدام الدالة json_extract في الاستعلامات، ولهذا أيضًا غالبًا ما يقدم الموفرون طرق عرض (config.views، مع ddl لكل لهجة وfallback) للإسقاطات المتداخلة الشائعة.
الموفرون غير المعتمدين على HTTP
يجعل protocolType: local_templated في provider.yaml الموفر يعتمد على أوامر محلية بدلًا من HTTP: تحمل الأساليب مصفوفة inline من أجزاء argv بقوالب Go، وتستخدم المعلمات in: inline، ويحول المفتاح response.transform إخراج الأوامر إلى صفوف. يوضح الموفر المرجعي local_openssl في any-sdk هذا الشكل. وهذا خارج نطاق خط أنابيب القالب، الذي يستهدف واجهات HTTP API.
بدء مشروع موفر
ابدأ كل موفر جديد من stackql-provider-TEMPLATE. وهو مستودع قوالب على GitHub يجسد المعيار الحالي للموفر: مواصفات أصلية مقفلة الإصدار، وخط أنابيب بناء حتمي يكون فيه كل قرار يدوي قاعدة في برنامج نصي بدلًا من تعديل يدوي على YAML الذي تم إنشاؤه، وثلاث طبقات اختبار لا تتطلب بيانات اعتماد، ومجموعة اختبارات دخان مباشرة بميزانية محددة، وموقع وثائق مبني على Docusaurus، وCI. يوجد الموفرون المنشورون الذين تم بناؤهم بهذه الطريقة في مؤسسة GitHub stackql-registry، وهم مادة مرجعية مفيدة إلى جانب القالب.
المتطلبات الأساسية: Node.js 20 أو إصدار أحدث، وGNU make وbash (Linux أو macOS أو WSL)، وPython 3 لمجموعة اختبارات الدخان، والملف الثنائي stackql (يقوم bin/start-server.sh بتنزيله إذا لم يتم العثور عليه).
- أنشئ المستودع من القالب (من خلال "Use this template" في GitHub) وشغّل
npm install. - شغّل
bin/init-provider.sh <name> "<Title>" [https://api.vendor.com]لاستبدال العناصر النائبة في جميع أنحاء المستودع. - املأ الثوابت في
provider-dev/scripts/lib/spec_helpers.mjs(عنوان URL للمواصفات، وبادئة إصدار المسار، وبادئة النطاق لواجهة API محددة النطاق حسب المستأجر أو المشروع) والتكوين ضمنprovider-dev/config/(servers.jsonوprovider_config.jsonوservice_names.json). - نفّذ خط الأنابيب، إما يدويًا من خلال أهداف
makeأو بفتح جلسة Claude Code في المستودع (راجع أدناه). - يسرد الأمر
grep -rn "TODO(template)"ما لم يكتمل بعد.
يعتمد خط الأنابيب على make (يسرد make help كل الأهداف):
make fetch-spec # verify the upstream spec against the recorded pin (fails on drift)
make inventory # one CSV row per operation with the proposed service, resource, method and verb
make split # write provider-dev/source/<service>.yaml from the ordered path rules
make mappings-report # print every derived operation -> resource.method mapping without writing
make mappings # regenerate provider-dev/config/all_services.csv and validate it
make normalize # flatten allOf, lower oneOf/anyOf, wrap bare arrays
make generate # generate provider.yaml + services/*.yaml, then post-process and merge GraphQL/views
make test # offline SHOW/DESCRIBE, mock API integration tests, meta-route walk (no credentials)
make smoke # live smoke suite against a dedicated dev account (sources .env)
make docs # generate the provider documentation site content
make all # everything above except the live suites
يستخدم خط الأنابيب داخليًا @stackql/provider-utils (split وnormalize وanalyze وgenerate وdocgen) مع قواعد خاصة بالموفر في provider-dev/scripts/. ينتهي الموفر الذي تم إنشاؤه في provider-dev/openapi/src/<name>/v00.00.00000/، وهو الدليل الذي يتم نشره في النهاية في السجل.
الملف provider-dev/config/all_services.csv هو العقد المودع لتعيين كل عملية إلى مورد وأسلوب. أي فرق يظهر عند إعادة الإنشاء هو مراجعة لتغيير جذري، وليس مجرد ضوضاء. يفشل CI عند وجود انحراف في الإنشاء غير مودع، لذا يجب أن تعيد عملية إعادة الإنشاء إنتاج الملفات الناتجة المودعة بشكل مطابق على مستوى كل بايت.
بالنسبة إلى مستودع موفر موجود يسبق القالب، انسخ الدليل .claude/skills إليه وابدأ من الملف references/uplift-checklist.md الخاص بالمهارة.
استخدام Claude Code لتطوير الموفرين
يتضمن القالب مهارة تطوير موفري StackQL لـ Claude Code. افتح جلسة Claude Code في مستودع تم إنشاؤه من القالب واطلب منه بناء الموفر؛ فهو يقرأ CLAUDE.md والمهارة وينفذ الخطوات بالترتيب. والمهارة هي أيضًا الإجراء المكتوب لتنفيذ العمل يدويًا.
تغطي المهارة ما يلي:
- اختيار النمط الأساسي: مستند OpenAPI أو Swagger أو مستند اكتشاف تنشره الجهة المزودة (مباشر)، أو مواصفات مشتقة من SDK الخاصة بالجهة المزودة حيث تكون SDK هي المصدر الموثوق (مشتق)
- استرداد المواصفات الأصلية وإصلاحها والتحقق من صحتها وقفل إصدارها، بحيث يظهر كل تحديث كفرق قابل للمراجعة
- جرد نقاط النهاية وتقسيم الخدمات وقواعد التعيين التي تنتج
all_services.csv - كل عنصر أساسي في مستند الموفر ومتى تستخدمه: تحديد النطاق باستخدام
x-stackQL-envVar، وobjectKey، وتحويلات الطلبات والاستجابات، والتقسيم إلى صفحات، ودفع معلمات الاستعلام إلى المصدر، وأساليبEXECلدورة الحياة، ودمج GraphQL، وطرق عرض الموفر - طبقات الاختبار الثلاث التي لا تتطلب بيانات اعتماد ومجموعة اختبارات الدخان المباشرة
- موقع الوثائق وسير عمل CI وملاحظات التسليم
يحتوي الدليل references/ الخاص بالمهارة على تفاصيل كل خطوة، ويطبع البرنامج النصي scripts/find_extension_examples.sh محتوى YAML المنشور لأي مفتاح ملحق من نسخة مستنسخة من سجل الموفرين، بحيث يمكن رؤية العنصر الأساسي قيد الاستخدام قبل كتابته.
اختبار موفر محليًا
يقرأ StackQL الموفرين من سجل تصفه العلامة العامة --registry. أثناء التطوير، وجّهه إلى دليل الموفر الذي تم إنشاؤه على نظام الملفات المحلي مع تعطيل التحقق من التوقيع (لا يتم توقيع المستندات إلا عند نشرها):
export LOCAL_REG='{ "url": "file:///path/to/provider-dev/openapi", "localDocRoot": "/path/to/provider-dev/openapi", "verifyConfig": { "nopVerify": true } }'
stackql --registry="${LOCAL_REG}" shell
يجب أن يحتوي الدليل الموجود ضمن localDocRoot على src/<provider>/<version>/provider.yaml وsrc/<provider>/<version>/services/*.yaml، وهذا بالضبط ما ينشئه القالب. من واجهة الأوامر، تؤكد الجمل SHOW SERVICES IN <provider> وSHOW RESOURCES IN <provider>.<service> وSHOW METHODS IN <provider>.<service>.<resource> وDESCRIBE EXTENDED <provider>.<service>.<resource> السطح المتاح قبل تشغيل أي استعلام. ويؤتمت الملف tests/offline_validation.mjs في القالب هذه التأكيدات، ويشغل npm run probe -- "SELECT ..." استعلامات SQL مخصصة على واجهة API الوهمية ويطبع الاستدعاءات على مستوى الاتصال.
يتم تخزين الموفرين الذين تم سحبهم من سجل بعيد في ذاكرة التخزين المؤقت ضمن <cwd>/.stackql افتراضيًا؛ استخدم العلامة --approot لتغيير الموقع.
تفيد واجهة CLI الخاصة بـ any-sdk في فحص مستند دون إشراك StackQL: يشغل الأمر anysdk aot <registry> <provider.yaml> التحليل الثابت على موفر (objectKey غير قابل للتوجيه، ومخططات استجابة مفقودة، وتقسيم إلى صفحات غير مكتمل، ومعلمات مسار متجاورة وما إلى ذلك)، ويتيح الأمر anysdk query تنفيذ أسلوب واحد مباشرة من مستندات الموفر والخدمة. ينشئ اختبار Automock واجهة API وهمية ونتائج متوقعة من المخططات الموجودة في الموفر لإجراء دورة كاملة دون المساس بواجهة API الفعلية.
اختبار الموفر الخاص بك باستخدام السجل dev
بعد دمج الموفر في الفرع dev من السجل، تتم إتاحته من سجل التطوير. وجّه StackQL إليه للتحقق من الملف الناتج المنشور:
export DEV_REG='{ "url": "https://registry-dev.stackql.app/providers" }'
stackql --registry="${DEV_REG}" shell
REGISTRY PULL myprovider;
يشغل الهدف make smoke-live في القالب مجموعة اختبارات الدخان على الموفر المنشور للتحقق بعد النشر.
نشر موفر
النشر خطوة منفصلة يشارك فيها الإنسان، ولا تدخل ضمن خط أنابيب القالب.
- أنشئ نسخة متفرعة من stackql-provider-registry وانسخ الدليل
provider-dev/openapi/src/<name>الذي تم إنشاؤه إلىproviders/src/<name>في فرع ميزة. - افتح طلب سحب إلى الفرع
devمع وصف للموفر والتغييرات (راجع دليل المساهمة الخاص بالسجل). - يتحقق GitHub Actions من صحة الموفر ويختبره باستخدام stackql-provider-tests. القواعد التي يتم تقييمها هي: يجب أن يكون المستند مواصفات OpenAPI صالحة، ويجب أن تكون جميع الخدمات قابلة لسرد مواردها، ويجب أن تكون جميع الموارد قابلة لسرد أساليبها، ويجب أن يكون للأساليب القابلة للاستدعاء عبر
SELECTمخطط استجابة صالح، ويجب أن يكون للأساليب القابلة للاستدعاء عبرINSERTمخطط طلب صالح. - عند الدمج، يخصص سير العمل رقم إصدار، ويوقع المستندات رقميًا (ML-DSA-65)، ويحزمها، وينشر الملف الناتج في مخزن الحفظ على AWS S3. ثم يتم نسخ شجرة المستندات إلى Cloudflare R2 ونشر Cloudflare Worker الذي يقدم
registry-dev.stackql.app. ويتاح الموفر فورًا لعمليات التثبيت التي تم تكوينها لاستخدام السجلdev. - بعد فترة من المراقبة، تتم ترقية
devإلىmain، مما يكرر النشر لـregistry.stackql.app. وهذا هو النشر لمثيلات StackQL ذات التكوين الافتراضي.
يمكن تشغيل أداة الاختبار stackql-provider-tests نفسها محليًا على دليل سجل قبل فتح طلب سحب:
test-provider.sh <provider_name> false /path/to/provider-dev/openapi
راجع البناء والنشر في مستودع السجل للاطلاع على سير العمل بالتفصيل، بما في ذلك آلية الحماية من حذف الموفرين التي تحمي providers/src.