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

Edge for Private Cloud v4.19.01

หากต้องการเริ่มต้นใช้งานองค์กร คุณต้องสร้างไฟล์การกําหนดค่าการเริ่มต้นใช้งาน แล้วส่งไฟล์นั้นให้กับคําสั่ง 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 ของเราเตอร์ได้

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

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

เรียกใช้ setup-org

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

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

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

วิธีเรียกใช้ 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 ของเซิร์ฟเวอร์ที่คุณติดตั้ง UI ของ Edge

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

  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

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

    \d analytics."org_name.env_name.fact"

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

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

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

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

      http://localhost:9000/login

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

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

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

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

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