Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Apigee sử dụng Pantheon, một dịch vụ quản lý trang web để lưu trữ các phiên bản trên đám mây của cổng Dịch vụ dành cho nhà phát triển. Pantheon được thiết kế để kết hợp với Drupal giúp bạn phát triển, thử nghiệm và xuất bản cổng thông tin trong một môi trường bảo mật. Trang web của Pantheon dịch vụ quản lý được cung cấp cho các khách hàng có nhu cầu vận hành lưu trữ và phát triển trên hình ảnh địa cầu.
Các phần sau đây mô tả cách sử dụng Pantheon để phát triển và quản lý cổng thông tin của bạn.
Truy cập trang tổng quan Pantheon
Khi Apigee gửi cho bạn URL trang thông tin của bạn, bạn cũng sẽ nhận được URL của Pantheon Trang tổng quan: https://dashboard.getpantheon.com/.
Khi đăng nhập lần đầu vào trang tổng quan Pantheon, bạn sẽ truy cập trang Trang web, được hiển thị bên dưới:
Từ trang tổng quan, bạn có thể truy cập vào trang web, định cấu hình tài khoản và thực hiện các thao tác khác các toán tử.
Chọn hình ảnh trang web của bạn (ví dụ: apigeedocs) để mở trang tổng quan cho trang web đó trang web:
Quản lý môi trường của bạn
Trên trang tổng quan Pantheon, có ba môi trường được liệt kê ở đầu trang: Nhà phát triển, Thử nghiệm và Trực tiếp. Từng loại được mô tả trong bảng sau.
|
Môi trường |
Nội dung mô tả |
|---|---|
|
Nhà phát triển |
Môi trường Dev được kết nối với kho lưu trữ Git của bạn. Bất kỳ hạng nào những thay đổi bạn đẩy đến Git sẽ hiển thị ngay lập tức trong môi trường Phát triển. URL dẫn tới trang web này có dạng như dưới đây, trong đó org_name là tên tổ chức của bạn: http://dev-{org_name}.devportal.apigee.io/ |
|
Kiểm thử |
Môi trường Test (Kiểm thử) là nơi để bạn kiểm thử mã mới nhất bằng bản sao dữ liệu từ môi trường Trực tiếp. Môi trường này nơi bạn kiểm thử các thay đổi mã trước khi đẩy lên môi trường Live (Trực tiếp). URL dẫn tới trang web này có dạng như dưới đây, trong đó org_name là tên tổ chức của bạn: http://test-{org_name}.devportal.apigee.io/ |
|
Trực tiếp |
Môi trường trực tiếp là môi trường sản xuất mà bạn giúp khách hàng của mình dễ dàng truy cập. URL dẫn tới trang web này có dạng như dưới đây, trong đó org_name là tên tổ chức của bạn: http://live-{org_name}.devportal.apigee.io/ |
Phát triển nội dung cổng thông tin
Các phần sau đây mô tả cách phát triển nội dung cổng thông tin của bạn.
- Tổng quan về kho lưu trữ Git
- Truy cập vào mã của bạn
- Triển khai mã cho cổng thông tin môi trường
- Thêm mô-đun và giao diện tuỳ chỉnh
- Ghi đè mô-đun hồ sơ Drupal và giao diện
Ngoài ra, hãy tham khảo các phần sau để biết thêm thông tin chi tiết về cách tuỳ chỉnh cổng thông tin.
|
Nếu bạn muốn... |
Bạn có thể |
Thông tin khác |
|---|---|---|
|
Thay đổi giao diện của trang web |
Cơ bản – Sử dụng mục nhập trình đơn Giao diện trên trang web cổng thông tin để thực hiện các thay đổi, chẳng hạn như sửa đổi biểu trưng và màu sắc của trang web. |
Xem phần Tuỳ chỉnh giao diện: |
|
Nâng cao – Để chỉnh sửa giao diện hoàn chỉnh của trang web, hãy mở rộng giao diện Thích ứng Apigee. |
Hãy xem Tuỳ chỉnh giao diện |
|
|
Thay đổi hành vi của chức năng trang web |
Cơ bản – Sử dụng phần cài đặt quản trị trên cổng thông tin để thay đổi/định cấu hình cách trang web hoạt động. |
Xem tài liệu về Apigee tại đây |
|
Nâng cao – Tạo mô-đun tùy chỉnh để thay đổi bất kỳ hành vi nào của của bạn. |
Xem bài viết Tạo mục hàng tuỳ chỉnh các mô-đun trong tài liệu Drupal |
Tổng quan về kho lưu trữ Git
Kho lưu trữ Git cho mã Drupal chứa tất cả mã cổng thông tin của bạn và được sắp xếp bằng cách sử dụng cấu trúc sau.
Lưu ý: Chỉ sửa đổi nội dung trong thư mục /sites/all. Nếu
bạn sửa đổi nội dung nằm ngoài thư mục /sites/all, thì bạn sẽ gặp vấn đề
khi nâng cấp lên phiên bản mới và có thể gặp phải xung đột hợp nhất khi kiểm tra các thay đổi đối với
Git.
|
Thư mục trong kho lưu trữ Git |
Mô tả |
|---|---|
/profiles/apigee |
Các mô-đun và giao diện do Apigee duy trì, trong đó có:
Lưu ý: Không sửa đổi nội dung trong thư mục /profiles/apigee, nếu không bạn sẽ gặp vấn đề khi nâng cấp lên phiên bản mới và có thể gặp phải xung đột hợp nhất khi đăng ký thay đổi đối với Git. Để biết các phương pháp hay nhất của Drupal, hãy xem bài viết Không bao giờ tấn công cốt lõi. |
/sites/all |
Các mô-đun và giao diện Drupal tuỳ chỉnh của bạn. Để biết thông tin về cách quản lý nội dung trong thư mục này, hãy xem phần Thêm mô-đun tuỳ chỉnh và giao diện và Ghi đè mô-đun hồ sơ Drupal và giao diện. Lưu ý: Chỉ sửa đổi nội dung trong thư mục /sites/all. |
Truy cập vào mã của bạn
Để truy cập kho lưu trữ mã trong Git, bạn cần thực hiện các tác vụ được mô tả trong các phần sau:
Xem thêm Làm cách nào để truy cập vào mã nguồn cổng thông tin dành cho nhà phát triển Drupal 7?
Bật quyền truy cập SSH vào máy chủ của bạn
Trước khi có thể sử dụng Git để quản lý mã Drupal, bạn phải bật SSH để truy cập vào máy chủ của mình bằng cách tải khoá SSH lên Pantheon.
Để bật quyền truy cập SSH vào máy chủ của bạn:
- Đăng nhập vào Pantheon tại https://dashboard.getpantheon.com/.
- Trên trang tổng quan, hãy chọn Tài khoản.
- Chọn SSH Keys (Khoá SSH) trong trình đơn bên trái.
- Thêm khoá rồi chọn Thêm khoá.
Nếu bạn cần trợ giúp, hãy chọn Tìm hiểu cách tạo SSH Key.
Truy cập kho lưu trữ mã của bạn trong Git
Lưu ý: Xem Tổng quan về Git kho lưu trữ để biết thông tin tổng quan về cấu trúc kho lưu trữ Git.
Cách truy cập vào kho lưu trữ mã của bạn trong Git:
- Đăng nhập vào trang tổng quan Pantheon.
- Trên trang Sites chính, hãy chọn biểu tượng cho cổng của bạn.
- URL của kho lưu trữ Git xuất hiện trên trang ở bên phải Kết nối Chế độ, như minh hoạ trong hình trước.
- Sao chép URL của kho lưu trữ Git và sao chép URL đó vào môi trường phát triển cục bộ bằng cách sử dụng
lệnh:
> git sao chép gitURL tên trang web
Ví dụ:
> nhân bản git ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal
Bất kỳ thay đổi nào về mã mà bạn đẩy vào kho lưu trữ Git sẽ xuất hiện ngay lập tức môi trường Phát triển trên cổng thông tin của bạn.
Triển khai mã cho cổng thông tin môi trường
Cách viết mã cho môi trường cổng thông tin:
- Đẩy các bản cập nhật mã của bạn tới Git, thao tác này sẽ cập nhật ngay lập tức Dev môi trường.
- Đăng nhập vào Pantheon và chọn trang web của bạn.
- Chọn môi trường Nhà phát triển.
- Chọn </>Mã trong trình đơn bên trái để xem thông báo về
thay đổi mã trong Nhật ký xác nhận:
- Chọn môi trường Kiểm thử ở đầu trang.
- Nếu chưa tải Nhà phát triển lên Kiểm thử, thì bạn được nhắc làm việc đó ngay bây giờ.
- Nếu bạn đã có môi trường Kiểm thử, một thông báo sẽ xuất hiện cho biết
rằng có cam kết của Nhà phát triển sẵn sàng triển khai:
- Nếu đã đẩy một trang web sang môi trường Trực tiếp, thì bạn có thể tuỳ ý chọn hộp đánh dấu thứ ba để sao chép cơ sở dữ liệu trực tiếp và bất kỳ tệp nào được tải lên nhà phát triển Kiểm tra từ Trực tiếp. Điều này rất hữu ích nếu bạn muốn kiểm tra các thay đổi đối với mã dựa trên dữ liệu gần đây nhất có trên trang Live (Đang hoạt động).
- Chọn nút Deploy Code from Development (Triển khai mã từ bản phát triển).
- Kiểm tra cổng trong môi trường Kiểm thử.
- Sửa lỗi mã cho môi trường Nhà phát triển rồi đẩy lại tệp lên Kiểm thử để kiểm thử.
- Khi quá trình kiểm thử hoàn tất, hãy chọn môi trường Trực tiếp ở đầu màn hình
.
- Nếu chưa tải Thử nghiệm lên Phát trực tiếp, thì bạn được nhắc làm việc đó ngay bây giờ.
- Nếu bạn đã có Môi trường Trực tiếp, một thông báo sẽ xuất hiện cho biết có cam kết từ Kiểm thử sẵn sàng triển khai. Triển khai những thay đổi đó trong giống như cách bạn triển khai chúng để Kiểm thử từ Nhà phát triển. Khi đã kiểm thử xong, hãy đẩy mã vào môi trường Live (Trực tiếp).
Tìm hiểu thêm:
- Pantheon cung cấp một loạt các bài hát Tham gia Bài viết trực tiếp về quy trình này mà bạn có thể xem. Một trong những cách quan trọng nhất là Sử dụng Pantheon Bài viết về quy trình công việc đưa ra thông tin tổng quan về cách phát triển, thử nghiệm và đẩy mạnh của bạn.
Thêm mô-đun và giao diện tuỳ chỉnh
Bạn có thể mở rộng chức năng của cổng thông tin bằng cách thêm các mô-đun và giao diện tuỳ chỉnh của riêng mình vào các thư mục được liệt kê trong bảng sau.
Lưu ý: Chỉ sửa đổi nội dung trong thư mục /sites/all. Nếu bạn sửa đổi nội dung nằm ngoài của thư mục /sites/all, bạn có thể gặp phải xung đột hợp nhất khi kiểm tra nội dung thay đổi đối với Git.
| Mô-đun/Giao diện | Thư mục trong kho lưu trữ Git | Thông tin khác (tài liệu về Drupal) |
| Mô-đun tuỳ chỉnh | sites/all/modules/custom |
Tạo mục tuỳ chỉnh các mô-đun |
| Chủ đề tùy chỉnh | sites/all/themes |
Tuỳ chỉnh
giao diện Tạo tệp Drupal theo chủ đề 7 |
Sau khi thêm mô-đun hoặc giao diện tuỳ chỉnh trong môi trường Nhà phát triển, bạn có thể triển khai ứng dụng Test (Kiểm thử) để kiểm thử, sau đó môi trường Trực tiếp để sản xuất, như mô tả trong bài viết Triển khai mã cho môi trường cổng.
Ghi đè các mô-đun và giao diện của hồ sơ Drupal
Mô-đun và giao diện trong các thư mục sau sẽ ghi đè mô-đun hồ sơ Drupal và
giao diện do Apigee duy trì và phân phối trong /profiles/apigee.
Xem Tổng quan về kho lưu trữ Git của bạn.
Ví dụ: có thể bạn muốn ghi đè một mô-đun trong quá trình phân phối Apigee Drupal trong trong các trường hợp sau:
- Bạn muốn sử dụng phiên bản khác của mô-đun cụ thể.
- Bạn muốn triển khai một bản cập nhật bảo mật trước lần phát hành Apigee theo lịch tiếp theo.
| Mô-đun/Giao diện | Thư mục trong kho lưu trữ Git | Thông tin khác (tài liệu về Drupal) |
| Các mô-đun do Drupal đóng góp |
Lưu ý: Các mô-đun được lưu trữ ở bất cứ đâu trong |
Mô-đun đóng góp
Lưu ý: Các mô-đun do Drupal đóng góp trong thư mục này sẽ ghi đè các mô-đun tương đương
do Apigee duy trì và phân phối ở |
| Giao diện do Drupal đóng góp | sites/all/themes |
Chủ đề đóng góp
Lưu ý: Các giao diện do Drupal đóng góp trong thư mục này sẽ ghi đè các mô-đun tương đương
do Apigee duy trì và phân phối
trong |
Giới thiệu về tệp settings.php
Drupal settings.php cam kết sử dụng kho lưu trữ Git ngược dòng cho Cổng dành cho nhà phát triển Apigee Drupal. Nếu bạn muốn chỉnh sửa tệp sites/default/settings.php, đừng chỉnh sửa tệp trực tiếp.
Thay vào đó, hãy tạo một tệp có tên sites/default/settings.local.php rồi đặt mã tuỳ chỉnh của bạn vào đó. sites/default/settings.local.php có trong tệp settings.php.
Ví dụ: khi thiết lập miền tuỳ chỉnh cho một trang web đang hoạt động theo hướng dẫn do Pantheon cung cấp, thay vì trực tiếp sửa đổi tệp settings.php, hãy thêm nội dung cập nhật bắt buộc trong sites/default/settings.local.php.
Bảo mật cổng thông tin của bạn
Các trang web cổng được liên kết với các Nhà phát triển, Kiểm thử và Theo mặc định, môi trường trực tiếp có thể truy cập công khai. Điều đó có nghĩa là bất kỳ ai có URL của trang web có thể truy cập vào trang web đó mặc dù họ có thể không đăng ký được tài khoản hoặc đăng nhập vào trang web. Để biết thêm thông tin về cách kiểm soát đăng ký người dùng, hãy xem Thêm và quản lý người dùng tài khoản.
Có lẽ bạn nên ẩn trang web Nhà phát triển và Thử nghiệm của mình khỏi công khai và muốn ẩn trang web Trực tiếp của mình cho đến khi bạn hoàn tất quá trình phát triển. Đền Pantheon cho phép bạn thêm quyền kiểm soát tên người dùng/mật khẩu để khoá trang web sao cho chỉ những người có quyền thông tin xác thực có thể truy cập vào đó.
Thêm khoá vào bất kỳ môi trường nào trong ba môi trường này bằng cách chọn Bảo mật trong trình đơn bên trái cho môi trường. Để biết thêm thông tin, hãy xem bài viết Khoá trang web của bạn.
Nếu bạn muốn bật TLS/SSL cho trang web của mình, hãy xem phần Sử dụng TLS trên cổng thông tin.
Áp dụng bản cập nhật Apigee cho cổng thông tin của bạn
Khi Apigee phát hành bản phát hành mới của cổng thông tin, một thông báo sẽ xuất hiện trên Pantheon Trang tổng quan.
Bạn thường áp dụng bản cập nhật cho môi trường Nhà phát triển, sau đó kiểm thử các bản cập nhật đó các thay đổi giống như cách bạn kiểm thử các thay đổi mã của chính mình. Ví dụ: đẩy Môi trường phát triển để Kiểm thử, đẩy dữ liệu trực tiếp từ Live (Đang hoạt động) để Test (Kiểm thử), sau đó kiểm thử bản cập nhật.
Cách áp dụng bản cập nhật:
- Đăng nhập vào Pantheon tại https://dashboard.getpantheon.com/ và chọn trang web của bạn.
- Chọn môi trường Nhà phát triển.
- Chọn mục nhập trình đơn </>Mã ở bên trái. Nếu có thông tin cập nhật về Apigee có sẵn, chúng sẽ được liệt kê.
- Áp dụng bản cập nhật:
-
Chọn hộp kiểm Run update.php sau khi kéo mã.
-
Chọn Xoá bộ nhớ đệm sau khi kéo mã (nếu có) hộp kiểm.
-
Chọn nút Deploy Code (Triển khai mã).
-
- Sau khi quá trình cập nhật hoàn tất, hãy chọn mục trong trình đơn Trạng thái trên bên trái trang tổng quan.
- Trong khu vực Trạng thái của một môi trường, bạn có thể thấy lỗi cho
cập nhật cơ sở dữ liệu, như được thể hiện dưới đây:
Nếu bạn thấy lỗi này trong bất kỳ môi trường nào, hãy cập nhật cơ sở dữ liệu theo cách thủ công:
- Đă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.
- Chọn biểu tượng Màn hình chính > Chạy bản cập nhật ở góc trên bên trái của cổng thông tin.
- Làm theo hướng dẫn để cập nhật cơ sở dữ liệu của bạn.
- Đẩy những thay đổi mã sang môi trường Test (Kiểm thử), sau đó đẩy đến Trực tiếp, như mô tả ở trên.
Di chuyển các tính năng tuỳ chỉnh
Nếu thêm mã hoặc các tính năng tuỳ chỉnh vào cổng thông tin, bạn sẽ phải quyết định cách duy trì chúng và cách chuyển chúng từ Nhà phát triển sang Kiểm thử và Xuất bản môi trường xung quanh.
Đối với mã trong kho lưu trữ Git, bạn có thể sử dụng quy trình được mô tả trong phần Triển khai mã cho môi trường cổng thông tin để di chuyển đoạn mã từ Dev sang Test (Kiểm thử) để Live (Đang hoạt động).
Nếu bạn đã tạo bất kỳ cấu hình tuỳ chỉnh nào, hãy sử dụng một trong các phương pháp sau để di chuyển chúng:
| Phương thức | Nội dung mô tả |
| Xuất cấu hình sang mã | Nhiều cấu hình phổ biến là "có thể xuất" viết mã bằng mô-đun Tính năng. Ví dụ: khung hiển thị, bảng điều khiển, bộ nhớ đệm hình ảnh, v.v. |
Triển khai hàm hook_update_N() |
Drupal quản lý các thay đổi về cơ sở dữ liệu và cấu hình bằng cách sử dụng hàm hook_update_N().
Nếu có mô-đun tuỳ chỉnh, bạn có thể:
|
Xem thêm Sử dụng Pantheon Quy trình công việc cung cấp thông tin tổng quan về cách phát triển, thử nghiệm và đẩy mạnh trang web của bạn. Có trong bài viết đó là phần về Configuration Management (Quản lý cấu hình).
Định cấu hình miền tuỳ chỉnh
Tên miền mà Apigee cung cấp cho một cổng thông tin mặc định là apigee.io, như
được mô tả trong Quản lý môi trường của bạn. Đây có thể không phải là điều bạn
muốn hiển thị cho khách hàng của bạn.
Gói cổng thông tin có tính phí có thể định cấu hình tên miền tuỳ chỉnh cho cổng (Nhà phát triển hoặc nhà phát triển không thể tạo miền tùy chỉnh). Để sử dụng miền tuỳ chỉnh, hãy tạo CNAME trong DNS của bạn và trỏ miền của bạn đến edge.apigee.getpantheon.com.
Ví dụ: để định cấu hình miền tuỳ chỉnh cho một công ty có tên Mytech:
- Định cấu hình chế độ cài đặt DNS sau đây:
developer.mytech.com. 3600 tập trung vào bản ghi CNAME Edge.apigee.getpantheon.com
Có thể mất đến 48 giờ để thay đổi về DNS này có hiệu lực trên tất cả các thiết bị khách. - Sử dụng mục nhập trình đơn Domains / SSL ở bên trái
trang tổng quan để thêm miền này vào trang tổng quan Pantheon của bạn cho
môi trường Live (Trực tiếp).
Trong hầu hết các trường hợp, bạn chỉ định cấu hình DNS cho môi trường Live (Trực tiếp) chứ không phải cho dành cho Nhà phát triển và Kiểm thử. Bạn không nên sử dụng môi trường Phát triển hoặc Kiểm thử cho sản xuất.
Để biết thêm thông tin, hãy xem tài liệu về Pantheon tại đây.
Thêm quản trị viên cổng thông tin
Khi bạn nhận được email từ Apigee thông báo rằng cổng thông tin của bạn đã sẵn sàng hoạt động, Apigee sẽ đã định cấu hình danh sách quản trị viên cổng thông tin. Bạn có thể xem danh sách đó bằng cách chọn đường liên kết Nhóm ở phía trên bên phải của trang tổng quan của trang web.
Để thêm các quản trị viên khác, hãy xem phần Tạo người dùng quản trị.
Đang sao lưu cổng thông tin của bạn
Để sao lưu cổng thông tin của bạn, hãy sử dụng thẻ Sao lưu trên trang tổng quan Pantheon. Bạn có thể tạo bản sao lưu theo yêu cầu hoặc tự động. Trong Pantheon, một bản sao lưu bao gồm ba bản sao riêng biệt lưu trữ: cơ sở dữ liệu, tệp và mã.
Để biết thêm thông tin, hãy xem bài viết Sao lưu Công cụ trong tài liệu về Pantheon.
Đăng ký nhận thông tin cập nhật về trạng thái
Bạn có thể đăng ký nhận bản phát hành và thông tin cập nhật trạng thái của Apigee tại status.apigee.com. Nhấp vào Đăng ký nhận nội dung cập nhật rồi nhập thông tin liên hệ của bạn, chẳng hạn như email địa chỉ email khi thấy thông báo rồi nhấp vào Đăng ký. Trên thông báo qua email trang quản lý, đảm bảo đã chọn Cổng thông tin dành cho nhà phát triển, bật/tắt các chế độ cài đặt thông báo khác nếu cần, rồi nhấp vào Cập nhật các lựa chọn ưu tiên.
Bạn có thể đăng ký nhận thông tin cập nhật trạng thái và báo cáo sự cố của Pantheon, chẳng hạn như khi xảy ra sự cố ngừng dịch vụ, hãy truy cập vào http://status.getpantheon.com. Nhấp vào Đăng ký phần Cập nhật để đăng ký.