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 hai để triển khai từ dòng lệnh. Đầu tiên là 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 nguồn proxy trên hệ thống của bạn. Có nhiều lý do khiến bạn có thể đang làm việc khi không có mạng. Có thể bạn muốn sử dụng một trình soạn thảo XML ưa thích hoặc bạn có thể đang phát triển các chính sách yêu cầu lập trình Java và bạn hoạt động 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 tệp nguồn 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.
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 API proxy. 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. Xem 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 chỉ bằng một thao tác đơn giản của chúng tôi.

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

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

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, rồi triển khai chúng vào môi trường xác định.

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

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 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 Edge tại cơ sở 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 sẽ chỉ định địa chỉ IP của máy chủ quản lý Edge. Nếu bạn đã tạo bản ghi DNS cho máy chủ quản lý, bạn có thể chỉ định URL trong 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 cho tài khoản của bạn trong một tổ chức tại Apigee Cạnh.
  • -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 tệp proxy API của bạn. Proxy API của bạn các tệp 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 "apiproxy" thư mục chứ không phải đường dẫn đến "apiproxy" chính thư mục đó.
  • -p: Đường dẫn URI được dùng làm mẫu so khớp để định tuyến thông báo đến đến API này proxy. Trong hầu hết các trường hợp, bạn có thể đặt giá trị này thành '/', trừ khi bạn đã nâng cao 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 Edge. Theo mặc định, URL là https://api.enterprise.apigee.com, tương ứng với Edge trên đám mây. Để triển khai tại chỗ, hãy sử dụng URL của Edge máy chủ quản lý 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 shell triển khai tập lệnh

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. Vỏ các tập lệnh bao bọc 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]:

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

Khi thành công, công cụ triển khai ZIP sẽ lưu các tệp trong /apiproxy, lệnh nhập gói này cho tổ chức của bạn trên Apigee Edge, rồi triển khai proxy API cho quá trình "kiểm thử" môi trường.

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