ภาพรวมเป้าหมายที่โฮสต์

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

เป้าหมายที่โฮสต์ช่วยให้คุณเรียกใช้แอปพลิเคชัน Node.js ในรันไทม์แบบเนทีฟที่โฮสต์โดย Apigee เป้าหมายของเป้าหมายที่โฮสต์นั้นง่ายมาก นั่นคือช่วยให้คุณติดตั้งใช้งานแอปพลิเคชันในสภาพแวดล้อมแบบเนทีฟที่ปลอดภัย ปรับขนาดได้ และแยกส่วน ซึ่งพร็อกซี Edge API สามารถเรียกใช้แอปพลิเคชันเหล่านั้นเป็นบริการเป้าหมายได้

ดังที่รูปภาพต่อไปนี้แสดง พารามิเตอร์ของ Edge API จะเรียกแอปพลิเคชัน Node.js ที่ติดตั้งใช้งานในสภาพแวดล้อมเป้าหมายที่โฮสต์ โปรดทราบว่าสภาพแวดล้อมเป้าหมายที่โฮสต์มีการกำหนดขอบเขตภายในองค์กร Apigee:environment

การรับพร็อกซี Edge API เพื่อติดต่อกับแอปพลิเคชันเป้าหมายที่โฮสต์ไว้อย่างเหมาะสมและทำให้ใช้งานได้แล้ว จะต้องมีการกำหนดค่าแบบง่ายในปลายทางเป้าหมายของพร็อกซี หากต้องการเริ่มต้นใช้งาน ให้ไปที่บทแนะนำเกี่ยวกับ Hosted Targets

เป้าหมายที่โฮสต์รองรับรันไทม์ของแอปพลิเคชันใดบ้าง

ปัจจุบันคุณสามารถทำให้แอป Node.js ใช้งานได้กับเป้าหมายที่โฮสต์เท่านั้น

การติดตั้งเป้าหมายที่โฮสต์

เป้าหมายที่โฮสต์ไว้จะพร้อมใช้งานในองค์กร Edge Public Cloud ทั้งหมด คุณไม่จําเป็นต้องติดตั้งสิ่งใดเพื่อใช้เป้าหมายที่โฮสต์

การยืนยันว่าเป้าหมายที่โฮสต์เปิดใช้อยู่

หากต้องการยืนยันว่าองค์กรเปิดใช้เป้าหมายที่โฮสต์แล้ว ให้ดูรายละเอียดองค์กรและตรวจสอบว่าพร็อพเพอร์ตี้ features.isEdgeFunctionsEnabled ตั้งค่าเป็น "จริง" พร็อพเพอร์ตี้เป็นแบบอ่านอย่างเดียว

เช่น

https://api.enterprise.apigee.com/v1/organizations/myorg

  {
     "createdAt":1507572884047,
     "createdBy":"jdoe@apigee.com",
     "displayName":"myorg",
     "environments":[
        "prod",
        "dev",
        "test",
        "portal"
     ],
     "lastModifiedAt":1507578673194,
     "lastModifiedBy":"jdoe@apigee.com",
     "name":"jdoe",
     "properties":{
        "property":[
           {
              "name":"features.isSmbOrganization",
              "value":"false"
           },
           {
              "name":"self.service.virtual.host.enabled",
              "value":"true"
           },
           {
              "name":"features.isCpsEnabled",
              "value":"true"
           },
           {
              "name":"features.isEdgeFunctionsEnabled",
              "value":"true"
           }
        ]
     },
     "type":"paid"
  }
  

สิ่งที่คุณต้องรู้เกี่ยวกับเป้าหมายที่โฮสต์

เป้าหมายที่โฮสต์ช่วยให้แอปพลิเคชัน Node.js ทำงานในสภาพแวดล้อมแบบเนทีฟซึ่งไม่ใช้เทคโนโลยีรันไทม์เฉพาะของ Apigee คุณแก้ไขข้อบกพร่องและทดสอบ แอปในเครื่องก่อนทำให้ใช้งานได้ และมั่นใจได้ว่าเวอร์ชันที่ทำให้ใช้งานได้แล้ว จะทำงาน แบบเดียวกับที่ทำในเครื่อง คุณจะเลือกรันไทม์เวอร์ชันใดก็ได้สำหรับรันแอปพลิเคชันในเป้าหมายที่โฮสต์ ณ เวลาที่มีการติดตั้งใช้งาน เช่น คุณอาจเลือกที่จะเรียกใช้แอป Node.js ในสภาพแวดล้อม v8.10.0 โดยเฉพาะ

จำกัดสูงสุด

สำหรับขีดจำกัดการใช้งานเป้าหมายที่โฮสต์ โปรดดูขีดจำกัดผลิตภัณฑ์ Apigee

ขั้นตอนพื้นฐานที่ต้องทำ

หากคุ้นเคยกับการพัฒนาพร็อกซี Edge คุณก็เพียงต้องเรียนรู้ขั้นตอนง่ายๆ 2-3 ขั้นตอนเพื่อใช้เป้าหมายที่โฮสต์ได้สําเร็จ โดยพื้นฐานแล้ว คุณจะสร้าง ทำให้ใช้งานได้ และจัดการพร็อกซี Edge สำหรับเป้าหมายที่โฮสต์ได้เช่นเดียวกับที่คุณทำกับพร็อกซี Apigee Edge อื่นๆ

หากต้องการใช้เป้าหมายที่โฮสต์ คุณต้องทำงานต่อไปนี้ บทแนะนำจะอธิบายแต่ละงานเหล่านี้อย่างละเอียด

  • พัฒนาและทดสอบแอปพลิเคชัน Node.js ในเครื่อง
  • สร้างไฟล์ Manifest ในไดเรกทอรีรูทของโปรเจ็กต์แอปพลิเคชัน ไฟล์ Manifest คือไฟล์ YAML ที่ระบุข้อมูลที่จำเป็นในการสร้างและทำให้แอปพลิเคชันใช้งานได้
  • เพิ่มแอปพลิเคชันลงในพร็อกซี Edge เป็นประเภททรัพยากรที่โฮสต์
  • ในปลายทางเป้าหมายของพร็อกซี ให้เพิ่มแท็ก <HostedTarget/> ที่ว่างเปล่า แท็กนี้จะบอกให้ Edge ติดตั้งใช้งานแอปพลิเคชัน Node.js ในสภาพแวดล้อมเป้าหมายที่โฮสต์ เช่น
  • <?xml version="1.0" encoding="UTF-8"?>
    <TargetEndpoint name="default">
       <PreFlow name="PreFlow">
          <Request />
          <Response />
       </PreFlow>
       <PostFlow name="PostFlow">
          <Request />
          <Response />
       </PostFlow>
       <Flows />
       <HostedTarget />
    </TargetEndpoint>

ขอบเขตของแอปพลิเคชันเป้าหมายที่โฮสต์

แอปพลิเคชันเป้าหมายที่โฮสต์จะมีขอบเขตเป็นองค์กร-สภาพแวดล้อม Edge การกําหนดขอบเขตนี้เหมือนกับพร็อกซี Edge

แอปพลิเคชันเป้าหมายที่โฮสต์เข้าถึงข้อมูลพร็อกซีได้ไหม

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

เมื่อใช้ Node.js ที่ฝัง (การรองรับ Node.js แบบดั้งเดิมที่ใช้ Trireme ใน Edge) คุณจะใช้ apigee-access เพื่อเข้าถึงตัวแปรของโฟลว์และเอนทิตีอื่นๆ ใน Edge ได้ อย่างไรก็ตาม เป้าหมายที่โฮสต์ไม่รองรับข้อบังคับ apigee-access สําหรับการติดตั้งใช้งาน Node.js ดูข้อมูลเพิ่มเติมได้ที่ หากไม่มี apigee-access จะแก้ปัญหาได้อย่างไร

การย้ายข้อมูลโค้ดแอปพลิเคชันที่มีอยู่ไปยังเป้าหมายที่โฮสต์

ปัจจุบันยังไม่มีเส้นทางการย้ายข้อมูลอัตโนมัติจากแอปพลิเคชัน Node.js แบบฝังตัวที่ใช้ Trireme ไปยังเป้าหมายที่โฮสต์ไว้ อย่างไรก็ตาม คุณสามารถแปลงโค้ดแอปพลิเคชันที่มีอยู่ให้เป็นเป้าหมายที่โฮสต์ได้ด้วยตนเอง ดูตัวอย่างได้ที่การย้ายข้อมูลพร็อกซี Node.js ที่มีอยู่ไปยังพร็อกซีเป้าหมายที่โฮสต์