ขั้นตอนที่ 3: ใช้นโยบายไฮไลต์ของส่วนขยาย

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

เมื่อพัฒนาพร็อกซี API คุณจะเพิ่มการสนับสนุนสำหรับส่วนขยายได้โดยการเพิ่มนโยบาย Extension โปรดเลือกลงในพร็อกซี (หากต้องการความช่วยเหลือในการสร้างพร็อกซีแบบง่าย โปรดดูสร้างพร็อกซีแรกของคุณ)

เมื่อคุณเพิ่มการสนับสนุนสำหรับส่วนขยาย คุณจะเชื่อมโยงนโยบาย ExtensionExtension กับส่วนขยายที่กำหนดค่าแล้ว การตั้งค่าการกำหนดค่าส่วนขยายดังกล่าวจะกำหนดวิธีที่ส่วนขยายจะโต้ตอบกับทรัพยากรแบ็กเอนด์ที่เชื่อมต่ออยู่ โดยเป็นส่วนขยายที่กำหนดค่าโดยเฉพาะนี้ซึ่งมีนโยบาย Extensionต้องระบุ รวมเข้ากับพร็อกซี API

วิธีเพิ่มส่วนขยายลงในพร็อกซี API

1. เปิดพร็อกซี API ในคอนโซล Apigee Edge ในมุมมองพัฒนา

   แม้ว่าคุณจะต้องเป็นผู้ดูแลระบบขององค์กรจึงจะสร้างส่วนขยายได้ แต่บทบาทของผู้ใช้ทุกบทบาทจะเพิ่มส่วนขยายไปยังพร็อกซี API ได้

2. ในแผง Navigator ให้เลือก PreFlow

   

3. ที่มุมบนขวา ให้คลิกปุ่ม + ขั้นตอนเพื่อเพิ่มนโยบาย

   

4. ในกล่องโต้ตอบเพิ่มขั้นตอน ให้คลิกไฮไลต์ของส่วนขยายในรายการนโยบายทางด้านซ้าย

   

   หากคุณไม่เห็นนโยบาย ExtensionExtension ในรายการ ให้ตรวจสอบว่าคุณใช้ Edge UI ใหม่ นอกจากนี้ ปัจจุบันส่วนขยาย Apigee มีให้บริการเฉพาะลูกค้า Apigee Edge Cloud Enterprise เท่านั้น

5. เลือกตัวเลือกเพื่อกำหนดค่านโยบายในแผงด้านขวา ดังนี้

   ฟิลด์	คำอธิบาย
   ชื่อที่แสดง	ป้อนชื่อที่แสดงของนโยบาย
   ชื่อ	ป้อนชื่อที่จะใช้สำหรับนโยบายแบบเป็นโปรแกรม ชื่อนี้ต้องไม่ซ้ำกันในพร็อกซี
   นามสกุลไฟล์	เลือกส่วนขยายที่ต้องการใช้ นี่คือส่วนขยายที่คุณกำหนดค่าไว้ก่อนหน้านี้
   การดำเนินการ	เลือกการดำเนินการ "บันทึก"

6. คลิกเพิ่ม
7. ในมุมมองโฟลว์ ให้คลิกนโยบายเพื่อดู XML การกำหนดค่า

   

   เมื่อเพิ่มส่วนขยาย คุณจะได้รับ XML ของนโยบายตัวอย่าง โปรดทราบว่ารายงานนี้มีสคีมาที่อธิบายวิธีจัดโครงสร้างการกำหนดค่าสำหรับองค์ประกอบ <Input> (คุณไม่จำเป็นต้องสนใจสคีมาขององค์ประกอบ <Output> ก็ได้ เพราะการดำเนินการ "log" ของส่วนขยายจะไม่แสดงเนื้อหาการตอบกลับ)

8. แก้ไข XML ของนโยบายให้มีลักษณะดังต่อไปนี้

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
     <DisplayName>Logging Extension</DisplayName>
     <Connector>my-logging-extension</Connector>
     <Action>log</Action>
     <Input>{
       "logName": "example-log",
       "metadata": {
         "resource": {
           "type": "global",
           "labels": {
             "project_id": "my-gcp-project"
           }
         }
       },
       "message": "This is a test"
     }</Input>
   </ConnectorCallout><!--
   Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
   -->
   <!--
   Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
   -->

   ในที่นี้ <Input> ให้คำจำกัดความไว้ดังนี้

   • logName คือชื่อของบันทึกที่จะเขียน หากไม่มีอยู่ ส่วนขยายจะสร้างขึ้น
   • metadata ระบุข้อมูลที่ใช้เรียกดูบันทึกได้ในคอนโซล Stackdriver
   • message ก็คือข้อความในบันทึกที่คุณต้องการเขียน
9. คลิกปุ่มบันทึก

ขั้นตอนถัดไป

ขั้นตอนที่ 1 ขั้นตอนที่ 2 ขั้นตอนที่ 3 ขั้นตอนที่ 4: ทำให้พร็อกซีใช้งานได้ ขั้นตอนที่ 5