Menyetel URL portal

Apigee menyediakan portal Apigee Developer Services (atau cukup disebut portal) yang dapat Anda gunakan untuk membuat dan meluncurkan situs Anda sendiri yang disesuaikan untuk menyediakan semua layanan ini kepada komunitas pengembangan Anda. Pelanggan Edge dapat membuat portal developer mereka sendiri, baik di cloud maupun di infrastruktur lokal. Lihat Apa yang dimaksud dengan portal developer? untuk mengetahui informasi selengkapnya.

UI Edge Baru menampilkan tombol DevPortal di halaman Publish > Portals (atau Publish > Developers) yang, jika diklik, akan membuka portal yang terkait dengan organisasi. Secara default, tombol tersebut akan membuka URL berikut:

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

Dengan orgname adalah nama organisasi.

Anda dapat mengonfigurasi URL portal developer di tingkat organisasi menggunakan properti organisasi, atau mengonfigurasi template URL penggantian global di UI Edge Baru.

Menetapkan URL portal untuk organisasi

Anda dapat menetapkan URL portal ke URL yang berbeda untuk organisasi tertentu, atau menonaktifkan tombol sepenuhnya, dengan menetapkan properti berikut di organisasi:

• features.devportalDisabled: Tetapkan ke false (default) untuk mengaktifkan tombol dan ke true untuk menonaktifkannya.
• features.devportalUrl: Tetapkan ke URL portal developer untuk organisasi.

Anda menetapkan properti ini secara terpisah untuk setiap organisasi. Untuk menetapkan properti ini, pertama-tama gunakan panggilan API berikut untuk menentukan setelan properti saat ini di organisasi:

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

Panggilan ini menampilkan objek yang menjelaskan organisasi dalam bentuk:

{
  "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"
}

Perhatikan properti yang ada di area properties objek. Saat Anda menetapkan properti di organisasi, nilai di properties akan menimpa properti saat ini. Oleh karena itu, jika Anda ingin menetapkan features.devportalDisabled atau features.devportalUrl di organisasi, pastikan Anda menyalin properti yang ada saat Anda menetapkannya.

Gunakan panggilan PUT berikut untuk menetapkan properti di organisasi:

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"
        }
      ]
    }
  }'

Dalam panggilan PUT, Anda hanya perlu menentukan displayName, name, dan properties. Perhatikan bahwa panggilan ini menyertakan foo properti yang awalnya ditetapkan di organisasi.

Menetapkan template URL portal penggantian global di UI Edge Baru

Jika features.devportalUrl tidak ditetapkan di organisasi, UI Edge Baru akan menggunakan template penggantian global yang ditentukan oleh conf_uebe_dev_portal_template (yang secara default adalah http://live-{org}.devportal.apigee.com, dengan {org} diganti dengan nama organisasi).

Untuk mengubah template URL penggantian global di UI Edge Baru:

1. Buka /opt/apigee/customer/application/management-ui.properties di editor. Jika file tidak ada, buat file tersebut:

   vi /opt/apigee/customer/application/management-ui.properties

2. Tetapkan conf_uebe_dev_portal_template menggunakan {org} sebagai placeholder untuk nama organisasi:

   conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"

3. Simpan perubahan Anda dan pastikan file dimiliki oleh pengguna apigee:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

4. Mulai ulang UI Edge Baru:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart