Câu hỏi thường gặp về Edge Microgateway

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

Bắt đầu

Làm cách nào để cài đặt Edge Microgateway?

Xem Cài đặt Microgateway.

Làm cách nào để chạy Edge Microgateway?

Xem Thiết lập và định cấu hình Edge Microgateway.

Tôi có cần cơ sở dữ liệu để chạy không Cổng nhỏ?

Các API được proxy thông qua Edge Microgateway có thể tương tác với cơ sở dữ liệu đang chạy như một phần của mục tiêu . Tuy nhiên, Edge Microgateway hoạt động độc lập với mọi cơ sở dữ liệu hoặc dữ liệu phụ trợ của bạn.

Hoạt động

Những thay đổi trên Edge cần khởi động lại Edge Microgateway không?

Edge Microgateway tự động thăm dò ý kiến những thay đổi đối với Apigee Edge, chẳng hạn như các thay đổi đối với các proxy, sản phẩm hoặc nhà phát triển nhận biết microgateway của chúng tôi. Khoảng thời gian thăm dò mặc định là 600 giây; tuy nhiên, bạn có thể thay đổi khoảng thời gian bằng Chế độ cài đặt cấu hình config_change_poll_interval. Xem các thuộc tính Edgemicro.

Nếu bạn không muốn đợi khoảng thời gian thăm dò ý kiến, hãy sử dụng edgemicro reload để chọn các thay đổi mới nhất. Xem Đang tải lại cụm cổng vi mô.

Làm cách nào để phân biệt giữa proxy được triển khai trên Edge và proxy trên Edge Microgateway?

Khi bạn định cấu hình cho Edge Microgateway, một danh sách các proxy nhận biết cổng vi mô được triển khai trên Apigee Edge sẽ được tải xuống cấu hình cục bộ của Edge Microgateway. Proxy nhận biết cổng vi mô là các biến được đặt tên bằng tiền tố edgemicro_.

Tôi có thể dùng những lựa chọn nào để ghi nhật ký bằng Edge Microgateway?

Edge Microgateway có tính năng ghi nhật ký được tích hợp sẵn. Để biết chi tiết, hãy xem Quản lý tệp nhật ký.

Bạn cũng có thể viết một trình bổ trợ tuỳ chỉnh để sử dụng dịch vụ ghi nhật ký của bên thứ ba bằng Edge Microgateway. Vì nhân đường Edge Microgateway đã hoạt động nên bạn không thể dùng Apigee Edge Chính sách ghi nhật ký tin nhắn để ghi nhật ký thông báo cho Edge Microgateway. Xem thêm Bài viết cộng đồng về Trình bổ trợ ghi nhật ký cho Microgateway.

Tôi có thể sử dụng lại tổ hợp khoá/bí mật giữa các phiên bản của Edge Microgateway không?

Miễn là cách tổ chức và môi trường trên các thực thể Microgateway giống nhau, bạn có thể sử dụng lại cặp khoá/bí mật được tạo trong quá trình định cấu hình.

Làm cách nào để định cấu hình Edge Microgateway để khởi động trong môi trường phát hành công khai?

Bạn có thể thiết lập biến môi trường cho các tham số lệnh khởi động, chẳng hạn như EDGEMICRO_KEY, EDGEMICRO_SECRET, EDGEMICRO_ORG và EDGEMICRO_ENV. Với các biến này (và các biến khác), bạn có thể bắt đầu Edge Microgateway bằng lệnh duy nhất edgemicro start. Xem thêm Đặt biến môi trường.

Tôi có thể sử dụng thuộc tính sản phẩm tuỳ chỉnh hoặc thuộc tính ứng dụng của nhà phát triển với Edge Microgateway?

Không. Theo mặc định, Edge Microgateway chỉ hoạt động trên các thuộc tính liên quan đến việc định tuyến cơ bản và bảo mật. Tuy nhiên, để giải quyết vấn đề, bạn có các lựa chọn sau:

1. Thêm các thuộc tính tuỳ chỉnh vào proxy edgemicro-auth mà Edge Microgateway triển khai cho Apigee Cạnh. Các thuộc tính này sẽ có sẵn khi sử dụng Khoá API hoặc mã thông báo OAuth.
2. Sửa đổi trình bổ trợ OAuth để hành động trên các thuộc tính đó.

Có giới hạn về kích thước tiêu đề yêu cầu không?

Nếu bạn nâng cấp Node.js lên v8.14.0 hoặc phiên bản mới hơn, lưu ý rằng kích thước tiêu đề tối đa được phép đối với các yêu cầu đã giảm từ 80KB xuống 8KB. Những tiêu đề vượt quá 8KB sẽ gây ra lỗi HTTP 431.

Tuỳ chọn cấu hình Node.js được thêm vào Node.js phiên bản 11.6.0 cho phép bạn thay đổi tuỳ chọn tối đa mặc định kích thước tiêu đề. Tham số --max-http-header-size này cho phép bạn chỉ định kích thước tối đa (tính bằng byte) của tiêu đề HTTP.

Để thay đổi cấu hình mặc định, hãy đặt giá trị của môi trường NODE_OPTIONS biến trên dòng lệnh như sau:

NODE_OPTIONS=--max-http-header-size=NUM_BYTES

Ví dụ:

NODE_OPTIONS=--max-http-header-size=80000

Edge Microgateway sử dụng API quản lý nào?

Triển khai

Tôi có thể triển khai không Edge Microgateway trên cùng một máy chủ nơi dịch vụ đích của tôi đang chạy?

Có. Edge Microgateway là một quy trình đơn giản, có thể chạy gần dịch vụ mục tiêu của bạn, bao gồm cùng một máy.

Tôi có thể triển khai gói proxy Edge hiện có dưới dạng hoạt động triển khai Edge Microgateway không?

Không. Những proxy nhận biết được Edge Microgateway có các yêu cầu cụ thể và không hỗ trợ tất cả các tính năng này proxy Edge thông thường. Xem Phần 2: Tạo thực thể trên Apigee Edge

Tôi có thể bật tính năng chuyển đổi dự phòng giữa gói proxy Edge có được không và triển khai Edge Microgateway cho cùng một Proxy API không?

Không. Edge Microgateway không biết về việc triển khai proxy API không theo cổng nhỏ trên Apigee Cạnh.

mô hình triển khai có tính sẵn sàng cao cho Edge Microgateway không?

Để thảo luận về cách chạy Edge Microgateway bằng NGINX làm trình cân bằng tải, hãy xem Quản lý API bằng Apigee Edge Microgateway và NGINX.

Tôi có thể sử dụng trình cân bằng tải nào với Edge Microgateway?

Edge Microgateway có thể hoạt động với mọi trình cân bằng tải.

Có giới hạn nào về số lượng proxy Edge Microgateway mà tôi có thể triển khai không?

Tham khảo giới hạn cấu hình sản phẩm được chỉ định cho proxy Edge thông thường. Số lượng proxy có thể nhận biết microgateway mà bạn có thể triển khai trong Apigee Edge tổ chức, môi trường và cuộc gọi qua Edge Microgateway phải tuân thủ cùng các giới hạn đó.

Tôi có thể liên kết việc triển khai Edge Microgateway của tôi với một tổ chức và môi trường cụ thể không?

Khi định cấu hình một phiên bản của Edge Microgateway, bạn phải liên kết phiên bản đó với một phiên bản Môi trường và tổ chức biên.

Tôi có thể liên kết việc triển khai Edge Microgateway với một khu vực cụ thể không (nếu tôi là khách hàng đa khu vực)?

Edge Microgateway tự động chọn khu vực phù hợp nhất để tương tác với Apigee Edge. Bạn có thể triển khai các phiên bản Edge Microgateway ở từng khu vực mà bạn muốn cung cấp dịch vụ.

Quản trị

Tôi có cần phải là quản trị viên tổ chức để định cấu hình và triển khai Edge Microgateway không?

Có. Bạn cần có thông tin đăng nhập của quản trị viên tổ chức để định cấu hình và triển khai Edge Microgateway.

Tôi có cần phải là quản trị viên tổ chức để chạy Edge Microgateway không?

Không. Edge Microgateway là một ứng dụng Node.js mà bất cứ ai có quyền chạy các ứng dụng như vậy trên một máy cụ thể.

Bất kỳ tổ chức nào của tôi có thể người dùng sử dụng Edge Microgateway?

Bạn không cần phải là người dùng trong tổ chức Apigee Edge để gọi API thông qua Edge Cổng nhỏ. Tuy nhiên, bạn phải có quyền ở cấp tổ chức để tạo hoặc thay đổi Edge Microgateway được triển khai trên Edge.

Hiệu suất

Những điểm cần cân nhắc về hiệu suất khi sử dụng Edge Microgateway là gì?

Nếu việc chạy Edge Microgateway cùng vị trí với ứng dụng đích, hãy đảm bảo máy chủ đã đủ dung lượng.

Đâu là các phương pháp hay nhất để chạy Edge Microgateway trên quy mô lớn?

Apigee khuyên bạn nên chạy nhiều phiên bản của Edge Microgateway trên các máy chủ khác nhau bởi trình cân bằng tải như NGINX. Xem thêm Quản lý API bằng Apigee Edge Microgateway và NGINX và Điều chỉnh tỷ lệ theo chiều dọc theo chiều ngang trong Cộng đồng Apigee.

TPS của Edge Microgateway là gì theo mặc định và những yêu cầu về phần cứng để Thực thể Microgateway

Các yêu cầu về phần cứng và số liệu đo lường TPS rất khó đánh giá bằng Edge Microgateway. Tuỳ trường hợp trong quá trình thiết lập, điều này là sự kết hợp giữa điều chỉnh Edge Microgateway, cách sử dụng trình bổ trợ, các trình bổ trợ tuỳ chỉnh, và định cấu hình các tính năng khác như TLS. Apigee thường khuyên bạn nên nêu ra ý tưởng đó kết hợp các mục và thực hiện thử nghiệm hiệu suất với thiết lập cụ thể của bạn.

Triển khai trên đám mây riêng tư

Có sử dụng Edge Microgateway có hoạt động với Edge dành cho Cloud riêng tư không?

Có. Để biết chi tiết, hãy xem Các bước định cấu hình Đám mây riêng tư của Apigee.

Trình bổ trợ

Cách thực thi Hạn mức bằng Edge Cổng nhỏ?

Bạn có thể tuỳ ý thêm trình bổ trợ hạn mức vào phiên bản Edge Microgateway. Để biết chi tiết, hãy xem Sử dụng hạn mức trình bổ trợ.

Hiện tượng Spike bắt giữ như thế nào thực thi bằng Edge Microgateway không?

Bạn có thể tuỳ ý thêm trình bổ trợ chặn tăng đột biến vào bản sao của Edge Microgateway. Cho để biết chi tiết, hãy xem Sử dụng mức tăng đột biến trình bổ trợ bắt giữ.

Là có cách nào khác để viết trình bổ trợ ngoài Node.js cho Edge Microgateway không?

Không. Trình bổ trợ phải được viết bằng Node.js.

Điều gì xảy ra khi Edge Microgateway không thể tải dữ liệu Analytics lên Edge?

Edge Microgateway có vùng đệm trong bộ nhớ. Nếu vùng đệm đầy, các tải trọng cũ hơn sẽ bị loại bỏ để lưu lượng truy cập API lưu thông suôn sẻ.

Tôi có thể thêm chính sách vào Edge không? Cổng nhỏ?

Nếu bạn đính kèm các chính sách thông thường của Apigee Edge để nhận biết cổng vi mô các proxy trong Apigee Edge, thì các proxy này sẽ bị bỏ qua. Thay vào đó, Edge Microgateway sử dụng trình bổ trợ để cung cấp có chức năng tương tự như các chính sách trong Edge, chẳng hạn như hạn mức, hạn chế tăng đột biến, bảo mật khoá API và Bảo mật OAuth2. Bạn cũng có thể viết các trình bổ trợ tuỳ chỉnh. Xem Sử dụng trình bổ trợ và Phát triển trình bổ trợ tuỳ chỉnh.

Các bài đăng và blog sau đây trên thẻ Cộng đồng Apigee thảo luận về các trường hợp sử dụng trình bổ trợ khác:

• Cách ghi đè URL mặc định trên Edge Microgateway
• Cách để Hạn mức hoạt động trong Edge Microgateway
• Thêm trình bổ trợ trình ghi nhật ký vào Edge Microgateway

Bảo mật

Làm cách nào để bảo vệ tài nguyên /products?

Tổng quan

Khi bạn định cấu hình Edge Microgateway, một proxy API có tên là edgemicro-auth được triển khai cho tổ chức của bạn:environment trên Apigee Edge. Proxy này hiển thị một điểm cuối /products trả về một các sản phẩm API. Bạn nên cài đặt Edge Microgateway từ ngày 5 tháng 10 năm 2018 trở về trước rằng bạn thực hiện các bước để bảo vệ điểm cuối này, vì các phản hồi chứa địa chỉ email của nhà phát triển đã tạo và sửa đổi các sản phẩm API trong Apigee của bạn tổ chức.

Bạn có thể bảo vệ điểm cuối bằng cách nâng cấp Edge Microgateway hoặc bằng cách định cấu hình Mutual TLS (Bảo mật tầng truyền tải tương tác). Cả hai trong các tuỳ chọn này được mô tả bên dưới.

Kiểm tra xem điểm cuối /products có được bảo vệ hay không

Nếu bạn không chắc liệu điểm cuối /products có được bảo vệ hay không, hãy chuyển đến phần này Xác minh tài nguyên /products được bảo vệ và thực hiện các bước trong đó trước khi tiếp tục.

Lựa chọn 1: Nâng cấp Edge Microgateway

Nếu đã cài đặt Edge Microgateway từ ngày 5 tháng 10 năm 2018 trở về trước, bạn nên nâng cấp lên phiên bản mới nhất của Edge Microgateway. Làm theo các bước trong Nâng cấp Edge Microgateway nếu bạn có kết nối Internet.

Nếu bạn không thể nâng cấp tại thời điểm này, hãy chuyển đến Lựa chọn 2.

Cách 2: Định cấu hình TLS tương hỗ

Nếu hiện tại bạn không thể nâng cấp Edge Microgateway, thì Apigee nên bạn bảo vệ hoạt động giao tiếp giữa Edge Microgateway và proxy edgemicro-auth với nhau TLS (còn được gọi là TLS hai chiều).

1. Mở tệp $HOME/.edgemicro/org-env-config.yaml. Xem Edge Microgateway được cài đặt ở đâu nếu bạn không tìm được tệp này.
2. Thêm khối tlsOptions sau vào Tệp org-env-config.yaml để bật TLS lẫn nhau giữa Edge Microgateway và Apigee Edge:

   edge_config:
     bootstrap: >-
       https://domain/edgemicro/bootstrap/organization/org/environment/env
     jwt_public_key: 'https://domain/edgemicro-auth/publicKey'
     managementUri: 'https://api.enterprise.apigee.com'
     tlsOptions:
       agentOptions:
         requestCert: true
         cert: 'path/to/cert'
         key: 'path/to/key'

   Ví dụ:

   tlsOptions:
     agentOptions:
       requestCert: true
       cert: '/Users/jdoe/twowayssl/ssl/client.key'
       key: '/Users/jdoe/twowayssl/ssl/ca.crt'

   Bạn cũng có thể thêm các tham số agentOptions không bắt buộc sau đây:

   • ca: Chỉ định đường dẫn đến tổ chức phát hành chứng chỉ.
   • pfx: Hãy đưa vào nếu bạn muốn sử dụng tệp p12/pfx thay vì chứng chỉ và khoá.
   • passphrase: Cụm mật khẩu dành cho tệp pfx.
   • ciphers: Chỉ định thuật toán mật mã TLS.
3. Đảm bảo máy chủ ảo mà proxy edgemicro-auth được triển khai đã bật TLS chung. Để biết thông tin chi tiết, hãy xem nội dung Xác định máy chủ ảo cho TLS hai chiều trong tài liệu về Apigee Edge.

   Ảnh chụp màn hình sau đây cho thấy cách bật TLS tương hỗ trên một máy chủ ảo trong giao diện người dùng Apigee Edge:

   
4. Xem proxy API edgemicro-auth trong giao diện người dùng Edge và đảm bảo rằng máy chủ ảo chính xác được chỉ định trong cấu hình proxy. Ví dụ: nếu bạn đã tạo một TLS có bật máy chủ ảo có tên mutualtls, khổ HTTPProxyConnection của proxy sẽ có dạng như sau:

   <HTTPProxyConnection>
       <BasePath>/edgemicro-auth</BasePath>
       <Properties/>
       <VirtualHost>mutualtls</VirtualHost>
   </HTTPProxyConnection>

curl -v https://your_domain/edgemicro-auth/products

{
  "error":"unauthorized",
  "error_description": "authentication failed"
}

curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number

{
   "apiProduct":[
      {
         "apiResources":[
            "/",
            "/**"
         ],
         "approvalType":"auto",
         "attributes":[

         ],
         "createdAt":1537374680948,
         "createdBy":"jdoe@foo.com",
         "description":"",
         "displayName":"mock",
         "environments":[
            "test"
         ],
         "lastModifiedAt":1537374680948,
         "lastModifiedBy":"test@test.com",
         "name":"mock",
         "proxies":[
            "edgemicro-auth",
            "edgemicro_mock"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[
            ""
         ]
      }
   ]
}

curl -v http://your_domain/edgemicro-auth/products

Kiểm thử và gỡ lỗi

Làm sao Tôi không cho phép "quá nhiều tệp đang mở" lỗi trong khi kiểm tra tải là gì?

Trong một số trường hợp, hệ thống của bạn có thể gặp phải tình huống có quá nhiều đường kết nối tệp mở và điều này có thể khiến Edge Micro gặp sự cố. Việc ghi nhật ký mặc định yêu cầu hai kết nối HTTP cho giao dịch đến và đi thông qua Microgateway.

Để thử nghiệm và đo điểm chuẩn, bạn nên đặt lệnh ulimit của hệ thống thành không giới hạn: ulimit -n unlimited. Xem thêm Edge Lỗi Microgateway trong quá trình kiểm tra tải trên Cộng đồng Apigee.

Mẹo để chạy video nhanh phát triển và gỡ lỗi

Nếu đang phát triển trình bổ trợ cho Edge Microgateway, bạn có thể thấy dịch vụ hỗ trợ cho còn hạn chế.

Sau đây là một số mẹo tạm thời:

• Để khởi động Edge Microgateway, bạn có thể đặt các biến môi trường EDGEMICRO_KEY và EDGEMICRO_SECRET vào cặp khoá/bí mật do lệnh khởi động Microgateway yêu cầu. Thao tác này cho phép bạn khởi động Edge Microgateway mà không cần nhập khoá/bí mật ở lệnh . Xem thêm Đặt biến môi trường trong tài liệu của Edge Microgateway.
• Khởi động Edge Microgateway ở chế độ DEBUG để xem kết quả bổ sung trong cửa sổ dòng lệnh: DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]

Hoạt động kinh doanh và cấp phép

Các mô hình hỗ trợ Apigee-127 và Edge Microgateway có mối quan hệ như thế nào?

Apigee-127 là dự án phần mềm nguồn mở được hỗ trợ trong mô hình nguồn mở. Đó tức là bạn có thể nêu vấn đề trong dự án GitHub và đưa ra yêu cầu lấy dữ liệu nếu bạn cố gắng khắc phục một điều gì đó. Apigee-127 không yêu cầu hoặc không bao gồm bất kỳ Thoả thuận cấp phép phần mềm nào với Apigee.

Mặt khác, Edge Microgateway là một sản phẩm dành cho Doanh nghiệp được Apigee hỗ trợ cho Khách hàng của Apigee. Tức là khách hàng của Apigee có thể tạo phiếu yêu cầu hỗ trợ, yêu cầu về tính năng và lỗi bằng cách sử dụng Bộ phận hỗ trợ Apigee Edge của Google Cloud.