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

Developer Services Portal v. 4.16.09

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

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

RAM

1 GB

Ổ đĩa cứng

10 GB

Giao diện mạng

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 xuống từ trang web. Nếu môi trường của bạn được thiết lập để chuyển tiếp các yêu cầu HTTP và HTTPS đi, thì bạn phải định cấu hình proxy để xử lý chính xác các yêu cầu được chuyển hướng có thể xảy ra trong quá trình tải xuống.

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

Bạn cần định cấu hình proxy để trả về mã trạng thái HTTP 200 cùng với 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 để proxy các yêu cầu HTTPS đi, thì proxy của bạn phải hỗ trợ TLSv1.0. OpenSSL 0.9.8 không hỗ trợ TLSv1.1 hoặc TLSv1.2, chỉ hỗ trợ TLSv1.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 nhà phát triển, thì cấu hình mạng đơn 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, bạn phải đã cài đặt Máy chủ MySQL trên hệ thống đó trước khi khởi động trình 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 một 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 sẽ 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 dành cho 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: CHỌN, CHÈN, CẬP NHẬT, XOÁ, TẠO, THẢO, INDEX, ALTER, TẠO BẢNG TẠM THỜI, LOCK BẢNG.

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

  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 là người dùng gốc bằng lệnh:
    > mysql -u root -p
  3. Nhập mật khẩu gốc khi được nhắc.
  4. Tại lời nhắc mysql>, hãy nhập nội dung sau để tạo người dùng devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. Theo lời nhắc của hệ thống, hãy tạo cơ sở dữ liệu devportal:
    > mysqladmin -u devportal -p create devportal

    Enter the devportal password.
  6. Đăng nhập vào MySQL và cấp quyền truy cập vào devportal từ IP của máy chủ cổng thông tin:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    trong đó portalIP là địa chỉ IP của máy chủ cổng thông tin và devportalPW là mật khẩu của người dùng devportal.
  7. Chỉnh sửa /etc/my.cnf để đặt bind-address 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 ACCEPT

Khi bạn cài đặt Dịch vụ kênh dành cho nhà phát triển, hãy chỉ định không cài đặt Máy chủ MySQL trên máy. 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 về 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 nội dung tải xuống phần mềm từ Red Hat. Máy chủ phải có thể kết nối với Internet để tải RPM xuống qua yum. Nếu sử dụng RHEL, máy chủ phải được đăng ký trên Mạng Red Hat (RHN) và đăng ký với kênh không bắt buộc của máy chủ.

Các yêu cầu của Red Hat sẽ đượ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 Red Hat của bạn.

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

Yêu cầu đối với SMTP

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

Trong môi trường phát hành công khai, Apigee yêu cầu bạn phải định cấu hình một máy chủ SMTP để gửi email từ 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 hỗ trợ TLS, cổng 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

Để 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 có 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ề các ứng dụng của người dùng. Dịch vụ kênh dành cho nhà phát triển phải 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 bản cài đặt của bạn.

Thông tin bắt buộc 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 các thông tin sau:

  1. Bạn đang định cấu hình nền tảng nào: Red Hat hay CentOS? Nếu đây là lượt cài đặt Red Hat, thì máy phải được đăng ký trên Mạng Red Hat để 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 nằm trên một máy khác với máy phân phát các trang web cổng thông tin. Nếu vậ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 có ý định truy cập vào một 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à localhost.
  5. Bạn có muốn sử 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ủ mà 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 sẽ là tên máy chủ hoặc địa chỉ IP. Đây là điểm cuối REST mà tất cả các lệnh gọi được thực hiện để tạo ứng dụng và đăng ký nhà phát triển cho khoá ứng dụng. Điểm cuối mặc định là https://api.enterprise.apigee.com/v1.

      Đối với quá trình cài đặt Edge for Private Cloud, URL 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à SSLport là cổng SSL cho API quản lý Edge. 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à 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 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 API quản lý: Quản trị viên của tổ chức phải thực hiện các lệnh gọi từ trang web đến Edge.

      Tên người dùng/mật khẩu này dành cho quản trị viên trong tổ chức của bạn và chỉ được 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 đó đã bị xoá trên Edge, thì cổng thông tin sẽ không thể kết nối với Edge nữa. Do đó, hãy tạo một quản trị viên trong tổ chức của bạn chỉ dành cho mối kết nối này.

      Ví dụ:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd