كيفية تطوير API بدون سرور مع AWS SAM CLI و GitHub Action

يسهل إدارة البنية التحتية، ويقدم دعم SSL/TLS المدمج، ويكمل مع خدمات AWS مثل CloudFormation، Lambda، S3, Route 53، و CloudWatch. من خلال الاستفادة من نموذج بدون سرور، يمكن للمطورين التركيز على كتابة منطق التطبيقات في حين أن AWS يتعامل مع التوسع والسلامة والعناية، مما يجعلها حلًا مثاليًا لمواقع API الحديثة ذات الصلة. سوف يدرسك هذا الدليل خطوة بخطوة حول كيفية إنشاء API بسيط، وتطبيقها باستخدام AWS CloudFormation مع SAM CLI، ثم تثبيت التطبيقات باستخدام GitHub Actions. للمحاكمة المحلية. اضغط على الملف صفحة المحتوى – إدراج: لماذا استخدام SAM لتنفيذ API؟ – متطلبات: تثبيت SAM CLI – الخطوة 1: بدء SAM – الخطوة 2: تحديد نقطة نهاية API – الخطوة 3: إنشاء و اختبار على المستوى المحلي – الخطوة 4: تطوير API – الخطوة 5: CI / CD مع عمليات Github - النتيجة Intro: لماذا تستخدم SAM لتنفيذ API؟ تشغيل API باستخدام نموذج التطبيقات AWS Serverless Application Model (SAM) هو نهجًا فعالًا ومتناسقًا لتطبيقات مبتكرة. انظر جدول أكثر تفصيلاً من هذا النوع من العمل: الطبيعة المبادئ الأساسية Node.js تثبيت Docker موقع GitHub. AWS CLI و SAM CLI تثبيت. Node.js متصفح Node.js تثبيت للتحقيق المحلي Docker الطباعة موقع GitHub GitHub المتطلبات الأولى: تثبيت SAM CLI بعد التفكير في الدليل ، تأكد من تثبيت AWS SAM CLI على جهاز الكمبيوتر الخاص بك. لأجهزة الكمبيوتر macOS (إذا لم يتم تثبيتها بالفعل): تثبيت Homebrew استخدام Homebrew /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" : ضغط على AWS و تثبيت SAM CLI ضغط على AWS و تثبيت SAM CLI كيفية إرسال إرسال إرسال إرسال إرسال إرسال إرسال blue tap aws/blue tap install aws-sam-cli تحقق من تثبيت sam --version sam - الإصدار بالإنترنت : تحميل متصفح SAM CLI تحميل متصفح SAM CLI نقل إلى و تحميل أحدث متصفح Windows. صفحة AWS SAM CLI الرسمية ذهب إلى و تحميل أحدث متصفح Windows. الصفحة الرسمية AWS SAM CLI صفحة AWS SAM CLI الرسمية : بدء التطبيق متابعة التطبيق ضغط مزدوج على الملف الذي تم تنزيله ثم اتبع مساعد التثبيت. .exe Double-click the downloaded file and follow the installation wizard. .exe .exe (إذا لم يتم إضافةها تلقائيا): إضافة SAM CLI إلى PATH إضافة SAM CLI إلى الطريق تسريع "البدائل البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية البيئية انقر فوق "تعديل المتغيرات البيئية في النظام". فتح قائمة البدء و البحث عن "البدائل البيئية." تسريع "البدائل البيئية البيئية البيئية البيئية البيئية البيئية." تسريع "البدائل البيئية البيئية البيئية" تحت "البدائل البيئية البيئية البيئية البيئية". فتح قائمة البدء و البحث عن "المعدات البيئية." بعد “تخصيصات النظام”، انقر فوق “تخصيصات البيئة”. في “تعديلات النظام” ، ابحث عن ثم اضغط على “إصلاح”. Path الطريق إضافة المجلد حيث تم تثبيت SAM CLI (مثل ). C:\Program Files\Amazon\AWS SAM CLI\bin C:\Program Files\Amazon\AWS SAM CLI\bin : افتح إرسال إرسال إرسال تحقق من تثبيت sam --version تحقق من تثبيت sam - الإصدار خطوة 1: بدء SAM CLI إنشاء مخزون جديد على جهازك: mkdir aws-serverless-api إنشاء مخزون جديد على جهازك: تقارير الخيارات الثنائية الخيارات الثنائية الخيار التنقل إلى القائمة: cd aws-serverless-api التنقل إلى القائمة: cd aws-serverless-api نتيجة لذلك ستحصل على بعض الخيارات. بدء تطبيق SAM جديد: sam init بدء تطبيق SAM جديد: sam init >ختار "1 - AWS Quick Start Templates." ختار لتنفيذ API serverless مع دعم Lambda على API Gateway." "7 - Serverless API" ختار "Node.js 20.x" >ختار أو لا لتتبع X-Ray لأننا نريد تقليل تكاليفنا، وهذا أمر بسيط. "N" اختيار "1 - AWS Quick Start Templates." “1 — AWS Quick Start Templates.” “1 — AWS Quick Start Templates.” ختار لتنفيذ API Serverless مع دعم Lambda على API Gateway. "7 — Serverless API" “7 – API بدون مستخدم” “7 – API بدون مستخدم” اختيار “Node.js 20.x” ”Node.js 20.x” ”Node.js 20.x” ختار أو لا لمتابعة X-Ray لأننا نريد انخفاض تكاليفنا، وهذا هو مثال بسيط فقط Hello World. أختار أيضًا لمراقبة شبكة cloudwatch لأننا لا نحتاج إلى تحليلات على الأداء لهذا مثال Hello World. "N" “N” ”N” "N" “N” ”N” لا يزال لموقع json في كتابة lambda لأن هذا هو فقط مثال Hello World. "N" “N” ”N” نعم، دعونا نضيف CD إلى المجلد الذي تم إنشاؤه من ؛ اخترت إسم مشروعي لذلك دعونا نذهب: sam init sam-hello-world sam init صديق_صديق_صديق تصنيفات cd ستيفان ستيفان ثم فتح المشروع في VSCode - عند فتح المشروع في VSCode أو IDE المفضلة لديك ، يجب أن ترى الكثير من الملفات التي تم إنشاؤها بالفعل. code. كود. فهم الملفات التي تم إنشاؤها هذه هي ما يفعله كل من الملفات التي تم إنشاؤها من : sam init sam init - تعريف API Gateway الخاص بك، Lambda، والموارد الأخرى AWS. **template.yaml** - يحتوي على نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذج نموذ **src/handlers/** – تحدد API Gateway ، Lambda ، والموارد الأخرى في AWS. **template.yaml** **template.yaml** – يحتوي على نموذج من نموذج نموذج نموذج Lambda. **src/handlers/** **src/handlers/** - أحداث اختبار العينات للتحقيق المحلي. **events/** **شخصيات/** – يسيطر على التوازنات في وظائف Node.js Lambda. **package.json** **package.json** **.gitignore** – ملفات إنشاء المشروع القياسية. **README.md** ، **README.md** نحن سوف . تعديل بعض هذه الملفات لتطبيق API "السلام عليكم عالم" بسيط جدا تعديل وإزالة بعض هذه الملفات لتطبيق API "السلام عليكم" البسيط جداً خطوة 2: تحديد نقطة نهاية API نقرأ الآن وبدء تحديدات وظيفة Lambda الحالية بـ: template.yaml Template.yaml AWSTemplateFormatVersion: "2010-09-09" Transform: AWS::Serverless-2016-10-31 Description: AWS SAM template for deploying Node.js/Express API to Lambda Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: Handler: src/app.lambdaHandler Runtime: nodejs20.x Events: HelloWorld: Type: Api Properties: Path: / Method: GET AWSTemplateFormatVersion: "2010-09-09" Transform: AWS::Serverless-2016-10-31 Description: AWS SAM template for deploying Node.js/Express API to Lambda Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: Handler: src/app.lambdaHandler Runtime: nodejs20.x Events: HelloWorld: Type: Api Properties: Path: / Method: GET هذا يحدد طريق واحد في جذر API لدينا وهو طلب GET تحديث وظيفة Lambda في مكتبة ، دعونا نخلق ملف يسمى /src app.js /src app.js في ، دعونا نكتب وظيفة لإرسال سلام العالم من مسارنا: src/app.js src/app.js exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "Hello, World!" }) }; }; exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "Hello, World!" }) }; }; إزالة الملفات غير الضرورية نحن الآن، دعونا نلجأ إلى إزالة الممارسين والإجراءات الإضافية التي تم إنشاؤها من في الخطوة 1. sam init sam init فتح محفظة في مكتبة المشاريع و : ممارسة هذه الأوامر ممارسة هذه الأوامر rm -rf src/handlers/get-all-items.mjs src/handlers/get-by-id.mjs src/handlers/put-item.mjs rm -rf src/handlers/get-all-items.mjs src/handlers/get-by-id.mjs src/handlers/put-item.mjs rm -rf الحوادث/ rm -rf الحوادث/ الخطوة الثالثة: إنشاء و اختبار على المستوى المحلي فتح محفظة في مكتبة المشاريع ثم اتبع الخطوات أدناه: : إنشاء التطبيق : بناء التطبيق بناء التطبيق يجب أن ترى النتائج مثل هذا: sam build يجب أن ترى النتيجة مثل هذا: sam build sam build تحتاج إلى تثبيت لتشغيل هذا على المستوى المحلي. عند النجاح، يجب عليك أن ترى مخزونًا تم إنشاؤه لـ API لدينا في الكمبيوتر الأندرويد. : بدء خدمة API المحلية : بدء تطبيق API المحلي بدء خادم API المحلي docker docker فتح متصفح أو استخدامه في الجهاز للتحقق من نقطة الانطلاق: curl < - يرجى ملاحظة أنك بحاجة إلى تثبيت لتشغيل هذا على المستوى المحلي. عند النجاح، يجب أن ترى مخزونًا تم إنشاؤه لـ API لدينا في مكتبة الأندرويد. sam local start-api docker فتح متصفح أو استخدامه في الجهاز للتحقق من نقطة نهاية: curl - يرجى ملاحظة أنك بحاجة إلى تثبيت لذلك على المستوى المحلي. sam local start-api docker sam local start-api docker فتح متصفح أو استخدامه في الجهاز للتحقق من النقطة النهائية: curl فتح متصفح أو استخدامه في الجهاز للتحقق من نقطة النهاية: curl Courl curl [http://127.0.0.1:3000/](http://127.0.0.1:3000/) curl [http://127.0.0.1:3000/](http://127.0.0.0.1:3000/) curl [http://127.0.0.1:3000/](http://127.0.0.1:3000/) إذا كنت ترى JSON تم إجراؤها من نقطة النهار لدينا، فأنت قد بدأت بنجاح API المحلي! خطوة 4: تطوير API : الآن نحن قد تأكدنا من أن API لدينا يعمل على المستوى المحلي، دعونا نستخدمه في AWS باستخدام تخزين وتشغيل API باستخدام SAM جمع وتشغيل API باستخدام SAM تصنيف --guided sam deploy --guided تمكنك من الاستفادة من هذه التطبيقات: تمكنك من إدخال هذا الإدخال الميداني: 1. اختار اسم المجموع الخاص بك؛ أنا sam-hello-world صديق_صديق_صديق 2. اختيار منطقة AWS؛ أنا us-east-1 us-east-1 3. تأكد من التغييرات قبل التطبيق؛ اخترت Y و 4. إمكانية إنشاء دورة SAM-CLI، Y و 5. إلغاء التردد، اختر نريد أداة لإزالة أي الموارد المفقودة N N 6. HelloWorldFunction ليس لديه توثيق؛ هل هذا صحيح؟ لأغراض هذا الدليل Y و 7: تخزين العناصر إلى ملف التحكم Y و يمكنك أيضًا البحث عن Lambda في محطات AWS لتشاهد وظيفة Lambda بدون سرور التي تم تطويرها، حيث يعيش الكود الذي كتبنا لهذه النقطة النهائية. 8. ملف التحكم samconfig.toml samconfig.toml 9. بيئة تكوين SAM - ارجع هذا كبديل إذا كان تطويرك ناجحًا، يجب أن ترى الموارد التي تم إنشاؤها بنجاح مثل هذا: عندما تكون التطبيق ناجحًا، قم بتسجيل والبحث عن خدمة API Gateway. اذهب إلى إعدادات API، قم بتسجيل الدخول إلى URL في نافذة المستعرض الخاص بك، وإضافة `/Prod` إلى نهاية URL الخاص بك لتصل إلى نقطة انطلاق API الخاص بك. تسجيل الدخول إلى حسابك AWS تسجيل الدخول إلى حسابك AWS لقد رأيت عنوان URL هذا: يجب أن ترى أيضًا حزمة S3 تم إنشاؤها، والتي تحتوي على مجموعة من الكود لدينا.بعد أن نستخدم API لدينا بنجاح، دعونا نستخدم هذه العملية مع GitHub بحيث في كل مرة نريد تطويرها على API لدينا، يمكن إطلاق التطبيق تلقائيًا عن طريق التزامها بقطاع MAIN أو MASTER. خطوة 5: CI/CD مع عمليات Github بدء Git Repo الخاص بك و دفع إلى غرفة الماجستير أولًا، سنقوم بتبديل مخزون git في مكتبة المشروع مع ثم نضيف هذه الملفات إلى لأننا لا نريد أن نأخذها. git init .gitignore جعل init .gitignore إيضاح "node_modules/\n.aws-sam/\nsamconfig.toml" >>.gitignore echo "node_modules/\n.aws-sam/\nsamconfig.toml" >>.gitignore نحن الآن آمنة من وضع جميع الملفات في المشروع: ثم إجراء أول إعطاء: git add. حصل على إضافة. Git commit -m "مبادرة الأولي - تثبيت AWS SAM API" git commit -m "Initial commit - AWS SAM API setup" نتوقع هذه الخطوة التالية أن يكون لديك GitHub CLI تثبيت - هذه الخطوة هي حتى نتمكن من إنشاء GitHub repo من مكتبةنا الحالية: إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال إرسال gh repo create aws-sam-cli-tutorial --public --source=. --remote=origin إذا لم يكن لديك GitHub CLI، يمكنك إنشاء repo يدويًا على GitHub ثم التركيز على المجلد إلى repo الخاص بك باستخدام هذه الخطوة: تحديد الأصل عن بعد https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git Git إضافية عن طريق الفوركس https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git أخيرا، دعونا نضيف كودنا إلى GitHub git push -u origin master git push -u origin master إعداد إجراءات GitHub لـ CI/CD لابد من إنشاء ملف عمل العمليات GitHub: تصنيف -p.github/workflows mqdir -p.github/workflows Touch.github/workflows/deploy.yml touch.github/workflows/deploy.yml فتح الملف في vscode وملء التكوين yaml التالي: deploy.yml deploy.yml سم: تثبيت API إلى AWS CloudFormation على: push: فصائل: - وظائف الماجستير: تثبيت: runs-on: ubuntu-latest خطوات: -سم: تمثيل Code يستخدم: actions/checkout@v3 -سم: تثبيت AWS SAM CLI يستخدم: aws-actions/setup-sam@v2 -سم: تثبيت AWS CLI يستخدم: aws-actions/configure-aws-credentials@v2 مع: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-secret-access-key: ${ secrets.AWS_SECRET_ACCESS_ سم: تثبيت API إلى AWS CloudFormation على: push: فصائل: - وظائف الماجستير: تثبيت: runs-on: ubuntu-latest خطوات: -سم: تثبيت Code uses: actions/checkout@v3 -سم: تثبيت AWS SAM CLI uses: aws-actions/setup-sam@v2 -سم: تثبيت AWS CLI uses: aws-actions/configure-aws-credentials@v2 with: aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} aws-seccess-key: ${ secrets.AWS_SECRET_ACCESS_KEY }} aws-reg الآن، دعونا نذهب إلى github.com - اذهب إلى مرافقك، انقر على مرافقنا التي خلقتنا لهذا المشروع، اذهب إلى الإعدادات والآليات، وسوف ترى هذه الشاشة لإضافة أسرار البيئة والمرافق. في هذه ملف.yaml لتنفيذ تلقائي، ونحن نعتمد على مخازن AWS-Actions من GitHub: لتثبيت SAM CLI وتحديث إمكانياتنا - هذه مخازن AWS قد تتغير في غضون بضعة سنوات، لذلك تحديث حسب الحاجة. https://github.com/orgs/aws-actions/repositories https://github.com/orgs/aws-actions/repositories لماذا نريد إضافة أسرار التخزين ل: نريد إضافة أسرار التخزين ل: AWS_ACCESS_KEY_ID AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SECRET_ACCESS_KEY AWS_REGION AWS_REGION AWS_S3_BUCKET AWS_S3_BUCKET لتحقق من هذه القيم، قم بزيارة مراقبة AWS الخاصة بك.لأن ستحتاج إلى استخدام نفس المنطقة التي تم تطويرها من جهازك المحلي.إذا كنت غير مطمئنًا من هذه المنطقة، فأنت تبحث عن Cloudformation وتجد القفز الذي خلقته، ثم انقر على ذلك، وكنت بحاجة إلى رؤية المنطقة في URL. AWS_REGION، AWS_REGION، بالإضافة إلى البحث عن S3 في قفل AWS واختيار القفز الذي تم إنشاؤه من جهازنا في الخطوة 4. AWS_S3_BUCKET، AWS_S3_BUCKET، لأن و انقر فوق خدمة IAM في قاعدة AWS: AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY، AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY، من هنا، إنشاء مستخدم IAM إذا لم يكن لديك أي مستخدم مع الوصول الذي تريد استخدامه، وإضافة ما لا يقل عن هذه المجالات المسموح بها للمستخدم: AWSLambdaFullAccess IAMFullAccess AmazonS3FullAccess CloudFormationFullAccess AmazonAPIGatewayالمدير AWSLambdaFullAccess IAMFullAccess AmazonS3FullAccess CloudFormationFullAccess AmazonAPIGatewayالمدير يمكنك أيضا فقط إضافة إذا كنت مطمئنًا مع ذلك. بعد ذلك، وسوف نريد إنشاء مفتاح Access وجوهر لهذا المستخدم. اختار CLI كوجهة الاستخدام لفتحة الاستخدام. تأكد من نسخ الجوهر الخاص بك لأنك لن تكون قادرًا على رؤيةها مرة أخرى. AdministratorAccess المديرالموافقة نعود الآن إلى GitHub وإضافة سر المخزون الخاص بك: نعم، الخطوة الأخيرة هي اختبار أن كل شيء يعمل! تحديث app.js الخاص بك ليقول شيئاً آخر؛ كنت تغير مني إلى "ماذا؟ العالم!" exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "What up, World!" }), }; }; exports.lambdaHandler = async (event) => { return { statusCode: 200, body: JSON.stringify({ message: "What up, World!" }), }; }; بعد ذلك، اضغط على التغييرات على النقطة الرئيسية. - تأكد من أنك على النقطة الرئيسية عند الضغط. git add. git commit -m 'updated message' git push حصل على إضافة. git commit -m 'updated message' Git Push في repo GitHub الخاص بك ، يجب أن ترى عملية التنفيذ وتشغيلها بنجاح: أخيرا، عود إلى متصفح الويب الخاص بك ورفع عنوان URL من خريطة API التي قمنا بتحديدها. أنا هي: - وأكدت على التغيير. https://tt40c6vgm3.execute-api.us-east-1.amazonaws.com/Prod https://tt40c6vgm3.execute-api.us-east-1.amazonaws.com/Prod التقييم الحمدلله! لقد قمت بإنشاء خطوط توزيع CI/CD لـ AWS Stack دون مستخدم؛ الآن يمكنك أن تضع خططًا لإنشاء API الخاص بك مع خدمات مفيدة.أخبرني إذا كان هذا المقال مفيدًا أو إذا كان لديك أي أسئلة أو توصيات لتطوير!