Trang này được dịch bởi Cloud Translation API.

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

Edge cho Private Cloud phiên bản 4.17.01

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à một quá trình gồm nhiều bước:

Tắt SELinux trên nút hoặc đặt chế độ này thành chế độ cho phép. Hãy xem phần Cài đặt tiện ích thiết lập apigee-setup của Edge để biết thêm thông tin.
Quyết định xem bạn có muốn bật tính năng xác thực Cassandra hay không.
Quyết định xem bạn có muốn thiết lập tính năng sao chép chính-chờ cho Postgres hay không.
Chọn cấu hình Edge trong danh sách các cấu trú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 để phát hành công khai. Hãy xem bài viết Thiết lập tính năng Sao chép dự phòng chính cho Postgres để biết thêm thông tin.
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 apigee-setup của Edge:
- Tải tệp Edge bootstrap_4.17.01.sh xuống /tmp/bootstrap_4.17.01.sh.
- Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge.
- Cài đặt tiện ích và phần phụ thuộc apigee-setup của Edge.
  
  Hãy xem phần Cài đặt tiện ích thiết lập apigee của Edge để biết thêm thông tin.
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 phần Cài đặt các thành phần Edge trên một nút.
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 sử dụng để tạo và quản lý các tổ chức Edge.
Hãy xem bài viết Giới thiệu về tổ chức để biết thêm thông tin.

Những người có thể 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 Edge, người dùng gốc hoặc người dùng có quyền truy cập sudo đầy đủ phải chạy các lệnh Edge. Đối với quyền truy cập sudo đầy đủ, tức 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ư quyền truy cập gốc.

Mọi người dùng 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 người dùng có toàn quyền truy cập sudo:

Phần mềm tiện ích apigee-service:
- Các lệnh apigee-service: install, gỡ cài đặt, cập nhật.
- apigee-all: install, gỡ cài đặt, cập nhật.
Tập lệnh setup.sh để cài đặt các thành phần Edge (Trừ phi bạn đã sử dụng lệnh "apigee-service install" để cài đặt các RPM bắt buộc. Sau đó, hãy cấp quyền truy cập gốc hoặc quyền truy cập 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 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 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 đối với 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 (bắt đầu, dừng, khởi động lại, định cấu hình).
- apigee-all các lệnh như bắt đầu, dừng, khởi động lại, định cấu hình.

Để đị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 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 đang làm việc với Edge.

Người dùng "apigee" 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. Tệp này bao gồm cả 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 đó:

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

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ề việc cài đặt Edge. Yêu cầu duy nhất đối với các lượt cài đặt thầm là người dùng "apigee" phải có thể truy cập hoặc đọc tệp cấu hình. Ví dụ: đặt tệp vào thư mục /usr/local/var hoặc /usr/local/share trên nút và chèn tệp đó vào "apigee:apigee".

Tất cả thông tin trong tệp cấu hình đều bắt buộc, 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.

Hãy 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 sự cố 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 lỗi hoặc nếu sau này bạn muốn thay đổi hoặc cập nhật một thành phần sau khi cài đặt.

Cài đặt qua Internet hoặc không qua 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 truy cập vào kho lưu trữ Apigee để cài đặt các 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ả 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 có sẵn từ các kho lưu trữ trên mạng nội bộ.

Lưu ý: Apigee không lưu trữ tất cả phần phụ thuộc của bên thứ ba trong các kho lưu trữ công khai của chúng tôi. Bạn phải tải xuống và cài đặt các phần phụ thuộc này từ các kho lưu trữ có thể truy cập công khai.

Để 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 các RPM và phần phụ thuộc 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ữ đó đến một nút khác hoặc cho phép các nút 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 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.

Tuy nhiên, có một lợi thế khác khi sử dụng kho lưu trữ cục bộ, ngay cả đối với các nút có kết nối Internet bên ngoài. Khi cài đặt Edge từ kho lưu trữ công khai của Apigee, bạn luôn cài đặt các RPM Edge mới nhất. Do đó, nếu muốn tải xuống và lưu trữ RPM Edge cho một phiên bản Edge cụ thể, bạn nên tạo một kho lưu trữ cục bộ cho phiên bản Edge đó. Sau đó, bạn có thể sử dụng kho lưu trữ cục bộ đó để cài đặt mọi phiên bản Edge.

Ví dụ: trước tiên, bạn sử dụng kho lưu trữ cục bộ để cài đặt môi trường phát triển Edge. Sau đó, khi đã sẵn sàng chuyển sang môi trường sản xuất, bạn sẽ cài đặt lại Edge từ kho lưu trữ cục bộ. Bằng cách cài đặt từ kho lưu trữ cục bộ, bạn đảm bảo rằng môi trường phát triển và môi trường sản xuất khớp với nhau.

Kho lưu trữ được phản ánh rất linh hoạt. Ví dụ: bạn có thể tạo một kho lưu trữ được phản chiếu từ các RPM Edge mới nhất hoặc từ một phiên bản Edge cụ thể. Sau khi tạo kho lưu trữ, bạn cũng có thể cập nhật kho lưu trữ đó để thêm RPM từ các phiên bản Edge khác nhau. Hãy xem bài viết Cài đặt tiện ích thiết lập apigee của Edge để biết thêm thông tin.

Giải quyết các phần phụ thuộc 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ó một 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 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, nút này có thể tải xuống các RPM và phần phụ thuộc cần thiết. Tuy nhiên, nếu đ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ó trong 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 quá trình 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 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 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 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 Edge Operations Guide, thư mục cài đặt gốc được ghi chú là:

<inst_root>/apigee

Quá trình cài đặt sử dụng cấu trúc hệ thống tệp sau để triển khai Apigee Edge cho Private Cloud.

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 mỗi thành phần nằm trong thư mục /opt/apigee/var/log. Mỗi thành phần có một 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

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

Thành phần	Vị trí
Máy chủ quản lý	<inst_root>/apigee/var/log/edge-management-server
Bộ định tuyến	<inst_root>/apigee/var/log/edge-router
Trình xử lý thông báo	<inst_root>/apigee/var/log/edge-message-processor
Máy chủ Qpid Apigee	<inst_root>/apigee/var/log/edge-qpid-server
Máy chủ Postgres Apigee	<inst_root>/apigee/var/log/edge-postgres-server
Giao diện người dùng Edge	<inst_root>/apigee/var/log/edge-ui
ZooKeeper	<inst_root>/apigee/var/log/apigee-zookeeper
OpenLDAP	<inst_root>/apigee/var/log/apigee-openldap
Cassandra	<inst_root>/apigee/var/log/apigee-cassandra
Qpidd	<inst_root>/apigee/var/log/apigee-qpidd
Cơ sở dữ liệu PostgreSQL	<inst_root>/apigee/var/log/apigee-postgresql

Dữ liệu

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

Thao tác sau khi cài đặt

Sau khi cài đặt xong, bạn có thể thực hiện các thao tác bổ sung trên các thành phần Edge.

Định cấu hình các thành phần Edge sau khi cài đặt

Để định cấu hình Edge sau khi cài đặt, bạn sử dụng kết hợp các tệp .properties và tiện ích Edge. Ví dụ: để định cấu hình TLS/SSL trên giao diện người dùng Edge, bạn chỉnh sửa các tệp .properties để đặt các thuộc tính cần thiết. Bạn cần khởi động lại thành phần Edge bị ảnh hưởng để thực hiện các thay đổi đối với tệp .properties.

Các tệp .properties nằm trong thư mục /opt/apigee/customer/application. Mỗi thành phần có một tệp .properties riêng trong thư mục đó. Ví dụ: router.properties và management-server.properties.

Để đặt thuộc tính cho một thành phần, hãy chỉnh sửa tệp .properties tương ứng, sau đó khởi động lại thành phần:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Ví dụ:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Khi bạn cập nhật Edge, các tệp .properties trong thư mục /opt/apigee/customer/application sẽ được đọc. Điều đó có nghĩa là bản cập nhật sẽ giữ lại mọi thuộc tính mà bạn đặt trên thành phần.

Hãy xem bài viết Cách định cấu hình Edge để biết thêm thông tin về cấu hình Edge.

Gọi lệnh trên các thành phần Edge

Edge cài đặt các tiện ích quản lý trong /opt/apigee/apigee-service/bin mà bạn có thể sử dụng để quản lý quá trình cài đặt Edge. Ví dụ: bạn có thể sử dụng tiện ích apigee-all để bắt đầu, dừng, khởi động lại hoặc xác định trạng thái của tất cả các thành phần Edge trên nút:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Sử dụng tiện ích apigee-service để kiểm soát và định cấu hình từng thành phần. Tiện ích apigee-service có dạng:

/opt/apigee/apigee-service/bin/apigee-service component action

Ví dụ: để khởi động lại Bộ định tuyến cạnh:

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

Bạn có thể xác định danh sách các thành phần được cài đặt trên nút bằng cách kiểm tra thư mục /opt/apigee. Thư mục đó chứa một thư mục con cho mỗi thành phần Edge được cài đặt trên nút. Mỗi thư mục con được đặt tiền tố là:

apigee – một thành phần bên thứ ba mà Edge sử dụng. Ví dụ: apigee-cassandra.
edge – một thành phần Edge của Apigee. Ví dụ: edge-management-server.
edge-mint – một thành phần Kiếm tiền. Ví dụ: edge-mint-management-server.
baas – một thành phần API BaaS. Ví dụ: baas-usergrid.

Danh sách đầy đủ các thao tác cho một thành phần phụ thuộc vào chính thành phần đó, nhưng tất cả các thành phần đều hỗ trợ những thao tác sau:

bắt đầu, dừng, khởi động lại
trạng thái, phiên bản
sao lưu, khôi phục
cài đặt, gỡ cài đặt