مجموعات متغيرات البيئة المشتركة

An environment variable group holds values that several Orbit projects need, such as a shared API key or a database credential, in one place. Link the group to the projects that need it and every…

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

مكان وجود مجموعات Env

افتح Orbit واختر Env groups من التنقل على المستوى الأعلى. الصفحة بعنوان Shared env var groups وتصفها بأنها مجموعات على مستوى الحساب مشتركة عبر عدة مشاريع Orbit.

المجموعات تقع فوق المشاريع. متغيرات المشروع الخاصة به لا تزال تعيش على علامة تبويب Env vars الخاصة به: انظر متغيرات البيئة في Orbit.

متى تستخدم مجموعة

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

المرشحون الجيدون:

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

المرشحون السيئون:

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

إنشاء مجموعة

انقر على New group.
أعطها Group name، بحد أقصى 64 حرفاً. سمِّها على اسم ما تحتويه، على سبيل المثال الخدمة التي تنتمي إليها بيانات الاعتماد.
أضف Description اختياري.
انقر على Create group.

يمكن للحساب الواحد أن يحتفظ بما يصل إلى 20 مجموعة. عند الوصول إلى الحد الأقصى، يعرض الزر (limit reached) وإنشاء مجموعة أخرى مرفوض.

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

إضافة متغيرات

افتح المجموعة واستخدم قسم Variables:

انقر على Add variable.
أدخل المفتاح والقيمة.
حدد Mark as secret لأي شيء حساس.
انقر على Save group.

المتغير المحدد كسري يتم تخزينه مشفراً ولا يتم إرجاع قيمته إلى اللوحة بعد ذلك. تعرض القائمة المفتاح ومؤشر Marked as secret (hidden) بدلاً من القيمة. تبقى القيم غير السرية مرئية حتى تتمكن من التحقق منها في لمحة.

وضع علامة على متغير باعتباره سري يعني أنه لا يمكنك قراءته مرة أخرى من اللوحة. هذه هي النقطة، لكنها تعني أيضاً أن المجموعة ليست مدير كلمات المرور. احتفظ بالنسخة الموثوقة حيثما تحتفظ فريقك بالفعل بيانات الاعتماد، واعتبر المجموعة كآلية التوزيع.

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

ربط المشاريع

يسرد قسم Linked projects كل مشروع في الحساب. انقر على مشروع لربطه أو فصله؛ يتم تمييز المشاريع المرتبطة. احفظ المجموعة لتطبيق.

مجموعة بدون مشاريع مرتبطة لا تفعل شيئاً، والقسم يقول No projects yet حتى تربط مشروعاً واحداً.

يتم حقن متغيرات المجموعة في وقت البناء، لذا فإن ربط مشروع يؤثر على البناء التالي له، وليس على النشر الحالي النشط. إذا كنت تحتاج إلى التغيير الآن، أعد النشر: انظر نشر مشروعك.

الأسبقية

القاعدة مذكورة على الصفحة: يتم حقن متغيرات المجموعة في وقت البناء، وتتمتع متغيرات مستوى المشروع ومستوى البيئة بالأسبقية على متغيرات المجموعة.

بمعنى آخر، الأكثر تحديداً يفوز:

متغيرات مستوى البيئة، أعلى أولوية.
متغيرات مستوى المشروع.
متغيرات المجموعة، الأقل.

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

كما أنه يشرح الالتباس الأكثر شيوعاً مع المجموعات: تقوم بتحرير المجموعة وإعادة النشر، ولا يحدث شيء، لأن المشروع له متغيره الخاص بنفس المفتاح الذي يفوز بهدوء. تحقق من علامة تبويب Env vars الخاصة به أولاً عندما يبدو أن قيمة المجموعة يتم تجاهلها.

تدوير بيانات اعتماد مشتركة

هذا هو سير العمل الذي توجد المجموعات من أجله:

أنشئ بيانات الاعتماد الجديدة عند المزود، مع ترك القديمة نشطة.
عدّل القيمة في المجموعة واحفظ.
أعد نشر كل مشروع مرتبط، أو انتظر نشره التالي.
تأكد من أن كل مشروع يعمل على بيانات الاعتماد الجديدة.
أبطل بيانات الاعتماد القديمة عند المزود.

القيام بالخطوة 5 أولاً يعطيك نافذة حيث كل مشروع مرتبط مكسور في وقت واحد، وهذا بالضبط الخطر الذي تركزه بيانات اعتماد مشتركة.

حذف مجموعة

انقر فوق حذف على المجموعة. التأكيد محدد بشأن العاقبة: البناء المستقبلي سيفقد هذه المتغيرات، وعمليات البناء المكتملة بالفعل لن تتأثر.

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

قبل الحذف، فصل المشاريع واحداً تلو الآخر وأعد نشر كل واحد، حتى تعرف أي منها يعتمد فعلاً على المجموعة قبل أن تفقدها جميعاً.

نصائح عملية

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

سمِّ المفاتيح بنفس الطريقة في كل مكان. إذا قرأ مشروع واحد SENTRY_DSN وقرأ مشروع آخر SENTRY_KEY، فلا يمكن لمجموعة مشتركة أن تساعدك. وحدّ الأسماء أولاً.

لا تضع بيانات اعتماد الإنتاج في مجموعة مرتبطة بمشاريع بمعاينات عامة. متغيرات المجموعة تصل إلى كل بناء لمشروع مرتبط، بما في ذلك المعاينات.

استكشاف الأخطاء

البناء لا يرى المتغير. تأكد من أن المشروع مرتبط وتم حفظه، وأن البناء تم تشغيله بعد الربط. تنطبق متغيرات المجموعة من البناء التالي.

القيمة خاطئة في وقت التشغيل. متغير على مستوى المشروع أو على مستوى البيئة بنفس المفتاح يتجاوزه. تحقق من علامة تبويب Env vars الخاصة به.

إنشاء مجموعة غير متاح. أنت في حد 20 مجموعة، أو دور الحساب الخاص بك ليس مالكاً أو مسؤولاً.

قيمة السري تظهر فارغة. هذا صحيح. قيم السري لا يتم إرجاعها إلى اللوحة بعد الحفظ.

مشروع انقطع بعد تحرير مجموعة. أرجع القيمة مرة أخرى في المجموعة وأعد النشر، ثم اكتشف أي مشروع لم يتفق. التراجع عن نشر يجعل الموقع المشغل صحياً بينما تفعل.

أين تذهب بعد ذلك

متغيرات البيئة في Orbit للمتغيرات على مستوى المشروع.
متغيرات البيئة لكل بيئة لطبقة التجاوز.
إعدادات مشروع Orbit لبقية تكوين المشروع.