การตั้งค่า URL ของพอร์ทัล

Apigee มีพอร์ทัลบริการสำหรับนักพัฒนาแอปของ Apigee (หรือเรียกง่ายๆ ว่า พอร์ทัล) ให้คุณใช้สร้างและเปิดตัวเว็บไซต์ที่ปรับแต่งเอง เพื่อให้บริการทั้งหมดนี้แก่ชุมชนนักพัฒนาแอป ลูกค้า Edge สามารถสร้างพอร์ทัลนักพัฒนาซอฟต์แวร์ของตนเองได้ ไม่ว่าจะในระบบคลาวด์หรือภายในองค์กร ดูข้อมูลเพิ่มเติมได้ที่ พอร์ทัลนักพัฒนาซอฟต์แวร์คืออะไร สำหรับ ข้อมูลเพิ่มเติม

UI ของ Edge เวอร์ชันใหม่จะแสดงปุ่ม DevPortal ในหน้า เผยแพร่ > พอร์ทัล (หรือ เผยแพร่ > นักพัฒนาแอป) ซึ่งเมื่อคลิกแล้วจะเปิด พอร์ทัลที่เชื่อมโยงกับองค์กร โดยค่าเริ่มต้น ปุ่มดังกล่าวจะเปิด URL ต่อไปนี้

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

โดยที่ orgname คือชื่อขององค์กร

คุณสามารถกำหนดค่า URL ของพอร์ทัลนักพัฒนาซอฟต์แวร์ที่ระดับองค์กรโดยใช้พร็อพเพอร์ตี้ขององค์กร หรือกำหนดค่าเทมเพลต URL สำรองส่วนกลางใน UI ของ Edge เวอร์ชันใหม่

ตั้งค่า URL ของพอร์ทัลสำหรับองค์กร

คุณสามารถตั้งค่า URL ของพอร์ทัลเป็น URL อื่นสำหรับองค์กรที่เฉพาะเจาะจง หรือปิดใช้ ปุ่มโดยสมบูรณ์ได้โดยตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในองค์กร

• features.devportalDisabled: ตั้งค่าเป็น false (ค่าเริ่มต้น) เพื่อเปิดใช้ปุ่ม และตั้งค่าเป็น true เพื่อปิดใช้
• features.devportalUrl: ตั้งค่าเป็น URL ของพอร์ทัลนักพัฒนาซอฟต์แวร์ของ องค์กร

คุณตั้งค่าพร็อพเพอร์ตี้เหล่านี้แยกกันสำหรับแต่ละองค์กร หากต้องการตั้งค่าพร็อพเพอร์ตี้เหล่านี้ ให้ใช้ การเรียก API ต่อไปนี้ก่อนเพื่อกำหนดการตั้งค่าพร็อพเพอร์ตี้ปัจจุบันในองค์กร

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

การเรียกนี้จะแสดงผลออบเจ็กต์ที่อธิบายองค์กรในรูปแบบต่อไปนี้

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

โปรดทราบพร็อพเพอร์ตี้ที่มีอยู่ในส่วน properties ของออบเจ็กต์ เมื่อคุณตั้งค่า พร็อพเพอร์ตี้ในองค์กร ค่าใน properties จะเขียนทับพร็อพเพอร์ตี้ปัจจุบัน ดังนั้น หากต้องการตั้งค่า features.devportalDisabled หรือ features.devportalUrl ในองค์กร โปรดตรวจสอบว่าได้คัดลอกพร็อพเพอร์ตี้ที่มีอยู่ เมื่อตั้งค่า

ใช้การเรียก PUT ต่อไปนี้เพื่อตั้งค่าพร็อพเพอร์ตี้ในองค์กร

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

ในการเรียก PUT คุณจะต้องระบุ displayName, name และ properties เท่านั้น โปรดทราบว่าการเรียกนี้รวมถึง foo พร็อพเพอร์ตี้ที่ตั้งค่าไว้ในองค์กรแต่เดิม

ตั้งค่าเทมเพลต URL ของพอร์ทัลสำรองส่วนกลางใน UI ของ Edge เวอร์ชันใหม่

หากไม่ได้ตั้งค่า features.devportalUrl ในองค์กร UI ของ Edge เวอร์ชันใหม่จะใช้ เทมเพลตสำรองส่วนกลางที่กำหนดโดย conf_uebe_dev_portal_template (ซึ่งมีค่าเริ่มต้นเป็น http://live-{org}.devportal.apigee.com โดยระบบจะแทนที่ {org} ด้วย ชื่อองค์กร)

วิธีเปลี่ยนเทมเพลต URL สำรองส่วนกลางใน UI ของ Edge เวอร์ชันใหม่

1. เปิด /opt/apigee/customer/application/management-ui.properties ในเครื่องมือแก้ไข หากไม่มีไฟล์ ให้สร้างไฟล์โดยทำดังนี้

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

2. ตั้งค่า conf_uebe_dev_portal_template โดยใช้ {org} เป็นตัวยึดตำแหน่ง สำหรับชื่อองค์กร:

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

3. บันทึกการเปลี่ยนแปลงและตรวจสอบว่าผู้ใช้ apigee เป็นเจ้าของไฟล์

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

4. รีสตาร์ท UI ของ Edge เวอร์ชันใหม่

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