ติดตั้งยูทิลิตีการตั้งค่า Edge API

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

หากต้องการติดตั้ง Edge ในโหนด คุณต้องติดตั้งยูทิลิตี Edge Apigee-setup ก่อน หากคุณอยู่ในสภาพแวดล้อมที่โหนดไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องติดตั้งสำเนาที่เก็บ Apigee ในเครื่องด้วย

การสร้างลิงก์สัญลักษณ์จาก /opt/apigee

Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee คุณจะเปลี่ยนไดเรกทอรีนี้ไม่ได้ อย่างไรก็ตาม คุณสามารถสร้างลิงก์สัญลักษณ์เพื่อจับคู่ /opt/apigee กับตำแหน่งอื่นได้หากต้องการ

ก่อนสร้างลิงก์สัญลักษณ์ คุณต้องสร้างผู้ใช้และกลุ่มชื่อ "apigee" ก่อน ซึ่งเป็นกลุ่มและผู้ใช้เดียวกับที่โปรแกรมติดตั้ง Edge สร้างขึ้น

หากต้องการสร้างลิงก์สัญลักษณ์ ให้ทำตามขั้นตอนเหล่านี้ก่อนดาวน์โหลดไฟล์ Bootstrap_4.16.05.sh คุณต้องทําตามขั้นตอนเหล่านี้ทั้งหมดในฐานะรูท

  1. สร้างผู้ใช้และกลุ่ม "apigee" ดังต่อไปนี้
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigeeplatform user" apigee
  2. สร้างลิงก์สัญลักษณ์จาก /opt/apigee ลงในรูทการติดตั้งที่ต้องการ ดังนี้
    > ln -Ts /srv/myInstallDir /opt/apigee
    โดยที่ /srv/myInstallDir เป็นตำแหน่งที่ต้องการของไฟล์ Edge
  3. เปลี่ยนการเป็นเจ้าของรูทการติดตั้งและ Symlink เป็นผู้ใช้ "apigee":
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

สิ่งที่ต้องทำก่อน: ปิดใช้ SELinux

คุณต้องปิดใช้ SELinux หรือตั้งค่าเป็นโหมดอนุญาต ก่อนจึงจะติดตั้งยูทิลิตี apigee-setup ของ Edge หรือคอมโพเนนต์ Edge ได้ หากจำเป็น หลังจากติดตั้ง Edge แล้ว คุณสามารถเปิดใช้ SELinux อีกครั้ง

  • หากต้องการตั้งค่า SELinux เป็นโหมดอนุญาตชั่วคราว ให้ใช้คำสั่งต่อไปนี้
    1. ในระบบปฏิบัติการ Linux 6.x:
      echo 0 > /selinux/enforce

      วิธีเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge ให้ทำดังนี้
      echo 1 > /selinux/enforce
    2. ในระบบปฏิบัติการ Linux 7.x
      setenforce 0

      หากต้องการเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge ให้ทำดังนี้
      setenforce 1
  • หากต้องการปิดใช้ SELinux ถาวร หรือตั้งค่าเป็นโหมดอนุญาต ให้ทำดังนี้
    1. เปิด /etc/sysconfig/selinux ใน ตัวแก้ไข
    2. ตั้งค่า SELINUX=disabled หรือ SELINUX=permissive
    3. บันทึกการแก้ไข
    4. รีสตาร์ทโหนด
    5. หากจำเป็น ให้เปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge โดยทำซ้ำขั้นตอนนี้เพื่อตั้งค่า SELINUX=enabled

ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

วิธีติดตั้ง Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

  1. รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
  2. เข้าสู่ระบบโหนดเป็นรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็ดำเนินการกำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท
  3. ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
  4. ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/Boottrap_4.16.05.sh -o /tmp/Boottrap_4.16.05.sh
  5. ติดตั้ง Edge apigee-serviceยูทิลิตีและ Dependencies:
    > sudo bash /tmp/Boottrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

    โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น

    โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 หรือไม่ หากคุณไม่ได้ทำ ระบบจะติดตั้งให้คุณ ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้

    I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
    C = ดำเนินการต่อโดยไม่ติดตั้ง Java
    Q = Quit คุณต้องติดตั้ง Java ด้วยตนเองสำหรับตัวเลือกนี้

    การติดตั้งยูทิลิตี Apigee-service จะสร้างไฟล์ /etc/yum.repos.d/apigee.repo ที่กำหนดที่เก็บ Apigee หากต้องการดูไฟล์คำจำกัดความ ให้ใช้คำสั่งต่อไปนี้
    > cat /etc/yum.repos.d/apigee.repo

    หากต้องการดูเนื้อหาของที่เก็บ ให้ใช้คำสั่งดังนี้
    > sudo yum -v repolist 'apigee*'
  6. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. ใช้ Apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

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

หมายเหตุ: Apigee ไม่ได้โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา คุณต้องดาวน์โหลดและติดตั้งทรัพยากร Dependency เหล่านี้จากที่เก็บที่เข้าถึงได้แบบสาธารณะ

หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณอาจต้องอัปเดตที่เก็บดังกล่าวด้วยไฟล์การเผยแพร่ Edge ล่าสุดในภายหลัง ส่วนต่อไปนี้อธิบายวิธีสร้างที่เก็บในเครื่องและวิธีอัปเดตที่เก็บ

สร้างที่เก็บ Apigee ในเครื่อง

วิธีสร้างที่เก็บ Apigee ในเครื่อง

  1. รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
  2. เข้าสู่ระบบโหนด RedHat หรือ CentOS เป็นรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็กำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท
  3. ตรวจสอบว่าคุณมี yum-utils เวอร์ชันล่าสุด:
    > sudo yumupdate yum-utils
  4. ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
  5. ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/Boottrap_4.16.05.sh -o /tmp/Boottrap_4.16.05.sh
  6. ติดตั้ง Edge apigee-serviceยูทิลิตีและการอ้างอิง:
    > sudo bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

    โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่ได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น
  7. ติดตั้งยูทิลิตี apigee-mirror บนโหนด:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  8. ใช้ยูทิลิตี apigee-mirror เพื่อซิงค์ที่เก็บ Apigee กับไดเรกทอรี /opt/apigee/data/apigee-mirror/repos/

    หากต้องการลดขนาดของที่เก็บ ให้ใส่ --only-new-rpms เพื่อดาวน์โหลดเฉพาะ RPM ล่าสุด คุณต้องมีพื้นที่ว่างในดิสก์ประมาณ 1.6 GB สําหรับการดาวน์โหลด
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms

    หากต้องการดาวน์โหลดที่เก็บข้อมูลทั้งหมด รวมถึง RPM เก่าๆ ให้ยกเว้น --only-new-rpms คุณต้องมีพื้นที่ว่างประมาณ 6 GB สําหรับการดาวน์โหลดแบบเต็ม
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync

    ตอนนี้คุณมีสำเนาที่เก็บ Apigee ในเครื่องแล้ว หัวข้อถัดไปอธิบายวิธีติดตั้งยูทิลิตี Edge apigee-setup จากที่เก็บในเครื่อง
  9. (ไม่บังคับ) หากต้องการติดตั้ง Edge จากที่เก็บในเครื่องลงในโหนดเดียวกันที่โฮสต์ที่เก็บในเครื่อง คุณจะต้องเรียกใช้คำสั่งต่อไปนี้ก่อน
    1. เรียกใช้ bootstrap_4.16.05.sh จาก repo ภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.16.05.sh:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/ไม้พฤกษ์ repo_4.16.05.sh apigeeprotocol="file://" apigeerepogeedata/apigeeprotocol="file://" apigeerepogeedata/apigeeprotocol="file://" apigeerepogeedata/opt/apigeeth
    2. ใช้ apigee-service เพื่อ ติดตั้งยูทิลิตี apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้ง Apigee-setup บนโหนดระยะไกลจากที่เก็บในเครื่อง

คุณมี 2 ตัวเลือกในการติดตั้ง Edge จากที่เก็บในเครื่อง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

  • สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด จากนั้นติดตั้ง Edge จากไฟล์ .tar
  • ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้

ติดตั้งจากไฟล์ .tar:

  1. บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อแพ็กเกจ repo ในเครื่องลงในไฟล์ .tar เดี่ยวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
  3. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
  4. ในโหนดใหม่ ให้ยกเลิกไฟล์ไปยังไดเรกทอรี /tmp ดังนี้
    > tar -xzf apigee-4.16.05.tar.gz

    คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos
  5. ติดตั้งยูทิลิตี้ Edge apigee-serviceและ Dependencies จาก /tmp/repos:
    > sudo bash /tmp/repos/เนื้อหาภายใน apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    แจ้งให้ทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรีคำสั่ง repos นี้แล้ว
  6. ใช้ apigee-service เพื่อ ติดตั้งยูทิลิตี apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx ดังนี้

  1. ติดตั้งเว็บเซิร์ฟเวอร์ Nginx บนโหนด Repo:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. โดยค่าเริ่มต้น Nginx จะได้รับการกำหนดค่าให้ใช้ localhost เป็นชื่อเซิร์ฟเวอร์และพอร์ต 3939 วิธีเปลี่ยนค่าเหล่านี้
    1. เปิด /opt/apigee/customer/application/mirror.properties ในตัวแก้ไข ให้สร้างไฟล์หากยังไม่มี
    2. กำหนดค่าต่อไปนี้ตามความจำเป็น
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. รีสตาร์ท Nginx:
      > /opt/nginx/scripts/apigee-nginxเกี่ยวกับการรีสตาร์ท
  3. โดยค่าเริ่มต้น ที่เก็บกำหนดให้ต้องมี username:password ของ admin:admin หากต้องการเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้ ให้ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
  5. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge Boottrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
    > /usr/bin/curl http://uName:pWord@REpo:3939/shoestrap_4.16.05 สำหรับ username google.

  6. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี้ Edge apigee-service U และ Dependencies
    > sudo bash /tmp/ Boottrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword protocol

  7. ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup ดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

อัปเดตที่เก็บ Apigee ในเครื่อง

หากต้องการอัปเดตที่เก็บ คุณต้องดาวน์โหลดไฟล์ Bootstrap_4.16.05.sh ล่าสุด จากนั้นดำเนินการ ซิงค์ใหม่

  1. ดาวน์โหลดไฟล์ Edge Boottrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/Boottrap_4.16.05.sh -o /tmp/หัวข้อบูตtrap_4.16.05.sh
  2. ดำเนินการซิงค์
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms
  3. หากต้องการดาวน์โหลดที่เก็บทั้งหมด ให้ทำดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync

ทำความสะอาดที่เก็บ Apigee ในพื้นที่

การล้างที่เก็บในเครื่องจะลบ /opt/apigee/data/apigee-mirror และ /var/tmp/yum-apigee-*

หากต้องการล้างที่เก็บในเครื่อง ให้ใช้

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

เพิ่มหรืออัปเดต Edge 4.16.01 ในที่เก็บ 4.16.05

หากคุณต้องรักษาการติดตั้งสำหรับทั้ง Edge 4.16.05 และ 4.16.01 คุณจะเก็บรักษาที่เก็บที่มีทั้ง 2 เวอร์ชันไว้ได้ จากที่เก็บดังกล่าว คุณจะติดตั้ง Edge 4.16.05 และ 4.16.01 ได้

วิธีเพิ่ม 4.16.01 ไปยังที่เก็บ 4.15.05

  1. ตรวจสอบว่าคุณได้ติดตั้งยูทิลิตี apigee-mirror เวอร์ชัน 4.16.05 แล้ว
    > /opt/apigee/apigee-service/bin/apigee-service apigee-miแสดงรายละเอียดเวอร์ชัน

    คุณจะเห็นผลลัพธ์ในแบบฟอร์มด้านล่าง โดยที่ xyz คือหมายเลขบิลด์:
    apigee-mirror-04.1
  2. ใช้ยูทิลิตี apigee-mirror เพื่อดาวน์โหลด Edge 4.16.01 ไปยังที่เก็บ สังเกตวิธีใส่คำนำหน้าคำสั่งด้วย apigeereleasever=4.16.01:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms

    ใช้คำสั่งเดียวกันนี้เพื่ออัปเดต 4.16.01 ในภายหลัง
  3. ตรวจสอบไดเรกทอรี /opt/apigee/data/apigee-mirror/repos เพื่อดูโครงสร้างไฟล์ ดังนี้
    > ls /opt/apigee/data/apigee-mirror/repos

    คุณควรจะเห็นไฟล์และไดเรกทอรีต่อไปนี้
    apigee.apigee-repo-1.0-6.x86_64.rpmnotice.0-6.x86_64.rpm Notification

    นอกจากนี้ ไดเรกทอรี apigee จะมีไดเรกทอรีแยกกันสำหรับ Edge แต่ละเวอร์ชันด้วย
  4. หากต้องการทำแพ็กเกจที่เก็บในไฟล์ .tar ให้ใช้คำสั่งต่อไปนี้
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    คำสั่งนี้จะรวบรวมทั้งไฟล์ 4.16.05 และ 4.16.01 ไว้ใน .tar เดียวกัน คุณจะสร้างแพ็กเกจเฉพาะบางส่วนของที่เก็บไม่ได้

หากต้องการติดตั้ง Edge จากไฟล์ repo ในเครื่องหรือไฟล์ .tar คุณเพียงแค่ต้องเรียกใช้ไฟล์ Bootstrap ที่ถูกต้องโดยใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้

  • หากติดตั้งจากไฟล์ .tar ให้เรียกใช้ไฟล์ Bootstrap ที่ถูกต้องจาก repo:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    โดยทำตามขั้นตอนที่เหลือจาก "ติดตั้ง" ตามขั้นตอนด้านบน
  • หากติดตั้งโดยใช้เว็บเซิร์ฟเวอร์ Nginx ให้ดาวน์โหลดแล้วเรียกใช้ไฟล์ Boottrap ที่ถูกต้องจาก repo:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh


    bootstrap_4.16.0X.sh