Sử dụng Docker cho 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

Chủ đề này giải thích cách chạy Edge Microgateway trong một vùng chứa Docker. Các bước được đề cập trong chủ đề này giả định rằng bạn có kiến thức cơ bản về Docker, các lệnh Docker, cũng như chế độ thiết lập và cấu hình Edge Microgateway. Để biết thêm thông tin, hãy tham khảo tài liệu về Docker và Edge Microgateway.

Điều kiện tiên quyết

Trước khi chạy Edge Microgateway trong một vùng chứa Docker, bạn phải thực hiện các tác vụ sau:

  • Định cấu hình Edge Microgateway cho tổ chức/môi trường Apigee của bạn:

    edgemicro configure -o your_org -e your_env -u your_username

    Để biết thêm thông tin chi tiết về cấu hình, hãy xem Phần 1: Định cấu hình Edge Microgateway.

  • Sau khi thực hiện các bước định cấu hình, hãy tìm tệp cấu hình. Vị trí mặc định là:

    $HOME/.edgemicro/your_org-your_env-config.yaml

    trong đó your_org và your_env là tổ chức và môi trường mà bạn đã sử dụng khi chạy lệnh edgemicro config. Bạn sẽ cần tệp này khi khởi động Edge Microgateway trong một vùng chứa Docker.

  • Đảm bảo bạn có khoá và thông tin đăng nhập bí mật được trả về khi bạn chạy lệnh edgemicro config. Ví dụ:

    The following credentials are required to start edge micro
  key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0
  secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430

  • Trước khi khởi động Edge Microgateway trong một vùng chứa Docker, bạn cần tạo (hoặc đã tạo) các thực thể Apigee Edge bắt buộc để thực hiện các lệnh gọi được xác thực đến API proxy. Các thực thể này bao gồm một proxy có nhận biết Edge Microgateway, một Sản phẩm API, một Nhà phát triển và một Ứng dụng dành cho nhà phát triển. Để biết hướng dẫn đầy đủ, hãy xem bài viết Tạo thực thể trên Apigee Edge.

Chạy Edge Micro dưới dạng vùng chứa Docker

  1. Tải hình ảnh Docker xuống cho Edge Microgateway:

    docker pull gcr.io/apigee-microgateway/edgemicro:latest

  2. Trước khi chuyển sang các bước tiếp theo, hãy nhớ thực hiện tất cả các bước trong phần Điều kiện tiên quyết.

  3. Chạy lệnh sau để mã hoá base64 tệp cấu hình Edge Microgateway nằm trong $HOME/.edgemicro:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

    trong đó your_org và your_env là tổ chức và môi trường mà bạn đã sử dụng khi chạy lệnh edgemicro config.

    Hãy nhớ đặt dấu nháy ngược (`) xung quanh lệnh. Ví dụ:

    export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

  4. Chạy Edge Microgateway dưới dạng một vùng chứa. Lệnh này đặt một số biến môi trường mà thời gian chạy vùng chứa dùng để khởi động Edge Microgateway:

    chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8000:8000 -d --name edgemicro \
-v /var/tmp:/opt/apigee/logs \
-e EDGEMICRO_PROCESSES=1 \
-e EDGEMICRO_ORG=your_org \
-e EDGEMICRO_ENV=your_env \
-e EDGEMICRO_KEY=your_key \
-e EDGEMICRO_SECRET=your_secret \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e "LOG_CONSOLE_OUTPUT_TO_FILE=false" \
-e SERVICE_NAME=edgemicro \
--security-opt=no-new-privileges \
--cap-drop=ALL \
gcr.io/apigee-microgateway/edgemicro:latest

    Tham số

      <tr>
    <td><code>SERVICE_NAME</code></td>
    <td>If you are on Kubernetes, this parameter is auto-populated. Otherwise,
      you can set it to anything you wish. If you specify nothing, the service
      name is set to <code>default</code>.</td>
  </tr>
  <tr>
    <tr>
    <td><code>DEBUG</code></td>
    <td>Set to <code>*</code> to enable debugging. </td>
  </tr>
  <tr>
    <td><code>HTTP_PROXY</code>
        <code>HTTPS_PROXY</code></td>
    <td>Use when Edge Microgateway is
      running behind a firewall and the gateway cannot communicate with Apigee
      Edge. For more
      information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>. 
      <p>For example: <code>HTTP_PROXY=http://10.203.0.1:5187/</code></p></td>
  </tr>
  <tr>
    <td><code>NO_PROXY</code></td>
    <td>A comma delimited list of domains that Edge Microgateway should not proxy to. 
      For more information, see <a href="operation-and-configuration-reference-edge-microgateway#settingupedgemicrogatewaybehindacompanyfirewall">Setting up Edge Microgateway behind a company firewall</a>.
      <p>For example: <code>localhost,127.0.0.1,localaddress,.localdomain.com</code></p></td>
  </tr>
  <tr>
  <tr>
    <tr>
    <td><code>NODE_EXTRA_CA_CERTS</code></td>
    <td>(Optional) Use this parameter if you are using a CA that's not trusted
      by default by Node.js. Set the value of this parameter to the path to a
      file containing one or more trusted certificates in PEM format. For
      details, see <a href="#tls_certificates">TLS certificates</a>.</td>
  </tr>
  <tr>
    <td><code>--security-opt</code></td>
    <td>(Optional) Sets desired Docker security options. See <a href="https://docs.docker.com/engine/reference/run/#security-configuration">Security configuration</a> in the Docker documentation.</td>
  </tr>
  <tr>
    <td><code>--cap-drop</code></td>
    <td>(Optional) Sets limits on Linux capabilities permitted in the container. See <a href="https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities">Runtime privilege and Linux capabilities</a> in the Docker documentation.</td>
  </tr>
</tbody>

    Tham số Nội dung mô tả
    -P Xuất bản tất cả các cổng được hiển thị cho máy chủ lưu trữ. Xem thêm Tài liệu tham khảo về lệnh chạy Docker.
    -p Liên kết rõ ràng một cổng hoặc dải cổng. Xem thêm Tài liệu tham khảo về lệnh chạy Docker.
    -d Chạy ở chế độ tách biệt. Xem thêm Tài liệu tham khảo về lệnh chạy Docker.
    -v, -- volume Chỉ định một điểm gắn kết ổ đĩa. Xin lưu ý rằng nếu định cấu hình Edge Microgateway để sử dụng TLS trong vùng chứa Docker, bạn phải hiển thị cổng 8443 nếu bạn gắn thư mục tệp nhật ký. Xem thêm VOLUME [shared filesystems]. Xem thêm bài viết Sử dụng TLS trong vùng chứa Docker.
    -w, -- workdir (Không bắt buộc) Chỉ định đường dẫn đến thư mục nơi bạn muốn tạo các tệp edgemicro.sock và edgemicro.pid. Bạn không thể sửa đổi tên tệp gốc edgemicro. Mặc định là đường dẫn thư mục đang hoạt động hiện tại.

    Ví dụ: 

    docker run -P -p 8000:8000 -d -w /tmp --name edgemicro 
    
...
    EDGEMICRO_ORG Tên của tổ chức Apigee mà bạn đã dùng để định cấu hình Edge Microgateway.
    EDGEMICRO_ENV Tên của môi trường Apigee mà bạn đã dùng để định cấu hình Edge Microgateway.
    EDGEMICRO_PROCESSES Số lượng quy trình cần bắt đầu.
    EDGEMICRO_KEY Khoá được trả về khi bạn định cấu hình Edge Microgateway.
    EDGEMICRO_SECRET Khoá bí mật được trả về khi bạn định cấu hình Edge Microgateway.
    EDGEMICRO_CONFIG Một biến chứa tệp cấu hình Edge Microgateway được mã hoá bằng base64.
    LOG_CONSOLE_OUTPUT_TO_FILE (Boolean) Cho phép bạn chỉ định nơi gửi kết quả đầu ra nhật ký. Xem phần Chỉ định các lựa chọn về tệp nhật ký.

    Ví dụ:

    chown -R 100:101 ~/.edgemicro/ 
    
  docker run -P -p 8000:8000 -d --name edgemicro 
    
  -v /var/tmp:/opt/apigee/logs 
    
  -e EDGEMICRO_PROCESS=1 
    
  -e EDGEMICRO_ORG=docs 
    
  -e EDGEMICRO_ENV=test 
    
  -e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0 
    
  -e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430 
    
  -e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" 
    
  -e SERVICE_NAME=edgemicro 
    
  --security-opt=no-new-privileges 
    
  --cap-drop=ALL 
    
  gcr.io/apigee-microgateway/edgemicro

    1. Cách kiểm tra để đảm bảo vùng chứa đang chạy:

      docker ps

      Bạn sẽ thấy kết quả tương tự như dưới đây:

      CONTAINER ID    IMAGE         COMMAND                CREATED          STATUS          PORTS                                             NAMES
8b92e082ea9c    edgemicro    "/tmp/entrypoint.sh"   12 minutes ago   Up 12 minutes    0.0.0.0:8000->8000/tcp, 0.0.0.0:32775->8443/tcp    edgemicro

    Chỉ định các lựa chọn đầu ra của tệp nhật ký

    Tham số cấu hình Edge Microgateway to_console cho phép bạn chọn gửi thông tin nhật ký đến đầu ra chuẩn thay vì đến tệp nhật ký. Nếu bạn làm theo các bước để chạy Edge Microgateway trong một vùng chứa Docker, thì theo mặc định, vùng chứa sẽ chuyển hướng stdout và đầu ra lỗi đến một tệp nằm trong vùng chứa tại vị trí: ${APIGEE_ROOT}/logs/edgemicro.log.

    Để ngăn thông tin nhật ký được gửi đến edgemicro.log, hãy sử dụng biến LOG_CONSOLE_OUTPUT_TO_FILE khi bạn chạy vùng chứa.

    Bảng sau đây mô tả hành vi đầu ra của nhật ký khi bạn sử dụng LOG_CONSOLE_OUTPUT_TO_FILE với to_console:

    to_console: true

    LOG_CONSOLE_OUTPUT_TO_FILE=false

    • Không có nhật ký nào được gửi đến tệp nhật ký Edge Microgateway, như mô tả trong phần Quản lý tệp nhật ký.
    • Nhật ký sẽ không được gửi đến tệp edgemicro.log.
    to_console: true

    LOG_CONSOLE_OUTPUT_TO_FILE=true

    • Không có nhật ký nào được gửi đến tệp nhật ký Edge Microgateway, như mô tả trong phần Quản lý tệp nhật ký.
    • Nhật ký sẽ được gửi đến tệp edgemicro.log.
    to_console: false

    LOG_CONSOLE_OUTPUT_TO_FILE=true

    • Nhật ký sẽ được gửi đến tệp nhật ký Edge Microgateway, như mô tả trong phần Quản lý tệp nhật ký.
    • Nhật ký sẽ được gửi đến tệp edgemicro.log.

    Kiểm thử lệnh gọi API

    Sau khi khởi động Edge Microgateway trong vùng chứa, bạn có thể thực hiện các lệnh gọi API đến vùng chứa đó. Ví dụ: nếu basepath của API là /hello:

    http://localhost:8000/hello

    Kết quả mẫu:

    {"error":"missing_authorization","error_description":"Missing Authorization header"}

    Nếu bạn thấy phản hồi này, tức là Edge Microgateway đã xử lý thành công lệnh gọi API. Tuy nhiên, theo mặc định, Edge Microgateway yêu cầu phải có khoá API để xác thực. Trong phần tiếp theo, bạn sẽ kiểm thử API bằng một khoá API hợp lệ.

    Kiểm thử một API bằng khoá API hợp lệ

    Trong giao diện người dùng Edge, hãy chuyển đến Ứng dụng dành cho nhà phát triển mà bạn đã tạo trước đó. Trong trang Ứng dụng nhà phát triển, hãy cho thấy Khoá người dùng và sao chép khoá đó. Giá trị này là khoá API. Bạn sẽ dùng khoá này để thực hiện các lệnh gọi API được xác thực.

    Gọi API bằng tiêu đề x-api-key như sau. Giá trị Consumer Key (Khoá người dùng) mà bạn đã sao chép từ Ứng dụng dành cho nhà phát triển chính là khoá API. Theo mặc định, Edge Microgateway yêu cầu bạn truyền khoá trong một tiêu đề có tên là x-api-key, như sau:

    curl -i http://localhost:8000/hello -H "x-api-key:apikey"

    Ví dụ:

    curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz"

    Nếu bạn muốn tìm hiểu thêm về cách thực hiện các lệnh gọi API đã xác thực thông qua Edge Microgateway bằng khoá API và mã thông báo OAuth, hãy xem Phần 4: Bảo mật Edge Microgateway.

    Dừng Edge Microgateway

    Sử dụng lệnh Docker sau để dừng Edge Microgateway:

    docker stop edgemicro

    Khởi động lại Edge Microgateway

    Sau khi dừng Edge Microgateway, bạn có thể khởi động lại bằng lệnh Docker sau:

    docker start edgemicro

    Sử dụng TLS trong vùng chứa Docker

    Phần này giải thích cách định cấu hình TLS cho Edge Microgateway đang chạy trong một vùng chứa Docker. Bạn có thể định cấu hình máy chủ Edge Microgateway để sử dụng TLS cho các yêu cầu đến (hướng bắc) và bạn có thể định cấu hình Edge Microgateway làm một ứng dụng TLS cho các yêu cầu đi đến các điểm cuối mục tiêu (hướng nam).

    Nơi đặt tệp chứng chỉ

    Vùng chứa Docker chạy Edge Microgateway có một điểm gắn kết trên /opt/apigee/.edgemicro. Khi định cấu hình Edge Microgateway để sử dụng chứng chỉ TLS, bạn có thể cung cấp các tệp chứng chỉ trên điểm gắn kết đó và tham chiếu đến các tệp đó trong tệp cấu hình Edge Microgateway. Tệp cấu hình này thường nằm trong thư mục $HOME/.edgemicro và có tên là your_org-your_env-config.yaml. Ví dụ:

    ...
edgemicro:
  ssl:
   key: /opt/apigee/.edgemicro/southbound/tls.key
   cert: /opt/apigee/.edgemicro/southbound/tls.crt
...

    Sử dụng một CA không được Node.js tin cậy

    Nếu bạn đang sử dụng Cơ quan cấp chứng chỉ (CA) mà Node.js không tin cậy theo mặc định (chẳng hạn như trường hợp sử dụng chứng chỉ tự ký), hãy cân nhắc sử dụng tham số NODE_EXTRA_CA_CERTS khi chạy vùng chứa.

    Đặt tham số này thành đường dẫn đến một tệp chứa một hoặc nhiều chứng chỉ đáng tin cậy ở định dạng PEM. Để xem cách sử dụng tham số này, hãy xem các ví dụ Cách định cấu hình TLS hướng bắc và Cách định cấu hình TLS hướng nam.

    Ví dụ:

    chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8443:8443 -d --name edgemicro \
-v $HOME/.edgemicro:/opt/apigee/.edgemicro \
-v $HOME/.edgemicro:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \
-e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

    Xem thêm bài viết Chạy Edge Micro dưới dạng một vùng chứa Docker.

    Tắt quy trình xác thực TLS

    Mặc dù không nên, nhưng trong một số trường hợp, bạn có thể muốn tắt quy trình xác thực TLS cho Edge Microgateway đang chạy trong một vùng chứa. Theo mặc định, vùng chứa Docker Edge Microgateway không có khả năng tắt TLS. Để hoàn thành nhiệm vụ này, bạn phải tạo một hình ảnh Docker tuỳ chỉnh cho Edge Microgateway. Dưới đây là hướng dẫn chung để tạo hình ảnh tuỳ chỉnh và tắt quy trình xác thực TLS.

    1. Sao chép hoặc tải kho lưu trữ nguồn Edge Microgateway xuống từ https://github.com/apigee-internal/microgateway.

    2. cd vào thư mục microgateway/kubernetes/docker/edgemicro trong thư mục mã nguồn.

      Ví dụ:

      cd $HOME/git/microgateway/kubernetes/docker/edgemicro

    3. Mở tệp entrypoint.sh và sửa đổi mã để chấp nhận biến môi trường NODE_TLS_REJECT_UNAUTHORIZED. Sau đó, khi chạy vùng chứa, bạn sẽ chỉ định một giá trị cho biến này.

    4. Tạo vùng chứa Docker:

      docker build -t edgemicro .

    5. Khi chạy vùng chứa, hãy chỉ định tuỳ chọn -e NODE_TLS_REJECT_UNAUTHORIZED = 1. Ví dụ:

    chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8443:8443 -d --name edgemicro \
-v $HOME/.edgemicro:/opt/apigee/.edgemicro \
-v $HOME/.edgemicro:/opt/apigee/logs \
-e NODE_TLS_REJECT_UNAUTHORIZED = 1 \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=ac36574905fb54fdae65fc5433e831bec2680efb98220a355f2e917e52973c \
-e EDGEMICRO_SECRET=aac81dff6c326eaa222d53c15c8841fa78ea863bf4472568c9ce2d80a3bc56 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

    Ví dụ: Cách định cấu hình TLS hướng bắc

    Phần này giải thích cách thiết lập một kết nối TLS chiều bắc (đến) trên máy chủ Edge Microgateway. TLS chiều bắc cho phép các ứng dụng sử dụng HTTPS khi thực hiện lệnh gọi API đến Edge Microgateway. Ví dụ bên dưới sử dụng chứng chỉ tự ký.

    1. Các bước thiết lập ban đầu

    1. Xác định vị trí tệp openssl.cnf trên hệ thống của bạn. Ví dụ: /etc/ssl/openssl.cnf.
    2. Mở tệp opensssl.cnf để chỉnh sửa.

    3. Đảm bảo rằng req_extensions có trong tệp cấu hình của bạn. Ví dụ: bạn nên có thông tin tương tự như sau trong tệp của mình:

      [ req ]
...
req_extensions          = v3_req
...

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

    4. Thêm đoạn sau vào openssl.cnf để tạo các thuộc tính SNI phù hợp:

      [ alt_names ]
DNS.1 = www.example.com
DNS.2 = example.com
DNS.3 = localhost
DNS.4 = localhost.localdomain
DNS.5 = 127.0.0.1
DNS.6 = ::1
DNS.7 = fe80::1

      Tệp opensssl.cnf mẫu:

      [ req ]
distinguished_name      = req_distinguished_name
attributes              = req_attributes
req_extensions          = v3_req

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

[ req_distinguished_name ]
countryName                     = Country Name (2 letter code)
countryName_min                 = 2
countryName_max                 = 2
stateOrProvinceName             = State or Province Name (full name)
localityName                    = Locality Name (eg, city)
0.organizationName              = Organization Name (eg, company)
organizationalUnitName          = Organizational Unit Name (eg, section)
commonName                      = Common Name (eg, fully qualified host name)
commonName_max                  = 64
emailAddress                    = Email Address
emailAddress_max                = 64

[ req_attributes ]
challengePassword               = A challenge password
challengePassword_min           = 4
challengePassword_max           = 20

[ alt_names ]
DNS.1 = www.example.com
DNS.2 = example.com
DNS.3 = localhost
DNS.4 = localhost.localdomain
DNS.5 = 127.0.0.1
DNS.6 = ::1
DNS.7 = fe80::1

    5. Làm theo các bước trong phần Điều kiện tiên quyết để khởi động và định cấu hình Edge Microgateway (nếu chưa thực hiện). Khi hoàn tất, bạn sẽ tạo được một proxy nhận biết Edge Microgateway, một Sản phẩm API, một Nhà phát triển và một Ứng dụng dành cho nhà phát triển. Ngoài ra, bạn sẽ chạy lệnh edgemicro configure và nhận được một khoá và mã bí mật.

    2. Tạo chứng chỉ tự ký

    Tiếp theo, hãy tạo các chứng chỉ và khoá mà bạn cần để thiết lập TLS:

    1. cd thành thư mục $HOME/.edgemicro.

    2. Tạo tập lệnh bash sau. Bạn có thể đặt tên tuỳ ý cho tệp này. Ví dụ:keygen.sh.

      #!/bin/bash
# generate ca
openssl genrsa -out rootca.key 2048
openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem
# generate key
openssl genrsa -out tls.key 2048
openssl req -new -key tls.key -out tls.csr
# sign cert
openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf

    3. Trong tệp bash, hãy đảm bảo đường dẫn đến tệp openssl.cnf là chính xác.

    4. Thực thi tệp bash. Bạn sẽ được nhắc cung cấp thông tin về chứng chỉ. Hãy nhớ sử dụng localhost cho Tên chung.

    5. Kiểm tra để đảm bảo bạn đã tạo các tệp sau:

      • rootca.key
      • rootca.pem
      • tls.key
      • tls.csr
      • rootca.srl
      • tls.crt

    3. Chỉnh sửa tệp cấu hình Edge Microgateway

    1. Mở tệp cấu hình Edge Micro trong một trình chỉnh sửa. Ví dụ:

      vi $HOME/.edgemicro/myorg-test-config.yaml

    2. Chỉnh sửa khổ thơ edgemicro như sau. Lưu ý rằng bạn đang thay đổi các thuộc tính port và ssl:

      edge_config:
...
edgemicro:
  port: 8443
  max_connections: 1000
  config_change_poll_interval: 600
  ssl:
    key: /opt/apigee/.edgemicro/tls.key
    cert: /opt/apigee/.edgemicro/tls.crt
    passphrase: admin123
    rejectUnauthorized: true
    requestCert: false
  logging:
...

    3. Thực thi lệnh sau để mã hoá base64 tệp cấu hình Edge Microgateway nằm trong $HOME/.edgemicro:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

      trong đó your_org và your_env là tổ chức và môi trường mà bạn đã sử dụng khi chạy lệnh edgemicro config.

      Hãy nhớ đặt dấu nháy ngược (`) xung quanh lệnh. Ví dụ:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

    Xem thêm: Chạy Edge Micro dưới dạng một vùng chứa Docker.

    4. Chạy vùng chứa

    1. Thực thi lệnh sau để chạy vùng chứa Docker bằng Edge Microgateway:

      chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
gcr.io/apigee-microgateway/edgemicro:latest

    2. Lưu ý các tham số sau được dùng trong lệnh; các tham số này khác với lệnh cơ bản được mô tả trong phần Chạy Edge Micro dưới dạng một vùng chứa Docker.

      • port được đặt thành 8443.
      • Một điểm gắn kết ổ đĩa được dùng để gắn các tệp khoá và chứng chỉ.
      • Biến NODE_EXTRA_CA_CERTS được dùng để thêm một CA tuỳ chỉnh (khi cần trong trường hợp có chứng chỉ tự ký).

    5. Kiểm thử cấu hình TLS

    1. Thực thi lệnh cURL sau đây để kiểm thử chế độ thiết lập. Thay thế basepath và khoá API của bạn vào lệnh. Ví dụ sau đây giả định rằng bạn đang ở trong thư mục có chứa rootca.pem và proxy mà bạn đã tạo có đường dẫn cơ sở là /hello:

      curl -v https://localhost:8443/hello --cacert rootca.pem \
-H "x-api-key: Az82fdnfONVCOOE4NKhajxAboDgA3FAo"

    2. Đầu ra cURL chi tiết cho thấy từng bước của quá trình bắt tay TLS. Nếu bạn thấy phản hồi HTTP 200, tức là cấu hình đã thành công:

      *   Trying ::1...ey:Az82fdnfONVCOOE4NKhajxAboDgA3FAo"
* TCP_NODELAY set
* Connected to localhost (::1) port 8443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH
* successfully set certificate verify locations:
*   CAfile: rootca.pem
  CApath: none
* TLSv1.2 (OUT), TLS handshake, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Server hello (2):
* TLSv1.2 (IN), TLS handshake, Certificate (11):
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
* TLSv1.2 (IN), TLS handshake, Server finished (14):
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
* TLSv1.2 (OUT), TLS change cipher, Client hello (1):
* TLSv1.2 (OUT), TLS handshake, Finished (20):
* TLSv1.2 (IN), TLS change cipher, Client hello (1):
* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256
* ALPN, server accepted to use http/1.1
* Server certificate:
*  subject: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com
*  start date: Dec 14 22:35:28 2018 GMT
*  expire date: Oct  3 22:35:28 2021 GMT
*  common name: localhost (matched)
*  issuer: C=US; ST=CO; L=Boulder; O=Docs; OU=Docs; CN=localhost; emailAddress=docs@apigee.com
*  SSL certificate verify ok.
> GET /hello HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key:Az82fdnfaONVCOE4NKhajxAboDA3FAo
>
< HTTP/1.1 200 OK
< x-powered-by: Apigee
< access-control-allow-origin: *
< x-frame-options: ALLOW-FROM RESOURCE-URL
< x-xss-protection: 1
< x-content-type-options: nosniff
< content-type: text/plain; charset=utf-8
< etag: W/"d-GHB1ZrJKk/wdVTdB/jgBsw"
< date: Fri, 14 Dec 2018 22:43:13 GMT
< via: 1.1 google
< alt-svc: clear
< x-response-time: 1325
< Connection: keep-alive
< Transfer-Encoding: chunked
<
* Connection #0 to host localhost left intact
Hello, Guest!

    Ví dụ: Cách định cấu hình TLS hướng nam

    Phần này giải thích cách thiết lập một kết nối TLS chiều nam (đầu ra) giữa máy chủ Edge Microgateway và một ứng dụng đích phụ trợ. Ví dụ bên dưới sử dụng chứng chỉ tự ký.

    1. Các bước thiết lập ban đầu

    1. Xác định vị trí tệp openssl.cnf trên hệ thống của bạn. Ví dụ: /etc/ssl/openssl.cnf.
    2. Mở tệp opensssl.cnf để chỉnh sửa.

    3. Đảm bảo rằng req_extensions có trong tệp cấu hình của bạn. Ví dụ: bạn nên có thông tin tương tự như sau trong tệp của mình:

      [ req ]
...
req_extensions          = v3_req
...

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

    4. Thêm đoạn sau vào openssl.cnf để tạo các thuộc tính SNI phù hợp:

      [ alt_names ]
DNS.1 = helloworld
DNS.2 = localhost
DNS.3 = localhost.localdomain
DNS.4 = 127.0.0.1
DNS.5 = ::1
DNS.6 = fe80::1

      Tệp opensssl.cnf mẫu:

      [ req ]
distinguished_name      = req_distinguished_name
attributes              = req_attributes
req_extensions          = v3_req

[ v3_req ]
extendedKeyUsage = serverAuth, clientAuth, codeSigning, emailProtection
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

[ req_distinguished_name ]
countryName                     = Country Name (2 letter code)
countryName_min                 = 2
countryName_max                 = 2
stateOrProvinceName             = State or Province Name (full name)
localityName                    = Locality Name (eg, city)
0.organizationName              = Organization Name (eg, company)
organizationalUnitName          = Organizational Unit Name (eg, section)
commonName                      = Common Name (eg, fully qualified host name)
commonName_max                  = 64
emailAddress                    = Email Address
emailAddress_max                = 64

[ req_attributes ]
challengePassword               = A challenge password
challengePassword_min           = 4
challengePassword_max           = 20

[ alt_names ]
DNS.1 = helloworld
DNS.2 = localhost
DNS.3 = localhost.localdomain
DNS.4 = 127.0.0.1
DNS.5 = ::1
DNS.6 = fe80::1

    5. Chạy lệnh edgemicro configure:

      edgemicro configure -o your_org -e your_env -u your_username

      Để biết thêm thông tin chi tiết về cấu hình, hãy xem Phần 1: Định cấu hình Edge Microgateway.

    6. Sao chép khoá và thông tin xác thực bí mật được trả về từ edgemicro configure. Bạn sẽ cần những giá trị này để chạy vùng chứa. Ví dụ:

      The following credentials are required to start edge micro
  key: d9c34e1aff68ed969273c016699eabf48780e4f652242e72fc88a43e21252cb0
  secret: 3bc95a71c86a3c8ce04537fbcb788158731t51dfc6cdec13b7c05aa0bd969430

    2. Tạo một ứng dụng đích Node.js

    1. cd thành thư mục .edgemicro.

    2. Tạo tập lệnh bash sau. Bạn có thể đặt tên tuỳ ý cho tệp này. Ví dụ:keygen.sh.

      #!/bin/bash
# generate ca
openssl genrsa -out rootca.key 2048
openssl req -x509 -new -nodes -key rootca.key -sha256 -days 1024 -out rootca.pem
# generate key
openssl genrsa -out tls.key 2048
openssl req -new -key tls.key -out tls.csr
# sign cert
openssl x509 -req -in tls.csr -CA rootca.pem -CAkey rootca.key -CAcreateserial -out tls.crt -days 1024 -sha256 -extensions 'v3_req' -extfile path/openssl.cnf

    3. Trong tệp bash, hãy đảm bảo đường dẫn đến tệp openssl.cnf là chính xác.

    4. Thực thi tệp bash. Bạn sẽ được nhắc cung cấp thông tin về chứng chỉ. Hãy nhớ sử dụng hellworld cho Tên chung.

    5. Kiểm tra để đảm bảo bạn đã tạo các tệp sau:

      • rootca.key
      • rootca.pem
      • tls.key
      • tls.csr
      • rootca.srl
      • tls.crt

    6. Tạo một tệp mới có tên là server.js.

      'use strict';

const express = require('express');
const https = require('https');
const fs = require('fs');

const options = {
  key: fs.readFileSync("tls.key"),
  cert: fs.readFileSync("tls.crt")
};

// Constants
const PORT = 9443;
const HOST = '0.0.0.0';

// App
const app = express();
app.get('/', (req, res) => {
  res.send('Hello world\n');
});

https.createServer(options, app).listen(PORT);

    7. Tạo một tệp package.json trong cùng thư mục với server.js. Ví dụ:

      {
  "name": "helloworld",
  "version": "1.0.0",
  "description": "",
  "main": "server.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node server.js"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.16.4",
    "fs": "0.0.1-security",
    "https": "^1.0.0"
  }
}

    8. Chạy npm install để lấy các phần phụ thuộc.

    9. Tạo một Dockerfile mới trong cùng thư mục với server.js, trong đó WORKDIR là đường dẫn đến thư mục gốc của ứng dụng Node.js:

      FROM node:8-alpine
WORKDIR path-to-your-node-app
COPY package*.json ./

RUN npm install
COPY . .
EXPOSE 9443
CMD [ "npm", "start" ]

    10. Tạo hình ảnh Docker:

      docker build -t helloworld .

    11. Khởi động ứng dụng mẫu:

      docker run -P -p 9443:9443 --name helloworld helloworld

    3. Tạo thực thể trên Apigee Edge

    1. Tạo một proxy nhận biết Edge Microgateway bằng các chế độ cài đặt này. Để biết thêm thông tin, hãy xem phần Tạo một proxy API có nhận biết Edge Microgateway trên Edge.

      • Tên proxy: edgemicro_local
      • Bản sửa đổi: 1
      • Đường dẫn cơ sở: /local
      • Mục tiêu: https://helloworld:9443

    2. Tạo một sản phẩm API. Để biết thông tin chi tiết, hãy xem bài viết Tạo sản phẩm.

    3. Tạo một nhà phát triển. Để biết thông tin chi tiết, hãy xem bài viết Tạo nhà phát triển.

    4. Tạo một ứng dụng dành cho nhà phát triển. Để biết thông tin chi tiết, hãy xem phần Tạo ứng dụng dành cho nhà phát triển

    4. Chạy vùng chứa

    1. Mở tệp cấu hình Edge Micro trong một trình chỉnh sửa. Ví dụ:

      vi $HOME/.edgemicro/myorg-test-config.yaml

    2. Chỉnh sửa khổ thơ edgemicro như sau. Lưu ý rằng bạn đang thay đổi các thuộc tính port và ssl:

      edge_config:
...
edgemicro:
  port: 8443
  max_connections: 1000
  config_change_poll_interval: 600
  ssl:
    key: /opt/apigee/.edgemicro/tls.key
    cert: /opt/apigee/.edgemicro/tls.crt
    passphrase: admin123
    rejectUnauthorized: true
    requestCert: false
  logging:
...

    3. Thực thi lệnh sau để mã hoá base64 tệp cấu hình Edge Microgateway nằm trong $HOME/.edgemicro:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

      trong đó your_org và your_env là tổ chức và môi trường mà bạn đã sử dụng khi chạy lệnh edgemicro config.

      Hãy nhớ đặt dấu nháy ngược (`) xung quanh lệnh. Ví dụ:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

    4. Chạy lệnh sau để khởi động Edge Microgateway trong vùng chứa Docker.

      chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

    5. Kiểm thử cấu hình TLS

    1. Thực thi lệnh cURL sau đây để kiểm thử chế độ thiết lập. Thay thế đường dẫn cơ sở mà bạn đã dùng trong proxy có nhận biết cổng siêu nhỏ và khoá API lấy được từ ứng dụng Nhà phát triển mà bạn đã tạo trên Apigee Edge. Ví dụ:

      curl https://localhost:8443/local -k -H "x-api-key: xxxx" -v

      Bạn sẽ thấy lỗi này:

      ...
*  subject: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com
*  start date: Dec 10 02:12:22 2018 GMT
*  expire date: Sep 29 02:12:22 2021 GMT
*  issuer: C=CA; ST=Ontario; L=Toronto; O=Google Canada; OU=Google Cloud Platform; CN=edgemicro; emailAddress=srinandans@google.com
*  SSL certificate verify result: unable to get local issuer certificate (20), continuing anyway.
> GET /local HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd
>
< HTTP/1.1 502 Bad Gateway
< Date: Wed, 12 Dec 2018 05:25:01 GMT
< Connection: keep-alive
< Content-Length: 93
<
* Connection #0 to host localhost left intact
{"message":"unable to verify the first certificate","code":"UNABLE_TO_VERIFY_LEAF_SIGNATURE"}

    2. Chạy lại Edge Microgateway, nhưng lần này hãy thêm biến NODE_EXTRA_CA_CERTS.

      chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8443:8443 -d --name edgemicro \
-v path_to_your_edgemicro_dir:/opt/apigee/.edgemicro \
-v path_to_your_logs_dir:/opt/apigee/logs \
-e NODE_EXTRA_CA_CERTS=/opt/apigee/.edgemicro/rootca.pem \
-e EDGEMICRO_PORT=8443 \
-e EDGEMICRO_ORG=$EDGEMICRO_ORG \
-e EDGEMICRO_ENV=$EDGEMICRO_ENV \
-e EDGEMICRO_KEY=$EDGEMICRO_KEY \
-e EDGEMICRO_SECRET=$EDGEMICRO_SECRET \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
--link helloworld:helloworld gcr.io/apigee-microgateway/edgemicro

    3. Thực thi lệnh cURL sau. Thay thế basepath và khoá API như trước. Ví dụ:

      curl https://localhost:8443/local -k -H "x-api-key: xxxx" -v

    4. Kiểm tra kết quả đầu ra. Khi thành công, bạn sẽ nhận được phản hồi trạng thái HTTP 200:

      ...
> GET /local HTTP/1.1
> Host: localhost:8443
> User-Agent: curl/7.54.0
> Accept: */*
> x-api-key: 9fVC65pFj8LrmlPmVyxFjx4KgAHTxqSd
>
< HTTP/1.1 200 OK
< x-powered-by: Express
< content-type: text/html; charset=utf-8
< etag: W/"c-M6tWOb/Y57lesdjQuHeB1P/qTV0"
< date: Wed, 12 Dec 2018 05:49:28 GMT
< x-response-time: 421
< Connection: keep-alive
< Transfer-Encoding: chunked
<
Hello world

    Thêm một trình bổ trợ tuỳ chỉnh

    Bạn có thể thêm các tính năng và chức năng mới vào cổng siêu nhỏ bằng cách viết các trình bổ trợ tuỳ chỉnh. Các trình bổ trợ tuỳ chỉnh cho phép bạn tương tác theo phương thức lập trình với các yêu cầu và phản hồi truyền qua cổng siêu nhỏ.

    Bạn có 2 lựa chọn để triển khai các trình bổ trợ cho một phiên bản Edge Microgateway đang chạy trong một vùng chứa Docker:

    Phần còn lại của phần này giả định rằng bạn đã quen với việc viết và định cấu hình các trình bổ trợ cho chế độ thiết lập Edge Microgateway tiêu chuẩn. Nếu không, hãy xem phần Phát triển các trình bổ trợ tuỳ chỉnh.

    Cách A: Gắn thư mục trình bổ trợ vào một ổ đĩa

    (Được thêm trong phiên bản 2.5.27) Các bước thêm trình bổ trợ thông qua một điểm gắn kết ổ đĩa tương tự như các bước cần thiết để thêm bất kỳ trình bổ trợ tuỳ chỉnh nào vào Edge Microgateway. Khi chạy vùng chứa Docker, bạn có thể gắn thư mục trình bổ trợ trên hệ thống cục bộ (ổ đĩa) vào điểm gắn vùng chứa, tức là /opt/apigee/plugins. Sau đó, bạn chỉ định thư mục ổ đĩa cục bộ trong tệp cấu hình Edge Microgateway.

    Các bước sau đây minh hoạ cách sử dụng điểm gắn kết Docker để thêm các trình bổ trợ tuỳ chỉnh.

    1. Dừng Edge Microgateway:

      edgemicro stop

    2. Tạo một thư mục cho các trình bổ trợ tuỳ chỉnh. Ví dụ: tạo

      $HOME/edgemicro/custom/plugins

    3. Thêm thư mục trình bổ trợ tuỳ chỉnh vào tệp cấu hình Edge Microgateway. Ví dụ:

        plugins:
    dir: $HOME/edgemicro/custom/plugins
    sequence:
      - oauth
      - response-uppercase
  ````

    4. Viết và kiểm thử trình bổ trợ theo hướng dẫn trong phần Viết một trình bổ trợ đơn giản. Hãy nhớ đặt mã trình bổ trợ của bạn trong cấu trúc thư mục thích hợp. Ví dụ:

      custom
  |
  |-- plugins
    |
    |- response-uppercase
    |     |- index.js
    |     |- package.json
    |- request-headers
    |     | - index.js
          | - package.json

    5. Chạy vùng chứa Docker bằng một lệnh tương tự như sau, trong đó bạn dùng lựa chọn -v để gắn thư mục trình bổ trợ trên ổ đĩa Docker. Trong lệnh ví dụ sau, thư mục trình bổ trợ $HOME/edgemicro/custom/plugins (nơi có trình bổ trợ tuỳ chỉnh) được liên kết với điểm gắn kết /opt/apigee/plugins của vùng chứa:

      chown -R 100:101 ~/.edgemicro/ \
docker run -P -p 8000:8000 -d --name edgemicro \
-v /var/tmp:/opt/apigee/logs \
-v $HOME/edgemicro/custom/plugins:/opt/apigee/plugins \
-e EDGEMICRO_PROCESSES=1 \
-e EDGEMICRO_ORG=jdoe \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=39c4b561100cd7f258768d1072f3e1d7c17b5f36a18fe89972bb5c9ce7e58fb \
-e EDGEMICRO_SECRET=f5f9e239a38b4e6cc99c2aa067716a84aebdcff9580a7925fc500e402b1a5fa \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicro \
--security-opt=no-new-privileges \
--cap-drop=ALL gcr.io/apigee-microgateway/edgemicro:latest

    6. Gọi API để kiểm thử trình bổ trợ.

    Để biết thêm thông tin, hãy xem phần VOLUME [hệ thống tệp được chia sẻ].

    Cách B: Tạo các trình bổ trợ trong vùng chứa

    Trong lựa chọn này, bạn sẽ tạo các trình bổ trợ vào vùng chứa của mình.

    1. Đóng gói trình bổ trợ

    1. Viết và kiểm thử trình bổ trợ theo hướng dẫn trong phần Viết một trình bổ trợ đơn giản.

    2. Đặt mã trình bổ trợ của bạn vào cấu trúc thư mục thích hợp. Các thư mục trình bổ trợ phải tuân theo một cấu trúc nhất định. Ví dụ sau đây cho thấy cấu trúc mà bạn phải tuân theo, trong đó response-uppercase và request-headers là tên của các thư mục chứa mã trình bổ trợ tuỳ chỉnh (đây chỉ là ví dụ, tên thư mục của bạn có thể khác):

      plugin
  |
  |-- plugins
    |
    |- response-uppercase
    |     |- index.js
    |     |- package.json
    |- request-headers
    |     | - index.js
          | - package.json

    3. cd vào thư mục plugin.

    4. Trong thư mục plugin, hãy nén toàn bộ thư mục plugins:

      zip -r plugins.zip plugins/

    2. Tạo một hình ảnh Docker

    Tiếp theo, hãy tạo một Dockerfile để thêm mã trình bổ trợ vào một hình ảnh Edge Microgateway.

    1. Trong cùng thư mục chứa tệp zip, hãy tạo một tệp mới có tên Dockerfile.

    2. Thêm đoạn mã sau vào Dockerfile rồi lưu tệp:

      USER root
RUN apk update && \
    apk upgrade && \
    apk add zipapk add zip && \
    mkdir /opt/apigee/customplugins && \
    chown apigee:apigee /opt/apigee/customplugins
COPY plugins.zip /opt/apigee/customplugins
RUN su - apigee -c "unzip /opt/apigee/customplugins/plugins.zip -d /opt/apigee/customplugins"
EXPOSE 8000
EXPOSE 8443
USER apigee
ENTRYPOINT ["entrypoint"]

    3. Tạo một hình ảnh Docker Edge Microgateway mới bằng các trình bổ trợ của bạn:

      docker build -t image-name .

      Ví dụ:

      docker build -t edgemicroplugins .

    3. Cập nhật cấu hình Edge Microgateway

    Bây giờ, khi các trình bổ trợ đã được đóng gói, bạn cần thêm chúng vào tệp cấu hình Edge Microgateway.

    1. Mở tệp cấu hình Edge Microgateway trong một trình chỉnh sửa:

      $HOME/.edgemicro/org-env-config.yaml

      Ví dụ:

      vi $HOME/.edgemicro/myorg-test-config.yaml

    2. Thêm thư mục trình bổ trợ vào tệp cấu hình. Trong ví dụ sau, thuộc tính dir chỉ định vị trí của mã trình bổ trợ (mà bạn đã chỉ định trong Dockerfile). Bạn cũng phải chỉ định tên của thư mục trình bổ trợ. Trong ví dụ bên dưới, tên này là response-uppercase. 

      edgemicro:
  ...
  plugins:
    dir: /opt/apigee/plugins
    sequence:
      - oauth
      - response-uppercase

    4. Khởi động cổng vi mô

    Cuối cùng, bạn phải khởi động microgateway trong vùng chứa.

    1. Chạy lệnh sau để mã hoá base64 tệp cấu hình Edge Microgateway nằm trong $HOME/.edgemicro:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/your_org-your_env-config.yaml`

      trong đó your_org và your_env là tổ chức và môi trường mà bạn đã sử dụng khi chạy lệnh edgemicro config.

      Hãy nhớ đặt dấu nháy ngược (`) xung quanh lệnh. Ví dụ:

      export EDGEMICRO_CONFIG=`base64 $HOME/.edgemicro/docs-test-config.yaml`

    2. Chạy Edge Microgateway dưới dạng một vùng chứa. Lệnh này đặt một số biến môi trường mà thời gian chạy vùng chứa dùng để khởi động Edge Microgateway:

      docker run -P -p 8000:8000 -d --name edgemicroplugins \
-e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \
-e EDGEMICRO_ORG=your_org \
-e EDGEMICRO_ENV=your_env \
-e EDGEMICRO_KEY=your_key \
-e EDGEMICRO_SECRET=your_secret \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicroplugins image_name

      Ví dụ:

      docker run -P -p 8000:8000 -d --name edgemicroplugins \
-e EDGEMICRO_PLUGIN_DIR=/opt/apigee/customplugins/plugins \
-e EDGEMICRO_ORG=docs \
-e EDGEMICRO_ENV=test \
-e EDGEMICRO_KEY=d9c34e1aff68ed969273b016699eabf48780e4f652242e72fc88a23e21252cb0 \
-e EDGEMICRO_SECRET=3bc95a71c86a3c8ce04137fbcb788158731t51dfc6cdec13b7c05aa0bd969430 \
-e "EDGEMICRO_CONFIG=$EDGEMICRO_CONFIG" \
-e SERVICE_NAME=edgemicroplugins edgemicroplugins

    3. Gọi API để kiểm thử trình bổ trợ:

      Kiểm thử để đảm bảo mã trình bổ trợ thực thi bằng cách gọi API của bạn và xác minh rằng đầu ra đúng như dự kiến:

      curl -i http://localhost:8000/hello -H "x-api-key:apikey"

      Ví dụ: trình bổ trợ response-uppercase có thể trả về một phản hồi như sau:

      curl -i http://localhost:8000/hello -H "x-api-key:PydUKRDGIXRqF2xh4usn1FLHbhGKVIz"
  HELLO, WORLD!