Triển khai proxy từ dòng lệnh

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Chủ đề này giải thích cách triển khai một proxy từ dòng lệnh. Apigee Edge cung cấp 2 lựa chọn để triển khai từ dòng lệnh. Cách đầu tiên là sử dụng một công cụ triển khai Apigee Edge được viết bằng Python. Cách khác là định cấu hình và chạy một tập lệnh shell.

Sử dụng các kỹ thuật triển khai dòng lệnh khi bạn đang làm việc trực tiếp với các tệp nguồn proxy trên hệ thống của mình. Có nhiều lý do khiến bạn có thể đang làm việc khi không có mạng. Bạn có thể muốn sử dụng một trình chỉnh sửa XML yêu thích hoặc có thể đang phát triển các chính sách yêu cầu mã hoá Java và bạn chủ yếu làm việc trong một IDE. Các kỹ thuật được mô tả trong phần này cho phép bạn tải lên và triển khai các tệp nguồn của mình vào môi trường Dịch vụ API mà bạn chọn.

Nếu bạn chủ yếu làm việc trong giao diện người dùng quản lý, hãy xem phần Triển khai proxy trong giao diện người dùng.

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Chạy công cụ triển khai Python Apigee Edge

Công cụ triển khai Python Apigee Edge hoạt động với API quản lý Edge để nhập và triển khai các proxy API. Công cụ này có trong bản phân phối API Platform Samples trên GitHub. Xem phần Sử dụng các proxy API mẫu.

Sử dụng công cụ Python của Apigee Edge để nhập (tải lên) và triển khai API của bạn trong một quy trình đơn giản.

Bạn phải chạy công cụ triển khai từ thư mục cơ sở trong bản phân phối của bản phân phối Mẫu API Platform, trong đó thư mục cơ sở là thư mục mẹ của thư mục setup và tools.

Trong lệnh sau, hãy thay thế tên proxy, tên người dùng và mật khẩu Edge, tổ chức và môi trường Edge, cũng như đường dẫn đến thư mục chứa "thư mục apiproxy"" của proxy API:

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

Ví dụ:

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

Lệnh này sẽ nén các tệp của bạn, đẩy chúng đến tổ chức của bạn trên Apigee Edge và triển khai chúng vào môi trường đã chỉ định.

Công cụ triển khai sẽ tự động phát hiện bản sửa đổi hiện tại của proxy API, huỷ triển khai bản sửa đổi hiện có và triển khai bản sửa đổi gia tăng của proxy API.

Khi thành công, bạn sẽ thấy kết quả ở dạng:

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

Theo mặc định, công cụ này tải API proxy lên https://api.enterprise.apigee.com, tương ứng với Edge trên đám mây. Bạn cũng có thể dùng công cụ này để tải API proxy lên phiên bản Edge tại chỗ bằng cách chỉ định cờ -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

Trong ví dụ này, bạn chỉ định địa chỉ IP của máy chủ quản lý Edge. Nếu đã tạo một bản ghi DNS cho máy chủ quản lý, bạn có thể chỉ định một URL theo biểu mẫu sau:

https://ms_URL:8080

Sau đây là danh sách đầy đủ các cờ cho lệnh này:

  • -n: Tên của proxy API.
  • -u: Tên người dùng và mật khẩu cho tài khoản của bạn trong một tổ chức trên Apigee Edge.
  • -o: Tên của tổ chức mà bạn có tài khoản.
  • -e: Môi trường mà bạn nên triển khai proxy API (test hoặc prod).
  • -d: Đường dẫn đến thư mục chứa các tệp proxy API. Các tệp proxy API phải được lưu trữ trong một thư mục có tên là "apiproxy". Giá trị này là đường dẫn của thư mục chứa thư mục "apiproxy" chứ không phải đường dẫn đến chính thư mục "apiproxy".
  • -p: Đường dẫn URI được dùng làm mẫu so khớp để định tuyến thông báo đến cho việc triển khai proxy API này. Trong hầu hết các trường hợp, bạn có thể đặt giá trị này thành "/", trừ phi bạn có các yêu cầu nâng cao về việc triển khai và định tuyến. Đường dẫn chính dùng cho hoạt động định tuyến proxy API được xác định trong tệp cấu hình ProxyEndpoint của proxy API.
  • -h: URL của Edge. Theo mặc định, URL là https://api.enterprise.apigee.com, tương ứng với Edge trên đám mây. Đối với việc triển khai tại cơ sở, hãy sử dụng URL của máy chủ quản lý Edge và cổng 8080, như trong: 
    https://ms_URL:8080

    Hoặc sử dụng địa chỉ IP của máy chủ quản lý, như trong https://192.168.11.111:8080.

Định cấu hình và chạy tập lệnh shell triển khai

Cách dễ nhất là chạy tập lệnh triển khai được cung cấp cùng với proxy API mẫu. Các tập lệnh shell bao bọc công cụ triển khai Python của Apigee Edge.

Chạy từ thư mục /simplyProxy:

$ sh deploy.sh

Bạn sẽ thấy:

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

Nhập mật khẩu rồi nhấn ENTER.

Sau đó, bạn sẽ thấy:

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

Nếu bạn thấy những thông tin sau:

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]:

điều đó có nghĩa là bạn cần sửa đổi tệp /setup/setenv.sh trong bản phân phối mẫu nền tảng. Để biết hướng dẫn, hãy tham khảo tệp README hoặc API Apigee Edge.

Khi thành công, công cụ triển khai sẽ nén các tệp trong /apiproxy,, nhập gói vào tổ chức của bạn trên Apigee Edge, rồi triển khai API proxy vào môi trường "test" (kiểm thử).

API proxy của bạn đã sẵn sàng được gọi.