เกี่ยวกับดาวเคราะห์ ภูมิภาค พ็อด องค์กร สภาพแวดล้อม และโฮสต์เสมือน

Edge สำหรับ Private Cloud เวอร์ชัน 4.18.05

การติดตั้ง 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. ผู้ใช้ที่ทําหน้าที่เป็นผู้ดูแลระบบองค์กร จากนั้นผู้ใช้รายนั้นจะเพิ่มผู้ใช้รายอื่นๆ ในองค์กรและกำหนดบทบาทของผู้ใช้แต่ละรายได้
2. พ็อด "เกตเวย์" ซึ่งเป็นพ็อดที่มีตัวประมวลผลข้อความ

องค์กรหนึ่งสามารถมีสภาพแวดล้อมได้มากกว่า 1 รายการ ขั้นตอนการติดตั้ง Edge เริ่มต้นจะให้คุณสร้างสภาพแวดล้อม 2 รายการ ได้แก่ "test" และ "prod" อย่างไรก็ตาม คุณสร้างสภาพแวดล้อมเพิ่มเติมตามความจำเป็นได้ เช่น "การลองใช้งาน" "การทดสอบ" เป็นต้น

องค์กรกำหนดขอบเขตสำหรับความสามารถบางอย่างของ Apigee เช่น ข้อมูลคีย์-ค่าแมป (KVM) จะมีอยู่ในระดับองค์กร ซึ่งหมายถึงจากทุกสภาพแวดล้อม ส่วนความสามารถอื่นๆ เช่น การแคช จะมีขอบเขตอยู่ในสภาพแวดล้อมที่เฉพาะเจาะจง ข้อมูลวิเคราะห์ของ Apigee แบ่งพาร์ติชันโดยทั้งองค์กรและสภาพแวดล้อม

ด้านล่างนี้เป็นออบเจ็กต์หลักขององค์กร ซึ่งรวมถึงออบเจ็กต์ที่กำหนดไว้ทั่วโลกและที่กําหนดให้กับสภาพแวดล้อมโดยเฉพาะ

เกี่ยวกับสภาพแวดล้อม

สภาพแวดล้อมคือบริบทของการดำเนินการรันไทม์สำหรับพร็อกซี API ในองค์กร คุณต้องทำให้พร็อกซี API ใช้งานได้กับสภาพแวดล้อมก่อนจึงจะเข้าถึงได้ คุณจะทำให้พร็อกซี API ใช้งานได้ในสภาพแวดล้อมเดียวหรือหลายสภาพแวดล้อมก็ได้

องค์กรหนึ่งอาจมีหลายสภาพแวดล้อมได้ เช่น คุณอาจกำหนดสภาพแวดล้อม "dev", "test" และ "prod" ในองค์กร

เมื่อสร้างสภาพแวดล้อม คุณจะต้องเชื่อมโยงสภาพแวดล้อมดังกล่าวกับผู้ประมวลผลข้อความอย่างน้อย 1 รายการ คุณอาจมองว่าสภาพแวดล้อมเป็นชุดของตัวประมวลผลข้อความที่มีชื่อที่พร็อกซี API ทำงาน สภาพแวดล้อมการทำงานทั้งหมดจะเชื่อมโยงกับ Message Processor เดียวกันหรือตัวประมวลผลที่แตกต่างกันก็ได้

หากต้องการสร้างสภาพแวดล้อม ให้ระบุข้อมูล 2 อย่างดังนี้

1. องค์กรที่มีสภาพแวดล้อม
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

หลังจากนั้นคุณจะเพิ่มองค์กร สภาพแวดล้อม และโฮสต์เสมือนกี่รายการก็ได้

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเริ่มร่วมงานกับองค์กร