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

Edge for Private Cloud v. 4.17.05

Một quá 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. Xem bài viết Cài đặt tiện ích thiết lập apigee của Edge để khác.
• 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ế độ chờ chính cho Postgres hay không.
• 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 phần Cấu hình cài đặt để biết thêm thông tin.
• 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 bootstrap_4.17.05.sh của Edge xuống /tmp/bootstrap_4.17.05.sh.
  • Cài đặt tiện ích apigee-service của Edge và phần phụ thuộc.
  • Cài đặt tiện ích và các phần phụ thuộc apigee-setup Edge.
    
    Xem bài viết Cài đặt thiết lập apigee của Edge tiện ích nào khác.
• Sử dụng tính năng apigee-setup tiện ích để cài đặt một hoặc nhiều thành phần Edge trên mỗi nút dựa trên lựa chọn của bạn cấu trúc liên kết.
  Xem Cài đặt các thành phần Edge trên một nút trên 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 Làm quen với một tổ chức để tìm hiểu thêm.

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, gỡ cài đặt, cập nhật.
  • Các lệnh apigee-all: install, uninstall, update (cài đặt, gỡ cài đặt, cập nhật).
• 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 settings" (cài đặt dịch vụ apigee) đến cài đặt RPM (doanh thu mỗi nghìn lượt xem) bắt buộc. Sau đó là quyền truy cập gốc hoặc quyền truy cập sudo đầy đủ 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, dừng, khởi động lại, định cấu hình.
  • Các lệnh apigee-all như start, stop, restart, configure (bắt đầu, dừng, khởi động lại, định cấu hình).

Tạo người dùng bằng 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 Cạnh.

Đặt quyền ở trạng thái bật các 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. Cho phép chủ sở hữu tệp là "apigee:apigee" hoặc nếu bạn thay đổi người dùng chạy ứng dụng Edge dịch vụ từ "apigee" người dùng, hãy chia nhỏ tệp cho người dùng đang chạy Edge .

Tách các tác vụ cài đặt Edge giữa người dùng có quyền truy cập thư mục gốc và người dùng không có quyền truy cập 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. Các tác vụ do thư mục gốc thực hiện:
   1. Tải xuống và chạy tệp bootstrap_4.17.05.sh:
      > cuộn tròn https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      Bước này sẽ cài đặt tiện ích apigee-service và tạo "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ả ở trên.
   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 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-ui, 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 tệp setup.sh tiện ích để hoàn tất cấu hình của các thành phần Edge trên nút. Hình thức của phụ thuộc vào thành phần mà bạn đã 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 của 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ấu hình cài đặt tệp

Bạn phải chuyển tệp cấu hình đến tiện ích apigee-setup chứa phần tử 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 /usr/local/var hoặc Thư mục /usr/local/share trên nút và chèn nó thành "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, phần mềm 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 để khác.

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.

Cài đặt qua 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:

• 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.
• 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ó 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 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.

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. Khi cài đặt Edge từ kho lưu trữ công khai Apigee, bạn sẽ luôn cài đặt RPM (doanh thu mỗi nghìn lượt xem) gần đây nhất. Do đó, nếu bạn muốn tải xuống và lưu trữ RPM cạnh cho một chỉ số cụ thể phiên bản Edge thì bạn nên tạo kho lưu trữ cục bộ cho phiên bản Edge đó. Sau đó, bạn có thể sử dụng repo cục bộ để thực hiện cài đặt cho bất kỳ phiên bản Edge nào.

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 lại cài đặt lại Edge từ kho lưu trữ. Bằng cách cài đặt từ kho lưu trữ cục bộ, bạn đảm bảo rằng quá trình phát triển và sản xuất của mình môi trường phù hợp.

Kho lưu trữ được phản chiếu 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ừ RPM mới nhất của Edge hoặc từ một phiên bản cụ thể của Edge. 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. Xem phần Cài đặt tiện ích thiết lập apigee của Edge để khá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 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 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 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.

Các 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 dọn dẹp tất cả
• Cách cập nhật thành phần Edge:
  cập nhật sudo yum componentName
  Ví dụ:
  thiết lập apigee cập nhật sudo yum
  sudo yum cập nhật máy chủ cạnh-quản lý

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ú dưới dạng:

/opt/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 là được ghi vào /tmp/setup-root.log.

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

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ý	/opt/apigee/var/log/edge-management-server
Bộ định tuyến	/opt/apigee/var/log/edge-router Trình định tuyến cạnh được triển khai bằng cách sử dụng Nginx. Để xem thêm nhật ký, hãy xem: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
Trình xử lý tin nhắn	/opt/apigee/var/log/edge-message-processor
Máy chủ Qpid Apigee	/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 Edge	/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
Qpidd	/opt/apigee/var/log/apigee-qpidd
Cơ sở dữ liệu PostgreSQL	/opt/apigee/var/log/apigee-postgresql

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ông báo	/opt/apigee/data/edge-message-processor
Nhân viên hỗ trợ Qpid Apigee	/opt/apigee/data/edge-qpid-server
Tác nhân 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

Tác vụ sau khi cài đặt

Sau khi cài đặt xong, bạn có thể thực hiện thêm thao tác trên các thành phần của 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 hãy sử dụng kết hợp các tệp .properties và các tiện ích của 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 phải thực hiện những thay đổi đối với tệp .properties khởi động lại thành phần Edge bị ảnh hưởng.

Các tệp .properties nằm trong thư mục /opt/apigee/customer/application. Mỗi thành phần có 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, rồi 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 /opt/apigee/customer/application đã được đọc. Điều đó có nghĩa là bản cập nhật 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 Edge thành phần

Các tiện ích quản lý các lượt cài đặt Edge trong /opt/apigee/apigee-service/bin mà bạn có thể dùng để quản lý việc 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 phần mềm tiện ích apigee-service để kiểm soát và định cấu hình các thành phần riêng lẻ. Tiện ích apigee-service có dạng:

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

Ví dụ: để khởi động lại Edge Router:

/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 là có tiền tố là:

• apigee – bên thứ ba thành phần mà Edge sử dụng. Ví dụ: apigee-cassandra.
• Edge – một thành phần Edge từ Apigee. Ví dụ: edge-management-server.
• edge-mint – Kiếm tiền thành phần. Ví dụ: edge-mint-management-server.
• baas – một API BaaS thành phần. 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ợ các 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