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 một dịch vụ quản lý trang web Acquia để 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. Acquia được thiết kế để hoạt động 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.
Các phần sau đây mô tả cách sử dụng Acquia để phát triển và quản lý cổng thông tin của bạn.
Truy cập giao diện Acquia Cloud
Sau khi thiết lập tài khoản Acquia Cloud, bạn có thể truy cập vào cổng thông tin của mình qua giao diện Acquia Cloud tại https://cloud.acquia.com/.
Khi bạn đăng nhập lần đầu, trang Ứng dụng sẽ hiển thị, như minh hoạ trong hình sau.
Trang Ứng dụng hiển thị tất cả các ứng dụng mà bạn có quyền truy cập được lưu trữ trên Acquia Cloud. Ứng dụng là thực thể phần mềm mà bạn đang quản lý trong Acquia Cloud, chẳng hạn như trang web cổng thông tin dựa trên Drupal.
Các phần sau đây mô tả cách sử dụng giao diện Acquia Cloud để quản lý nội dung trên cổng thông tin.
Để biết thêm thông tin về giao diện Acquia Cloud, hãy xem phần Đăng nhập vào giao diện Acquia Cloud và Quản lý ứng dụng bằng Acquia Cloud trong tài liệu về Acquia Cloud.
Quản lý môi trường
Truy cập vào giao diện Acquia Cloud và trên trang Ứng dụng, nhấp vào Quản lý liên kết với trang web cổng để truy cập trang tổng quan.
Để quản lý quy trình làm việc, chúng tôi cung cấp 3 môi trường để bạn phát triển, kiểm thử và xuất bản cổng thông tin, như trình bày trong bảng sau. Cổng của bạn được triển khai cho từng môi trường, nhưng có thể ở một trạng thái khác với nhánh mã hoặc thẻ, cơ sở dữ liệu duy nhất, v.v. Xem phần Triển khai mã cho môi trường cổng thông tin.
Môi trường | Mô tả | URL mặc định |
Nhà phát triển | Phát triển các tính năng mới và tuỳ chỉnh cổng thông tin của bạn. |
http://{application-name}xxxxxx.devcloud.acquia-sites.com/
Trong đó |
Sân khấu | Hãy kiểm thử mã mới nhất trước khi đưa vào môi trường sản xuất. |
http://{application-name}yyyyyy.devcloud.acquia-sites.com/
Trong đó |
Sản xuất | Xuất bản cổng thông tin của bạn ở dạng chính thức (trực tiếp). |
http://{application-name}.devcloud.acquia-sites.com/
Trong đó Lưu ý: Xem thêm phần Định cấu hình miền tuỳ chỉnh. |
Để biết thêm thông tin, hãy xem phần Làm việc với môi trường trong tài liệu về Acquia Cloud.
Phát triển cổng thông tin
Các phần sau đây mô tả cách phát triển 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 phải 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. Để biết thêm thông tin, hãy xem phần Bật quyền truy cập SSH trong tài liệu về Acquia Cloud.
Cách bật quyền truy cập SSH:
- Đăng nhập vào giao diện Tài khoản Acquia tại https://accounts.acquia.com.
- Nhấp vào Thông tin xác thực.
- Nếu được nhắc, hãy nhập lại mật khẩu để xác nhận danh tính của bạn.
- Trong khoá SSH, hãy nhấp vào Thêm khoá SSH.
- Nhập thông tin dưới đây:
Trường Mô tả Biệt hiệu Biệt hiệu của khoá SSH. Biệt hiệu này có thể chứa ký tự chữ-số và dấu gạch dưới. Khoá công khai Khoá công khai. Để biết thông tin về cách tạo khoá công khai SSH, hãy xem phần Tạo khoá công khai SSH trong tài liệu của Acquia Cloud.
- Nhấp vào Thêm khoá.
Truy cập vào kho lưu trữ mã của bạn trong Git
Kho lưu trữ Git chứa tất cả mã nguồn của trang web cổng thông tin của bạn. Bạn có thể thêm mã mới hoặc tuỳ chỉnh mã hiện có để định cấu hình cổng thông tin của mình. Để biết thêm thông tin, hãy xem phần Sử dụng kho lưu trữ mã trong tài liệu về Acquia Cloud.
Cách truy cập vào kho lưu trữ mã trong kho lưu trữ Git:
- Đăng nhập vào giao diện Acquia Cloud tại https://cloud.acquia.com/.
- Trên trang Ứng dụng, hãy nhấp vào Quản lý để xem thông tin chi tiết của cổng thông tin này.
- Nhấp vào Application Info (Thông tin ứng dụng) trong thanh điều hướng.
- Sao chép lệnh sao chép trong hộp thoại Thông tin ứng dụng.
- Sao chép kho lưu trữ Git vào môi trường cục bộ bằng cách thực thi một trong các lệnh Git sau:
Cách sao chép kho lưu trữ Git và tạo nhánh mới:
> git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
Cách sao chép kho lưu trữ Git từ nhánh master:
> git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
- Lặp lại các bước này khi bạn đã sẵn sàng giai đoạn, cam kết và đẩy các thay đổi vào kho lưu trữ Git bằng các lệnh liên quan hiện trong cửa sổ Application.
Khi bạn cam kết một nhánh vào kho lưu trữ của mình, Acquia Cloud sẽ cập nhật môi trường đang chạy nhánh mã đó. Bạn có thể triển khai mã cho môi trường cổng thông tin của mình, như mô tả trong phần tiếp theo.
Triển khai mã cho môi trường cổng thông tin
Để triển khai, chuyển đổi hoặc huỷ bỏ mã trong môi trường cổng thông tin, di chuyển mã giữa các môi trường hoặc tìm hiểu thêm về cấu trúc kho lưu trữ và quy trình làm việc được đề xuất, hãy xem phần Làm việc với các trang web trên Aquia Cloud trong tài liệu về Acquia Cloud. Khi triển khai mã mới cho một môi trường, bạn sẽ cần chạy update.php
để
cập nhật cơ sở dữ liệu theo yêu cầu.
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 |
sites/all/modules/contrib
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 |
Bật SSL
Để cho phép truy cập an toàn vào trang web của bạn bằng HTTPS, bạn phải bật SSL.
Cách bật SSL:
- Lấy chứng chỉ SSL từ tổ chức phát hành chứng chỉ (CA) hoặc nhà cung cấp chứng chỉ SSL. Xem phần Bật SSL.
- Tải chứng chỉ SSL lên trang SSL trong giao diện Acquia Cloud. Xem bài viết Quản lý chứng chỉ SSL.
Bảo vệ môi trường sản xuất
Khi tạo một ứng dụng lần đầu tiên, bạn có thể tự do quản lý môi trường sản xuất và truyền các thay đổi từ môi trường phát triển và thử nghiệm. Sau khi xuất bản nội dung, bạn nên khoá môi trường phát hành công khai để ngăn chặn việc vô tình hoặc trái phép cập nhật nội dung đó. Để biết thêm thông tin, hãy xem phần Sử dụng chế độ Sản xuất để bảo vệ ứng dụng đang hoạt động trong tài liệu về Acquia Cloud.
Cách bảo mật môi trường sản xuất:
- Đăng nhập vào giao diện Acquia Cloud tại https://cloud.acquia.com/.
- Trên trang Ứng dụng, hãy nhấp vào Quản lý để xem thông tin chi tiết về trang web cổng thông tin của bạn.
- Nhấp vào Sản xuất để xem thông tin chi tiết về môi trường sản xuất.
- Nhấp vào Chế độ sản xuất trong thanh điều hướng.
- Nhấp vào Bật để bật chế độ sản xuất.
Áp dụng các bản cập nhật mô-đun và giao diện cho cổng thông tin
Theo định kỳ, Apigee sẽ tự động cập nhật các mô-đun và giao diện trong cổng thông tin của bạn lên phiên bản mới nhất. Các bản cập nhật chỉ được thực hiện cho môi trường Dev (Nhà phát triển) và được gắn thẻ để cho biết rằng những bản cập nhật này cần được di chuyển sang các môi trường cổng khác.
Nếu trang web của bạn không thuộc tổ chức thanh toán Apigee Acquia (ví dụ: một trang web mới được di chuyển từ một nhà cung cấp dịch vụ lưu trữ khác sang tổ chức của bạn), bạn phải cho phép Apigee truy cập vào kho lưu trữ Git của mình để nhận các bản cập nhật tự động cho cổng thông tin phát triển. Hãy liên hệ với nhóm hỗ trợ Apigee để biết thêm thông tin.
Nếu đã thêm mô-đun hoặc giao diện tuỳ chỉnh, bạn sẽ phải cập nhật các mô-đun hoặc giao diện đó theo cách thủ công.
Bảng sau đây tóm tắt các bước cần thiết để áp dụng các nội dung cập nhật mô-đun và giao diện cho cổng thông tin.
Mô-đun/Chủ đề | Mô tả |
Mô-đun Apigee Edge |
Apigee chỉ tự động áp dụng các bản cập nhật cho môi trường Nhà phát triển. Sau khi bạn kiểm thử các bản cập nhật, hãy di chuyển chúng từ môi trường Dev (Nhà phát triển) sang Stage (Giai đoạn) sang môi trường Prod (Sản xuất) như mô tả trong phần Triển khai mã cho môi trường cổng thông tin. |
Giao diện thích ứng Apigee |
Apigee chỉ tự động áp dụng các bản cập nhật cho môi trường Nhà phát triển. Sau khi bạn kiểm thử các bản cập nhật, hãy di chuyển chúng từ môi trường Dev (Nhà phát triển) sang Stage (Giai đoạn) sang môi trường Prod (Sản xuất) như mô tả trong phần Triển khai mã cho môi trường cổng thông tin. |
Các mô-đun cốt lõi và đóng góp của Drupal |
Apigee chỉ tự động áp dụng các bản cập nhật cho môi trường Nhà phát triển. Sau khi bạn kiểm thử các bản cập nhật, hãy di chuyển chúng từ môi trường Dev (Nhà phát triển) sang Stage (Giai đoạn) sang môi trường Prod (Sản xuất) như mô tả trong phần Triển khai mã cho môi trường cổng thông tin. |
Mô-đun và giao diện tuỳ chỉnh |
Nếu đã thêm mô-đun và giao diện tuỳ chỉnh vào cổng thông tin của mình, như mô tả trong phần Thêm mô-đun và giao diện tuỳ chỉnh, bạn phải cài đặt các bản cập nhật theo cách thủ công. Tải phiên bản mới nhất xuống thư mục cục bộ theo cách thủ công hoặc dùng Drush. Sau đó, phân đoạn, xác nhận và đẩy bản cập nhật vào kho lưu trữ Git. Sau khi bạn kiểm thử các bản cập nhật, hãy di chuyển chúng từ môi trường Dev (Nhà phát triển) sang Stage (Giai đoạn) sang môi trường Prod (Sản xuất) như mô tả trong phần Triển khai mã cho môi trường cổng thông tin. |
Di chuyển các tính năng tuỳ chỉnh
Nếu thêm mã hoặc cấu hình tuỳ chỉnh vào cổng thông tin, bạn cần duy trì và di chuyển chúng từ môi trường Dev (Nhà phát triển) sang môi trường Stage (Giai đoạn) sang môi trường Prod (Nhà phát triển).
Đối với mã trong kho lưu trữ Git, bạn có thể 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 Stage sang Prod.
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ể:
|
Định cấu hình miền tuỳ chỉnh
Như đã lưu ý trong phần Quản lý môi trường của bạn, tên miền mặc định cho các môi trường cổng đều kết thúc bằng acquia-sites.com
. Bạn nên
cung cấp tên miền tuỳ chỉnh của riêng mình để cá nhân hoá và truyền tải
mục đích của trang web hiệu quả hơn. Ví dụ: một lựa chọn thay thế phổ biến là:
https://developers.mycompany.com
Cách định cấu hình miền tuỳ chỉnh:
- Thêm miền của bạn vào môi trường trang web cổng thông tin. Xem phần Quản lý miền trong tài liệu về Acquia Cloud.
- Thiết lập miền tuỳ chỉnh với nhà cung cấp DNS bằng cách trỏ mục nhập bản ghi DNS của tên miền
đến địa chỉ IP công khai (chứ không phải miền
acquia-sites.com
). Xem phần Trỏ bản ghi DNS đến địa chỉ IP công khai của bạn trong tài liệu về Acquia Cloud.Lưu ý: Đừng đặt mục CNAME của tên miền thành miền
acquia-sites.com
. Việc này có thể gây ra vấn đề về độ trễ hoặc thời gian ngừng hoạt động trên trang web cổng thông tin của bạn.
Giám sát cổng thông tin của bạn bằng Acquia Insights
Acquia Insights là một bộ công cụ giúp bạn tối ưu hoá trang web cổng thông tin của mình bằng cách theo dõi hiệu suất, khả năng bảo mật và hoạt động tối ưu hoá của trang web cho công cụ tìm kiếm. Để biết thêm thông tin, hãy xem Acquia Insights.
Đang sao lưu cổng của bạn
Các bảng sau đây tóm tắt các tuỳ chọn có sẵn để sao lưu các thành phần cổng thông tin.
Thành phần | Chi tiết về dữ liệu sao lưu | Thông tin chi tiết trong Acquia Cloud Tài liệu |
Mã |
|
|
Cơ sở dữ liệu |
|
|
Files | Thực hiện sao lưu thủ công hoặc lên lịch cron job. | |
Đơn đăng ký đầy đủ | Thực hiện sao lưu thủ công bằng Drush. . |
|
Hệ thống tệp Drupal |
Thực hiện sao lưu thủ công bằng một trong những cách sau:
Lưu ý: Mô-đun Sao lưu và di chuyển không được hỗ trợ trên Acquia Cloud. Để biết thêm thông tin, hãy xem bài viết Mô-đun sao lưu và di chuyển không được hỗ trợ trên Acquia Cloud. |
Xem thông báo hoạt động
Bạn có thể xem thông báo hoạt động để theo dõi các hành động quan trọng xảy ra trên trang web cổng thông tin của mình, chẳng hạn như cài đặt hoặc sao chép mã giữa các môi trường, cập nhật và sao lưu cơ sở dữ liệu, thay đổi máy chủ, v.v. Để biết thêm thông tin, hãy xem phần Xem thông báo về hoạt động trong tài liệu về Acquia Cloud.
Cách xem danh sách thông báo:
- Đăng nhập vào giao diện Acquia Cloud tại https://cloud.acquia.com/.
- Trên trang Ứng dụng, hãy nhấp vào Quản lý để xem thông tin chi tiết về trang web cổng thông tin của bạn.
- Nhấp vào biểu tượng chuông ở góc trên bên phải của thanh điều hướng để xem các thông báo gần đây nhất của bạn.
- Nhấp vào mũi tên bên cạnh một thông báo để xem thêm thông tin về hoạt động đó.
Đă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 của Acquia để nhận thông báo về mọi sự gián đoạn dịch vụ, việc bảo trì khẩn cấp hoặc thông tin cập nhật về bảo mật đối với nền tảng này. Cách đăng ký nhận thông tin cập nhật về Acquia Cloud:
- Chuyển đến trang Acquia Status (Trạng thái Acquia).
- Nhấp vào Đăng ký nhận bản cập nhật.
- Chọn phương thức bạn muốn sử dụng để nhận thông tin cập nhật (email, SMS, v.v.).
- Trên trang Thông báo, hãy chọn những sản phẩm bạn muốn nhận thông tin cập nhật về trạng thái. Ví dụ: Acquia Cloud Enterprise.
- Nhấp vào Cập nhật lựa chọn ưu tiên.