การทำให้พร็อกซีใช้งานได้จากบรรทัดคำสั่ง

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

หัวข้อนี้จะอธิบายวิธีทำให้พร็อกซีใช้งานได้จากบรรทัดคำสั่ง Apigee Edge มี 2 สิ่งนี้ เพื่อทำให้ใช้งานได้จากบรรทัดคำสั่ง ตัวเลือกแรกคือการใช้เครื่องมือทำให้ Apigee Edge ใช้งานได้ ที่เขียนด้วยภาษา Python อีกลิงก์หนึ่งคือการกำหนดค่าและเรียกใช้สคริปต์ Shell

ใช้เทคนิคการทำให้บรรทัดคำสั่งใช้งานได้เมื่อคุณทำงานกับแหล่งที่มาของพร็อกซีโดยตรง ไฟล์ในระบบของคุณ มีเหตุผลหลายประการที่ทำให้คุณทำงานแบบออฟไลน์ คุณอาจต้องการใช้ ตัวแก้ไข XML ที่คุณชื่นชอบ หรือคุณอาจกำลังพัฒนานโยบาย ที่จำเป็นต้องใช้การเขียนโค้ด Java และคุณ ทำงานใน IDE เป็นหลัก เทคนิคที่อธิบายในส่วนนี้จะช่วยให้คุณสามารถอัปโหลดและ ทำให้ไฟล์ต้นฉบับใช้งานได้กับสภาพแวดล้อมของบริการ API ที่คุณเลือก

หากคุณทำงานใน UI การจัดการเป็นหลัก โปรดดูการทำให้พร็อกซีใช้งานได้ใน UI

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

การเรียกใช้เครื่องมือทำให้ Apigee Edge Python ใช้งานได้

เครื่องมือการทำให้ Apigee Edge Python ใช้งานได้จะทำงานร่วมกับ Edge Management API เพื่อนำเข้าและทำให้ API ใช้งานได้ พร็อกซี เครื่องมือนี้พร้อมให้ใช้งานเป็นส่วนหนึ่งของการกระจายตัวอย่างแพลตฟอร์ม API ใน GitHub โปรดดู การใช้พร็อกซี API ตัวอย่าง

ใช้เครื่องมือ Apigee Edge Python เพื่อนำเข้า (อัปโหลด) และติดตั้งใช้งาน API ได้ง่ายๆ ในที่เดียว ขั้นตอนได้

เครื่องมือทำให้ใช้งานได้ต้องเรียกใช้จากไดเรกทอรีฐานในการกระจายของแพลตฟอร์ม API การกระจายตัวอย่าง โดยที่ไดเรกทอรีฐานเป็นไดเรกทอรีระดับบนของ setup และไดเรกทอรี tools

ในคำสั่งต่อไปนี้ ให้ใช้ชื่อพร็อกซี, ชื่อผู้ใช้และรหัสผ่าน Edge และ Edge แทน องค์กรและสภาพแวดล้อม และเส้นทางไปยังไดเรกทอรีที่มีพร็อกซี API "ไดเรกทอรี apiproxy":

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

เช่น

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

คำสั่งนี้จะบีบอัดไฟล์ พุชไปยังองค์กรของคุณใน Apigee Edge และติดตั้งใช้งานได้ ลงในสภาพแวดล้อมที่ระบุ

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

เมื่อทำสำเร็จ คุณจะเห็นเอาต์พุตในแบบฟอร์ม:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

โดยค่าเริ่มต้น เครื่องมือจะอัปโหลดพร็อกซี API ไปยัง https://api.enterprise.apigee.com ที่สอดคล้องกับ Edge ในระบบคลาวด์ คุณยังสามารถใช้เครื่องมือนี้เพื่ออัปโหลดพร็อกซี API ไปยัง Edge เวอร์ชันภายในองค์กรด้วยการระบุ Flag -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

ในตัวอย่างนี้ คุณจะระบุที่อยู่ IP ของเซิร์ฟเวอร์การจัดการ Edge หากคุณสร้าง ระเบียน DNS สำหรับเซิร์ฟเวอร์การจัดการ คุณสามารถระบุ URL ในรูปแบบต่อไปนี้

https://ms_URL:8080

รายการแฟล็กทั้งหมดสำหรับคำสั่งมีดังนี้

  • -n: ชื่อพร็อกซี API
  • -u: ชื่อผู้ใช้และรหัสผ่านสำหรับบัญชีของคุณในองค์กรใน Apigee Edge
  • -o: ชื่อองค์กรที่คุณมีบัญชี
  • -e: สภาพแวดล้อมที่ควรทำให้พร็อกซี API ใช้งานได้ (test หรือ prod)
  • -d: เส้นทางไปยังไดเรกทอรีที่มีไฟล์พร็อกซี API พร็อกซี API ของคุณ ต้องจัดเก็บไฟล์ภายใต้ไดเรกทอรีที่ชื่อ "apiproxy" ค่านี้คือเส้นทางของ ไดเรกทอรีที่มี "apiproxy" ไม่ใช่เส้นทางไปยัง "apiproxy" ของไดเรกทอรีนั้นๆ
  • -p: เส้นทาง URI ที่ใช้เป็นการจับคู่รูปแบบเพื่อกำหนดเส้นทางข้อความขาเข้าไปยัง API นี้ การทำให้พร็อกซีใช้งานได้ ในกรณีส่วนใหญ่ คุณสามารถตั้งค่านี้เป็น "/" เว้นแต่ว่าคุณตั้งค่าขั้นสูง การติดตั้งใช้งานและการกำหนดเส้นทาง ระบบจะกำหนดเส้นทางหลักที่ใช้สำหรับการกำหนดเส้นทางพร็อกซี API ใน ไฟล์การกำหนดค่า ProxyEndpoint ของพร็อกซี API
  • -h: URL ของ Edge โดยค่าเริ่มต้น URL จะเป็น https://api.enterprise.apigee.com ที่สอดคล้องกับ Edge ในระบบคลาวด์ สำหรับการทำให้ใช้งานได้ภายในองค์กร ให้ใช้ URL ของ Edge เซิร์ฟเวอร์การจัดการและพอร์ต 8080 เช่น 
    https://ms_URL:8080

    หรือใช้ที่อยู่ IP ของเซิร์ฟเวอร์การจัดการ เช่น https://192.168.11.111:8080

การกำหนดค่าและเรียกใช้เชลล์การทำให้ใช้งานได้ แบบตัวเขียน

วิธีที่ง่ายที่สุดคือการเรียกใช้สคริปต์การติดตั้งใช้งานที่มาพร้อมกับพร็อกซี API ตัวอย่าง เปลือกหอย สคริปต์จะรวมเครื่องมือติดตั้งใช้งาน Apigee Edge Python ไว้ด้วยกัน

จากการเรียกใช้ไดเรกทอรี /simplyProxy:

$ sh deploy.sh

คุณควรจะเห็นสิ่งต่อไปนี้

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

ป้อนรหัสผ่าน แล้วกด ENTER

จากนั้นคุณควรจะเห็นสิ่งต่อไปนี้

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

หากคุณเห็นสิ่งต่อไปนี้

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

หมายความว่าคุณต้องแก้ไขไฟล์ /setup/setenv.sh ใน ของแพลตฟอร์มตัวอย่าง โปรดดูวิธีการที่หัวข้อ README หรือ Apigee Edge API

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

พร็อกซี API พร้อมที่จะเรียกใช้แล้ว