Edge for Private Cloud phiên bản 4.18.01
Yêu cầu về phần cứng
Bạn phải đáp ứng các yêu cầu tối thiểu về phần cứng sau đây để có thể sử dụng trong môi trường cấp sản xuất. Đối với tất cả trường hợp cài đặt được mô tả trong Thông tin xin lỗi về việc cài đặt, các bảng sau liệt kê các yêu cầu tối thiểu về phần cứng cho cấu phần cài đặt.
Trong các bảng này, yêu cầu về ổ đĩa cứng ngoài dung lượng ổ đĩa cứng mà hệ điều hành. Tuỳ thuộc vào ứng dụng và lưu lượng truy cập mạng, quá trình cài đặt có thể cần nhiều hoặc ít tài nguyên hơn danh sách dưới đây.
Thành phần cài đặt | RAM | CPU | Ổ đĩa cứng tối thiểu |
---|---|---|---|
Cassandra | 16 GB | 8 nhân | 250 GB bộ nhớ cục bộ với SSD hoặc HDD nhanh hỗ trợ 2000 IOPS |
Bộ xử lý/Bộ định tuyến tin nhắn trên cùng một máy | 16 GB | 8 nhân | 100 GB |
Analytics – Postgres/Qpid trên cùng một máy chủ (không khuyên dùng cho phiên bản sản xuất) | 16GB* | 8 nhân* | 500 GB – 1 TB** Bộ nhớ mạng***, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1000 IOPS trở lên* |
Analytics – Postgres độc lập | 16GB* | 8 nhân* | 500 GB – 1 TB** Bộ nhớ mạng***, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1000 IOPS trở lên* |
Analytics – Qpid độc lập | 8GB | 4 nhân | Bộ nhớ cục bộ 30 GB – 50 GB có SSD hoặc HDD nhanh
Đối với các cài đặt lớn hơn 250 TPS, HDD có bộ nhớ cục bộ hỗ trợ 1000 IOPS được đề xuất. Kích thước hàng đợi Qpid mặc định là 20 GB. Nếu bạn cần thêm dung lượng, hãy nạp thêm dung lượng Nút Qpid. |
Khác (OpenLDAP, Giao diện người dùng, Máy chủ quản lý) | 4GB | 2 nhân | 60GB |
* Điều chỉnh các yêu cầu hệ thống của Postgres dựa trên thông lượng:
- Dưới 250 TPS: 8GB, 4 lõi có thể được xem xét với mạng được quản lý bộ nhớ*** hỗ trợ 1000 IOPS trở lên
- Hơn 250 TPS: 16 GB, 8 lõi, bộ nhớ mạng được quản lý*** hỗ trợ 1000 IOPS trở lên
- Hơn 1.000 TPS: 16 GB, 8 lõi, bộ nhớ mạng được quản lý*** hỗ trợ 2000 IOPS trở lên
- Hơn 2.000 TPS: 32 GB, 16 lõi, bộ nhớ mạng được quản lý*** hỗ trợ 2000 IOPS trở lên
- Hơn 4.000 TPS: 64 GB, 32 lõi, bộ nhớ mạng được quản lý*** hỗ trợ 4000 IOPS trở lên
** Giá trị ổ đĩa cứng Postgres dựa trên số liệu phân tích có sẵn do Edge thu thập được. Nếu bạn thêm giá trị tùy chỉnh vào dữ liệu phân tích, thì các giá trị này sẽ được tăng lên cho phù hợp. Sử dụng công thức sau để ước tính dung lượng lưu trữ cần thiết:
bytes of storage needed =
(# bytes of analytics data/request) *
(requests/second) *
(seconds/hour) *
(hours of peak usage/day) *
(days/month) *
(months of data retention)
Ví dụ:
(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)
= 1,194,393,600,000 bytes or 1194.4 GB
*** Bạn nên sử dụng Bộ nhớ mạng cho cơ sở dữ liệu Postgresql vì:
- Tính năng này cho phép tự động mở rộng dung lượng lưu trữ nếu và khi là bắt buộc.
- IOPS mạng có thể được điều chỉnh nhanh chóng trong hầu hết môi trường/Hệ thống phụ bộ nhớ/Mạng.
- Bạn có thể bật tính năng tổng quan nhanh mức bộ nhớ trong quá trình sao lưu và khôi phục Cloud.
Ngoài ra, sau đây liệt kê các yêu cầu về phần cứng nếu bạn muốn cài đặt Dịch vụ kiếm tiền:
Thành phần có Kiếm tiền | RAM | CPU | Ổ đĩa cứng |
---|---|---|---|
Máy chủ quản lý (có Dịch vụ kiếm tiền) | 8GB | 4 nhân | 60GB |
Analytics - Postgres/Qpid trên cùng một máy chủ | 16 GB | 8 nhân | Bộ nhớ mạng từ 500 GB đến 1 TB, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1.000 IOPS hoặc cao hơn hoặc sử dụng quy tắc trong bảng trên. |
Analytics – Postgres độc lập | 16 GB | 8 nhân | Bộ nhớ mạng từ 500 GB đến 1 TB, tốt nhất là có phần phụ trợ SSD, hỗ trợ 1.000 IOPS hoặc cao hơn hoặc sử dụng quy tắc trong bảng trên. |
Analytics – Qpid độc lập | 8GB | 4 nhân | Bộ nhớ cục bộ 40 GB – 500 GB có SSD hoặc ổ cứng nhanh
Đối với các cài đặt lớn hơn 250 TPS, HDD có bộ nhớ cục bộ hỗ trợ 1000 IOPS được đề xuất. |
Sau đây là các yêu cầu về phần cứng nếu bạn muốn cài đặt API BaaS:
Thành phần API BaaS | RAM | CPU | Ổ đĩa cứng |
---|---|---|---|
ElasticSearch* | 8GB | 4 nhân | 60-80GB |
Ngăn xếp API BaaS* | 8GB | 4 nhân | 60-80GB |
Cổng API BaaS | 1 GB | 2 nhân | 20GB |
Cassandra** | 16 GB | 8 nhân | 250 GB bộ nhớ cục bộ với SSD hoặc HDD nhanh hỗ trợ 2000 IOPS |
* Bạn có thể cài đặt ElasticSearch và API BaaS Stack trên cùng một nút. Nếu có, định cấu hình ElasticSearch để sử dụng 4GB bộ nhớ (mặc định). Nếu ElasticSearch được cài đặt trên nút riêng, sau đó định cấu hình nút đó để sử dụng 6 GB bộ nhớ.
** Không bắt buộc; thông thường, bạn sẽ sử dụng cùng một cụm Cassandra cho cả Edge và API BaaS Các dịch vụ.
Hệ điều hành và bên thứ ba yêu cầu về phần mềm
Các hướng dẫn cài đặt này và tệp cài đặt được cung cấp đã được kiểm tra trên hệ điều hành và phần mềm bên thứ ba được liệt kê trong Các phiên bản phần mềm và phiên bản được hỗ trợ.
Tạo người dùng apigee
Quy trình cài đặt này sẽ tạo một người dùng hệ thống Unix có tên 'apigee'. Thư mục cạnh và các tệp do "apigee" sở hữu, cũng như các quy trình của Edge. Điều đó có nghĩa là các thành phần Edge sẽ chạy dưới dạng "apigee" người dùng. nếu cần, bạn có thể chạy các thành phần với tư cách là một người dùng khác.
Thư mục cài đặt
Theo mặc định, trình cài đặt ghi tất cả tệp vào thư mục /opt/apigee
. Bạn
không thể thay đổi vị trí thư mục này. Tuy không thể thay đổi thư mục này, nhưng bạn vẫn có thể tạo một
đường liên kết tượng trưng để ánh xạ /opt/apigee
đến một vị trí khác, như được mô tả dưới đây.
Trong phần hướng dẫn này, thư mục cài đặt được ghi chú là
/opt/apigee
.
Tạo đường liên kết tượng trưng từ /opt/apigee
Trước khi tạo đường liên kết tượng trưng, trước tiên bạn phải tạo một người dùng và nhóm có tên "apigee". Đây là cùng một nhóm và người dùng do trình cài đặt Edge tạo.
Để tạo liên kết tượng trưng, hãy thực hiện các bước này trước khi tải tệp bootstrap_4.18.01.sh xuống. Bạn phải thực hiện tất cả các bước sau dưới dạng thư mục gốc:
- Tạo "apigee" người dùng và nhóm:
groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
- Tạo một đường liên kết tượng trưng từ
/opt/apigee
đến thư mục cài đặt gốc mà bạn muốn:ln -Ts /srv/myInstallDir /opt/apigee
trong đó /srv/myInstallDir là vị trí mong muốn của các tệp Edge.
- Thay đổi quyền sở hữu thư mục gốc cài đặt và đường liên kết tượng trưng đến "api" ("API") người dùng:
chown -h apigee:apigee /srv/myInstallDir /opt/apigee
Java
Bạn cần cài đặt phiên bản Java 1.8 được hỗ trợ trên mỗi máy trước khi cài đặt. JDK được hỗ trợ được liệt kê trong Các phiên bản phần mềm và phiên bản được hỗ trợ.
Đảm bảo rằng JAVA_HOME
trỏ đến gốc của JDK để người dùng thực hiện thao tác
cài đặt.
SELinux
Tuỳ thuộc vào chế độ cài đặt của bạn cho SELinux, Edge có thể gặp sự cố khi cài đặt và khởi động Thành phần viền. Nếu cần, bạn có thể vô hiệu hoá SELinux hoặc đặt SELinux sang chế độ cho phép trong cài đặt, sau đó bật lại công cụ này sau khi cài đặt. 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.
Cài đặt mạng
Bạn nên kiểm tra chế độ cài đặt mạng trước khi cài đặt. Trình cài đặt yêu cầu rằng tất cả các máy đều có địa chỉ IP cố định. Hãy dùng các lệnh sau để xác thực cài đặt:
hostname
trả về tên của máyhostname -i
trả về địa chỉ IP cho tên máy chủ có thể được xác định địa chỉ các máy khác.
Tuỳ thuộc vào loại hệ điều hành và phiên bản hệ điều hành, bạn có thể phải chỉnh sửa
/etc/hosts
và /etc/sysconfig/network
nếu tên máy chủ không phải là
đặt chính xác. Hãy xem tài liệu dành cho hệ điều hành cụ thể của bạn để biết thêm thông tin.
Nếu một máy chủ có nhiều thẻ giao diện, thì "tên máy chủ -i" trả về một lệnh được phân tách bằng dấu cách danh sách các địa chỉ IP. Theo mặc định, trình cài đặt Edge sử dụng địa chỉ IP đầu tiên được trả về. Địa chỉ này có thể không chính xác trong mọi trường hợp. Thay vào đó, bạn có thể đặt thuộc tính sau trong tệp cấu hình cài đặt:
ENABLE_DYNAMIC_HOSTIP=y
Khi thuộc tính đó được đặt thành "y", trình cài đặt sẽ nhắc bạn chọn địa chỉ IP để sử dụng làm của quá trình cài đặt. Giá trị mặc định là "n". Xem Tham khảo tệp cấu hình Edge để biết thêm thông tin.
Trình bao bọc TCP
Trình bao bọc TCP có thể chặn hoạt động giao tiếp của một số cổng và có thể ảnh hưởng đến OpenLDAP, Postgres và
Lắp đặt Cassandra. Trên các nút đó, hãy đánh dấu chọn /etc/hosts.allow
và
/etc/hosts.deny
để đảm bảo rằng không có hạn chế về cổng đối với yêu cầu
Các cổng OpenLDAP, Postgres và Cassandra.
iptables
Kiểm tra để đảm bảo rằng không có chính sách nào đối với iptables ngăn chặn khả năng kết nối giữa các nút trên các cổng Edge cần thiết. Nếu cần, bạn có thể dừng iptables trong quá trình cài đặt bằng cách sử dụng :
sudo/etc/init.d/iptables stop
Trên CentOS 7.x:
systemctl stop firewalld
Đảm bảo Bộ định tuyến cạnh có thể truy cập /etc/rc.d/init.d/functions
Các nút Edge Router và BaaS Portal sử dụng bộ định tuyến Nginx và yêu cầu quyền đọc
thành /etc/rc.d/init.d/functions
.
Nếu quy trình bảo mật yêu cầu bạn đặt quyền ở trạng thái bật
/etc/rc.d/init.d/functions
, đừng đặt các mức này ở mức 700, nếu không bộ định tuyến sẽ không thể
đầu. Bạn có thể thiết lập quyền thành 744 để cho phép đọc
/etc/rc.d/init.d/functions
.
Cassandra
Tất cả các nút Cassandra phải được kết nối với một vòng. Cassandra lưu trữ các bản sao dữ liệu trên nhiều nút để đảm bảo độ tin cậy và khả năng chịu lỗi. Chiến lược sao chép cho mỗi Không gian phím cạnh xác định các nút Cassandra nơi đặt bản sao. Để biết thêm thông tin,hãy xem Giới thiệu về Cassandra Hệ số sao chép và mức độ nhất quán.
Cassandra tự động điều chỉnh kích thước vùng nhớ khối xếp Java dựa trên bộ nhớ còn trống. Để biết thêm thông tin, hãy xem Chỉnh Tài nguyên Java. Trong trường hợp hiệu suất suy giảm hoặc mức tiêu thụ bộ nhớ cao.
Sau khi cài đặt Edge cho Đám mây riêng tư, bạn có thể kiểm tra để đảm bảo rằng Cassandra đã được định cấu hình
bằng cách kiểm tra /opt/apigee/apigee-cassandra/conf/cassandra.yaml
. Ví dụ: đảm bảo rằng tập lệnh cài đặt Edge cho Đám mây riêng tư đặt các giá trị sau
thuộc tính:
cluster_name
initial_token
partitioner
seeds
listen_address
rpc_address
snitch
Cơ sở dữ liệu PostgreSQL
Sau khi cài đặt Edge, bạn có thể điều chỉnh các chế độ cài đặt cơ sở dữ liệu PostgreSQL sau đây dựa trên dung lượng RAM có sẵn trên hệ thống của bạn:
conf_postgresql_shared_buffers = 35% of RAM # min 128kB conf_postgresql_effective_cache_size = 45% of RAM conf_postgresql_work_mem = 512MB # min 64kB
Cách đặt những giá trị này:
- Chỉnh sửa tệp postgresql.properties:
vi /opt/apigee/customer/application/postgresql.properties
Nếu tệp không tồn tại, hãy tạo tệp đó.
- Đặt các thuộc tính nêu trên.
- Lưu nội dung bạn chỉnh sửa.
- Khởi động lại cơ sở dữ liệu PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Giới hạn của hệ thống
Đảm bảo rằng bạn đã đặt các giới hạn hệ thống sau đây cho Cassandra và Message Processor nút:
- Trên các nút Cassandra, hãy đặt giới hạn cho memlock mềm và cứng, không có tệp và không gian địa chỉ (dưới dạng) cho
người dùng cài đặt (mặc định là “apigee”) trong
/etc/security/limits.d/90-apigee-edge-limits.conf
như minh hoạ dưới đây:apigee soft memlock unlimited apigee hard memlock unlimited apigee soft nofile 32768 apigee hard nofile 65536 apigee soft as unlimited apigee hard as unlimited
- Trên các nút Trình xử lý thông báo, hãy đặt số lượng chỉ số mô tả tệp mở tối đa thành 64K
trong
/etc/security/limits.d/90-apigee-edge-limits.conf
dưới dạng được hiển thị bên dưới:apigee soft nofile 32768 apigee hard nofile 65536
Nếu cần, bạn có thể tăng giới hạn đó. Ví dụ: nếu bạn có một số lượng lớn mở đồng thời.
jsvc
"jsvc" là điều kiện tiên quyết để sử dụng API BaaS. Phiên bản 1.0.15-dev được cài đặt khi bạn cài đặt API BaaS.
Dịch vụ an ninh mạng (NSS)
Dịch vụ bảo mật mạng (NSS) là một tập hợp các thư viện hỗ trợ việc phát triển các ứng dụng khách và máy chủ có hỗ trợ bảo mật. Bạn phải đảm bảo rằng mình đã cài đặt NSS phiên bản 3.19 trở lên.
Cách kiểm tra phiên bản hiện tại:
yum info nss
Cách cập nhật NSS:
yum update nss
Hãy xem bài viết này từ RedHat để biết thêm thông tin.
Tắt tính năng tra cứu DNS trên IPv6 khi sử dụng NSCD (Trình nền dịch vụ bộ nhớ đệm của dịch vụ tên)
Nếu bạn đã cài đặt và bật NSCD (Name Service Cache Daemon) Trình xử lý thư thực hiện hai tra cứu DNS: một cho IPv4 và một cho IPv6. Bạn phải tắt tính năng tra cứu DNS trên IPv6 khi sử dụng NSCD.
Cách tắt tính năng tra cứu DNS trên IPv6:
- Trên mỗi nút Trình xử lý thư, hãy chỉnh sửa
/etc/nscd.conf
- Đặt thuộc tính sau:
enable-cache hosts no
Tắt IPv6 trên Google Cloud Nền tảng dành cho RedHat/CentOS 7
Nếu bạn đang cài đặt Edge trên RedHat 7 hoặc CentOS 7 trên Google Cloud Platform, thì bạn phải tắt IPv6 trên tất cả các nút Qpid.
Hãy xem tài liệu về RedHat hoặc CentOS để biết phiên bản hệ điều hành cụ thể của bạn để biết hướng dẫn về tắt IPv6. Ví dụ như bạn có thể:
- Mở
/etc/hosts
trong trình chỉnh sửa. - Chèn dấu "#" trong cột một trong các dòng sau để nhận xét về nội dung đó:
#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
- Lưu tệp.
AMI AWS
Nếu bạn đang cài đặt Edge trên Hình ảnh máy Amazon (AMI) của AWS cho Red Hat Enterprise Linux 7.x, trước tiên, bạn phải chạy lệnh sau:
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Công cụ
Trình cài đặt sử dụng các công cụ UNIX sau đây trong phiên bản tiêu chuẩn do EL5 cung cấp hoặc EL6.
awk |
thử nghiệm |
libxslt |
nhịp thở/phút |
giải nén |
tên cơ sở |
grep |
lua-socket |
rpm2cpio |
thêm người dùng |
bash |
hostname |
thiếu |
sed |
wc |
bc |
id |
công cụ mạng |
sudo |
wget |
curl |
cung-thiên-bình |
perl (từ Prop) |
hắc ín |
xerces-c |
cây bách xù | libdb4 | pgrep (từ procp) | tr | ngon |
date |
libdb-cxx |
điểm |
uuid |
chkconfig |
tên dirname | động từ | pwd | uname | |
echo | librdmacm | python |
ntpdate
Bạn nên có máy chủ đã đồng bộ hoá thời gian. Nếu chưa được định cấu hình,
Tiện ích ntpdate
có thể phục vụ mục đích này, điều này xác minh
xem các máy chủ có được đồng bộ hoá về thời gian hay không. Bạn có thể sử dụng yum install ntp
để cài đặt
tiện ích. Điều này đặc biệt hữu ích cho việc sao chép các thiết lập OpenLDAP. Lưu ý rằng bạn thiết lập máy chủ
múi giờ theo giờ UTC.
openldap 2.4
Việc lắp đặt tại chỗ yêu cầu OpenLDAP 2.4. Nếu
máy chủ của bạn có kết nối Internet, thì tập lệnh cài đặt Edge sẽ tải xuống và cài đặt
OpenLDAP. Nếu máy chủ của bạn không có kết nối Internet, bạn phải đảm bảo rằng OpenLDAP
cài đặt trước khi chạy tập lệnh cài đặt Edge. Trên RHEL/CentOS, bạn có thể chạy
yum install openldap-clients openldap-servers
để cài đặt OpenLDAP.
Đối với việc cài đặt 13 máy chủ và 12 máy chủ lưu trữ với 2 Trung tâm dữ liệu, bạn cần Sao chép OpenLDAP do có nhiều nút lưu trữ OpenLDAP.
Tường lửa và máy chủ ảo
Thuật ngữ virtual
thường bị quá tải trong lĩnh vực CNTT, do đó, thuật ngữ này đi kèm với
Apigee Edge để triển khai Đám mây riêng tư và máy chủ ảo. Để làm rõ, có hai
việc sử dụng cụm từ virtual
:
- Máy ảo (VM): Không bắt buộc, nhưng một số hoạt động triển khai sử dụng công nghệ VM để tạo các máy chủ riêng biệt cho các thành phần Apigee. Các máy chủ ảo (như máy chủ thực) có thể có giao diện mạng và tường lửa.
- Máy chủ ảo: Các điểm cuối trên web, tương tự như máy chủ ảo Apache.
Một bộ định tuyến trong máy ảo có thể hiển thị nhiều máy chủ ảo (miễn là các máy chủ này khác nhau trong bí danh máy chủ lưu trữ hoặc trong cổng giao diện của họ).
Tương tự như ví dụ đặt tên, một máy chủ thực A
có thể đang chạy hai máy ảo,
có tên là "VM1" và "VM2". Giả sử "VM1" hiển thị giao diện Ethernet ảo, giao diện này được đặt tên
"eth0" bên trong máy ảo và được chỉ định địa chỉ IP 111.111.111.111
bằng
máy ảo hoá hoặc máy chủ DHCP của mạng; rồi giả định VM2 hiển thị một
Giao diện Ethernet còn có tên là "eth0" và được gán một địa chỉ IP
111.111.111.222
Chúng tôi có thể có một bộ định tuyến Apigee đang chạy trên mỗi máy ảo. Bộ định tuyến hiển thị máy chủ ảo như trong ví dụ giả định này:
Bộ định tuyến Apigee trong VM1 hiển thị 3 máy chủ ảo trên giao diện eth0 (trong đó có một số
địa chỉ IP cụ thể), api.mycompany.com:80
, api.mycompany.com:443
và
test.mycompany.com:80
.
Bộ định tuyến trong VM2 hiển thị api.mycompany.com:80
(cùng tên và cổng với
do VM1 cung cấp).
Hệ điều hành của máy chủ thực tế có thể có tường lửa mạng; nếu có, tường lửa đó
phải được định cấu hình để truyền lưu lượng truy cập TCP bị giới hạn đối với các cổng hiển thị trên
giao diện (111.111.111.111:{80, 443}
và 111.111.111.222:80
). Ngoài ra, mỗi
Hệ điều hành của máy ảo có thể cung cấp tường lửa riêng trên giao diện eth0 và các tường lửa này cũng phải
cho phép cổng 80 và lưu lượng 443 kết nối.
Đường dẫn cơ sở là thành phần thứ ba liên quan đến việc định tuyến lệnh gọi API đến các proxy API khác nhau
mà bạn có thể đã triển khai. Các gói proxy API có thể dùng chung một điểm cuối nếu chúng có các điểm cuối khác nhau
đường dẫn cơ sở. Ví dụ: một đường dẫn cơ sở có thể được định nghĩa là http://api.mycompany.com:80/
và một thuộc tính khác được xác định là http://api.mycompany.com:80/salesdemo
.
Trong trường hợp này, bạn cần một trình cân bằng tải hoặc giám đốc lưu lượng truy cập để phân chia
http://api.mycompany.com:80/ lưu lượng truy cập giữa hai địa chỉ IP
(111.111.111.111
trên VM1 và 111.111.111.222
trên VM2). Chức năng này
dành riêng cho cài đặt cụ thể của bạn và được định cấu hình bởi nhóm mạng cục bộ của bạn.
Đường dẫn cơ sở được thiết lập khi bạn triển khai API. Từ ví dụ trên, bạn có thể triển khai 2 API,
mycompany
và testmycompany
cho tổ chức
mycompany-org
với máy chủ ảo có bí danh máy chủ là
api.mycompany.com
và cổng được đặt thành 80
. Nếu bạn không khai báo
đường dẫn cơ sở trong phần triển khai thì bộ định tuyến không biết phải gửi các yêu cầu đến bằng API nào
sang.
Tuy nhiên, nếu bạn triển khai API testmycompany
với URL cơ sở là
/salesdemo
, thì người dùng truy cập vào API đó bằng
http://api.mycompany.com:80/salesdemo
. Nếu bạn triển khai mycompany API với
URL cơ sở của /
, thì người dùng sẽ truy cập API theo URL
http://api.mycompany.com:80/
Yêu cầu về cổng ở cạnh
Nhu cầu quản lý tường lửa không chỉ dừng lại ở máy chủ ảo; cả máy ảo và máy chủ thực tường lửa phải cho phép lưu lượng truy cập đối với các cổng do thành phần yêu cầu để giao tiếp với từng cổng khác.
Hình ảnh sau đây cho thấy các yêu cầu về cổng đối với mỗi thành phần của Edge:
Lưu ý trên sơ đồ này:
- * Cổng 8082 trên Bộ xử lý thông báo chỉ phải được mở để Bộ định tuyến truy cập khi bạn định cấu hình TLS/SSL giữa Bộ định tuyến và Trình xử lý thư. Nếu bạn không định cấu hình TLS/SSL giữa Bộ định tuyến và Bộ xử lý thư, cấu hình mặc định, cổng 8082 vẫn phải mở trên Trình xử lý thư để quản lý thành phần này nhưng Bộ định tuyến không yêu cầu quyền truy cập vào nội dung đó.
- Các cổng có tiền tố "M" là các cổng dùng để quản lý thành phần và phải được mở trên và phải mở trên thành phần đó để Máy chủ quản lý có thể truy cập.
- Các thành phần sau yêu cầu quyền truy cập vào cổng 8080 trên Máy chủ quản lý: Bộ định tuyến, Message Processor (Trình xử lý thông báo), UI, Postgres và Qpid.
- Bộ xử lý thông báo phải mở cổng 4528 làm cổng quản lý. Nếu bạn có nhiều Tất cả các Bộ xử lý thư này phải có thể truy cập lẫn nhau qua cổng 4528 (được biểu thị bằng mũi tên lặp lại trong sơ đồ ở trên cho cổng 4528 trên Bộ xử lý thông báo). Nếu bạn có nhiều Đối với Trung tâm dữ liệu, cổng phải truy cập được từ tất cả Trình xử lý thông báo trong mọi Trung tâm dữ liệu.
- Mặc dù không bắt buộc nhưng bạn có thể mở cổng 4527 trên Bộ định tuyến để truy cập bằng bất kỳ Thông báo nào Bộ xử lý. Nếu không, bạn có thể thấy thông báo lỗi trong tệp nhật ký của Trình xử lý thư.
- Bộ định tuyến phải mở cổng 4527 làm cổng quản lý. Nếu bạn có nhiều Bộ định tuyến, chúng tất cả đều có thể truy cập với nhau qua cổng 4527 (được biểu thị bằng mũi tên vòng lặp trong sơ đồ ở trên cho cổng 4527 trên Bộ định tuyến).
- Giao diện người dùng Edge yêu cầu quyền truy cập vào Bộ định tuyến, trên các cổng được proxy API hiển thị để hỗ trợ nút Send (Gửi) trong công cụ theo dõi.
- Máy chủ quản lý yêu cầu quyền truy cập vào cổng JMX trên Cassandra nút.
- Quyền truy cập vào cổng JMX có thể được định cấu hình để yêu cầu tên người dùng/mật khẩu. Xem Cách giám sát để biết thêm thông tin.
- Bạn có thể tuỳ ý định cấu hình quyền truy cập TLS/SSL cho một số kết nối nhất định. Chế độ này có thể sử dụng cổng khác nhau. Xem TLS/SSL cho khác.
- Nếu định cấu hình hai nút Postgres để sử dụng tính năng sao chép chế độ chờ chính, bạn phải mở cổng 22 trên mỗi nút để truy cập SSH. Bạn có thể tuỳ ý mở các cổng trên từng nút để cho phép SSH.
- Bạn có thể định cấu hình Management Server và Edge UI để gửi email thông qua một SMTP bên ngoài máy chủ. Nếu làm như vậy, bạn phải đảm bảo rằng Máy chủ quản lý và giao diện người dùng có thể truy cập vào các thông tin cần thiết cổng trên máy chủ SMTP. Đối với SMTP không phải TLS, số cổng thường là 25. Đối với TLS được bật SMTP, thường là 465, nhưng hãy kiểm tra với nhà cung cấp SMTP của bạn.
Bảng bên dưới cho biết các cổng cần được mở trong tường lửa, theo thành phần Edge:
Thành phần | Cổng | Mô tả |
---|---|---|
Cổng HTTP tiêu chuẩn | 80, 443 | HTTP cùng với mọi cổng khác mà bạn sử dụng cho máy chủ ảo |
Máy chủ quản lý | 8080 | Chuyển các lệnh gọi API quản lý Edge. Các thành phần này cần có quyền truy cập vào cổng 8080 trên Máy chủ quản lý: Bộ định tuyến, Bộ xử lý thư, Giao diện người dùng, Postgres và Qpid. |
1099 | Cổng JMX | |
4526 | Đối với các lệnh gọi quản lý và bộ nhớ đệm được phân phối | |
Giao diện người dùng quản lý | 9000 | Cổng cho phép trình duyệt truy cập vào giao diện người dùng quản lý |
Trình xử lý tin nhắn | 8998 | Cổng Trình xử lý thư để giao tiếp từ Bộ định tuyến |
8082 |
Cổng quản lý mặc định cho Trình xử lý tin nhắn và phải được mở trên thành phần cho quyền truy cập bằng Máy chủ quản lý. Nếu bạn định cấu hình TLS/SSL giữa Bộ định tuyến và Trình xử lý thư, được Bộ định tuyến sử dụng để kiểm tra tình trạng của Bộ xử lý tin nhắn. |
|
1101 | Cổng JMX | |
4528 | Đối với bộ nhớ đệm phân phối và các lệnh gọi quản lý giữa các Trình xử lý thư và cho hoạt động giao tiếp từ Bộ định tuyến và Máy chủ quản lý | |
Bộ định tuyến | 8081 | Cổng quản lý mặc định cho Bộ định tuyến và phải được mở trên thành phần để truy cập bởi Máy chủ quản lý. |
4527 | Đối với các lệnh gọi quản lý và bộ nhớ đệm được phân phối | |
15999 |
Cổng kiểm tra tình trạng. Trình cân bằng tải sử dụng cổng này để xác định xem Bộ định tuyến có đang sẵn có. Để biết trạng thái của Bộ định tuyến, trình cân bằng tải gửi yêu cầu đến cổng 15999 trên Bộ định tuyến: curl -v http://routerIP:15999/v1/servers/self/reachable Nếu có thể truy cập được Bộ định tuyến, yêu cầu sẽ trả về HTTP 200. |
|
59001 | Cổng được dùng để kiểm tra quá trình cài đặt Edge bằng tiện ích apigee-validate .
Tiện ích này yêu cầu quyền truy cập vào cổng 59001 trên Bộ định tuyến. Xem
Kiểm tra quá trình cài đặt để biết thêm thông tin trên cổng 59001. |
|
ZooKeeper | 2181 | Được các thành phần khác như Máy chủ quản lý, Bộ định tuyến, Bộ xử lý thư, v.v. sử dụng |
2888, 3888 | Được ZooKeeper sử dụng nội bộ cho cụm ZooKeeper (còn gọi là tập hợp ZooKeeper) thông tin liên lạc | |
Cassandra | 7000, 9042, 9160 | Các cổng Apache Cassandra để giao tiếp giữa các nút Cassandra và để truy cập bằng các thành phần Edge khác. |
7199 | Cổng JMX. Máy chủ quản lý phải mở để máy chủ quản lý có thể truy cập. | |
Qpid | 5672 | Dùng để giao tiếp từ Bộ định tuyến và Bộ xử lý thư đến máy chủ Qpid |
8083 | Cổng quản lý mặc định trên máy chủ Qpid và phải được mở trên thành phần này quyền truy cập bằng Máy chủ quản lý. | |
1102 | Cổng JMX | |
4529 | Đối với các lệnh gọi quản lý và bộ nhớ đệm được phân phối | |
Postgres | 5432 | Dùng cho giao tiếp từ Qpid/Máy chủ quản lý đến Postgres |
8084 | Cổng quản lý mặc định trên máy chủ Postgres và phải được mở trên thành phần để truy cập bởi Máy chủ quản lý. | |
1103 | Cổng JMX | |
4530 | Đối với các lệnh gọi quản lý và bộ nhớ đệm được phân phối | |
22 | Nếu định cấu hình hai nút Postgres để sử dụng tính năng sao chép chế độ chờ chính, bạn phải mở cổng 22 trên mỗi nút để truy cập SSH. | |
LDAP | 10389 | OpenLDAP |
SmartDocs | 59002 | Cổng trên bộ định tuyến Edge nơi yêu cầu trang SmartDocs được gửi. |
Bảng tiếp theo trình bày các cổng đó, được liệt kê bằng số, kèm theo nguồn và đích thành phần:
Số cổng | Mục đích | Thành phần nguồn | Thành phần đích |
---|---|---|---|
virtual_host_port | HTTP cùng với mọi cổng khác mà bạn sử dụng cho lưu lượng lệnh gọi API máy chủ ảo. Cổng 80 và 443 thường được sử dụng nhất; Bộ định tuyến thư có thể chấm dứt kết nối TLS/SSL. | Máy khách bên ngoài (hoặc trình cân bằng tải) | Trình nghe trên Bộ định tuyến thư |
1099 đến 1103 | Quản lý JMX | Ứng dụng JMX | Máy chủ quản lý (1099) Trình xử lý tin nhắn (1101) Máy chủ Qpid (1102) Máy chủ Postgres (1103) |
2181 | Giao tiếp với máy khách của Zookeeper | Máy chủ quản lý Máy định tuyến Trình xử lý tin nhắn Máy chủ Qpid Máy chủ Postgres |
Người giữ vườn thú |
2888 và 3888 | Quản lý nội dung của người giữ vườn | Người giữ vườn thú | Người giữ vườn thú |
4526 | Cổng quản lý RPC | Máy chủ quản lý | Máy chủ quản lý |
4527 | Cổng quản lý RPC cho bộ nhớ đệm phân phối và các lệnh gọi quản lý cũng như cho thông tin liên lạc giữa các Bộ định tuyến | Bộ định tuyến máy chủ quản lý |
Bộ định tuyến |
4528 | Đối với các lệnh gọi được lưu vào bộ nhớ đệm được phân phối giữa các Trình xử lý thư và để giao tiếp từ Bộ định tuyến | Máy chủ quản lý Máy định tuyến Trình xử lý tin nhắn |
Trình xử lý tin nhắn |
4529 | Cổng quản lý RPC cho bộ nhớ đệm được phân phối và lệnh gọi quản lý | Máy chủ quản lý | Máy chủ Qpid |
4530 | Cổng quản lý RPC cho bộ nhớ đệm được phân phối và lệnh gọi quản lý | Máy chủ quản lý | Máy chủ Postgres |
5432 | Ứng dụng Postgres | Máy chủ Qpid | Postgres |
5672 |
Dùng để gửi phân tích từ Bộ định tuyến và Bộ xử lý thư đến Qpid |
Máy định tuyến Trình xử lý tin nhắn |
Máy chủ Qpid |
7000 | Giao tiếp giữa các nút Cassandra | Cassandra | Nút Cassandra khác |
7199 | Quản lý JMX. Phải mở để Quản lý truy cập trên nút Cassandra Máy chủ. | ứng dụng JMX | Cassandra |
8080 | Cổng API Quản lý | Ứng dụng API Quản lý | Máy chủ quản lý |
8081 đến 8084 |
Cổng API thành phần, dùng để gửi yêu cầu API trực tiếp đến từng thành phần. Mỗi thành phần mở ra một cổng khác nhau; cổng chính xác được sử dụng phụ thuộc vào cấu hình nhưng phải mở trên thành phần này để Máy chủ quản lý truy cập |
Ứng dụng API Quản lý | Bộ định tuyến (8081) Trình xử lý tin nhắn (8082) Máy chủ Qpid (8083) Máy chủ Postgres (8084) |
8998 | Hoạt động giao tiếp giữa Bộ định tuyến và Bộ xử lý thư | Bộ định tuyến | Trình xử lý tin nhắn |
9000 | Cổng giao diện người dùng quản lý Edge mặc định | Trình duyệt | Máy chủ giao diện người dùng quản lý |
9042 | Truyền tải gốc CQL | Máy định tuyến Trình xử lý tin nhắn Máy chủ quản lý |
Cassandra |
9160 | Khách hàng tiết kiệm của Cassandra | Máy định tuyến Trình xử lý tin nhắn Máy chủ quản lý |
Cassandra |
10389 | cổng LDAP | Máy chủ quản lý | OpenLDAP |
15999 | Cổng kiểm tra tình trạng. Trình cân bằng tải sử dụng cổng này để xác định xem Bộ định tuyến có đang sẵn có. | Trình cân bằng tải | Bộ định tuyến |
59001 | Cổng mà tiện ích apigee-validate sử dụng để kiểm tra việc cài đặt Edge |
apigee-validate | Bộ định tuyến |
59002 | Cổng bộ định tuyến nơi yêu cầu trang SmartDocs được gửi | SmartDocs | Bộ định tuyến |
Trình xử lý thông báo luôn mở nhóm kết nối chuyên dụng cho Cassandra (được định cấu hình) thành không bao giờ hết thời gian chờ. Khi một tường lửa giữa trình xử lý thư và máy chủ Cassandra, tường lửa có thể hết thời gian kết nối. Tuy nhiên, trình xử lý thư không được thiết kế để thiết lập lại kết nối với Cassandra.
Để ngăn chặn tình huống này, Apigee khuyến nghị máy chủ Cassandra, trình xử lý tin nhắn và các bộ định tuyến nằm trong cùng một mạng con để tường lửa không liên quan đến việc triển khai các thành phần.
Nếu tường lửa nằm giữa bộ định tuyến và trình xử lý thư, đồng thời đã đặt thời gian chờ tcp ở trạng thái rảnh, các đề xuất của chúng tôi là:
- Đặt
net.ipv4.tcp_keepalive_time = 1800
trong phần cài đặt sysctl trên hệ điều hành Linux, trong đó 1800 phải thấp hơn thời gian chờ tcp ở trạng thái rảnh của tường lửa. Chế độ cài đặt này sẽ giữ cho kết nối ở trạng thái đã được thiết lập để tường lửa không ngắt kết nối. - Trên tất cả Trình xử lý thư, hãy chỉnh sửa
/opt/apigee/customer/application/message-processor.properties
để thêm thuộc tính sau. Nếu tệp không tồn tại, hãy tạo tệp đó.conf_system_cassandra.maxconnecttimeinmillis=-1
- Khởi động lại Trình xử lý thư:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Trên tất cả Bộ định tuyến, hãy chỉnh sửa
/opt/apigee/customer/application/router.properties
để thêm thuộc tính sau. Nếu tệp không tồn tại, hãy tạo tệp đó.conf_system_cassandra.maxconnecttimeinmillis=-1
- Khởi động lại Bộ định tuyến:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Nếu bạn cài đặt cấu hình phân cụm 12 máy chủ lưu trữ với hai Trung tâm dữ liệu, hãy đảm bảo rằng các nút trong hai Trung tâm dữ liệu có thể giao tiếp qua các cổng được hiển thị dưới đây:
Các yêu cầu về cổng API BaaS
Nếu chọn cài đặt API BaaS, bạn sẽ thêm các thành phần API BaaS Stack và API BaaS Portal. Các thành phần này sử dụng các cổng như trong hình dưới đây:
Lưu ý trên sơ đồ này:
- Cổng API BaaS không bao giờ gửi yêu cầu trực tiếp đến nút Ngăn xếp BaaS. Khi một nhà phát triển đăng nhập vào Portal, ứng dụng Portal sẽ được tải xuống trình duyệt. Ứng dụng Portal đang chạy trong sau đó trình duyệt đưa ra yêu cầu đến các nút Ngăn xếp BaaS.
- Quá trình cài đặt phiên bản chính thức của API BaaS sẽ sử dụng trình cân bằng tải giữa nút Cổng API BaaS và nút Ngăn xếp API BaaS. Khi định cấu hình Portal và khi thực hiện lệnh gọi API BaaS, bạn chỉ định địa chỉ IP hoặc tên DNS của trình cân bằng tải, chứ không phải của các nút Ngăn xếp.
- Tất cả các nút Ngăn xếp phải mở cổng 2551 để truy cập từ tất cả các nút Ngăn xếp khác (được biểu thị bằng mũi tên lặp lại trong sơ đồ ở trên cho cổng 2551 trên các nút Ngăn xếp). Nếu bạn có nhiều Dữ liệu Trung tâm, cổng phải có thể truy cập được từ tất cả các nút Ngăn xếp trong tất cả Trung tâm dữ liệu.
- Bạn phải định cấu hình tất cả các nút Ngăn xếp Baas để gửi email thông qua một máy chủ SMTP bên ngoài. Cho SMTP không phải TLS, số cổng thường là 25. Đối với SMTP có bật TLS, thường là 465, nhưng hãy kiểm tra với nhà cung cấp SMTP của bạn.
- Các nút Cassandra có thể dành riêng cho API BaaS hoặc có thể được chia sẻ với Edge.
Bảng dưới đây trình bày các cổng mặc định cần được mở trong tường lửa theo thành phần:
Thành phần | Cổng | Mô tả |
---|---|---|
Cổng API BaaS | 9000 | Cổng cho giao diện người dùng API BaaS |
Ngăn xếp API BaaS | 8080 | Cổng nơi nhận được yêu cầu API |
2551 |
Cổng để giao tiếp giữa tất cả các nút Ngăn xếp. Phải có thể truy cập được bằng tất cả các Ngăn xếp khác các nút trong bộ dữ liệu. Nếu bạn có nhiều trung tâm dữ liệu, cổng phải truy cập được từ tất cả các nút Ngăn xếp trong tất cả Trung tâm dữ liệu. |
|
ElasticSearch | 9200 đến 9400 | Để giao tiếp với Ngăn xếp API BaaS và để giao tiếp giữa ElasticSearch nút |
Cấp phép
Mỗi lần cài đặt Edge, bạn sẽ phải có một tệp giấy phép duy nhất mà bạn nhận được từ Apigee. Bạn sẽ cần cung cấp đường dẫn đến tệp giấy phép khi cài đặt máy chủ quản lý, ví dụ: /tmp/license.txt.
Trình cài đặt sao chép tệp giấy phép vào
/opt/apigee/customer/conf/license.txt
.
Nếu tệp giấy phép hợp lệ, máy chủ quản lý sẽ xác thực ngày hết hạn và thời điểm thông báo được cho phép
Số bộ xử lý (MP). Nếu bất kỳ chế độ cài đặt giấy phép nào đã hết hạn, bạn có thể xem nhật ký trong
vị trí sau đây: /opt/apigee/var/log/edge-management-server/logs
.
Trong trường hợp này, bạn có thể liên hệ với Bộ phận hỗ trợ Apigee Edge để biết thông tin chi tiết về việc di chuyển.
Nếu bạn chưa có giấy phép, hãy liên hệ với Apigee Sales.