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

การติดตั้ง 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

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

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