عن المشروع

يُصان هذا المستودع بواسطة AWS ويجمع أمثلة كود توضح كيفية استخدام AWS SDKs للتفاعل مع خدمات AWS. تُدرج أمثلة كثيرة مباشرة في وثائق AWS الرسمية وأدلة مطوري SDK. التنظيم حسب اللغة وإصدار SDK. لكل لغة دليلها الفرعي الخاص، وبعض اللغات لديها مجلدات منفصلة لأجيال SDK الأقدم والأحدث: - .NET: dotnetv3 (SDK 3.5+) وdotnet (أقل من 3.5) - C++: cpp (SDK 1) - Go: gov2 (SDK 2) وgo (SDK 1) - Java: javav2 (SDK 2) وjava (SDK 1) - JavaScript: javascriptv3 (SDK 3) وjavascript (SDK 2) - Kotlin: kotlin (SDK 1) - PHP: php (SDK 3) - Python: pythonv4 (SDK 4) وpython (SDK 3) - Ruby: ruby (SDK 3) - Rust: rustv1 (SDK 1) - Swift: swift (معاينة) يحتوي كل دليل على تعليمات خاصة بـ SDK لفهم الأمثلة وتشغيلها. يذكر ملف README أن AWS SDK for Java v1.x دخل وضع الصيانة في 31 يوليو 2024 ويصل إلى نهاية الدعم في 31 ديسمبر 2025. إلى جانب المجلدات الخاصة بكل لغة، توجد أدلة إضافية: - applications: مكونات غير خاصة بلغة معينة من تطبيقات الأمثلة التي توضح استخدام SDK في سيناريوهات شبيهة بالإنتاج. توجد الأجزاء الخاصة بكل لغة في مجلد الخدمات المتقاطعة لكل لغة. - test: مكونات تدعم إطار أتمتة اختبار مخصص يختبر كود المستودع بانتظام، ويُنشر على AWS كحل اختبار تكامل متعدد اللغات قائم على الحاويات. يشير ملف README إلى أن هذا لا يزال قيد الإنشاء النشط اعتبارًا من 2023. - resources: مكونات مشتركة تستخدمها أمثلة كثيرة، وتُنشر كعملاء واجهة أمامية أو مكونات خلفية CDK/CloudFormation. يتطلب تشغيل الأمثلة حساب AWS وبيانات اعتماد AWS مهيأة، على سبيل المثال عبر AWS CLI. يتضمن ملف README إخلاء مسؤولية بشأن الاستخدام: تتفاعل الأمثلة مع خدمات قد تترتب عليها رسوم، وقد تنشئ موارد AWS أو تحذفها. وينصح المستخدمين بالانتباه إلى الموارد المنشأة أو المحذوفة، والتكاليف المحتملة، ونسخ البيانات المهمة احتياطيًا. تُرحب المساهمات عبر دليل CONTRIBUTING.md. يمكن تقديم طلبات الأمثلة عبر متتبع المشكلات باستخدام قالب التحسين. يقيّم الفريق الطلبات من حيث الوضوح والملاءمة والجدوى، ويطلب تقديم الطلبات في أقرب وقت ممكن، ويُفضّل قبل شهرين على الأقل للأمثلة الأكبر. تحظى إصلاحات الأخطاء والمشكلات الأمنية بالأولوية على الأمثلة الجديدة، ويزيد وجود طلب سحب عالي الجودة مصاحب من احتمال معالجة الطلب. يذكر ملف README أيضًا "tributaries": مصادر إضافية تتدفق أمثلة الكود الخاصة بها إلى وثائق AWS، بما في ذلك هذا المستودع، وaws-samples/serverless-snippets، وaws/aws-tools-for-powershell. الترخيص: المحتوى حقوق نشر Amazon Web Services, Inc. أو الشركات التابعة لها. ما لم يُذكر خلاف ذلك، تُرخّص الأمثلة بموجب Apache License 2.0، مع النص الكامل في ملف LICENSE. يطلب ملف README من المساهمين تضمين تعليق حقوق النشر وSPDX-License-Identifier: Apache-2.0 في أعلى الملفات حيثما أمكن.