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

Một bản 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 ở chế độ cho phép. Hãy xem phần Cài đặt tiện ích thiết lập apigee Edge để 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ế độ chờ chính cho Postgres hay không.
  4. Chọn cấu hình Edge của bạn trong danh sách 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 duy nhất để thử nghiệm hoặc trên 13 nút để phát hành chính thức. Hãy xem phần 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 đã chọn, hãy cài đặt tiện ích Edge apigee-setup:
    • Tải tệp Edge bootstrap_4.52.01.sh xuống /tmp/bootstrap_4.52.01.sh.
    • Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-service.
    • Cài đặt tiện ích và các phần phụ thuộc của Edge apigee-setup.

      Hãy xem bài viết Cài đặt tiện ích thiết lập apigee Edge để 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 bạn chọn.

    Xem phần 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. Đây là những tiện ích mà bạn dùng để tạo và quản lý các tổ chức Edge.

    Hãy xem phần Giới thiệu một 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 cũ trên mỗi nút sau khi cài đặt xong, như ví dụ sau cho thấy:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Nên dùng) Sau khi hoàn tất quá trình cài đặt ban đầu, Apigee khuyên bạn nên cài đặt giao diện người dùng Edge mới (tên thành phần là edge-management-ui). Đây là một giao diện người dùng nâng cao dành cho các nhà phát triển và quản trị viên của Apigee Edge for Private Cloud.

    Để biết thêm thông tin, hãy xem phần Cài đặt giao diện người dùng mới của Edge.

Sau khi cài đặt xong, hãy xem danh sách các thao tác thường gặp sau khi cài đặt.

Ai có thể thực hiện 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 RPM và phần phụ thuộc. Để cài đặt, gỡ cài đặt và cập nhật RPM của Edge, các lệnh phải do người dùng gốc hoặc người dùng có toàn quyền truy cập sudo thực hiện. Đối với quyền truy cập sudo đầy đủ, 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 phải là người dùng gốc hoặc là người dùng có toàn quyền truy cập sudo:

  • Tiện ích apigee-service:
    • Các lệnh apigee-service: install, uninstall, update.
    • Các lệnh apigee-all: install, uninstall, update.
  • setup.sh để 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 sudo gốc hoặc đầy đủ nếu không cần thiết.)
  • 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 dưới dạng 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 hiển thị ở trên phải là người dùng có quyền truy cập sudo đầy đủ đối với người dùng "apigee". Những lệnh này bao gồm:

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

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

Để định cấu hình người dùng có toàn quyền truy cập sudo cho người dùng "apigee", hãy sử dụng lệnh "visudo" để chỉnh sửa tệp sudoers cần 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.

Đặt quyền đối với 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à lệnh Edge sử dụng. Dữ liệ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 một 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 được vào tệp này:

  1. Tạo tệp trong trình chỉnh sửa như bất kỳ người dùng nào.
  2. chown chủ sở hữu 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 chọn tệp đó cho người dùng đang chạy dịch vụ Edge.

Tách biệt các tác vụ cài đặt Edge giữa người dùng gốc và người dùng không bị can thiệp vào hệ thống

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

  1. Các thao tác do cấp độ gốc thực hiện:
    1. Tải xuống và chạy tệp bootstrap_4.52.01.sh:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.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ó toàn quyền truy cập sudo cho người dùng "apigee" như mô tả trong phần Tạo một người dùng có quyền truy cập sudo đầy đủ cho 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 RPM của Edge trên nút:
      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM Edge mà bạn cài đặt trên nút 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 có sẵn bao gồm: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

  2. Sau khi người dùng gốc cài đặt RPM Edge trên nút, người dùng có toàn quyền truy cập sudo vào người dùng "apigee" sẽ hoàn tất quá 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 của Edge trên nút. Hình thức của 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 phần 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 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 truyền tệp cấu hình đến tiện ích apigee-setup chứa thông tin về việc cài đặt Edge. Yêu cầu duy nhất đối với các lượt cài đặt ở chế độ im lặng là tệp cấu hình phải cho phép người dùng "apigee" truy cập hoặc đọc được. Ví dụ: đặt tệp vào thư mục /usr/local/var hoặc /usr/local/share trên nút và chown vào "apigee:apigee".

Bạn cần phải nhậ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 đó vào 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 quá trình cài đặt thành phần Edge không thành công, 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 đó bạn muốn thay đổi hay cập nhật mộ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 trên mỗi nút mà tiện ích đang chạy.

Cài đặt qua Internet hoặc ngoài Internet

Để cài đặt Edge trên một nút, nút đó phải truy cập được 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 RPM và phần phụ thuộc của Edge.

  • 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 phản chiếu 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 của Edge, nhưng bạn phải đảm bảo rằng mình có tất cả các phần phụ thuộc khác có sẵn 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 có một nút có quyền truy cập Internet bên ngoài để có thể tải RPM và phần phụ thuộc của Edge xuống. Sau khi tạo kho lưu trữ nội bộ, bạn có thể di chuyển kho lưu trữ đó sang một nút khác hoặc đặt nút đó có thể truy cập được 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 phản chiếu 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ài đặt RPM

Các tệp phân phối Apigee đượ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 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 rõ ràng của từng phần phụ thuộc.

Nếu bạn đang cài đặt trên một máy có kết nối Internet, thì nút này có thể tải các RPM và phần phụ thuộc cần thiết xuống. Tuy nhiên, nếu đang cài đặt từ một nút không có quyền truy cập Internet, bạn thường thiết lập một kho lưu trữ nội bộ chứa mọi phần phụ thuộc cần thiết. Cách duy nhất để đảm bảo tất cả phần phụ thuộc đều có trong kho lưu trữ cục bộ là thử cài đặt, xác định mọi phần phụ thuộc còn thiếu rồi 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 phổ biến

Các công cụ cài đặt Edge dành 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 dùng một số lệnh Yum để quản lý quá trình cài đặt trên một nút.

  • Dọn dẹp tất cả bộ nhớ đệm Yum:
    sudo yum clean all
  • Cách cập nhật mộ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 sẽ 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 hoạt động Edge, thư mục cài đặt gốc được ghi chú như sau:

/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ý của apigee-setup và tập lệnh setup.sh được ghi vào /tmp/setup-root.log.

Các tệp nhật ký của mỗi thành phần đều nằm trong thư mục /opt/apigee/var/log. Mỗi thành phần đều có thư mục con riêng. Ví dụ: nhật ký của 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ý:

Thành phần Vị trí

Máy chủ quản lý

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

Bộ định tuyến

/opt/apigee/var/log/edge-router

Bộ định tuyến Edge được triển khai bằng Nginx. Để xem nhật ký bổ sung, hãy xem:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

Trình xử lý thư

/opt/apigee/var/log/edge-message-processor

Máy chủ Qpid

/opt/apigee/var/log/edge-qpid-server
Máy chủ Apigee Postgres /opt/apigee/var/log/edge-postgres-server
Giao diện người dùng cổ điển (không phải giao diện người dùng mới của Edge, có tên thành phần là edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
Cơ sở dữ liệu PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

Dữ liệu

Thành phần Vị trí
Máy chủ quản lý /opt/apigee/data/edge-management-server
Bộ định tuyến /opt/apigee/data/edge-router
Trình xử lý thư /opt/apigee/data/edge-message-processor
Tác nhân Apigee Qpid /opt/apigee/data/edge-qpid-server
Nhân viên hỗ trợ Apigee Postgres /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
Cơ sở dữ liệu PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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", thì 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ớ đối với thành phần đang được cài đặt. Giá trị mặc định là "n" để tắt yêu cầu kiểm tra.