تكامل API Gateway مع لامبدا: CloudFormation Integration

عند العمل على تكوين مورد بوابة واجهة برمجة التطبيقات (API Gateway) في خدمة Amazon Web Services (AWS) باستخدام قالب CloudFormation، قد تواجه التحدي في تكوين تكامل (Integration) لمورد المصادر (Resource) مع وظيفة لامبدا (Lambda) باستخدام التكامل البروكسي للامبدا (Lambda Proxy Integration). في واجهة تحكم AWS Console، يمكنك بسهولة تحديد هذا التكامل باختيار خانة الاختيار “Use Lambda Proxy Integration”. ومع ذلك، في قالب CloudFormation، لا يوجد حقل مباشر يتيح لك تحديد هذا التكامل.

لحل هذه المشكلة، يمكنك استخدام خاصية “Integration” في مورد “AWS::ApiGateway::Method” وتكوينها لتتماشى مع متطلبات التكامل البروكسي للامبدا. تحتاج إلى تعيين القيمة المناسبة لخاصية “Integration” للوصول إلى نفس النتيجة التي تحصل عليها في واجهة تحكم AWS Console.

في CloudFormation، يمكنك تحقيق ذلك عن طريق تعريف المورد “AWS::ApiGateway::Method” بشكل مشابه للتالي:

yamlCopy code
MyApiMethod:
  Type: AWS::ApiGateway::Method
  Properties:
    RestApiId: !Ref MyRestApi
    ResourceId: !Ref MyResource
    HttpMethod: GET
    AuthorizationType: NONE
    Integration:
      IntegrationHttpMethod: POST
      Type: AWS_PROXY
      Uri: !Sub "arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${MyLambdaFunction.Arn}/invocations"

تأكد من استبدال “MyRestApi” بمعرف مورد الـ API Gateway الخاص بك، و “MyResource” بمعرف مورد المصدر الذي تريد تكامله مع وظيفة اللامبدا. بالإضافة إلى ذلك، استبدل “MyLambdaFunction” بمعرف وظيفة اللامبدا التي ترغب في تكاملها مع المصدر.

من خلال تعريف الخاصية “Integration” بهذه الطريقة، يتم تحقيق التكامل البروكسي للامبدا، مما يتيح لمصادر API Gateway التحويل المباشر للطلبات إلى وظيفة اللامبدا دون الحاجة إلى تكوين إضافي. يقوم التكامل البروكسي بتوجيه جميع بيانات الطلب إلى وظيفة اللامبدا، مما يجعلها تتعامل مباشرة مع الطلب وتستجيب وفقًا للعمليات المعرفة داخل الوظيفة.

باستخدام هذا التعريف في قالب CloudFormation، يمكنك بسهولة تكوين مصادر API Gateway للتكامل السلس مع وظائف Lambda باستخدام التكامل البروكسي.

في السياق نفسه، يجب مراعاة بعض النقاط الهامة عند استخدام التكامل البروكسي للامبدا في CloudFormation:

1. تحديد الطريقة (HTTP Method): في المثال السابق، تم تعيين القيمة “GET” للطريقة HTTP. يجب تعديل هذه القيمة وفقاً للطريقة التي ترغب في استخدامها لمصدر API Gateway الخاص بك، مثل POST أو PUT أو DELETE.

2. الوصول إلى مورد وظيفة اللامبدا: تأكد من أن لديك الإذن الكافي لمورد وظيفة اللامبدا المستهدفة لضمان قدرتك على استدعاء الوظيفة من API Gateway.

3. استبدال القيم المتغيرة: استبدل القيم المتغيرة مثل “MyRestApi” و “MyResource” و “MyLambdaFunction” بالقيم الفعلية التي تنطبق على بنية مورداتك في AWS CloudFormation.

4. فهم تأثير التكامل البروكسي: يجب على المستخدمين فهم أن استخدام التكامل البروكسي للامبدا يؤدي إلى إرسال كل البيانات المتعلقة بالطلب إلى وظيفة اللامبدا، بما في ذلك بيانات الطلب والرأس والمعلومات البيئية. يعني هذا أن وظيفة اللامبدا يمكنها التعامل مباشرة مع الطلب بشكل كامل دون الحاجة إلى تحويل أو معالجة إضافية من جانب API Gateway.

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