Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Sử dụng tiện ích apigee-adminapi.sh

apigee-adminapi.sh gọi API quản lý Edge để thực hiện nhiều tác vụ bảo trì.

Giới thiệu về apigee-adminapi.sh

Ưu điểm

Tiện ích apigee-adminapi.sh có ưu điểm là:

Sử dụng giao diện dòng lệnh đơn giản
Triển khai tính năng tự động hoàn thành lệnh dựa trên thẻ
Cung cấp thông tin trợ giúp và thông tin sử dụng
Có thể hiển thị lệnh gọi API tương ứng nếu bạn quyết định dùng thử API

So sánh với apigee-provision

Tiện ích apigee-adminapi.sh không thay thế cho tiện ích apigee-provision. Tiện ích apigee-provision thực sự sử dụng tiện ích apigee-adminapi.sh để thực hiện các tác vụ của mình.

Điểm khác biệt chính giữa hai tiện ích này là:

apigee-adminapi.sh thực hiện các hàm nguyên tử thay thế cho các lệnh gọi API Edge riêng lẻ. Ví dụ: để tạo một tổ chức, môi trường và máy chủ ảo, bạn cần 3 lệnh apigee-adminapi.sh riêng biệt tương ứng với 3 lệnh gọi API.
apigee-provision thực hiện một thao tác hoàn chỉnh ở cấp cao trong một lệnh. Ví dụ: bạn có thể tạo một tổ chức, môi trường và máy chủ ảo bằng một lệnh apigee-provision bằng cách truyền một tệp cấu hình có chứa tất cả thông tin cần thiết.

Tài liệu Edge sử dụng cả hai tiện ích này khi thích hợp.

Cài đặt apigee-adminapi.sh

Tiện ích apigee-adminapi.sh sẽ tự động được cài đặt khi bạn cài đặt apigee-provision hoặc tiện ích apigee-validate.

Tiện ích này được cài đặt ở vị trí sau:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh

Gọi apigee-adminapi.sh

Bạn gọi apigee-adminapi.sh từ một nút Máy chủ quản lý. Khi gọi tiện ích này, bạn phải xác định các biến môi trường hoặc tuỳ chọn dòng lệnh sau:

ADMIN_EMAIL (tương ứng với tuỳ chọn dòng lệnh admin)
ADMIN_PASSWORD (pwd)
EDGE_SERVER (host)

Ví dụ sau đây gọi apigee-adminapi.sh và truyền các giá trị bắt buộc dưới dạng tuỳ chọn dòng lệnh:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh buildinfo list --admin user@example.com --pwd abcd1234 --host localhost

Ví dụ sau đây xác định các tuỳ chọn bắt buộc dưới dạng biến môi trường tạm thời, sau đó gọi tiện ích apigee-adminapi.sh:

export ADMIN_EMAIL=user@example.com
export ADMIN_PASSWORD=abcd1234
export EDGE_SERVER=192.168.56.101
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list

Nếu bạn không truyền mật khẩu dưới dạng một tuỳ chọn hoặc xác định mật khẩu đó dưới dạng biến môi trường, apigee-adminapi.sh sẽ nhắc bạn nhập mật khẩu.

Đặt các tham số apigee-adminapi.sh

Bạn phải nhập tất cả các tham số cho một lệnh bằng cách sử dụng các công tắc dòng lệnh hoặc bằng cách sử dụng các biến môi trường. Đặt tiền tố cho các công tắc dòng lệnh bằng một dấu gạch ngang (-) hoặc dấu gạch ngang kép (--) theo yêu cầu.

Ví dụ: bạn có thể chỉ định tên tổ chức bằng cách:

Sử dụng công tắc dòng lệnh -o:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs -o testOrg

Đặt một biến môi trường có tên là ORG:

export ORG=testOrg
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs

LƯU Ý: Bạn thường sử dụng các biến môi trường để đặt ADMIN_EMAIL và EDGE_SERVER, và tuỳ ý đặt ADMIN_PASSWORD. Hầu hết các lệnh đều sử dụng các tham số này. Việc đặt các tham số khác, chẳng hạn như ORG, bằng cách sử dụng các biến môi trường có thể gây ra vấn đề là chế độ cài đặt có thể chính xác đối với một lệnh nhưng có thể không chính xác đối với lệnh tiếp theo. Ví dụ : nếu quên đặt lại biến môi trường, bạn có thể vô tình truyền giá trị không chính xác cho lệnh tiếp theo.

Nếu bạn bỏ qua bất kỳ tham số bắt buộc nào cho lệnh, tiện ích này sẽ hiển thị thông báo lỗi mô tả các tham số bị thiếu. Ví dụ: nếu bạn bỏ qua tuỳ chọn --host (tương ứng với biến môi trường EDGE_SERVER), apigee-adminapi.sh sẽ phản hồi bằng lỗi sau:

Error with required variable or parameter
ADMIN_PASSWORD....OK
ADMIN_EMAIL....OK
EDGE_SERVER....null

Nếu bạn nhận được lỗi HTTP STATUS CODE: 401, thì bạn đã nhập sai mật khẩu.

Nhận trợ giúp về apigee-adminapi.sh

Bất cứ lúc nào, hãy sử dụng phím Tab để hiển thị lời nhắc liệt kê các tuỳ chọn lệnh hiện có.

Để xem tất cả các lệnh có thể có, hãy gọi tiện ích này mà không có tuỳ chọn nào:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh

Nếu bạn nhấn phím Tab sau khi nhập apigee-adminapi.sh, bạn sẽ thấy danh sách các tuỳ chọn có thể có:

analytics  classification  logsessions  regions  securityprofile  userroles
buildinfo  GET             orgs         runtime  servers          users

Phím Tab hiển thị các tuỳ chọn dựa trên ngữ cảnh của lệnh. Nếu bạn nhấn phím Tab sau khi nhập:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs

Bạn sẽ thấy các tuỳ chọn có thể có để hoàn tất lệnh orgs:

add  apis  apps  delete  envs  list  pods  userroles

Sử dụng tuỳ chọn -h để hiển thị trợ giúp cho bất kỳ lệnh nào. Ví dụ: nếu bạn sử dụng tuỳ chọn -h như minh hoạ bên dưới:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs -h

Tiện ích này sẽ hiển thị thông tin trợ giúp đầy đủ cho tất cả các tuỳ chọn có thể có đối với lệnh orgs. Mục đầu tiên trong kết quả cho thấy phần trợ giúp cho lệnh orgs add

+++++++++++++++++++++++++++++++++++++++++++
orgs add
  Required:
    -o ORG Organization name
  Optional:
    -H HEADER add http header in request
    --admin ADMIN_EMAIL admin email address
    --pwd ADMIN_PASSWORD admin password
    --host EDGE_SERVER edge server to make request to
    --port EDGE_PORT port to use for the http request
    --ssl set EDGE_PROTO to https, defaults to http
    --debug ( set in debug mode, turns on verbose in curl )
    -h      Displays Help

Truyền tệp vào apigee-adminapi.sh

Tiện ích apigee-adminapi.sh là một trình bao bọc xung quanh curl. Do đó, một số lệnh tương ứng với PUT và POST lệnh gọi API nhận nội dung yêu cầu. Ví dụ: việc tạo một máy chủ ảo tương ứng với một lệnh gọi API POST yêu cầu thông tin về máy chủ ảo trong nội dung yêu cầu.

Khi sử dụng tiện ích apigee-adminapi.sh để tạo một máy chủ ảo hoặc bất kỳ lệnh nào nhận nội dung yêu cầu, bạn có thể truyền tất cả thông tin cần thiết trên dòng lệnh như minh hoạ bên dưới:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -v myVHostUtil -p 9005 -a 192.168.56.101:9005

Hoặc bạn có thể truyền một tệp chứa cùng thông tin như trong nội dung yêu cầu của POST. Ví dụ: lệnh sau đây nhận một tệp xác định máy chủ ảo:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -f vhostcreate

Trong đó, tệp vhostcreate chứa nội dung POST của lệnh gọi. Trong ví dụ này, đó là nội dung yêu cầu được định dạng XML:

<VirtualHost name="myVHostUtil">
  <HostAliases>
    <HostAlias>192.168.56.101:9005</HostAlias>
  </HostAliases>
  <Interfaces/>
  <Port>9005</Port>
</VirtualHost>

Hiển thị thông tin gỡ lỗi và API

Sử dụng tuỳ chọn --debug cho tiện ích apigee-adminapi.sh để hiển thị thông tin chi tiết về lệnh. Thông tin này bao gồm lệnh curl command do tiện ích apigee-adminapi.sh tạo để thực hiện thao tác.

Ví dụ: lệnh sau đây sử dụng tuỳ chọn --debug. Kết quả hiển thị đầu ra của lệnh curl cơ bản ở chế độ chi tiết:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh orgs add -o testOrg2 --admin foo@bar.com --host localhost --debug
curl -H Content-Type: application/xml -v -X POST -s -k -w \n==> %{http_code}
  -u ***oo@bar.com:*****     http://localhost:8080/v1/o -d <Organization name="testOrg2"
  type="paid"/>
  * About to connect() to localhost port 8080 (#0)
  *   Trying ::1... connected
  * Connected to localhost (::1) port 8080 (#0)
  * Server auth using Basic with user 'foo@bar.com'
  > POST /v1/o HTTP/1.1
  > Authorization: Basic c2dp234234NvbkBhcGlnZ2342342342342341Q5
  > User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1
  Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2
  > Host: localhost:8080
  > Accept: */*
  > Content-Type: application/xml
  > Content-Length: 43
  >
  } [data not shown]
  < HTTP/1.1 201 Created
  < Content-Type: application/json
  < Date: Tue, 03 May 2016 02:08:32 GMT
  < Content-Length: 291
  <
  { [data not shown]
  * Connection #0 to host localhost left intact
  * Closing connection #0