Praca z Acquią

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Apigee korzysta z usługi Acquia do zarządzania witryną, aby hostować wersje portalu usług dla programistów działające w chmurze. Usługa Acquia została zaprojektowana pod kątem współpracy z Drupal, dzięki czemu możesz tworzyć, testować i publikować portal w bezpiecznym środowisku.

W kolejnych sekcjach opisano, jak korzystać z Acquia do tworzenia portalu i zarządzania nim.

Uzyskiwanie dostępu do interfejsu Acquia Cloud

Po skonfigurowaniu konta Acquia Cloud możesz uzyskać dostęp do portalu przez interfejs Acquia Cloud na stronie https://cloud.acquia.com/.

Gdy zalogujesz się po raz pierwszy, wyświetli się strona Aplikacje, jak pokazano na tej ilustracji.

Na stronie Aplikacje wyświetlane są wszystkie aplikacje, do których masz dostęp, a przechowywane na serwerze Acquia Cloud. Aplikacja to oprogramowanie, którym zarządzasz w usłudze Acquia Cloud, na przykład witryna portalu opartego na Drupal.

W kolejnych sekcjach opisano, jak za pomocą interfejsu Acquia Cloud zarządzać treścią portalu.

Więcej informacji o interfejsie Acquia Cloud znajdziesz w sekcjach Logowanie się w interfejsie Acquia Cloud i Zarządzanie aplikacjami za pomocą Acquia Cloud w dokumentacji na temat tej usługi.

Zarządzanie środowiskami

Otwórz interfejs Acquia Cloud i na stronie Aplikacje kliknij Zarządzaj powiązaną z witryną portalu, aby uzyskać dostęp do jej panelu.

Do zarządzania przepływem pracy potrzebne są 3 środowiska do programowania, testowania i publikowania portalu, jak opisano w poniższej tabeli. Portal jest wdrożony w każdym środowisku, ale może być w innym stanie z unikalną gałęzią kodu, tagiem, bazą danych itd. Przeczytaj sekcję Wdrażanie kodu w środowiskach portalu.

Środowisko Opis Domyślny adres URL
Dla programistów Opracuj nowe funkcje i dostosuj swój portal. http://{application-name}xxxxxx.devcloud.acquia-sites.com/

Gdzie application-name to nazwa aplikacji, a xxxxxx to unikalny ciąg znaków używany do odróżnienia wersji deweloperskiej od wersji deweloperskiej.
Etap Przetestuj najnowszy kod, zanim przekażesz go do środowiska produkcyjnego. http://{application-name}yyyyyy.devcloud.acquia-sites.com/

Gdzie application-name to nazwa aplikacji, a yyyyyy to unikalny ciąg znaków używany do odróżnienia wersji deweloperskiej od wersji deweloperskiej.
Produkcyjne Opublikuj portal w wersji produkcyjnej (wersja aktywna). http://{application-name}.devcloud.acquia-sites.com/

Gdzie application-name to nazwa Twojej aplikacji.

Uwaga: zobacz też Konfigurowanie domeny niestandardowej.

Więcej informacji znajdziesz w sekcji Praca ze środowiskami w dokumentacji Acquia Cloud.

Tworzenie portalu

Poniższe sekcje zawierają opis sposobu tworzenia portalu.

Dodatkowo w poniższych sekcjach znajdziesz więcej informacji na temat dostosowywania portalu.

Jeśli chcesz...

Możesz

Więcej informacji

zmieniać wygląd i sposób działania witryny,

Podstawowe – korzystając z wpisu w menu Wygląd w witrynie portalu, możesz wprowadzać zmiany, takie jak zmiana logo i kolorów witryny.

Zobacz Dostosowywanie wyglądu.

Zaawansowane – aby zmienić pełny wygląd i styl witryny, rozszerz motyw elastyczny Apigee.

Patrz: Dostosowywanie motywu.

Zmień działanie funkcji witryny

Podstawowe – użyj ustawień administratora w portalu, aby zmienić lub skonfigurować sposób działania witryny.

Dokumentację Apigee znajdziesz tutaj

Zaawansowane – utwórz moduł niestandardowy, aby zmienić dowolne działanie witryny.

Zapoznaj się z sekcją Tworzenie modułów niestandardowych w dokumentacji Drupala.

Omówienie repozytorium Git

Repozytorium Git dla kodu Drupal zawiera cały kod portalu i jest uporządkowane według poniższej struktury.

Uwaga: modyfikuj tylko zawartość katalogu /sites/all. Jeśli zmodyfikujesz treść spoza katalogu /sites/all, podczas uaktualniania do nowych wersji wystąpią problemy i mogą wystąpić konflikty scalania podczas sprawdzania zmian w Git.

Folder w repozytorium Git

Opis
/profiles/apigee

Apigee utrzymuje moduły i motywy, w tym:

  • /profiles/apigee/modules/contrib: moduły Contrib Drupal obsługiwane przez Apigee
  • /profiles/apigee/themes/contrib: motywy Contrib w Drupal utworzone przez Apigee
  • /profiles/apigee/modules/custom: moduły niestandardowe utworzone przez Apigee
  • /profiles/apigee/themes/custom: motywy niestandardowe utworzone przez Apigee

Uwaga: nie zmieniaj zawartości katalogu /profiles/apigee, bo podczas aktualizowania do nowych wersji wystąpią problemy i mogą wystąpić konflikty scalania podczas sprawdzania zmian w Git. Sprawdzone metody dotyczące systemu Drupal znajdziesz w artykule Nigdy nie hakuj rdzeni.
/sites/all

Twoje niestandardowe moduły i motywy w systemie Drupal. Informacje o zarządzaniu zawartością w tym folderze znajdziesz w sekcjach Dodawanie niestandardowych modułów i motywów oraz Zastępowanie modułów i motywów profilu Drupal.

Uwaga: modyfikuj tylko zawartość katalogu /sites/all.

Uzyskiwanie dostępu do kodu

Aby uzyskać dostęp do repozytorium kodu w Git, musisz wykonać zadania opisane w tych sekcjach:

Zobacz też Jak uzyskać dostęp do kodu źródłowego portalu dla programistów Drupal 7?

Włączanie dostępu SSH do serwera

Zanim zaczniesz używać Git do zarządzania kodem Drupal, musisz włączyć SSH, aby uzyskać dostęp do serwera. Więcej informacji znajdziesz w sekcji Włączanie dostępu przez SSH w dokumentacji Acquia Cloud.

Aby włączyć dostęp przez SSH:

  1. Zaloguj się w interfejsie kont Acquia na https://accounts.acquia.com.
  2. Kliknij Credentials (Dane logowania).
  3. Jeśli pojawi się prośba o podanie hasła, wpisz je jeszcze raz, aby potwierdzić swoją tożsamość.
  4. W sekcji Klucze SSH kliknij Dodaj klucz SSH.
  5. Wprowadź następujące informacje:
    Pole Opis
    Pseudonim Nazwa klucza SSH. Pseudonim może zawierać znaki alfanumeryczne i podkreślenia.
    Klucz publiczny Klucz publiczny.

    Informacje na temat generowania klucza publicznego SSH znajdziesz w sekcji Generowanie klucza publicznego SSH w dokumentacji Acquia Cloud.
  6. Kliknij Dodaj klucz.

Dostęp do repozytorium kodu w Git

Repozytorium Git zawiera cały kod witryny portalu. Aby skonfigurować portal, możesz dodać nowy kod lub dostosować istniejący kod. Więcej informacji znajdziesz w sekcji Korzystanie z repozytorium kodu w dokumentacji Acquia Cloud.

Aby uzyskać dostęp do repozytorium kodu w repozytorium Git:

  1. Zaloguj się w interfejsie Acquia Cloud na stronie https://cloud.acquia.com/.
  2. Na stronie Aplikacje kliknij Zarządzaj, aby wyświetlić szczegóły portalu.
  3. Kliknij Informacje o aplikacji na pasku nawigacyjnym.

  4. Skopiuj polecenie klonowania z okna Informacje o aplikacji.
  5. Skopiuj repozytorium Git do środowiska lokalnego, wykonując jedno z tych poleceń Git:

    Aby skopiować repozytorium Git i utworzyć nową gałąź:

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    Aby sklonować repozytorium Git z gałęzi master:

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. Powtórz te kroki, gdy wszystko będzie gotowe do sceny, zatwierdzenia i przekazania zmian do repozytorium Git za pomocą odpowiednich poleceń wyświetlanych w oknie aplikacji.

    Gdy zatwierdzisz gałąź do repozytorium, Acquia Cloud zaktualizuje środowisko, w którym działa ta gałąź kodu. Możesz wdrożyć kod w środowiskach portalu zgodnie z opisem w następnej sekcji.

Wdrażanie kodu w środowiskach portalu

Jeśli chcesz wdrożyć, przełączyć lub przywrócić kod w środowisku portalu, przenieść kod między środowiskami lub dowiedzieć się więcej o strukturze repozytorium i zalecanym przepływie pracy, przeczytaj artykuł Praca z witrynami w Aquia Cloud w dokumentacji Acquia Cloud. Gdy wdrażasz nowy kod w środowisku, musisz uruchomić update.php, aby wprowadzić wymagane aktualizacje bazy danych.

Dodawanie niestandardowych modułów i motywów

Możesz rozszerzyć funkcjonalność portalu, dodając własne niestandardowe moduły i motywy do folderów wymienionych w poniższej tabeli.

Uwaga: modyfikuj tylko zawartość katalogu /sites/all. Jeśli modyfikujesz treści spoza katalogu /sites/all, podczas sprawdzania zmian w Git mogą wystąpić konflikty scalania.

Moduł/motyw Folder w repozytorium Git Więcej informacji (dokumentacja Drupala)
Moduły niestandardowe sites/all/modules/custom Tworzenie modułów niestandardowych
Motywy niestandardowe sites/all/themes Dostosowywanie motywu
Theming Drupal 7

Po dodaniu modułu niestandardowego lub motywu w środowisku deweloperskim możesz go wdrożyć w środowisku testowym, a następnie w aktywnym środowisku produkcyjnym zgodnie z opisem w sekcji Wdrażanie kodu w środowiskach portalu.

Zastępowanie modułów i motywów profilu Drupal

Moduły i motywy w poniższych katalogach zastępują moduły i motywy profilu Drupal obsługiwane i rozpowszechniane przez Apigee w katalogu /profiles/apigee. Zobacz Omówienie repozytorium Git.

Możesz na przykład zastąpić moduł w dystrybucji Apigee Drupal w tych sytuacjach:

  • Chcesz użyć innej wersji danego modułu.
  • Chcesz wdrożyć aktualizację zabezpieczeń przed następną zaplanowaną wersją Apigee.
Moduł/motyw Folder w repozytorium Git Więcej informacji (dokumentacja Drupala)
Moduły ze strony Drupal sites/all/modules/contrib

Uwaga: moduły przechowywane w dowolnym miejscu w /sites/all/modules zastąpią moduły dystrybucji Apigee Drupal.

 Przesłane moduły

Uwaga: moduły dodane w tym katalogu zastępują odpowiednie moduły obsługiwane i rozpowszechniane przez Apigee w /profiles/apigee/modules. Jeśli chcesz korzystać z obsługiwanych przez Apigee modułów profilu Drupal, usuń wszystkie zduplikowane moduły dodane do tego folderu.
Motywy dodane przez Drupal sites/all/themes Przesłane motywy

Uwaga: motywy opublikowane w tym katalogu zastępują odpowiednie moduły obsługiwane i rozpowszechniane przez Apigee w /profiles/apigee/themes. Jeśli chcesz używać motywów profilu obsługiwanych przez Apigee, usuń wszystkie zduplikowane moduły dodane do tego folderu.

Włączanie SSL

Aby włączyć bezpieczny dostęp do witryny za pomocą protokołu HTTPS, musisz włączyć protokół SSL.

Aby włączyć SSL:

  1. Uzyskaj certyfikat SSL od urzędu certyfikacji lub dostawcy certyfikatów SSL. Zobacz Włączanie SSL.
  2. Prześlij certyfikat SSL na stronie SSL w interfejsie Acquia Cloud. Patrz Zarządzanie certyfikatami SSL.

Ochrona środowiska produkcyjnego

Po utworzeniu aplikacji możesz swobodnie zarządzać środowiskiem produkcyjnym oraz rozpowszechniać zmiany ze środowisk programistycznych i testowych. Po opublikowaniu treści możesz zablokować środowisko produkcyjne, aby zapobiec nieautoryzowanym lub przypadkowym aktualizacjom treści. Więcej informacji znajdziesz w sekcji Korzystanie z trybu produkcyjnego do ochrony opublikowanej aplikacji w dokumentacji Acquia Cloud.

Aby zabezpieczyć środowisko produkcyjne:

  1. Zaloguj się w interfejsie Acquia Cloud na stronie https://cloud.acquia.com/.
  2. Na stronie Aplikacje kliknij Zarządzaj, aby wyświetlić szczegóły witryny portalu.
  3. Kliknij Prod (Prod), aby wyświetlić szczegóły środowiska produkcyjnego.
  4. Na pasku nawigacyjnym kliknij Tryb produkcyjny.
  5. Kliknij Włącz, aby włączyć tryb produkcyjny.

Stosuję aktualizacje modułów i motywów do portalu

Apigee okresowo automatycznie aktualizuje moduły i motywy w portalu do najnowszej wersji. Aktualizacje są przeprowadzane tylko w środowisku Dev i są otagowane w celu wskazania, że należy je przenieść do innych środowisk portalu.

Jeśli Twoja witryna nie należy do organizacji obsługującej płatności Apigee Acquia (np. nowej witryny przeniesionej od innego dostawcy usług hostingowych do Twojej organizacji), musisz zezwolić Apigee na dostęp do repozytorium Git, aby otrzymywać automatyczne aktualizacje Devportal. Aby uzyskać więcej informacji, skontaktuj się z zespołem pomocy Apigee.

Jeśli masz dodane niestandardowe moduły lub motywy, musisz je zaktualizować ręcznie.

W tabeli poniżej znajdziesz podsumowanie czynności wymaganych do zastosowania aktualizacji modułów i motywów w portalu.

Moduły/motywy Opis
Moduły Apigee Edge

Apigee automatycznie stosuje aktualizacje tylko w środowisku deweloperskim.

Po przetestowaniu aktualizacji przenieś je ze środowisk Dev do Stage do Prod zgodnie ze wskazówkami w sekcji Wdrażanie kodu w środowiskach portalu.
Elastyczny motyw Apigee

Apigee stosuje aktualizacje automatycznie tylko w środowisku deweloperskim.

Po przetestowaniu aktualizacji przenieś je ze środowisk Dev do Stage do Prod zgodnie ze wskazówkami w sekcji Wdrażanie kodu w środowiskach portalu.
Rdzeń Drupal i współdzielone moduły

Apigee stosuje aktualizacje automatycznie tylko w środowisku deweloperskim.

Po przetestowaniu aktualizacji przenieś je ze środowisk Dev do Stage do Prod zgodnie ze wskazówkami w sekcji Wdrażanie kodu w środowiskach portalu.
Moduły i motywy niestandardowe

Jeśli do portalu zostały dodane niestandardowe moduły i motywy zgodnie z opisem w sekcji Dodawanie niestandardowych modułów i motywów, aktualizacje musisz zainstalować ręcznie.

Pobierz najnowszą wersję do katalogu lokalnego ręcznie lub za pomocą Drusha. Następnie dokonaj etapu, zatwierdź i przekaż aktualizacje do repozytorium Git. Po przetestowaniu aktualizacji przenieś je ze środowisk Dev do Stage do Prod zgodnie ze wskazówkami w sekcji Wdrażanie kodu w środowiskach portalu.

Migracja funkcji niestandardowych

Jeśli dodasz do portalu niestandardowy kod lub konfiguracje, musisz je zachować i przenieść ze środowisk Dev do Stage i Prod.

W przypadku kodu w repozytorium Git możesz użyć procesu opisanego w sekcji Wdrażanie kodu w środowiskach portalu, aby przenieść kod z Dev do Stage do Prod.

Jeśli masz utworzone konfiguracje niestandardowe, przenieś je za pomocą jednej z tych metod:

Metoda Opis
Eksportowanie konfiguracji do kodu Wiele popularnych konfiguracji można wyeksportować do kodu za pomocą modułu funkcji. Mogą to być na przykład widoki, panele, pamięć podręczna obrazów itd.
Wdróż funkcję hook_update_N() Drupal zarządza zmianami w bazie danych i konfiguracji przy użyciu funkcji hook_update_N().

Jeśli masz moduł niestandardowy, możesz:

  • Aby umożliwić przetworzenie zmian, dodaj funkcje hook_update_N() do pliku .install modułu.
  • Wdróż te zmiany razem z kodem.
  • Uruchom update.php, aby przenieść zmiany w środowiskach Stage i Prod.

Konfigurowanie domeny niestandardowej

Jak wspomnieliśmy w sekcji Zarządzanie środowiskami, domyślne nazwy domen środowisk portalu kończą się na acquia-sites.com. Zalecamy podanie własnej niestandardowej nazwy domeny, która będzie personalizowana i lepiej odzwierciedla przeznaczenie Twojej witryny. Popularną alternatywą jest na przykład:

https://developers.mycompany.com

Aby skonfigurować domenę niestandardową:

  1. Dodaj domenę do środowiska witryny portalu. Przeczytaj sekcję Zarządzanie domenami w dokumentacji Acquia Cloud.
  2. Skonfiguruj domenę niestandardową u dostawcy DNS, kierując wpis rekordu DNS nazwy domeny na publiczny adres IP (a nie na domenę acquia-sites.com). Przeczytaj sekcję Wskazywanie rekordów DNS na Twoje publiczne adresy IP w dokumentacji Acquia Cloud.

    Uwaga: w polu CNAME nazwy domeny nie ustawiaj domeny acquia-sites.com. Może to spowodować problemy z opóźnieniami lub przerwę w działaniu witryny portalu.

Monitorowanie portalu za pomocą Acquia Insight

Acquia Insight to zestaw narzędzi umożliwiających optymalizację witryny portalu przez monitorowanie jej wydajności, bezpieczeństwa i optymalizacji pod kątem wyszukiwarek. Więcej informacji znajdziesz w Acquia Insight.

Tworzę kopię zapasową portalu

W tabelach poniżej znajdziesz podsumowanie dostępnych opcji tworzenia kopii zapasowych komponentów portalu.

Komponent Szczegóły kopii zapasowej Więcej informacji znajdziesz w dokumentacji Acquia Cloud
Kod
  • Kod jest utrzymywany przez system kontroli wersji i tagowany przy każdym zatwierdzeniu.
  • W każdej chwili możesz zsynchronizować lub przywrócić konkretny tag.
Baza danych
  • Codzienne kopie zapasowe są wykonywane i przechowywane przez 3 dni.
  • planować automatyczne i na żądanie tworzenia kopii zapasowych;
  • Wewnętrzne zrzuty wszystkich danych związane z awariami są wykonywane co godzinę.
Files Wykonuj ręczne kopie zapasowe lub zaplanuj zadanie cron.
Pełna aplikacja Rób kopie zapasowe ręcznie za pomocą Drusha.
.
System plików Drupal Rób kopie zapasowe ręcznie, korzystając z jednej z tych opcji:
  • Skopiuj pliki za pomocą klienta FTP lub narzędzi wiersza poleceń (rsync i scp).
  • Utwórz skompresowane archiwum za pomocą Drusha.

Uwaga: moduł Tworzenie kopii zapasowych i migrowanie nie jest obsługiwany w Acquia Cloud. Więcej informacji znajdziesz w artykule Moduł tworzenia kopii zapasowych i migracji danych nie jest obsługiwany w acquia Cloud.

Wyświetlanie powiadomień o aktywności

Możesz wyświetlać powiadomienia o aktywności, aby śledzić ważne działania wykonywane w witrynie portalu, takie jak instalowanie lub kopiowanie kodu między środowiskami, aktualizowaniem bazy danych i tworzeniem kopii zapasowych czy zmiany na serwerze. Więcej informacji znajdziesz w sekcji Wyświetlanie powiadomień o aktywności w dokumentacji Acquia Cloud.

Aby wyświetlić listę powiadomień:

  1. Zaloguj się w interfejsie Acquia Cloud na stronie https://cloud.acquia.com/.
  2. Na stronie Aplikacje kliknij Zarządzaj, aby wyświetlić szczegóły witryny portalu.
  3. Aby zobaczyć najnowsze powiadomienia, kliknij ikonę dzwonka w prawym górnym rogu paska nawigacyjnego.

  4. Kliknij strzałkę obok powiadomienia, aby wyświetlić więcej informacji o aktywności.

Subskrybowanie aktualizacji stanu

Aktualizacje wersji i stanu Apigee możesz zasubskrybować na stronie status.apigee.com. Kliknij Subskrybuj aktualizacje, wpisz informacje kontaktowe, takie jak adres e-mail, gdy pojawi się prośba, a następnie kliknij Subskrybuj. Na stronie zarządzania powiadomieniami e-mail zaznacz Portal dla programistów, w razie potrzeby zmień inne ustawienia powiadomień i kliknij Zaktualizuj ustawienia.

Możesz zasubskrybować aktualizacje stanu Acquia, aby otrzymywać powiadomienia o przerwach w działaniu usługi, awaryjnej konserwacji i aktualizacjach zabezpieczeń platformy. Aby zasubskrybować aktualizacje Acquia Cloud:

  1. Otwórz stronę Acquia Status.
  2. Kliknij Subskrybuj aktualizacje.
  3. Wybierz metodę, za pomocą której chcesz otrzymywać aktualności (e-maile, SMS-y itd.).
  4. Na stronie Powiadomienia wybierz usługi, w przypadku których chcesz otrzymywać aktualne informacje o stanie. Na przykład Acquia Cloud Enterprise.
  5. Kliknij Zaktualizuj ustawienia.