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

คุณกำลังดูเอกสารประกอบของ 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 และเส้นทางไปยังไดเรกทอรีที่มีไดเรกทอรี "apiproxy"" ของพร็อกซี API:

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 เวอร์ชันภายในองค์กรได้โดยระบุแฟล็ก -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

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

วิธีที่ง่ายที่สุดคือการเรียกใช้สคริปต์ทำให้ใช้งานได้ที่มีให้พร้อมกับพร็อกซี API ตัวอย่าง สคริปต์ Shell จะรวมเครื่องมือการทำให้ 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 พร้อมที่จะเรียกใช้แล้ว