Tổng quan về Cài đặt Edge

Một lượt cài đặt Edge điển hình bao gồm các thành phần Edge được phân phối trên nhiều nút. Sau khi cài đặt Edge trên một nút, bạn sẽ cài đặt và định cấu hình một hoặc nhiều thành phần Edge trên nút đó.

Quy trình cài đặt

Việc cài đặt Edge trên một nút là một quy trình gồm nhiều bước:

1. Tắt SELinux trên nút hoặc đặt thành chế độ cho phép. Xem bài viếtCài đặt tiện ích Edge apigee-setup để biết thêm thông tin.
2. Quyết định xem bạn có muốn bật tính năng xác thực Cassandra hay không.
3. Quyết định xem bạn có muốn thiết lập tính năng sao chép chính-dự phòng cho Postgres hay không.
4. Chọn cấu hình Edge trong danh sách các cấu trúc liên kết được đề xuất. Ví dụ: bạn có thể cài đặt Edge trên một nút để kiểm thử hoặc trên 13 nút để sản xuất. Xem Cấu trúc liên kết cài đặt để biết thêm thông tin.
5. Trên mỗi nút trong cấu trúc liên kết mà bạn chọn, hãy cài đặt tiện ích apigee-setup của Edge:
   • Tải tệp Edge bootstrap_4.54.00.sh xuống /tmp/bootstrap_4.54.00.sh.
   • Cài đặt tiện ích apigee-service của Edge và các phần phụ thuộc.
   • Cài đặt tiện ích apigee-setup của Edge và các phần phụ thuộc.

     Xem bài viết Cài đặt tiện ích Edge apigee-setup tiện ích để biết thêm thông tin.

6. Sử dụng tiện ích apigee-setup để cài đặt một hoặc nhiều thành phần Edge trên mỗi nút dựa trên cấu trúc liên kết mà bạn chọn.

   Xem bài viết Cài đặt các thành phần Edge trên một nút.

7. Trên nút Máy chủ quản lý, hãy sử dụng tiện ích apigee-setup để cài đặt apigee-provision, các tiện ích mà bạn dùng để tạo và quản lý tổ chức Edge.

   Xem bài viết Giới thiệu tổ chức để biết thêm thông tin.

8. Khởi động lại thành phần Giao diện người dùng Edge mới trên mỗi nút sau khi quá trình cài đặt hoàn tất, như trong ví dụ sau:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. Định cấu hình chế độ xác thực và các chế độ cài đặt không bắt buộc cho Giao diện người dùng Edge mới (có tên thành phần là edge-management-ui và edge-management-ui-static).

   Để biết thêm thông tin, hãy xem Định cấu hình Giao diện người dùng Edge mới.

Sau khi quá trình cài đặt hoàn tất, hãy xem danh sách các thao tác thường gặp sau khi cài đặt.

Người có thể thực hiện quá trình cài đặt

Các tệp phân phối Apigee Edge được cài đặt dưới dạng một tập hợp các RPM và phần phụ thuộc. Để cài đặt, gỡ cài đặt và cập nhật các RPM Edge, các lệnh phải được chạy bởi người dùng root hoặc người dùng có quyền truy cập sudo đầy đủ. Đối với quyền truy cập sudo đầy đủ, điều đó có nghĩa là người dùng có quyền truy cập sudo để thực hiện các thao tác tương tự như root.

Bất kỳ người dùng nào muốn chạy các lệnh hoặc tập lệnh sau đây đều phải là root hoặc là người dùng có quyền truy cập sudo đầy đủ:

• Tiện ích apigee-service:
  • Lệnh apigee-service: install, uninstall, update.
  • Lệnh apigee-all: install, uninstall, update.
• setup.sh tập lệnh để cài đặt các thành phần Edge (Trừ phi bạn đã sử dụng "apigee-service install" để cài đặt các RPM bắt buộc. Sau đó, quyền truy cập root hoặc sudo đầy đủ nếu không bắt buộc.)
• Tập lệnh update.sh để cập nhật các thành phần Edge

Ngoài ra, trình cài đặt Edge sẽ tạo một người dùng mới trên hệ thống của bạn, có tên là "apigee". Nhiều lệnh Edge gọi sudo để chạy với tư cách người dùng "apigee".

Bất kỳ người dùng nào muốn chạy tất cả các lệnh khác ngoài các lệnh được hiển thị ở trên đều phải là người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee". Các lệnh này bao gồm:

• Các lệnh tiện ích apigee-service, bao gồm:
  • Các lệnh apigee-service như start, stop, restart, configure.
  • Các lệnh apigee-all như start, stop, restart, configure.

Tạo người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee"

Để định cấu hình người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee", hãy sử dụng lệnh "visudo" để chỉnh sửa tệp sudoers nhằm thêm:

installUser        ALL=(apigee)      NOPASSWD: ALL

Trong đó, installUser là tên người dùng của người làm việc với Edge.

Thiết lập quyền trên các tệp cấu hình

Người dùng "apigee" phải có thể truy cập vào mọi tệp hoặc tài nguyên mà các lệnh Edge sử dụng. Điều này bao gồm tệp giấy phép Edge và mọi tệp cấu hình.

Khi tạo tệp cấu hình, bạn có thể thay đổi chủ sở hữu của tệp đó thành "apigee:apigee" để đảm bảo rằng các lệnh Edge có thể truy cập vào tệp đó:

1. Tạo tệp trong trình chỉnh sửa với tư cách bất kỳ người dùng nào.
2. chown chủ sở hữu của tệp thành "apigee:apigee" hoặc, nếu bạn đã thay đổi người dùng chạy dịch vụ Edge từ người dùng "apigee", hãy chown tệp thành người dùng đang chạy dịch vụ Edge.

Phân tách các tác vụ cài đặt Edge giữa người dùng root và người dùng không phải root

Mặc dù cách đơn giản nhất là thực hiện toàn bộ quy trình cài đặt Edge với tư cách root hoặc người dùng có quyền truy cập sudo đầy đủ, nhưng không phải lúc nào bạn cũng có thể làm như vậy. Thay vào đó, bạn có thể phân tách quy trình thành các tác vụ do root thực hiện và các tác vụ do người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee" thực hiện.

1. Các tác vụ do root thực hiện:
   1. Tải và chạy tệp bootstrap_4.54.00.sh:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      Bước này sẽ cài đặt tiện ích apigee-service và tạo người dùng "apigee" .

   2. Định cấu hình người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee" như mô tả trong Tạo người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee".
   3. Cài đặt tiện ích apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Sử dụng tiện ích apigee-setup để cài đặt các RPM Edge trên nút:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      Các RPM Edge mà bạn cài đặt trên nút sẽ phụ thuộc vào cấu trúc liên kết của bạn. Danh sách các thành phần hiện có bao gồm: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Sau khi người dùng root cài đặt các RPM Edge trên nút, người dùng có quyền truy cập sudo đầy đủ vào người dùng "apigee" sẽ hoàn tất quy trình định cấu hình:
   1. Sử dụng tiện ích setup.sh để hoàn tất việc định cấu hình các thành phần Edge trên nút. Dạng lệnh phụ thuộc vào các thành phần mà bạn đã cài đặt trên nút. Để xem danh sách đầy đủ, hãy xem bài viết Cài đặt các thành phần Edge trên một nút.

      Ví dụ: để hoàn tất quá trình cài đặt ZooKeeper và Cassandra, hãy sử dụng lệnh sau:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      Trong đó, configFile là tệp cấu hình Edge.

      Hoặc, để thực hiện quá trình cài đặt tất cả trong một, hãy sử dụng lệnh sau:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Vị trí của các tệp cấu hình cài đặt

Bạn phải chuyển tệp cấu hình đến tiện ích apigee-setup chứa thông tin về quá trình cài đặt Edge. Yêu cầu duy nhất đối với quá trình cài đặt thầm lặng là tệp cấu hình phải có thể truy cập hoặc đọc được bởi người dùng "apigee". Ví dụ: hãy đặt tệp vào thư mục /usr/local/var hoặc /usr/local/share trên nút và chown tệp đó thành "apigee:apigee".

Bạn phải cung cấp tất cả thông tin trong tệp cấu hình, ngoại trừ mật khẩu của quản trị viên hệ thống Edge. Nếu bạn bỏ qua mật khẩu, tiện ích apigee-setup sẽ nhắc bạn nhập mật khẩu đó trên dòng lệnh.

Xem bài viết Cài đặt các thành phần Edge trên một nút để biết thêm thông tin.

Xử lý lỗi cài đặt

Trong trường hợp xảy ra lỗi trong quá trình cài đặt thành phần Edge, bạn có thể thử khắc phục vấn đề rồi chạy lại trình cài đặt. Trình cài đặt được thiết kế để chạy nhiều lần trong trường hợp phát hiện thấy lỗi hoặc nếu sau này bạn muốn thay đổi hoặc cập nhật thành phần sau khi cài đặt.

Sau khi cài đặt hoặc nâng cấp, hãy nhớ khởi động lại thành phần Giao diện người dùng Edge mới trên mỗi nút mà thành phần đó đang chạy.

Cài đặt có Internet hoặc không có Internet

Để cài đặt Edge trên một nút, nút đó phải có thể truy cập vào kho lưu trữ Apigee:

• Các nút có kết nối Internet bên ngoài

  Các nút có kết nối Internet bên ngoài sẽ truy cập vào kho lưu trữ Apigee để cài đặt các RPM Edge và phần phụ thuộc.

• Các nút không có kết nối Internet bên ngoài

  Các nút không có kết nối Internet bên ngoài có thể truy cập vào phiên bản được sao chép của kho lưu trữ Apigee mà bạn thiết lập nội bộ. Kho lưu trữ này chứa tất cả các RPM Edge, nhưng bạn phải đảm bảo rằng bạn có tất cả các phần phụ thuộc khác từ các kho lưu trữ trên mạng nội bộ.

  Để tạo kho lưu trữ Apigee nội bộ, bạn cần một nút có quyền truy cập Internet bên ngoài để có thể tải các RPM Edge và phần phụ thuộc xuống. Sau khi tạo kho lưu trữ nội bộ, bạn có thể chuyển kho lưu trữ đó sang một nút khác hoặc cho phép nút đó truy cập vào các nút Edge để cài đặt.

Sử dụng kho lưu trữ Edge cục bộ để duy trì phiên bản Edge

Một trong những lý do để sử dụng kho lưu trữ cục bộ hoặc được sao chép là để cài đặt Edge trên các nút không có kết nối Internet bên ngoài, như mô tả trong phần trước.

Giải quyết các phần phụ thuộc của quá trình cài đặt RPM

Các tệp phân phối Apigee Edge được cài đặt dưới dạng một tập hợp các tệp RPM, mỗi tệp có thể có chuỗi phần phụ thuộc cài đặt riêng. Nhiều phần phụ thuộc trong số này được xác định bởi các thành phần của bên thứ ba nằm ngoài tầm kiểm soát của Apigee và có thể thay đổi bất cứ lúc nào. Do đó, tài liệu không liệt kê số phiên bản cụ thể của từng phần phụ thuộc.

Nếu bạn đang thực hiện quá trình cài đặt trên một máy có quyền truy cập Internet, thì nút đó có thể tải các RPM và phần phụ thuộc cần thiết xuống. Tuy nhiên, nếu bạn đang cài đặt từ một nút không có quyền truy cập Internet, thì bạn thường thiết lập một kho lưu trữ nội bộ chứa tất cả các phần phụ thuộc cần thiết. Cách duy nhất để đảm bảo rằng tất cả các phần phụ thuộc đều được đưa vào kho lưu trữ cục bộ là thử cài đặt, xác định mọi phần phụ thuộc bị thiếu và sao chép các phần phụ thuộc đó vào kho lưu trữ cục bộ cho đến khi cài đặt thành công.

Các lệnh Yum thường dùng

Các công cụ cài đặt Edge cho Linux dựa vào Yum để cài đặt và cập nhật các thành phần. Bạn có thể phải sử dụng một số lệnh Yum để quản lý quá trình cài đặt trên một nút.

• Xoá tất cả bộ nhớ đệm Yum:

  sudo yum clean all

• Cách cập nhật thành phần Edge:

  sudo yum update componentName

  Ví dụ:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Cấu trúc hệ thống tệp

Edge cài đặt tất cả các tệp trong thư mục /opt/apigee.

Trong hướng dẫn này và trong Hướng dẫn về hoạt động của Edge, thư mục cài đặt gốc được ghi chú là:

/opt/apigee

Quá trình cài đặt sử dụng cấu trúc hệ thống tệp sau đây để triển khai Apigee Edge cho Đám mây riêng tư.

Tệp nhật ký

Tệp nhật ký cho apigee-setup và tập lệnh setup.sh được ghi vào /tmp/setup-root.log.

Các tệp nhật ký cho từng thành phần có trong thư mục /opt/apigee/var/log. Mỗi thành phần có thư mục con riêng. Ví dụ: nhật ký cho Máy chủ quản lý nằm trong thư mục:

/opt/apigee/var/log/edge-management-server

Bảng sau đây liệt kê vị trí của các tệp nhật ký:

Dữ liệu

Bật tính năng kiểm tra hệ thống khi cài đặt

Tệp cấu hình cài đặt Edge hỗ trợ thuộc tính sau:

ENABLE_SYSTEM_CHECK=y

Nếu bạn đặt thuộc tính này thành "y", trình cài đặt sẽ kiểm tra để đảm bảo rằng hệ thống đáp ứng các yêu cầu về CPU và bộ nhớ cho thành phần đang được cài đặt. Giá trị mặc định là "n" để tắt tính năng kiểm tra.