Cài đặt cổng dịch vụ dành cho nhà phát triển

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

Làm theo các bước sau để cài đặt cổng Dịch vụ kênh dành cho nhà phát triển.

Trước khi tiếp tục cài đặt, hãy sao lưu toàn bộ thư mục gốc web Drupal thư mục. Vị trí cài đặt mặc định là /var/www/html, nhưng bạn có thể đã thay đổi vị trí này tại thời điểm cài đặt. Sau khi thực hiện các bước cài đặt được mô tả dưới đây, bạn có thể khôi phục từ bản sao lưu.

1. Tải gói Dịch vụ kênh dành cho nhà phát triển

Truy cập vào http://community.apigee.com/content/apigee-customer-support và chọn Đăng nhập vào Cổng hỗ trợ của bạn để yêu cầu tệp .tar Dịch vụ kênh dành cho nhà phát triển trong một trong hai cách:

• Hãy yêu cầu quyền truy cập vào Edge dành cho thư mục tải xuống của Private Cloud.
• Yêu cầu URL đến tệp .tar của Dịch vụ kênh dành cho nhà phát triển.

2. Đảm bảo hệ thống của bạn đáp ứng hệ thống các yêu cầu

Trước khi bạn cài đặt cổng thông tin, máy chủ của bạn phải đáp ứng các yêu cầu sau:

1. Đảm bảo rằng bạn đang cài đặt trên phiên bản 64-bit của phiên bản được hỗ trợ của Red Hat Enterprise Linux, CentOS hoặc Oracle. Xem danh sách các phiên bản được hỗ trợ tại đây.
2. Đảm bảo bạn đã cài đặt Yum.
3. (Đối với quá trình cài đặt trên máy chủ không có kết nối Internet) Bạn phải trước tiên, hãy tải tất cả các tệp cần thiết xuống máy chủ có kết nối Internet dưới dạng một Tệp .tar.gz. Sau đó, bạn sao chép tệp .tar.gz đó vào máy chủ mà không cần kết nối Internet để thực hiện cài đặt.
   1. Đăng nhập vào máy chủ có kết nối Internet ở cấp độ gốc hoặc với tư cách siêu người dùng.
   2. Tạo một thư mục cho các tệp cài đặt, chẳng hạn như portal_tar.
   3. CD vào thư mục mới rồi tải DeveloperServices_x.y.z.tar xuống Dịch vụ kênh dành cho nhà phát triển trong đó x.y.z tương ứng với số phiên bản cổng thông tin.
   4. Trích xuất nội dung của tệp .tar của Dịch vụ kênh dành cho nhà phát triển bằng cách sử dụng tệp :
      &gt; tar -xvf <tar file&gt;
   5. CD sang DeveloperServices-4.x.y.z.
   6. Tạo tệp .tar.gz cổng thông tin bằng cách sử dụng lệnh:
      &gt; ./non-networked-install.sh
      
      Lệnh đó sẽ tải tất cả các tệp cần thiết và các tệp đó xuống một tệp .tar.gz. Bạn sau đó sao chép tệp .tar.gz đó vào máy chủ không có kết nối Internet để hoàn tất cài đặt.
4. Kiểm tra kết nối của bạn với máy chủ quản lý Edge bằng cách thực thi lệnh cURL sau từ lời nhắc lệnh trên máy chủ cổng thông tin:
   &gt; cuộn tròn {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   Trong đó EMAIL và MẬT là email địa chỉ và mật khẩu của quản trị viên cho ORGNAME.
   
   Hãy nhớ chỉ định tên máy chủ và số cổng dành riêng cho quá trình cài đặt Edge. Cổng sạc 8080 là cổng mặc định mà Edge sử dụng. Nếu bạn đang kết nối với một tổ chức và công nghệ đám mây, thì URL yêu cầu sẽ là:
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   Nếu thành công, lệnh này sẽ trả về một phản hồi tương tự như sau:
   {
   "MadeAt" (được tạo lúc) : 1348689232699,
   "được tạoBy" : "USERNAME",
   &quot;displayName&quot; : "cg",
   "môi trường" : [ "kiểm thử", "sản phẩm" ],
   "lastModifiedAt" : 1348689232699,
   "lastModifiedBy" (Lần sửa đổi gần đây nhất) : "foo@bar.com",
   "tên" : "cg",
   "thuộc tính" : {
   "thuộc tính" : [ ]
   },
   "loại" : "thử nghiệm"
   }

3. Cài đặt dành cho nhà phát triển Dịch vụ kênh sử dụng tập lệnh cài đặt tự động

Làm theo quy trình sau đây để cài đặt cổng thông tin bằng cách dùng tập lệnh cài đặt tự động. Chiến dịch này Quy trình này hoạt động đối với các máy chủ có hoặc không có kết nối Internet bên ngoài.

1. Đăng nhập vào máy chủ dưới dạng tài khoản gốc hoặc với tư cách siêu người dùng.
2. Tạo một thư mục cho các tệp cài đặt, chẳng hạn như portal.
3. Trên máy chủ có kết nối Internet:
   1. CD sang cổng dịch vụ mới và tải DeveloperServices_x.y.z.tar xuống Thư mục Dịch vụ kênh dành cho nhà phát triển , trong đó x.y.z tương ứng với số phiên bản cổng thông tin.
      
      Bạn có thể tải tệp xuống qua đường liên kết mà Apigee gửi cho bạn trong trình duyệt hoặc bằng cách sao chép tệp đó rồi thêm vào lệnh cURL sau đây:
      &gt; curl -kOL <dán đường liên kết here&gt;
   2. Trích xuất nội dung của tệp .tar của Dịch vụ kênh dành cho nhà phát triển bằng cách sử dụng tệp :
      &gt; tar -xvf <tar file&gt;
   3. CD sang DeveloperServices-4.x.y.z.
   4. Chạy tập lệnh cài đặt bằng cách sử dụng lệnh sau:
      &gt; ./networked-install.sh
4. Trên máy chủ không có kết nối Internet:
   1. Sao chép tệp .tar.gz mà bạn đã tạo ở trên trong phần 2. Đảm bảo hệ thống của bạn đáp ứng các yêu cầu về hệ thống.
   2. Trích xuất nội dung của tệp .tar.gz bằng cách sử dụng lệnh:
      &gt; tar -xvf <tar file&gt;
   3. CD vào thư mục do lệnh tar tạo.
   4. Thiết lập các quyền trên tập lệnh install-from-rpm-bundle.sh:
      &gt; Chmod 755 install-from-rpm-bundle.sh
   5. Chạy tập lệnh install-from-rpm-bundle.sh bằng cách bằng lệnh:
      &gt; ./install-from-rpm-bundle.sh
5. Trả lời câu lệnh.
6. Sau khi cài đặt xong, hãy điều hướng đến URL máy chủ trong một trình duyệt, chẳng hạn như dưới dạng:
   http://localhost. Hoặc, nếu bạn có IP hoặc DNS cụ thể Bạn đã định cấu hình xong, hãy truy cập vào http://IP_address hoặc http://DNS_name.
   
   Bạn được chuyển hướng đến trang cấu hình Cơ sở dữ liệu hồ sơ Apigee.
   
   Lưu ý: Thông thường, bạn sẽ định cấu hình và đăng ký tên máy chủ với máy chủ DNS của bạn để bạn không phải sử dụng http://localhost.
7. Định cấu hình kết nối với MySQL. Nếu MySQL ở trên một máy từ xa, hãy mở rộng Tùy chọn nâng cao rồi nhập thông tin kết nối vào máy đó, sau đó chọn Lưu và tiếp tục.
8. Thiết lập kết nối với Điểm cuối Apigee bằng cách nhập các thông tin sau và sau đó chọn Lưu:
   Để biết thêm thông tin về các giá trị này, hãy xem "Thông tin bắt buộc trước khi bạn bắt đầu cài đặt" tại cổng dịch vụ dành cho nhà phát triển .
   1. Đơn vị tổ chức của Cổng thông tin cho nhà phát triển
   2. URL điểm cuối của Cổng thông tin cho nhà phát triển
   3. Người dùng xác thực thiết bị đầu cuối
   4. Người dùng được xác thực Mật khẩu
9. Khi được nhắc, hãy chọn nút Install Sample SmartDocs WADL để cài đặt mẫu SmartDocs WADL. Nếu bạn bỏ qua bước này, thì API SmartDocs mẫu sẽ không xuất hiện trên cổng thông tin của bạn.
   Lưu ý: Nếu cổng thông tin của bạn kết nối với dịch vụ Cài đặt Apigee Edge cho ứng dụng Riêng tư Cloud và quá trình cài đặt Edge không có kết nối Internet bên ngoài, thì bạn phải thực hiện cấu hình bổ sung của mô-đun SmartDocs trước khi bạn có thể sử dụng SmartDocs. Để biết thêm thông tin về SmartDocuments, hãy xem http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
10. Định cấu hình Cài đặt máy chủ SMTP. Apigee yêu cầu bạn định cấu hình một máy chủ SMTP để gửi thư email từ cổng thông tin.
    Để biết thêm thông tin, hãy truy cập http://apigee.com/docs/developer-services/content/configuring-email.
11. Định cấu hình người dùng quản trị bằng cách nhập thông tin sau đây rồi chọn Lưu. Xin lưu ý rằng Drupal tạo một người dùng quản trị có tên là "quản trị viên" theo mặc định, nên không sử dụng 'quản trị' dưới dạng tên người dùng.
    Nếu bỏ qua bước này, bạn vẫn có thể sử dụng Drush để tạo quản trị viên như mô tả bên dưới trong 4. Tạo người dùng quản trị.
    1. Họ và tên của nhà phát triển
    2. Tên người dùng cổng thông tin của nhà phát triển
    3. Mật khẩu
    4. Địa chỉ email
12. Sau khi cài đặt xong, hãy thiết lập các quyền cho tệp settings.php:
    &gt; Chmod 640 /var/www/html/sites/default/settings.php
13. Chuyển đến trang chủ của cổng thông tin tại http://localhost/ hoặc đến tên DNS của cổng thông tin của bạn.
14. Đăng nhập vào cổng thông tin bằng thông tin đăng nhập của quản trị viên.

4. Tạo người dùng quản trị

Sử dụng Drush để tạo người dùng có quyền quản trị cho quá trình cài đặt Dịch vụ kênh dành cho nhà phát triển của bạn. Drupal tự động tạo một người dùng quản trị có tên là "admin" theo mặc định, nên không sử dụng 'quản trị' với tư cách là tên người dùng.

1. CD vào thư mục drupal_root/sites/default của bạn. Vị trí chuẩn cho gốc Drupal thư mục là /var/www/html:
   &gt; cd &lt;drupal_root&gt;/sites/default
2. Đảm bảo rằng bạn có quyền ghi trên các tệp Drupal riêng tư:
   &gt; drush vget file_private_path
   
   Lệnh này trả về đường dẫn đến các tệp Drupal riêng tư, ví dụ:
   file_private_path: "trang web/mặc định/riêng tư"
   
   Tương ứng với /var/www/html/sites/default/private/. Hãy dùng lệnh sau đây để đảm bảo rằng chủ sở hữu và nhóm có thể ghi thư mục này:
   chmod -R g+w dirPathAndName
   chmod –R o+r dirPathAndName
3. Nhập các lệnh sau đây để tạo người dùng quản trị, thay thế các lệnh trong phần "< >" với các giá trị của bạn:
   &gt; Drush do người dùng tạo <tên người dùng> --mail=&quot;&lt;email-address&gt;&quot; --password=&quot;&lt;password&gt;&quot;
   &gt; drush người dùng thêm vai trò Quản trị viên <tên người dùng>
4. Đăng nhập vào cổng thông tin dành cho nhà phát triển với tư cách quản trị viên bằng cách sử dụng tên người dùng và mật khẩu được chỉ định ở trên.

5. Đặt mật khẩu gốc MySQL

Nếu bạn đã cài đặt MySQL như một phần của quá trình cài đặt cổng thông tin, tập lệnh cài đặt sẽ thoát Mật khẩu gốc của MySQL đã được đặt thành giá trị mặc định và đang trống.

Sử dụng lệnh sau để đặt mật khẩu gốc:

> mysqladmin -u root password NEWPASSWORD

Nếu trước đây bạn đã đặt mật khẩu gốc và muốn thay đổi mật khẩu đó, hãy sử dụng :

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Bạn cũng phải cập nhật mật khẩu trong tệp /var/www/html/sites/default/settings.php .

6. Đảm bảo rằng mô-đun Trình quản lý cập nhật được đã bật

Để nhận thông báo về các bản cập nhật của Drupal, hãy đảm bảo rằng mô-đun trình quản lý Cập nhật Drupal được bật. Trong trình đơn Drupal, hãy chọn Modules (Mô-đun) rồi di chuyển xuống Mô-đun Cập nhật trình quản lý. Nếu chưa bật, hãy bật.

Sau khi bật, bạn có thể xem các bản cập nhật có sẵn bằng cách sử dụng Báo cáo > Có sẵn Mục trong trình đơn Cập nhật. Bạn cũng có thể sử dụng lệnh Drush sau:

> drush pm-info update

Sử dụng trang Báo cáo > Bản cập nhật hiện có > Mục trong trình đơn Cài đặt để định cấu hình mô-đun gửi email cho bạn khi có bản cập nhật và để đặt tần suất kiểm tra bản cập nhật.

7. Không bắt buộc – Triển khai quá trình sản xuất máy chủ

Nếu đang triển khai cổng thông tin trên một máy chủ sản xuất, bạn nên tăng cường bảo mật các bước, bao gồm:

1. Chạy tập lệnh sau để bảo mật quá trình cài đặt MySQL của bạn:
   &gt; /usr/bin/mysql_secure_installation
   
   Tập lệnh này đặt mật khẩu gốc và cung cấp cho bạn tùy chọn hạn chế quyền truy cập gốc vào localhost và để xoá cơ sở dữ liệu kiểm thử và người dùng ẩn danh được tạo theo mặc định. Chạy tác vụ này tập lệnh được khuyến nghị cho máy chủ sản xuất.
2. Bật và định cấu hình SELinux nếu chính sách của công ty bạn yêu cầu.

8. Không bắt buộc – Định cấu hình Apache Solr công cụ tìm kiếm

Theo mặc định, các mô-đun Drupal kết nối với công cụ tìm kiếm Apache Solr sẽ bị tắt khi bạn cài đặt cổng thông tin. Hầu hết các cổng đều sử dụng công cụ tìm kiếm nội bộ Drupal nên không cần có mô-đun Drupal Solr.

Nếu quyết định dùng Solr làm công cụ tìm kiếm, bạn phải cài đặt Solr cục bộ trên máy chủ sau đó bật và định cấu hình các mô-đun Drupal Solr trên cổng thông tin.

Cách bật các mô-đun Drupal Solr:

1. Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền của quản trị viên hoặc quyền tạo nội dung.
2. Chọn Modules (Mô-đun) trong trình đơn Drupal.
3. Bật mô-đun Apache Solr Framework và Apache Solr của Apache Tìm kiếm.
4. Lưu các thay đổi.
5. Định cấu hình Solr như mô tả tại https://drupal.org/node/1999280.

9. Không bắt buộc - Cài đặt mod_ssl để hỗ trợ HTTPS

Mô-đun mod_ssl được Máy chủ HTTP Apache sử dụng để cung cấp các trang web qua HTTPS. Nếu bạn muốn sử dụng HTTPS, hãy sử dụng lệnh sau để cài đặt mod_ssl:

> yum install mod_ssl

Để biết thêm thông tin về cách định cấu hình cổng thông tin để sử dụng SSL, hãy xem http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Không bắt buộc – Cài đặt SmartDocs

SmartDocs cho phép bạn ghi lại API của mình trên cổng Dịch vụ dành cho nhà phát triển theo cách giúp Tài liệu API có tính tương tác đầy đủ. Tuy nhiên, để sử dụng SmartDocs với cổng thông tin, trước tiên bạn phải cài đặt SmartDocs trên Edge.

• Nếu bạn đang kết nối cổng thông tin với một bản cài đặt Edge Cloud, thì SmartDocuments đã được cài đặt mà không cần định cấu hình gì thêm.
• Nếu đang kết nối cổng thông tin với một Edge để cài đặt Đám mây riêng tư, bạn phải đảm bảo mà SmartDocs được cài đặt trên Edge. Để biết thêm thông tin về cách cài đặt Edge và SmartDocs, hãy xem phần Cài đặt SmartDocs.

Để biết thêm thông tin về SmartDocs, hãy xem phần Sử dụng SmartDocs để tạo tài liệu API.

11. Ðiều gì kế tiếp?

Bước tiếp theo của bạn sau khi cài đặt cổng Dịch vụ dành cho nhà phát triển là định cấu hình và tuỳ chỉnh phù hợp với yêu cầu cụ thể của bạn. Tài liệu trên trang web Apigee chứa tất cả thông tin về cách định cấu hình, tạo kiểu và quản lý cổng thông tin. Truy cập tài liệu tại http://apigee.com/docs/developer-services/content/what-developer-portal.

Bảng sau đây liệt kê một số tác vụ phổ biến nhất mà bạn thực hiện sau khi cài đặt, và có đường liên kết đến tài liệu về Apigee để bạn tìm thêm thông tin:

Việc cần làm	Nội dung mô tả
Tuỳ chỉnh giao diện	Giao diện xác định giao diện của cổng thông tin, bao gồm màu sắc, kiểu và các thông tin khác khía cạnh trực quan.
Tuỳ chỉnh diện mạo	Trang chủ bao gồm trình đơn chính, thư chào mừng, đầu trang, chân trang và tiêu đề.
Thêm và quản lý tài khoản người dùng	Quy trình đăng ký kiểm soát cách nhà phát triển mới đăng ký tài khoản trên cổng thông tin. Ví dụ: liệu các nhà phát triển mới có quyền truy cập ngay lập tức vào cổng thông tin hay không, phải được quản trị viên xác minh. Quá trình này cũng kiểm soát cách cổng thông tin quản trị viên sẽ được thông báo khi tài khoản mới được tạo.
Định cấu hình email	Cổng thông tin sẽ gửi email để phản hồi một số sự kiện nhất định. Ví dụ: khi một người dùng mới nhà phát triển đăng ký trên cổng thông tin và khi nhà phát triển mất mật khẩu.
Thêm và quản lý tài khoản người dùng	Thêm Điều khoản & Trang điều kiện mà nhà phát triển phải chấp nhận trước khi được phép truy cập cổng thông tin.
Thêm và quản lý tài khoản người dùng	Cổng thông tin này sẽ triển khai mô hình uỷ quyền dựa trên vai trò. Trước khi cho phép nhà phát triển đăng ký, xác định quyền và vai trò mà cổng thông tin sử dụng.
Thêm blog và bài đăng trên diễn đàn	Cổng thông tin có tính năng hỗ trợ tích hợp dành cho blog và diễn đàn theo chuỗi. Xác định quyền cần phải có để xem, thêm, chỉnh sửa cũng như xoá các bài đăng trên blog và diễn đàn.
Đảm bảo bạn đang sao lưu cơ sở dữ liệu	Đảm bảo rằng bạn đang sao lưu cơ sở dữ liệu Drupal. Lưu ý rằng vì mỗi khác nhau, việc xác định cách tốt nhất để sao lưu dữ liệu là tuỳ thuộc vào bạn cơ sở dữ liệu.
Thiết lập tên máy chủ	Nếu không thiết lập tên máy chủ trong máy chủ DNS, bạn luôn có thể truy cập trang web qua địa chỉ IP của máy chủ. Nếu muốn sử dụng tên máy chủ, bạn có thể định cấu hình DNS cho máy chủ để hoạt động chính xác mà không cần bất kỳ cấu hình nào khác ở bước thiết lập cơ bản. Nếu bạn thiết lập trình cân bằng tải hoặc nhận được URL không chính xác trên trang web của mình vì một số lý do khác, bạn có thể đặt $base_url trong tệp settings.php của Cổng thông tin phát triển, URL này được đặt theo mặc định trong tệp /var/www/html/sites/default thư mục.