localstack

ملخص

LocalStack هو محاكي خدمة سحابية يتم تشغيله في حاوية واحدة على الكمبيوتر المحمول الخاص بك أو في بيئة CI الخاصة بك. باستخدام LocalStack، يمكنك تشغيل تطبيقات AWS أو Lambdas بالكامل على جهازك المحلي دون الاتصال بموفر خدمة سحابية عن بعد! سواء كنت تختبر تطبيقات CDK معقدة أو تكوينات Terraform، أو بدأت للتو في التعرف على خدمات AWS، فإن LocalStack يساعدك على تسريع وتبسيط سير عمل الاختبار والتطوير.

يدعم LocalStack عددًا متزايدًا من خدمات AWS، مثل AWS Lambda وS3 وDynamodb وKinesis وSQS وSNS وغيرها الكثير! يدعم الإصدار Pro من LocalStack واجهات برمجة التطبيقات الإضافية والميزات المتقدمة. يمكنك العثور على قائمة شاملة بواجهات برمجة التطبيقات المدعومة على صفحة تغطية الميزات الخاصة بنا.

يوفر LocalStack أيضًا ميزات إضافية لتجعل حياتك كمطور سحابي أسهل! راجع أدلة مستخدم LocalStack لمزيد من المعلومات.

ثَبَّتَ

أسرع طريقة لبدء استخدام LocalStack هي استخدام LocalStack CLI. فهو يمكّنك من بدء وإدارة حاوية LocalStack Docker مباشرة من خلال سطر الأوامر الخاص بك. تأكد من أن جهازك يحتوي على بيئة docker وظيفية مثبتة قبل المتابعة.

Brew (نظام التشغيل MacOS أو Linux مع Homebrew)

قم بتثبيت LocalStack CLI من خلال LocalStack Brew Tap الرسمي الخاص بنا:

 قم بتثبيت localstack/tap/localstack-cli

التنزيل الثنائي (MacOS وLinux وWindows)

إذا لم يكن Brew مثبتًا على جهازك، فيمكنك تنزيل الملف الثنائي LocalStack CLI المبني مسبقًا مباشرة:

• تفضل بزيارة localstack/localstack-cli وقم بتنزيل أحدث إصدار لمنصتك.

• قم باستخراج الأرشيف الذي تم تنزيله إلى دليل مدرج في متغير PATH الخاص بك:

• بالنسبة لنظام التشغيل MacOS/Linux، استخدم الأمر: sudo tar xvzf ~/Downloads/localstack-cli-*-darwin-*-onefile.tar.gz -C /usr/local/bin

PyPI (ماك، لينكس، ويندوز)

تم تطوير LocalStack باستخدام لغة Python. لتثبيت LocalStack CLI باستخدام pip ، قم بتشغيل الأمر التالي:

 python3 -m pip تثبيت localstack

يمكّنك تثبيت localstack-cli من تشغيل صورة Docker التي تحتوي على وقت تشغيل LocalStack. للتفاعل مع خدمات AWS المحلية، تحتاج إلى تثبيت awslocal CLI بشكل منفصل. للحصول على إرشادات التثبيت، راجع وثائق awslocal .

هام : لا تستخدم sudo أو تعمل كمستخدم root . يجب تثبيت LocalStack وبدء تشغيله بالكامل تحت مستخدم محلي غير جذر. إذا كانت لديك مشكلات تتعلق بالأذونات في macOS High Sierra، فقم بالتثبيت باستخدام pip install --user localstack

بداية سريعة

ابدأ تشغيل LocalStack داخل حاوية Docker عن طريق تشغيل:

 % بدء المكدس المحلي -d

     __ _______ __ __
    / / ____ _________ _/ / ___// /______ ______/ /__
   / / / __ / ___/ __ `/ /__ / __/ __ `/ ___/ //_/
  / /____/ /_/ / /__/ /_/ / /____/ / /_/ /_/ / /__/ ,<
 /______/____/____/__,_/_//____/__/__,_/___/_/|_|

 ؟ LocalStack CLI 3.8.0
 ؟ الملف الشخصي: افتراضي

[12:47:13] هل تريد بدء LocalStack في وضع Docker؟                       localstack.py:494
           إعداد البيئة bootstrap.py:1240
           تكوين الحاوية bootstrap.py:1248
           بدء تشغيل الحاوية bootstrap.py:1258
[12:47:15] فصل bootstrap.py:1262

يمكنك الاستعلام عن حالة الخدمات المعنية على LocalStack عن طريق تشغيل:

 % خدمات حالة المكدس المحلي
┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━ ━┓
┃ الخدمة ┃ الحالة ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━ ━┩
│ ACM │ ✔ متاح │
│ طريق apigateway │ ✔ متوفر │
│ التشكل السحابي │ ✔ متاح │
│ ساعة سحابية │ ✔ متاحة │
│ التكوين │ ✔ متاح │
│ dynamodb │ ✔ متوفر │
...

لاستخدام SQS، قم بتشغيل خدمة انتظار الرسائل الموزعة المُدارة بالكامل على LocalStack:

 % awslocal sqs create-queue --queue-name Sample-queue
{ "QueueUrl": "http://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"}

تعرف على المزيد حول خدمات LocalStack AWS واستخدامها مع awslocal CLI الخاص بـ LocalStack.

جري

يمكنك تشغيل LocalStack من خلال الخيارات التالية:

• LocalStack CLI

• عامل ميناء

• عامل الميناء يؤلف

• هيلم

الاستخدام

لبدء استخدام LocalStack، راجع وثائقنا.

• تكوين LocalStack

• LocalStack في CI

• التكامل LocalStack

• أدوات LocalStack

• فهم LocalStack

• الأسئلة المتداولة

لاستخدام LocalStack مع واجهة مستخدم رسومية، يمكنك استخدام عملاء واجهة المستخدم التالية:

• تطبيق ويب LocalStack

• سطح المكتب LocalStack

• ملحق LocalStack Docker

الإصدارات

يرجى الرجوع إلى إصدارات GitHub للاطلاع على القائمة الكاملة للتغييرات لكل إصدار. للحصول على ملاحظات الإصدار الموسعة، يرجى الرجوع إلى مناقشة LocalStack.

المساهمة

إذا كنت مهتمًا بالمساهمة في LocalStack:

• ابدأ بقراءة دليل المساهمة الخاص بنا.

• تحقق من دليل إعداد بيئة التطوير لدينا.

• انتقل إلى قاعدة التعليمات البرمجية لدينا والقضايا المفتوحة.

نحن ممتنون لجميع المساهمات والتعليقات التي نتلقاها.

تواصل معنا

تواصل مع فريق LocalStack للإبلاغ؟ القضايا، التصويت؟ طلبات الميزة،؟؟ اطرح أسئلة الدعم، أو ️ ناقش تطوير السحابة المحلية:

• مجتمع LocalStack سلاك

• صفحة مناقشة LocalStack

• أداة تعقب المشكلات LocalStack GitHub

المساهمين

ونحن نشكر جميع الأشخاص الذين ساهموا في هذا المشروع.

المؤيدون

كما أننا ممتنون لجميع داعمينا الذين تبرعوا للمشروع. يمكنك أن تصبح مؤيدًا لـ Open Collective.

الرعاة

يمكنك أيضًا دعم هذا المشروع من خلال أن تصبح راعيًا لـ Open Collective. سيظهر شعارك هنا مع رابط لموقعك على الويب.

رخصة

حقوق الطبع والنشر (ج) 2017-2024 لمشرفي LocalStack والمساهمين.

حقوق الطبع والنشر (ج) 2016 لشركة Atlassian وآخرون.

تم إصدار هذا الإصدار من LocalStack بموجب ترخيص Apache، الإصدار 2.0 (راجع الترخيص). عن طريق تنزيل هذا البرنامج واستخدامه، فإنك توافق على اتفاقية ترخيص المستخدم النهائي (EULA).