เริ่มร่วมงานกับองค์กร

หากต้องการเริ่มต้นใช้งานองค์กร คุณต้องสร้างไฟล์การกำหนดค่าการเริ่มต้นใช้งาน แล้วส่งไปยังคำสั่ง setup-org อ่านข้อมูลเกี่ยวกับแต่ละขั้นตอนเหล่านี้ได้ในส่วนต่อไปนี้

ดูข้อมูลเกี่ยวกับการใช้ API การจัดการเพื่อเริ่มต้นใช้งานองค์กรได้ที่การสร้างองค์กร สภาพแวดล้อม และโฮสต์เสมือน

สร้างไฟล์การกำหนดค่าการเริ่มต้นใช้งาน

ส่วนนี้ประกอบด้วยตัวอย่างไฟล์การกำหนดค่าสำหรับการเริ่มต้นใช้งานองค์กรด้วย setup-org

คัดลอกตัวอย่างต่อไปนี้และแก้ไขตามที่จำเป็นสำหรับองค์กร

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

โปรดทราบว่า

  • สำหรับ VHOST_ALIAS หากคุณมีระเบียน DNS อยู่แล้วที่จะใช้เข้าถึงโฮสต์เสมือน ให้ระบุชื่อแทนโฮสต์และระบุพอร์ต (ไม่บังคับ) เช่น "myapi.example.com" หากคุณยังไม่มีระเบียน DNS คุณใช้ที่อยู่ IP ของเราเตอร์ได้

    ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีกำหนดค่าโฮสต์เสมือนได้ที่การตั้งค่าโฮสต์เสมือน

  • สำหรับการกำหนดค่า TLS/SSL โปรดดู Keystores และ Truststores และการกำหนดค่าการเข้าถึง TLS ไปยัง API สำหรับ Private Cloud เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างไฟล์ JAR และแง่มุมอื่นๆ ของการกำหนดค่า TLS/SSL
  • โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าโฮสต์เสมือนที่หัวข้อการกำหนดค่าการเข้าถึง TLS ไปยัง API สำหรับ Private Cloud
  • คุณไม่สามารถสร้างองค์กร 2 แห่งที่มีชื่อเดียวกันได้ ในกรณีนี้ การสร้างรายการที่ 2 จะล้มเหลว

ดำเนินการตั้งค่าองค์กร

หลังจากสร้างไฟล์การกำหนดค่าการเริ่มต้นใช้งานแล้ว ให้ส่งไฟล์ดังกล่าวไปยังสคริปต์ setup-org เพื่อดำเนินการขั้นตอนการเริ่มต้นใช้งาน คุณต้องเรียกใช้สคริปต์บนโหนดเซิร์ฟเวอร์การจัดการ

เมื่อเริ่มต้นใช้งานองค์กร สคริปต์ setup-org จะดำเนินการต่อไปนี้

  • สร้างองค์กรใหม่
  • สร้างสภาพแวดล้อม
  • สร้างโฮสต์เสมือนสำหรับสภาพแวดล้อม
  • ตั้งผู้ใช้ที่ระบุเป็นผู้ดูแลระบบขององค์กร โปรดทราบว่า
    • คุณจะใช้ผู้ใช้ที่มีอยู่หรือสร้างผู้ใช้ใหม่สำหรับผู้ดูแลระบบองค์กรก็ได้
    • ผู้ดูแลระบบขององค์กรต้องไม่เป็นคนเดียวกับผู้ดูแลระบบระบบ
  • เชื่อมโยงองค์กรกับพ็อด "เกตเวย์" (ซึ่งเป็นค่าเริ่มต้นและ เปลี่ยนแปลงไม่ได้)
  • เชื่อมโยงสภาพแวดล้อมกับผู้ประมวลผลข้อความทั้งหมด
  • เปิดใช้ Analytics

หากต้องการเรียกใช้ setup-org:

  1. ติดตั้ง apigee-provision ในโหนดเซิร์ฟเวอร์การจัดการ: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. เรียกใช้สคริปต์ setup-org บนโหนดเซิร์ฟเวอร์การจัดการแล้วชี้ไปที่ไฟล์การกำหนดค่าที่คุณสร้างไว้ในสร้างไฟล์การกำหนดค่าการเริ่มต้นใช้งาน โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    ผู้ใช้ "apigee" ต้องอ่านไฟล์การกำหนดค่าได้

  3. ยืนยันว่าคุณได้เริ่มต้นใช้งานองค์กรเรียบร้อยแล้ว วิธีหนึ่งในการตรวจสอบคือการเข้าสู่ระบบ UI ด้วยการขอ URL ต่อไปนี้ในเบราว์เซอร์ 
    http://IP_address:9000/login

    โดย IP_address คือที่อยู่ IP ของเซิร์ฟเวอร์ที่ติดตั้ง Edge UI

    โปรดดูขั้นตอนการยืนยันเพิ่มเติมที่หัวข้อยืนยันการเริ่มต้นใช้งาน

  4. สร้างพร็อกซีแรก

ยืนยันการเริ่มต้นใช้งาน

เมื่อเริ่มต้นใช้งานเรียบร้อยแล้ว ให้ยืนยันสถานะของระบบโดยการออกคำสั่ง curl ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ

  1. ตรวจสอบสถานะผู้ใช้และองค์กรในเซิร์ฟเวอร์การจัดการโดยใช้คำสั่งต่อไปนี้ 
    curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments
  2. ตรวจสอบข้อมูลวิเคราะห์โดยเรียกใช้คำสั่งต่อไปนี้ 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. ตรวจสอบสถานะฐานข้อมูล PostgreSQL โดยเรียกใช้คำสั่งต่อไปนี้บนโหนด 2 (ดังที่แสดงในโทโพโลยีการติดตั้ง) 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

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

    \d analytics."org_name.env_name.fact"

    ใช้คำสั่งต่อไปนี้เพื่อออกจาก psql

    \q
  4. เข้าถึง UI ของ Apigee Edge โดยใช้เว็บเบราว์เซอร์ โปรดทราบว่าคุณได้บันทึก URL ของคอนโซลการจัดการในตอนท้ายของการติดตั้งแล้ว
    1. เปิดเบราว์เซอร์ที่ต้องการและป้อน URL ของ Edge UI ซึ่งจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้ ซึ่งที่อยู่ IP คือสำหรับโหนด 1 (ดังที่แสดงในโทโพโลยีการติดตั้ง) หรือโหนดใดก็ตามที่คุณติดตั้ง UI สำหรับการกำหนดค่าทางเลือก 
      http://192.168.56.111:9000/login

      9000 คือหมายเลขพอร์ตที่ UI ใช้

      หากคุณเริ่มต้นเบราว์เซอร์บนเซิร์ฟเวอร์ที่โฮสต์ Edge UI โดยตรง คุณจะใช้ URL ในแบบฟอร์มต่อไปนี้ได้ 

      http://localhost:9000/login

    2. ในหน้าเข้าสู่ระบบคอนโซล ให้ระบุชื่อผู้ใช้/รหัสผ่านผู้ดูแลระบบของระบบ Apigee
  5. ลงชื่อสมัครใช้บัญชีผู้ใช้ Apigee ใหม่และใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ใหม่เพื่อเข้าสู่ระบบ ในหน้าการลงชื่อเข้าใช้คอนโซล ให้คลิกปุ่มลงชื่อเข้าใช้

    เบราว์เซอร์จะเปลี่ยนเส้นทางไปที่ http://192.168.56.111:9000/platform/#/org_name/ และเปิดหน้าแดชบอร์ดที่ให้คุณกำหนดค่าองค์กรที่คุณสร้างขึ้น (หากเข้าสู่ระบบโดยใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ Apigee)

สร้างพร็อกซีแรก

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

แหล่งข้อมูลอื่นๆ ที่อาจเป็นประโยชน์สำหรับคุณมีดังนี้