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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Chủ đề này giải thích cách triển khai 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 thứ nhất là sử dụng công cụ triển khai Apigee Edge được viết bằng Python. Hai là định cấu hình và chạy tập lệnh shell.

Sử dụng các kỹ thuật triển khai dòng lệnh khi bạn 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 ngoại tuyến. Bạn nên sử dụng một trình chỉnh sửa XML yêu thích, hoặc bạn có thể đang phát triển các chính sách yêu cầu phải lập trình Java và bạn đang làm việc chủ yếu trong 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 vào môi trường Dịch vụ API mà bạn chọn.

Nếu bạn đang làm việc chủ yếu 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.
Tham khảo tài liệu về Apigee X. thông tin

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

Công cụ triển khai Apigee Edge Python hoạt động với API quản lý Edge để nhập và triển khai proxy API. Công cụ này được cung cấp trong quá trình phân phối Mẫu nền tảng API trên GitHub. Hãy xem phần Sử dụng proxy API mẫu.

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

Công cụ triển khai phải được chạy từ thư mục cơ sở trong bản phân phối mẫu nền tảng API, 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 các tệp đó vào tổ chức của bạn trên Apigee Edge và triển khai các tệp đó vào môi trường được 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 một bản sửa đổi tăng dần của proxy API.

Sau khi thành công, bạn sẽ thấy kết quả dưới 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 sẽ tải proxy API lên https://api.enterprise.apigee.com, tương ứng với Edge trên đám mây. Bạn cũng có thể sử dụng công cụ này để tải proxy API lên một phiên bản tại cơ sở của Edge 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 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

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

  • -n: Tên proxy API của bạn.
  • -u: Tên người dùng và mật khẩu của tài khoản của bạn thuộc một tổ chức dùng Apigee.
  • -o: Tên của tổ chức mà bạn có tài khoản.
  • -e: Môi trường mà proxy API sẽ được triển khai (test hoặc prod).
  • -d: Đường dẫn đến thư mục chứa các tệp proxy API của bạn. Các tệp proxy API của bạn phải được lưu trữ trong thư mục có tên "apiproxy". Giá trị này là đường dẫn của thư mục chứa thư mục "api proxy" 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 phương thức so khớp mẫu để định tuyến tin nhắn đến tới quá trình 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 để định tuyến proxy API được xác định trong tệp cấu hình ProxyEndpoint của proxy API.
  • -h: URL cạnh. 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 hoạt động 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ư sau: 
    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 gồm công cụ triển khai Apigee Edge Python.

Trong thư mục /simplyProxy, hãy chạy:

$ 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 của bạn, 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ư 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]:

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

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

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