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

Một quy trình cài đặt Edge thông thường 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

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

1. Tắt SELinux trên nút hoặc đặt SELinux ở chế độ cho phép. Xem Cài đặt tiện ích thiết lập apigee của Edge cho khác.
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ác lời xin lỗi được đề xuất. Ví dụ: bạn có thể cài đặt Edge trên một nút duy nhất để kiểm thử hoặc trên 13 nút để sản xuất. Xem Thông tin liên hệ về việc cài đặt để tìm hiểu thêm.
5. Trên mỗi nút trong cấu trúc liên kết bạn đã chọn, hãy cài đặt tiện ích apigee-setup Edge:
   • Tải tệp Edge bootstrap_4.19.06.sh xuống /tmp/bootstrap_4.19.06.sh
   • Cài đặt tiện ích và các phần phụ thuộc apigee-service của Edge.
   • Cài đặt tiện ích và các phần phụ thuộc apigee-setup của Edge.

     Xem phần Cài đặt thiết lập apigee của Edge tiện ích khác.

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 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 của Edge trên một nút.

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

   Hãy xem bài viết Tham gia một tổ chức để tìm hiểu thêm.

8. Khởi động lại thành phần Giao diện người dùng cổ điển trên từng nút sau khi cài đặt xong, như trong ví dụ sau đây:

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

9. (Nên dùng) Sau khi hoàn tất bước 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 (có tên thành phần là edge-management-ui), là giao diện người dùng nâng cao cho các nhà phát triển và quản trị viên của Apigee Edge cho Private Cloud.

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

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

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

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à người dùng gốc hoặc người dùng với quyền truy cập sudo đầy đủ:

• Phần mềm tiện ích apigee-service:
  • Các lệnh apigee-service: install, uninstall, update.
  • Các lệnh apigee-all: install, uninstall, update.
• Tập lệnh setup.sh để cài đặt các thành phần của Edge (Trừ phi bạn đã sử dụng "apigee-service install" để cài đặt RPM (doanh thu mỗi nghìn lượt xem) bắt buộc. Sau đó là root hoặc đầy đủ sudo nếu không cần thiết.)
• 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, tên là "apigee". Nhiều lệnh Edge gọi sudo để chạy dưới dạng "apigee" người dùng.

Bất kỳ người dùng nào muốn chạy tất cả các lệnh khác ngoài những lệnh nêu trên đều phải là người dùng có toàn quyền truy cập sudo vào "apigee" người dùng. 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.
  • apigee-all chẳng hạn như start, stop, restart, configure.

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

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

"API" phải truy cập được vào mọi tệp hoặc tài nguyên mà các lệnh Edge sử dụng người dùng. Chiến dịch 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 tệp thành "apigee:apigee" để đảm bảo rằng có thể truy cập vào các lệnh của Edge:

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ừ "api" người dùng, hãy chia nhỏ 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 phải thư mục gốc

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 ở cấp thư mục gốc hoặc do người dùng thực hiện có toàn quyền truy cập sudo, điều đó không phải lúc nào cũng có thể. Thay vào đó, bạn có thể tách riêng thành các tác vụ được thực hiện bởi thư mục gốc và các tác vụ do người dùng thực hiện toàn quyền truy cập sudo vào "apigee" người dùng.

1. Tác vụ được thực hiện bởi thư mục gốc:
   1. Tải xuống và chạy tệp bootstrap_4.19.06.sh:

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

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

   2. Định cấu hình người dùng để có toàn quyền truy cập sudo vào "apigee" người dùng như được mô tả trong Tạo một người dùng có toàn quyền truy cập sudo vào "apigee" người dùng.
   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ạnh trên nút:

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

      Các RPM cạnh 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 cạnh trên nút, người dùng có toàn quyền truy cập sudo vào "apigee" người dùng 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 Edge trên nút. Hình thức của lệnh này tuỳ thuộc vào các thành phần mà bạn được cài đặt trên nút. Để xem danh sách đầy đủ, hãy xem 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 hàm 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ích hợp, 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 có chứa thông tin về cách cài đặt Edge. Yêu cầu duy nhất đối với việc cài đặt ngầm là tệp cấu hình phải có thể truy cập hoặc có thể đọc được bởi "apigee" người dùng. Ví dụ: đặt tệp trong thư mục /usr/local/var hoặc /usr/local/share trên nút và chown thành "apigee:apigee".

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

Xem bài viết Cài đặt các thành phần của 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 sự cố, sau đó chạy lại trình cài đặt. Trình cài đặt được thiết kế để chạy lặp lại trong những trường hợp mà hệ thống 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 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 nó đang chạy.

Cài đặt kết nối Internet hoặc không qua Internet

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

• 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 truy cập vào kho lưu trữ Apigee để cài đặt Edge RPM (doanh thu mỗi nghìn lượt xem) và phần phụ thuộ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 Apigee mà bạn thiết lập nội bộ. Kho lưu trữ này chứa tất cả RPM của Edge, nhưng bạn phải đảm bảo rằng bạn có sẵn tất cả các phần phụ thuộc khác từ các kho lưu trữ trên mạng.

  Để tạo kho lưu trữ Apigee nội bộ, bạn cần có một nút có kết nối Internet bên ngoài để có thể tải các phần phụ thuộc và RPM của Edge xuống. Sau khi tạo repo nội bộ, sau đó bạn có thể di chuyển nó đến một nút khác hoặc cho phép Edge truy cập vào nút đó để 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 đồng bộ hoá hai 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 khi 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 do bên thứ ba xác định những thành phần 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 này 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 thực hiện cài đặt trên máy có truy cập Internet, nút có thể tải xuống các RPM và phần phụ thuộc cần thiết. Tuy nhiên, nếu bạn cài đặt từ một nút không có Internet quyền truy cập, 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ó trong repo cục bộ của bạn là thử cài đặt, xác định phần phụ thuộc bị thiếu rồi sao chép chúng vào kho lưu trữ cục bộ cho đến khi cài đặt thành công.

Lệnh Yum phổ biến

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 nhiều lệnh Yum để quản lý việc cài đặt trên một nút.

• Xoá tất cả bộ nhớ đệm của 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 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 thao tác với Edge, thư mục cài đặt gốc được ghi chú là:

/opt/apigee

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

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.

Tệp nhật ký cho từng thành phần có trong /opt/apigee/var/log thư mục. Mỗi thành phần có thư mục con riêng. Ví dụ: nhật ký cho phần Quản lý Máy chủ 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 xem hệ thống có đáp ứng với CPU và các yêu cầu về bộ nhớ đối với thành phần đang được cài đặt. Giá trị mặc định là "n" để vô hiệu hoá .