Yêu cầu về cổng dịch vụ dành cho nhà phát triển

Cổng dịch vụ dành cho nhà phát triển phiên bản 4.16.05

Sau đây là các yêu cầu về phần cứng và phần mềm để cài đặt.

Phần cứng

Yêu cầu

Hệ điều hành

Các hướng dẫn cài đặt này và tệp cài đặt cung cấp đã được kiểm thử trên các hệ điều hành có trong danh sách tại đây: https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

Ổ cứng

10 GB

Giao diện mạng

Bạn cần có kết nối Internet đang hoạt động.

Trong quá trình cài đặt, trình cài đặt sẽ tải các tài nguyên từ web xuống. Nếu môi trường của bạn được thiết lập để thực hiện các yêu cầu HTTP và HTTPS đi qua proxy, thì proxy của bạn phải được định cấu hình để xử lý chính xác các yêu cầu chuyển hướng có thể xảy ra trong quá trình tải xuống.

Ví dụ: Một yêu cầu tới https://drupal.org/ sẽ trả về mã trạng thái HTTP 301 và chuyển hướng đến https://www.drupal.org/.

Proxy của bạn phải được định cấu hình để trả về mã trạng thái HTTP 200 có nội dung được yêu cầu từ lệnh chuyển hướng.

Đối với các lượt cài đặt SAP, nếu môi trường của bạn được thiết lập để chấp nhận các yêu cầu HTTPS đi qua proxy, thì proxy của bạn phải hỗ trợ TLS phiên bản 1.0. OpenSSL 0.9.8 không hỗ trợ TLS phiên bản 1.1 hoặc TLS phiên bản 1.2, chỉ TLS phiên bản 1.0.

Yêu cầu về cơ sở dữ liệu MySQL

Nếu bạn chọn cài đặt Máy chủ MySQL trên cùng một máy với Dịch vụ kênh dành cho nhà phát triển, cấu trúc liên kết một máy, trình cài đặt Dịch vụ kênh nhà phát triển sẽ nhắc bạn nhập tên cơ sở dữ liệu và người dùng cơ sở dữ liệu, sau đó cài đặt Máy chủ MySQL và tạo giản đồ cơ sở dữ liệu cho bạn. Phiên bản đã cài đặt là phiên bản mới nhất hiện có cho hệ điều hành của bạn.

Nếu muốn cài đặt Máy chủ MySQL trên một hệ thống riêng, thì bạn phải cài đặt Máy chủ MySQL trên hệ thống đó trước khi bắt đầu cài đặt Dịch vụ kênh dành cho nhà phát triển. Bạn phải cài đặt MySQL 5.0.15 trở lên.

Trình cài đặt Dịch vụ kênh dành cho nhà phát triển yêu cầu Máy chủ MySQL chứa cơ sở dữ liệu có giản đồ cơ sở dữ liệu trống. Trình cài đặt Dịch vụ kênh dành cho nhà phát triển nhắc bạn nhập tên máy chủ cơ sở dữ liệu, tên cơ sở dữ liệu và người dùng cơ sở dữ liệu. Sau đó, trình cài đặt sẽ kết nối với cơ sở dữ liệu để tạo bảng và dữ liệu cơ sở dữ liệu mặc định.

Người dùng cơ sở dữ liệu được Dịch vụ kênh của nhà phát triển sử dụng để kết nối với cơ sở dữ liệu và phải có các đặc quyền sau: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE EMPORARY TABLES, LOCK BẢNG.

Ví dụ: để tạo cơ sở dữ liệu có tên devcổng và người dùng có tên devcổng:

  1. Cài đặt Máy chủ MySQL trên hệ thống.
  2. Đăng nhập vào MySQL với tư cách người dùng gốc bằng cách sử dụng lệnh:
    > mysql -u root -p
  3. Nhập mật khẩu gốc khi được nhắc.
  4. Tại dấu nhắc mysql>, hãy nhập nội dung sau để tạo người dùng cổng phát triển:
    mysql>tạo người dùng 'devcổng'@'localhost' được xác định bởi 'devcổng';
    mysql> cấp tất cả đặc quyền trên *.* cho 'devcổng'@'localhost';
    mysql> xóa đặc quyền;
    mysql> thoát
  5. Khi được nhắc hệ thống, hãy tạo cơ sở dữ liệu devcổng:
    > mysqladmin -u devcổng -p create devcổng

    Nhập mật khẩu devcổng.
  6. Đăng nhập vào MySQL và cấp quyền truy cập vào nhà phát triển từ IP của máy chủ cổng thông tin:
    mysql> cấp TẤT CẢ TRÊN cổng phát triển.* TO devcổng@'portalIP' ĐƯỢC XÁC ĐỊNH BỞI "portalIP';

    trong đó portalIP là địa chỉ IP của máy chủ cổng thông tin và portalIP là mật khẩu của người dùng devcổngPW.
  7. Chỉnh sửa /etc/my.cnf để đặt địa chỉ liên kết thành địa chỉ IP của máy chủ MySQL.
  8. Khởi động lại MySQL:
    > /etc/init.d/mysqld restart
  9. Đảm bảo cổng 3306 đang mở trên máy chủ MySQL. Quy trình này dựa trên hệ điều hành của bạn. Ví dụ: đối với Linux, hãy sử dụng lệnh:
    > /sbin/iptables -A input -i eth0 -p tcp --destination-port 3306 -j consent

Khi bạn cài đặt Dịch vụ kênh nhà phát triển, vui lòng nêu rõ là không cài đặt Máy chủ MySQL cục bộ. Sau đó, bạn sẽ được nhắc nhập địa chỉ IP, tên người dùng và tên cơ sở dữ liệu của cơ sở dữ liệu từ xa.

Yêu cầu của Red Hat Enterprise Linux (RHEL)

RHEL có các yêu cầu bổ sung do cần có gói thuê bao để truy cập vào phần mềm tải xuống từ Red Hat. Máy chủ phải kết nối được với Internet để tải RPM xuống qua yum. Nếu sử dụng RHEL, thì máy chủ phải được đăng ký trên Red Hat Network (RHN) và được đăng ký vào kênh không bắt buộc dành cho máy chủ.

Các yêu cầu của Red Hat được kiểm tra trong quá trình cài đặt và trình cài đặt cổng thông tin sẽ nhắc bạn nếu RHEL chưa được đăng ký. Nếu đã có thông tin đăng nhập Red Hat, bạn có thể sử dụng lệnh sau để đăng ký RHEL trước khi bắt đầu quá trình cài đặt:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Thay thế my_usernamemy_password bằng thông tin đăng nhập của bạn trên Red Hat.

Nếu có phiên bản dùng thử của RHEL, bạn có thể nhận giấy phép dùng thử 30 ngày. Hãy truy cập vào https://access.redhat.com/solutions/32790 để biết thêm thông tin.

Yêu cầu về SMTP

Theo mặc định, cổng thông tin sẽ gửi thư bằng cách sử dụng hàm mail() PHP. PHP cố gắng gửi email bằng cách sử dụng sendmail trên hệ thống cục bộ, có thể được định cấu hình trong tệp php.ini của PHP.

Trong môi trường phát hành chính thức, Apigee yêu cầu bạn phải định cấu hình máy chủ SMTP để gửi email qua cổng thông tin. Do đó, bạn phải đảm bảo rằng Drupal có thể truy cập vào cổng cần thiết 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 SMTP có hỗ trợ TLS, mã này thường là 465, nhưng hãy kiểm tra với nhà cung cấp SMTP của bạn.

Yêu cầu bổ sung

Để thực hiện quá trình cài đặt, người dùng cài đặt phần mềm phải có quyền truy cập thư mục gốc.

Yêu cầu về cấu trúc triển khai

Dịch vụ kênh dành cho nhà phát triển sử dụng một giao diện duy nhất với Máy chủ quản lý Apigee thông qua API REST để lưu trữ và truy xuất thông tin về ứng dụng của người dùng. Dịch vụ kênh của nhà phát triển cần có khả năng kết nối với Máy chủ quản lý qua HTTP hoặc HTTPS, tuỳ thuộc vào chế độ cài đặt của bạn.

Thông tin cần thiết trước khi bạn bắt đầu cài đặt

Trước khi bắt đầu cài đặt, bạn phải có sẵn những thông tin sau:

  1. Bạn đang định cấu hình nền tảng nào: Red Hat hoặc CentOS? Nếu cài đặt Red Hat, thì máy phải được đăng ký trên Red Hat Network để tải RPM xuống.
  2. Bạn có định cài đặt MySQL trên máy cục bộ không? Một số lượt cài đặt HA yêu cầu MySQL phải trên một máy khác với máy phân phát trang web của cổng thông tin. Trong trường hợp này, đừng cài đặt MySQL cục bộ. Nếu bạn muốn cài đặt đơn giản với mọi thứ trên cùng một máy, hãy cài đặt MySQL cục bộ.
  3. Nếu bạn định truy cập vào máy chủ MySQL từ xa, thì tên máy chủ, cổng, tên cơ sở dữ liệu, tên người dùng và mật khẩu của máy chủ MySQL từ xa. Bạn phải định cấu hình máy chủ MySQL từ xa trước khi bắt đầu cài đặt.
  4. Tên miền đủ điều kiện của máy chủ web là gì? (Thông tin này sẽ được thêm vào /etc/hosts.) Đây phải là địa chỉ IP hoặc tên máy chủ, chẳng hạn như portalserver.example.com. Giá trị mặc định là portalserver.example.com.
  5. Bạn có muốn dùng cấu hình mặc định của Apigee cho máy chủ ảo của Apache không? Một máy chủ ảo được tạo bằng tên máy chủ bạn đã chỉ định ở trên trong Bước 7.
  6. Có 3 thông tin giúp cổng thông tin của bạn giao tiếp với máy chủ quản lý Apigee Edge. Thông tin này như sau:
    1. URL của Điểm cuối API Quản lý Apigee: Đây có thể là tên máy chủ hoặc địa chỉ IP. Đây là điểm cuối REST mà mọi lệnh gọi đều được thực hiện để tạo ứng dụng và đăng ký khoá ứng dụng cho nhà phát triển. Điểm cuối mặc định là https://api.enterprise.apigee.com/v1.

      Khi cài đặt Edge dành cho đám mây riêng tư, URL sẽ có dạng:
      http://EdgeIp:8080/v1

      hoặc:
      https://EdgeIp:SSLport/v1

      Trong đó EdgeIp là địa chỉ IP của máy chủ quản lý Edge và cổng SSL là EdgeIp Ví dụ: 8443.
    2. Tên tổ chức Apigee: Có mối quan hệ giữa các cổng thông tin và các tổ chức Apigee Edge. Bạn sẽ thiết lập tổ chức mặc định khi thiết lập Điểm cuối của API quản lý. Giá trị mặc định là my-org.
    3. Tên người dùng và mật khẩu cho điểm cuối của API quản lý: Các lệnh gọi từ cổng thông tin đến Edge phải do quản trị viên cho tổ chức của bạn thực hiện.

      Tên người dùng/mật khẩu này là dành cho quản trị viên trong tổ chức của bạn và chỉ nên dùng để kết nối với Edge từ cổng thông tin. Ví dụ: nếu bạn chỉ định thông tin xác thực của một người dùng và người dùng đó đã từng bị xoá trên Edge, thì cổng thông tin sẽ không thể kết nối với Edge được nữa. Do đó, hãy tạo một quản trị viên trong tổ chức của bạn dành riêng cho kết nối này.

      Ví dụ:
      dc_devcổng+ORGNAME@apigee.com:MyP@ssw0rd