عن المشروع

fakecloud هو محاكي AWS محلي مجاني ومفتوح المصدر مصمم للاختبار التكاملي والتطوير المحلي. يقدم نفسه كبديل مباشر لـ LocalStack، خاصة بعد أن أصبحت النسخة المجتمعية من LocalStack مملوكة بشكل خاص في مارس 2026. يوفر المشروع ملفاً تنفيذياً واحداً (حوالي 19 ميغابايت) يبدأ في حوالي 300 مللي ثانية ويستمع على http://localhost:4566، مما يسمح لواجهات AWS SDK وأدوات CLI بالاتصال باستخدام بيانات اعتماد وهمية. تشمل الميزات الرئيسية: - **تغطية واسعة للخدمات**: 105 خدمات AWS و7,508 عملية، بما في ذلك S3 وDynamoDB وSQS وSNS وEventBridge وLambda وIAM وSTS وKMS وSecrets Manager وCloudFormation وSES وCognito وKinesis وRDS وElastiCache وECS/ECR وEC2 وStep Functions وAPI Gateway وBedrock. - **اختبار التوافق**: يدّعي المشروع توافق Smithy بنسبة 100% مع نجاح 248,557 متغير اختبار في كل commit، تم التحقق منها مقابل نماذج Smithy الخاصة بـ AWS. كما تشغّل CI مجموعات TestAcc الخاصة بـ terraform-provider-aws من المنبع. - **ربط حقيقي بين الخدمات**: تكاملات مثل EventBridge إلى Step Functions، وS3 إلى Lambda، وSES الوارد إلى S3/SNS/Lambda تُنفَّذ من البداية إلى النهاية. - **بنية تحتية للخدمات ذات الحالة**: تعمل Lambda (23 بيئة تشغيل) وRDS (6 محركات حقيقية) وElastiCache وECS وEC2 كحاويات حقيقية، مع خيار خلفية Kubernetes Pod. - **محاكاة Bedrock**: 216 عملية عبر 4 واجهات برمجة تطبيقات مع بث حقيقي لـ InvokeModel/Converse، وguardrails، ووكلاء، وتدفقات، بالإضافة إلى استجابات قابلة للتكوين وحقن الأخطاء. - **حزم SDK للاختبار من الطرف الأول**: متاحة لـ TypeScript وPython وGo وPHP وJava وRust وC#/.NET، مما يتيح تأكيدات الاختبار على الآثار الجانبية مثل رسائل البريد الإلكتروني المرسلة ورسائل SNS واستدعاءات Lambda. - **خيارات الأمان**: التحقق من SigV4 والتفعيل الاختياري لـ IAM بأوضاع مرنة أو صارمة. - **التوافق**: يدعم أنماط عناوين URL الخاصة بـ LocalStack وAWS الحقيقي، بما في ذلك متغيرات S3 المستضافة افتراضياً. المشروع مرخّص بموجب AGPL-3.0-or-later، مع تطبيق شرط الحقوق المتروكة فقط إذا قمت بتعديل وإعادة توزيع fakecloud نفسه كخدمة شبكة. تشمل خيارات التثبيت سكريبت shell وHomebrew وCargo وDocker وDocker Compose والبناء من المصدر. الوثائق متاحة على fakecloud.dev، بما في ذلك مصفوفة التكافؤ ووثائق لكل خدمة وأدلة لإعداد CI واختبار Bedrock وتكوين خلفية Kubernetes.