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

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

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

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

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

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

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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 ของเราเตอร์ได้

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

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

เรียกใช้ setup-org

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

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

  • สร้างองค์กรใหม่
  • สร้างสภาพแวดล้อม
  • สร้างโฮสต์เสมือนสำหรับสภาพแวดล้อม
  • ตั้งค่าผู้ใช้ที่ระบุเป็นผู้ดูแลระบบขององค์กร โดยมีข้อควรทราบดังนี้
    • คุณสามารถใช้ผู้ใช้ที่มีอยู่หรือสร้างผู้ใช้ใหม่สำหรับผู้ดูแลระบบขององค์กรก็ได้
    • ผู้ดูแลระบบขององค์กรต้องไม่ใช่ ผู้ดูแลระบบ
  • เชื่อมโยงองค์กรกับพ็อด "เกตเวย์" (ซึ่งเป็นค่าเริ่มต้นและเปลี่ยนแปลงไม่ได้ )
  • เชื่อมโยงสภาพแวดล้อมกับ Message Processor ทั้งหมด
  • เปิดใช้ 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 ของ New Edge โดยขอ URL ต่อไปนี้ในเบราว์เซอร์ 
    http://IP_address:3001

    โดย IP_address คือที่อยู่ IP ของเซิร์ฟเวอร์ที่คุณติดตั้ง UI ของ New 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. ตรวจสอบ Analytics โดยเรียกใช้คำสั่งต่อไปนี้ 
    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 ให้ป้อนคำสั่งต่อไปนี้เพื่อดูตาราง Analytics สำหรับ องค์กร

    \d analytics."org_name.env_name.fact"

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

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

      3001 คือหมายเลขพอร์ตเริ่มต้นที่ UI ของ New Edge ใช้

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

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

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

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

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

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