การติดตั้ง Edge Private Cloud หรืออินสแตนซ์ Edge ภายในองค์กรประกอบด้วยคอมโพเนนต์ Edge หลายรายการที่ติดตั้งในชุดโหนดเซิร์ฟเวอร์ รูปภาพต่อไปนี้แสดงความสัมพันธ์ระหว่างดาวเคราะห์ ภูมิภาค พ็อด องค์กร สภาพแวดล้อม และโฮสต์เสมือนที่ประกอบขึ้นเป็นอินสแตนซ์ Edge
ตารางต่อไปนี้อธิบายความสัมพันธ์เหล่านี้
ส่วนประกอบ | ประกอบด้วย | เชื่อมโยงกับ | ค่าเริ่มต้น |
---|---|---|---|
ดาวเคราะห์ | ภูมิภาคอย่างน้อย 1 แห่ง | ไม่มี | |
ภูมิภาค | อย่างน้อย 1 พ็อด | "dc-1" | |
พ็อด | คอมโพเนนต์ Edge อย่างน้อย 1 รายการ | "central" "gateway" "analytics" |
|
องค์กร | สภาพแวดล้อมอย่างน้อย 1 รายการ | อย่างน้อย 1 พ็อดที่มีตัวประมวลผลข้อความและผู้ใช้ทำหน้าที่เป็นผู้ดูแลระบบองค์กร | ไม่มี |
สภาพแวดล้อม | โฮสต์เสมือนอย่างน้อย 1 รายการ | ตัวประมวลผลข้อความอย่างน้อย 1 รายการในพ็อดที่เชื่อมโยงกับองค์กรระดับบนสุด | ไม่มี |
โฮสต์เสมือน | ชื่อแทนโฮสต์อย่างน้อย 1 รายการ | ไม่มี |
เกี่ยวกับดาวเคราะห์
ดาวเคราะห์แสดงถึงสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ของ Edge ทั้งหมด และมีภูมิภาคได้มากกว่า 1 ภูมิภาค ใน Edge ดาวเคราะห์คือการจัดกลุ่มภูมิภาคอย่างเป็นเหตุเป็นผล นั่นคือคุณต้องไม่ได้สร้างหรือกำหนดค่าดาวเคราะห์ดวงนี้เป็นส่วนหนึ่งของการติดตั้ง Edge อย่างชัดแจ้ง
เกี่ยวกับภูมิภาค
ภูมิภาคคือการจัดกลุ่มพ็อดอย่างน้อย 1 รายการ โดยค่าเริ่มต้น เมื่อคุณติดตั้ง Edge โปรแกรมติดตั้งจะสร้างภูมิภาคเดียวที่ชื่อ "dc-1" ซึ่งมี 3 พ็อดตามที่แสดงในตารางต่อไปนี้
ภูมิภาค | พ็อดในภูมิภาค |
---|---|
"dc-1" | "เกตเวย์", "ศูนย์กลาง", "ข้อมูลวิเคราะห์" |
รูปภาพต่อไปนี้แสดงภูมิภาคเริ่มต้น
รูปภาพนี้แสดงตัวจัดสรรภาระงานที่นําการรับส่งข้อมูลไปยังพ็อด "เกตเวย์" พ็อด "gateway" มีคอมโพเนนต์ Edge Router และเครื่องมือประมวลผลข้อความที่จัดการคำขอ API คุณไม่ควรต้องสร้างภูมิภาคเพิ่มเติม เว้นแต่กำหนดศูนย์ข้อมูลไว้หลายแห่ง
ในการติดตั้งที่ซับซ้อนมากขึ้น คุณสามารถสร้างภูมิภาค 2 ภูมิภาคขึ้นไป เหตุผลหนึ่งในการสร้างภูมิภาคต่างๆ คือการจัดระเบียบเครื่องตามพื้นที่ทางภูมิศาสตร์ ซึ่งจะลดเวลาขนส่งของเครือข่าย ในสถานการณ์นี้ คุณต้องโฮสต์ปลายทาง API เพื่อให้ใกล้เคียงกับผู้บริโภคของ API เหล่านั้นตามภูมิศาสตร์
ใน Edge แต่ละภูมิภาคจะเรียกว่าศูนย์ข้อมูล จากนั้น ศูนย์ข้อมูลในสหรัฐอเมริกาฝั่งตะวันออกสามารถจัดการคำขอที่มาจากเมืองบอสตัน รัฐแมสซาชูเซตส์ ส่วนศูนย์ข้อมูลในสิงคโปร์จัดการคำขอจากอุปกรณ์หรือคอมพิวเตอร์ในเอเชียได้
ตัวอย่างเช่น รูปภาพต่อไปนี้แสดง 2 ภูมิภาคตามศูนย์ข้อมูล 2 แห่ง
เกี่ยวกับพ็อด
พ็อดคือการจัดกลุ่มคอมโพเนนต์ Edge อย่างน้อย 1 รายการและพื้นที่เก็บข้อมูล Cassandra คอมโพเนนต์ Edge จะติดตั้งในโหนดเดียวกันได้ แต่โดยทั่วไปจะติดตั้งในโหนดต่างๆ กันมากกว่า พื้นที่เก็บข้อมูล Cassandra คือพื้นที่เก็บข้อมูลที่คอมโพเนนต์ Edge ในพ็อดใช้
โดยค่าเริ่มต้น เมื่อคุณติดตั้ง Edge โปรแกรมติดตั้งจะสร้าง 3 พ็อดและเชื่อมโยงคอมโพเนนต์ Edge และพื้นที่เก็บข้อมูล Cassandra ต่อไปนี้กับแต่ละพ็อด
พ็อด | คอมโพเนนต์ของ Edge | พื้นที่เก็บข้อมูล Cassandra |
|
---|---|---|---|
"gateway" | เราเตอร์, ตัวประมวลผลข้อความ | Cache-datastore Counter-datastore dc-datastore |
keyvaluemap-datastore kms-datastore |
"central" | เซิร์ฟเวอร์การจัดการ, Zookeeper, LDAP, UI, Qpid | application-datastore apimodel-datastore audit-datastore auth-datastore |
Identityzone-datastore edgenotification-datastore เซิร์ฟเวอร์การจัดการ Scheduler-datastore user-settings-datastore |
"analytics" | Postgres | analytics-datastore | reportcrud-datastore |
ต้องมีคอมโพเนนต์ Edge และที่เก็บข้อมูล Cassandra ในพ็อด "เกตเวย์" สำหรับการประมวลผล API คอมโพเนนต์และพื้นที่เก็บข้อมูลเหล่านี้ต้องพร้อมทำงานเพื่อประมวลผลคำขอ API คอมโพเนนต์และพื้นที่เก็บข้อมูลในพ็อด "ศูนย์กลาง" และ "ข้อมูลวิเคราะห์" ไม่จำเป็นต้องประมวลผล API แต่เพิ่มฟังก์ชันอื่นๆ ลงใน Edge
รูปภาพต่อไปนี้แสดงคอมโพเนนต์ในแต่ละพ็อด
คุณเพิ่มตัวประมวลผลข้อความและพ็อดเราเตอร์เพิ่มเติมลงในพ็อดที่สร้างขึ้นโดยค่าเริ่มต้นได้ 3 รายการ หรือคุณสามารถเพิ่มคอมโพเนนต์ Edge เพิ่มเติมลงในพ็อดที่มีอยู่ได้ เช่น คุณอาจเพิ่มเราเตอร์และผู้ประมวลผลข้อมูลข้อความเพิ่มเติมลงในพ็อด "เกตเวย์" เพื่อจัดการกับการโหลดที่เพิ่มขึ้น
โปรดสังเกตว่าพ็อด "เกตเวย์" ประกอบด้วยคอมโพเนนต์ Edge Router และเครื่องมือประมวลผลข้อความ เราเตอร์จะส่งคำขอไปยังผู้ประมวลผลข้อความในพ็อดเดียวกันเท่านั้น และไม่ส่งไปยังผู้ประมวลผลข้อความในพ็อดอื่น
คุณใช้การเรียก API ต่อไปนี้เพื่อดูรายละเอียดการลงทะเบียนเซิร์ฟเวอร์ในช่วงท้ายของการติดตั้งสำหรับแต่ละพ็อดได้ นี่เป็นเครื่องมือตรวจสอบที่มีประโยชน์
curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=podName
โดย ms_IP คือที่อยู่ IP หรือชื่อ DNS ของเซิร์ฟเวอร์การจัดการ และ podName คืออย่างใดอย่างหนึ่งต่อไปนี้
gateway
central
analytics
ตัวอย่างเช่น สำหรับพ็อด "เกตเวย์"
curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=gateway
Apigee จะแสดงผลเอาต์พุตที่คล้ายกับตัวอย่างต่อไปนี้
[ { "externalHostName" : "localhost", "externalIP" : "192.168.1.11", "internalHostName" : "localhost", "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ { "name" : "jmx.rmi.port", "value" : "1101" }, ... ] }, "type" : [ "message-processor" ], "uUID" : "276bc250-7dd0-46a5-a583-fd11eba786f8" }, { "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ ] }, "type" : [ "dc-datastore", "management-server", "cache-datastore", "keyvaluemap-datastore", "counter-datastore", "kms-datastore" ], "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4" }, { "externalHostName" : "localhost", "externalIP" : "192.168.1.11", "internalHostName" : "localhost", "internalIP" : "192.168.1.11", "isUp" : true, "pod" : "gateway", "reachable" : true, "region" : "dc-1", "tags" : { "property" : [ { "name" : "jmx.rmi.port", "value" : "1100" }, ... ] }, "type" : [ "router" ], "uUID" : "de8a0200-e405-43a3-a5f9-eabafdd990e2" } ]
แอตทริบิวต์ type
จะแสดงประเภทคอมโพเนนต์ โปรดทราบว่าระบบจะแสดงพื้นที่เก็บข้อมูล Cassandra ที่ลงทะเบียนในพ็อด ขณะที่ติดตั้งโหนด Cassandra ในพ็อด "เกตเวย์" คุณจะเห็นพื้นที่เก็บข้อมูล Cassandra ที่ลงทะเบียนด้วยพ็อดทั้งหมด
เกี่ยวกับองค์กร
องค์กรคือคอนเทนเนอร์สำหรับออบเจ็กต์ทั้งหมดในบัญชี Apigee รวมถึง API, ผลิตภัณฑ์ API, แอป และนักพัฒนาซอฟต์แวร์ องค์กรเชื่อมโยงกับพ็อดอย่างน้อย 1 รายการ ซึ่งแต่ละพ็อดต้องมีตัวประมวลผลข้อความอย่างน้อย 1 รายการ
ในการติดตั้ง Edge Private Cloud ภายในองค์กร จะไม่มีองค์กรตามค่าเริ่มต้น เมื่อคุณสร้างองค์กร คุณจะต้องระบุข้อมูล 2 อย่างต่อไปนี้
- ผู้ใช้ที่ทําหน้าที่เป็นผู้ดูแลระบบองค์กร จากนั้นผู้ใช้รายนั้นจะเพิ่มผู้ใช้รายอื่นๆ ในองค์กรและกำหนดบทบาทของผู้ใช้แต่ละรายได้
- พ็อด "เกตเวย์" ซึ่งเป็นพ็อดที่มีตัวประมวลผลข้อความ
องค์กรหนึ่งสามารถมีสภาพแวดล้อมได้มากกว่า 1 รายการ ขั้นตอนการติดตั้ง Edge เริ่มต้นจะให้คุณสร้างสภาพแวดล้อม 2 รายการ ได้แก่ "test" และ "prod" อย่างไรก็ตาม คุณสร้างสภาพแวดล้อมเพิ่มเติมตามความจำเป็นได้ เช่น "การลองใช้งาน" "การทดสอบ" เป็นต้น
องค์กรกำหนดขอบเขตสำหรับความสามารถบางอย่างของ Apigee เช่น ข้อมูลคีย์-ค่าแมป (KVM) จะมีอยู่ในระดับองค์กร ซึ่งหมายถึงจากทุกสภาพแวดล้อม ส่วนความสามารถอื่นๆ เช่น การแคช จะมีขอบเขตอยู่ในสภาพแวดล้อมที่เฉพาะเจาะจง ข้อมูลวิเคราะห์ของ Apigee แบ่งพาร์ติชันโดยทั้งองค์กรและสภาพแวดล้อม
ด้านล่างนี้เป็นออบเจ็กต์หลักขององค์กร ซึ่งรวมถึงออบเจ็กต์ที่กำหนดไว้ทั่วโลกและที่กําหนดให้กับสภาพแวดล้อมโดยเฉพาะ
เกี่ยวกับสภาพแวดล้อม
สภาพแวดล้อมคือบริบทของการดำเนินการรันไทม์สำหรับพร็อกซี API ในองค์กร คุณต้องทำให้พร็อกซี API ใช้งานได้กับสภาพแวดล้อมก่อนจึงจะเข้าถึงได้ คุณจะทำให้พร็อกซี API ใช้งานได้ในสภาพแวดล้อมเดียวหรือหลายสภาพแวดล้อมก็ได้
องค์กรหนึ่งอาจมีหลายสภาพแวดล้อมได้ เช่น คุณอาจกำหนดสภาพแวดล้อม "dev", "test" และ "prod" ในองค์กร
เมื่อสร้างสภาพแวดล้อม คุณจะต้องเชื่อมโยงสภาพแวดล้อมดังกล่าวกับผู้ประมวลผลข้อความอย่างน้อย 1 รายการ คุณอาจมองว่าสภาพแวดล้อมเป็นชุดของตัวประมวลผลข้อความที่มีชื่อที่พร็อกซี API ทำงาน สภาพแวดล้อมการทำงานทั้งหมดจะเชื่อมโยงกับ Message Processor เดียวกันหรือตัวประมวลผลที่แตกต่างกันก็ได้
หากต้องการสร้างสภาพแวดล้อม ให้ระบุข้อมูล 2 อย่างดังนี้
- องค์กรที่มีสภาพแวดล้อม
- ตัวประมวลผลข้อความที่จัดการคำขอพร็อกซี API ไปยังสภาพแวดล้อม ตัวประมวลผลข้อความเหล่านี้ต้องอยู่ในพ็อดที่เชื่อมโยงกับองค์กรระดับบนสุดของสภาพแวดล้อม
โดยค่าเริ่มต้น เมื่อสร้างสภาพแวดล้อม Edge จะเชื่อมโยงตัวประมวลผลข้อความที่มีอยู่ทั้งหมดในพ็อด "เกตเวย์" กับสภาพแวดล้อม หรือจะระบุชุดย่อยของ Message Processor ที่ใช้ได้เพื่อให้ผู้ประมวลผลข้อความต่างๆ จัดการคำขอไปยังสภาพแวดล้อมที่ต่างกัน ก็ได้
ตัวประมวลผลข้อความสามารถเชื่อมโยงกับสภาพแวดล้อมต่างๆ ได้ เช่น การติดตั้ง Edge จะมีตัวประมวลผลข้อความ 2 ตัว ได้แก่ A และ B จากนั้นสร้างสภาพแวดล้อม 3 รายการในองค์กร ได้แก่ "dev", "test" และ "prod" ดังนี้
- สำหรับสภาพแวดล้อม "dev" คุณเชื่อมโยงผู้ประมวลผลข้อความ A เนื่องจากไม่คาดว่าจะมีการเข้าชมปริมาณมาก
- สำหรับสภาพแวดล้อม "ทดสอบ" คุณเชื่อมโยงผู้ประมวลผลข้อมูลข้อความ B ไว้เนื่องจากคาดว่าจะไม่ได้มีการเข้าชมจำนวนมาก
- สำหรับสภาพแวดล้อม "prod" คุณเชื่อมโยงทั้งผู้ประมวลผลข้อมูลข้อความ A และ B เพื่อจัดการปริมาณระดับที่ใช้งานจริง
ตัวประมวลผลข้อความที่กำหนดให้กับสภาพแวดล้อมหนึ่งอาจมาจากพ็อดเดียวกันหรือมาจากหลายพ็อด ซึ่งครอบคลุมหลายภูมิภาคและศูนย์ข้อมูล เช่น คุณกำหนดสภาพแวดล้อม "ทั่วโลก" ในองค์กรที่มีผู้ประมวลผลข้อมูลข้อความจาก 3 ภูมิภาค ซึ่งหมายถึงศูนย์ข้อมูล 3 แห่งที่แตกต่างกัน ได้แก่ สหรัฐอเมริกา ญี่ปุ่น และเยอรมนี
การทำให้พร็อกซี API ใช้งานได้ในสภาพแวดล้อม "ส่วนกลาง" จะทำให้พร็อกซี API ทำงานบน ตัวประมวลผลข้อความในศูนย์ข้อมูลทั้ง 3 แห่ง การรับส่งข้อมูล API ที่มาถึงเราเตอร์ในศูนย์ข้อมูลใดศูนย์หนึ่งจะเปลี่ยนเส้นทางไปยังผู้ประมวลผลข้อมูลข้อความในศูนย์ข้อมูลนั้นเท่านั้น เนื่องจากเราเตอร์จะเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังผู้ประมวลผลข้อความในพ็อดเดียวกันเท่านั้น
เกี่ยวกับโฮสต์เสมือน
โฮสต์เสมือนกำหนดพอร์ตบนเราเตอร์ Edge ที่พร็อกซี API แสดง รวมถึง URL ที่แอปใช้เพื่อเข้าถึงพร็อกซี API สำหรับส่วนขยาย สภาพแวดล้อมทั้งหมดต้องกำหนดโฮสต์เสมือนอย่างน้อย 1 รายการ
ตรวจสอบว่าหมายเลขพอร์ตที่ระบุโดยโฮสต์เสมือนเปิดอยู่บนโหนดเราเตอร์ จากนั้นคุณจะเข้าถึงพร็อกซี API ได้โดยการส่งคำขอไปยัง URL ต่อไปนี้
http://routerIP:port/proxy-base-path/resource-name https://routerIP:port/proxy-base-path/resource-name
โดยที่
http
หรือhttps
: หากกำหนดค่าโฮสต์เสมือนให้รองรับ TLS/SSL ให้ใช้ HTTPS หากโฮสต์เสมือนไม่รองรับ TLS/SSL ให้ใช้ HTTP- routerIP:port คือที่อยู่ IP และหมายเลขพอร์ตของโฮสต์เสมือน
- ระบบจะกำหนด proxy-base-path และ resource-name เมื่อคุณสร้างพร็อกซี API
โดยปกติแล้วคุณจะไม่เผยแพร่ API ต่อลูกค้าที่มีที่อยู่ IP และหมายเลขพอร์ต แต่คุณจะระบุรายการ DNS สำหรับเราเตอร์และพอร์ตแทน เช่น
http://myAPI.myCo.com/proxy-base-path/resource-name https://myAPI.myCo.com/proxy-base-path/resource-name
นอกจากนี้ คุณต้องสร้างชื่อแทนโฮสต์สำหรับโฮสต์เสมือนที่ตรงกับชื่อโดเมนของรายการ DNS ด้วย จากตัวอย่างข้างต้น คุณจะต้องระบุชื่อโฮสต์ที่เป็น myAPI.myCo.com หากไม่มีรายการ DNS ให้ตั้งค่าชื่อแทนโฮสต์เป็นที่อยู่ IP ของเราเตอร์และพอร์ตของโฮสต์เสมือนเป็น routerIP:port
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเกี่ยวกับโฮสต์เสมือน
การสร้างองค์กร สภาพแวดล้อม และโฮสต์เสมือนแรก
หลังจากเสร็จสิ้นกระบวนการติดตั้ง Edge แล้ว การดำเนินการแรกของคุณมักจะเป็นการสร้างองค์กร สภาพแวดล้อม และโฮสต์เสมือนผ่านกระบวนการ "เริ่มต้นใช้งาน" หากต้องการเริ่มต้นใช้งาน ให้เรียกใช้คำสั่งต่อไปนี้ในโหนด Edge Management Server
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
คำสั่งนี้ใช้เป็นอินพุตไฟล์กำหนดค่าที่กำหนดผู้ใช้ องค์กร สภาพแวดล้อม และโฮสต์เสมือน
เช่น คุณสร้างสิ่งต่อไปนี้
- ผู้ใช้ที่คุณเลือกทำหน้าที่เป็นผู้ดูแลระบบองค์กร
- องค์กรชื่อ
example
- สภาพแวดล้อมในองค์กรชื่อ
prod
ที่เชื่อมโยงกับตัวประมวลผลข้อความทั้งหมดในพ็อด "เกตเวย์" - โฮสต์เสมือนในสภาพแวดล้อมชื่อ
default
ที่อนุญาตการเข้าถึง HTTP บนพอร์ต 9001 - ชื่อแทนโฮสต์สำหรับโฮสต์เสมือน
หลังจากเรียกใช้สคริปต์แล้ว คุณจะเข้าถึง API โดยใช้ URL ในแบบฟอร์มได้ดังนี้
http://routerIP:9001/proxy-base-path/resource-name
หลังจากนั้นคุณจะเพิ่มองค์กร สภาพแวดล้อม และโฮสต์เสมือนกี่รายการก็ได้
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเริ่มร่วมงานกับองค์กร