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

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

Bắt đầu

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

Xem phần Cài đặt Edge Microgateway.

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

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

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

Các API được uỷ quyền thông qua Edge Microgateway có thể tương tác với một cơ sở dữ liệu đang chạy trong một dịch vụ đích. Tuy nhiên, Edge Microgateway hoạt động độc lập với mọi cơ sở dữ liệu hoặc kho dữ liệu phụ trợ.

Hoạt động

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

Edge Microgateway tự động thăm dò các thay đổi được thực hiện trên Apigee Edge, chẳng hạn như các thay đổi đối với những proxy, sản phẩm hoặc ứng dụng dành cho nhà phát triển có nhận biết microgateway. 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 này 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ò, hãy sử dụng lệnh edgemicro reload để nhận các thay đổi mới nhất. Xem phần Tải lại cụm microgateway.

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

Khi bạn định cấu hình Edge Microgateway, một danh sách các proxy nhận biết microgateway đượ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. Các proxy nhận biết microgateway là những proxy có tên bắt đầu bằng tiền tố edgemicro_.

Tôi có 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ý tích hợp sẵn. Để biết thông tin chi tiết, hãy xem bài viết 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 với Edge Microgateway. Do cách hoạt động của Edge Microgateway, bạn không thể sử dụng chính sách Ghi nhật ký thông báo của Apigee Edge để ghi nhật ký thông báo cho Edge Microgateway. Xem thêm bài viết Trình bổ trợ ghi nhật ký cho Microgateway trên cộng đồng.

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

Miễn là tổ chức và môi trường giống nhau đối với các thực thể Microgateway, bạn có thể sử dụng lại cặp khoá/mã 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 thực tế?

Bạn có thể đặt các 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 những biến này (và các biến khác), bạn có thể khởi động Edge Microgateway bằng một lệnh duy nhất edgemicro start. Xem thêm phần Đặt biến môi trường.

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

Không. Theo mặc định, Edge Microgateway chỉ hoạt động trên các thuộc tính liên quan đến hoạt động định tuyến và bảo mật cơ bản. Tuy nhiên, để khắc phục, bạn có thể chọn một trong các phương á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 đến Apigee Edge. Các thuộc tính này sẽ có sẵn khi bạn sử dụng bảo mật Khoá API hoặc mã thông báo OAuth.
2. Sửa đổi trình bổ trợ OAuth để tác động đến các thuộc tính đó.

Có giới hạn về kích thước tiêu đề của 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, hãy 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ừ 80 KB xuống 8 KB. Các tiêu đề vượt quá 8 KB sẽ dẫn đến lỗi HTTP 431.

Một lựa 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 kích thước tiêu đề tối đa mặc định. Tham số này (--max-http-header-size) 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 biến môi trường NODE_OPTIONS 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 những API quản lý nào?

Triển khai

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

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, kể cả trên cùng một máy.

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

Không. Các proxy có nhận biết 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 của 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 chế độ dự phòng giữa việc triển khai gói proxy Edge và việc triển khai Edge Microgateway cho cùng một API Proxy không?

Không. Edge Microgateway không biết về các hoạt động triển khai proxy API không phải là microgateway trên Apigee Edge.

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

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

Tôi có thể sử dụng những bộ 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 về số lượng proxy Edge Microgateway mà tôi có thể triển khai không?

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

Tôi có thể liên kết việc triển khai Edge Microgateway 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 Edge Microgateway, bạn phải liên kết phiên bản đó với một tổ chức và môi trường Edge cụ thể.

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

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 ở mỗi 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 và bất kỳ ai có quyền chạy các ứng dụng như vậy trên một máy nhất định đều có thể chạy ứng dụng này.

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

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

Hiệu suất

Những yếu tố nào cần cân nhắc về hiệu suất khi sử dụng Edge Microgateway?

Nếu đang chạy Edge Microgateway cùng với ứng dụng mục tiêu, hãy đảm bảo máy chủ có đủ 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 đề xuất chạy nhiều phiên bản của Edge Microgateway trên các máy chủ khác nhau được cân bằng tải như NGINX. Xem thêm bài viết Quản lý API bằng Apigee Edge Microgateway và NGINX và Mở rộng theo chiều dọc và chiều ngang trên Cộng đồng Apigee.

TPS của Edge Microgateway theo mặc định là bao nhiêu và những yêu cầu nào về phần cứng cần thiết cho một phiên bản Microgateway

Khó đánh giá các yêu cầu về phần cứng và chỉ số TPS bằng Edge Microgateway. Điều này phụ thuộc vào chế độ thiết lập của bạn, bao gồm việc điều chỉnh Edge Microgateway, sử dụng trình bổ trợ, trình bổ trợ tuỳ chỉnh và định cấu hình những thứ khác như TLS. Thông thường, Apigee đề xuất bạn nắm được ý tưởng về sự kết hợp đó và tiến hành kiểm thử hiệu suất với chế độ thiết lập cụ thể của mình.

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

Edge Microgateway có hoạt động với Edge cho Đám mây riêng tư không?

Có. Để biết thông tin chi tiết, hãy xem Các bước định cấu hình Apigee Private Cloud.

Trình bổ trợ

Hạn mức được thực thi như thế nào với Microgateway Edge?

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

Cách thực thi chính sách Chặn đột biến bằng Edge Microgateway

Bạn có thể tuỳ ý thêm một trình bổ trợ chống đột biến vào phiên bản Edge Microgateway. Để biết thông tin chi tiết, hãy xem phần Sử dụng trình bổ trợ ngăn chặn đột biến.

Có cách nào khác để viết các 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ì sẽ xảy ra khi Edge Microgateway không thể tải dữ liệu Analytics lên Edge?

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

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

Nếu bạn đính kèm các chính sách Apigee Edge thông thường vào các proxy có nhận biết cổng siêu nhỏ trong Apigee Edge, thì các chính sách đó sẽ bị bỏ qua. Thay vào đó, Edge Microgateway sử dụng các trình bổ trợ để cung cấp 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, ngăn chặn độ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 phần 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 Cộng đồng Apigee thảo luận về các trường hợp sử dụng bổ sung của trình bổ trợ:

• 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 sẽ được triển khai cho tổ chức:môi trường của bạn trên Apigee Edge. Proxy này hiển thị một điểm cuối /products trả về danh sách Sản phẩm API. Nếu bạn đã cài đặt Edge Microgateway vào hoặc trước ngày 5 tháng 10 năm 2018, thì Apigee khuyên bạn nên thực hiện các bước để bảo vệ điểm cuối này, vì phản hồi chứa địa chỉ email của nhà phát triển đã tạo và sửa đổi Sản phẩm API trong tổ chức Apigee của bạn.

Bạn có thể bảo vệ điểm cuối bằng cách nâng cấp Edge Microgateway hoặc định cấu hình TLS tương hỗ. Cả hai lựa chọn này đều được mô tả dưới đây.

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 chắn liệu điểm cuối /products có được bảo vệ hay không, hãy chuyển đến phần Xác minh rằng tài nguyên /products được bảo vệ và thực hiện các bước ở đó trước khi tiếp tục.

Cách 1: Nâng cấp Edge Microgateway

Nếu bạn đã cài đặt Edge Microgateway vào hoặc trước ngày 5 tháng 10 năm 2018, thì Apigee khuyên 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 phần 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 vào thời điểm này, hãy chuyển sang Cách 2.

Cách 2: Thiết lập TLS hai chiều

Nếu không thể nâng cấp Edge Microgateway vào thời điểm này, Apigee khuyên bạn nên bảo vệ thông tin liên lạc giữa Edge Microgateway và proxy edgemicro-auth bằng TLS hai chiều (còn gọi là TLS song phương).

1. Mở tệp $HOME/.edgemicro/org-env-config.yaml. Hãy xem phần Edge Microgateway được cài đặt ở đâu nếu bạn không tìm thấy tệp này.
2. Thêm khối tlsOptions sau vào tệp org-env-config.yaml để bật TLS hai chiều 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 cơ quan cấp chứng chỉ.
   • pfx: Thêm nếu bạn muốn sử dụng tệp p12/pfx thay vì cert và khoá.
   • passphrase: Cụm mật khẩu cho tệp pfx.
   • ciphers: Chỉ định các thuật toán mật mã TLS.
3. Đảm bảo rằng máy chủ ảo mà bạn triển khai proxy edgemicro-auth đã bật TLS hai chiều. Để biết thông tin chi tiết, hãy xem bài viết 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 hai chiều trên một máy chủ ảo trong giao diện người dùng Apigee Edge:

   
4. Xem xét 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 máy chủ ảo hỗ trợ TLS có tên là mutualtls, thì đoạn 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 cách nào để ngăn lỗi "mở quá nhiều tệp" trong quá trình kiểm thử tải?

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 kết nối tệp đang mở và điều này có thể khiến Edge Micro gặp sự cố. Hoạt động ghi nhật ký mặc định yêu cầu 2 kết nối HTTP cho các giao dịch đến và đi thông qua Microgateway.

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

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

Nếu đang phát triển các trình bổ trợ cho Edge Microgateway, bạn có thể thấy rằng khả năng hỗ trợ phát triển nhanh bị hạn chế.

Hiện tại, bạn có thể tham khảo một số mẹo sau:

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

Kinh doanh và cấp phép

Mối quan hệ giữa Apigee-127 và các mô hình hỗ trợ Edge Microgateway là gì?

Apigee-127 là một dự án phần mềm nguồn mở được hỗ trợ theo mô hình nguồn mở. Tức là bạn có thể nêu vấn đề trong dự án GitHub và gửi yêu cầu kéo nếu bạn cố gắng khắc phục vấn đề nào đó. Apigee-127 không yêu cầu hoặc 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à báo cáo lỗi bằng cách sử dụng Nhóm hỗ trợ Apigee Edge của Google Cloud.