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