Đặt URL của cổng

Apigee cung cấp cho bạn cổng thông tin Dịch vụ dành cho nhà phát triển của Apigee (hoặc đơn giản là cổng thông tin) mà bạn có thể sử dụng để xây dựng và ra mắt trang web tuỳ chỉnh của riêng mình nhằm cung cấp tất cả các dịch vụ này cho cộng đồng phát triển của bạn. Khách hàng của Edge có thể tạo cổng thông tin cho nhà phát triển của riêng họ, trên đám mây hoặc tại chỗ. Hãy xem bài viết Cổng thông tin cho nhà phát triển là gì? để biết thêm thông tin.

Giao diện người dùng Edge mới hiển thị nút DevPortal trên trang Publish > Portals (Phát hành > Cổng) (hoặc Publish > Developers (Phát hành > Nhà phát triển)). Khi nhấp vào nút này, cổng liên kết với một tổ chức sẽ mở ra. Theo mặc định, nút đó sẽ mở URL sau:

http://live-orgname.devportal.apigee.com

Trong đó, orgname là tên của tổ chức.

Bạn có thể định cấu hình URL của cổng thông tin cho nhà phát triển ở cấp tổ chức bằng cách sử dụng các thuộc tính của tổ chức hoặc định cấu hình mẫu URL dự phòng chung trong giao diện người dùng New Edge.

Đặt URL cổng thông tin cho một tổ chức

Bạn có thể đặt URL cổng thông tin thành một URL khác cho một tổ chức cụ thể hoặc tắt hoàn toàn nút này bằng cách đặt các thuộc tính sau cho tổ chức:

  • features.devportalDisabled: Đặt thành false (mặc định) để bật nút và đặt thành true để tắt nút.
  • features.devportalUrl: Đặt thành URL của cổng thông tin cho nhà phát triển của tổ chức.

Bạn đặt các thuộc tính này riêng cho từng tổ chức. Để đặt các thuộc tính này, trước tiên, hãy sử dụng lệnh gọi API sau để xác định chế độ cài đặt thuộc tính hiện tại của tổ chức:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

Lệnh gọi này trả về một đối tượng mô tả tổ chức ở dạng:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "orgname",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

Lưu ý mọi thuộc tính hiện có trong vùng properties của đối tượng. Khi bạn đặt các thuộc tính cho tổ chức, giá trị trong properties sẽ ghi đè mọi thuộc tính hiện tại. Do đó, nếu bạn muốn đặt features.devportalDisabled hoặc features.devportalUrl trong tổ chức, hãy nhớ sao chép mọi tài sản hiện có khi bạn đặt các tài sản đó.

Sử dụng lệnh gọi PUT sau đây để đặt thuộc tính cho tổ chức:

curl -H "Content-Type:application/json" -u adminEmail:pword -X PUT \
  http://ms_IP:8080/v1/organizations/orgname \
  -d '{
    "displayName" : "orgname",
    "name" : "orgname",
    "properties" : {
      "property" : [
        {
          "name" : "foo",
          "value" : "bar"
        },
        {
          "name": "features.devportalUrl",
          "value": "http://dev-orgname.devportal.apigee.com/"
        },
        {
          "name": "features.devportalDisabled",
          "value": "false"
        }
      ]
    }
  }'

Trong lệnh gọi PUT, bạn chỉ phải chỉ định displayName, name và properties. Xin lưu ý rằng lệnh gọi này bao gồm thuộc tính foo được đặt ban đầu trên tổ chức.

Đặt mẫu URL cổng dự phòng chung trong Giao diện người dùng Edge mới

Nếu features.devportalUrl không được thiết lập cho một tổ chức, thì Giao diện người dùng Edge mới sẽ sử dụng mẫu dự phòng chung do conf_uebe_dev_portal_template xác định (mặc định là http://live-{org}.devportal.apigee.com, trong đó {org} được thay thế bằng tên tổ chức).

Cách thay đổi mẫu URL dự phòng chung trong Giao diện người dùng Edge mới:

  1. Mở /opt/apigee/customer/application/management-ui.properties trong trình chỉnh sửa. Nếu tệp không tồn tại, hãy tạo tệp: 
    vi /opt/apigee/customer/application/management-ui.properties
  2. Đặt conf_uebe_dev_portal_template bằng cách sử dụng {org} làm phần giữ chỗ cho tên tổ chức: 
    conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"
  3. Lưu các thay đổi và đảm bảo rằng tệp thuộc sở hữu của người dùng apigee: 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  4. Khởi động lại giao diện người dùng New Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart