Работа с Acquia

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Apigee использует Acquia , службу управления веб-сайтами, для размещения облачных версий портала Developer Services. Acquia предназначен для работы с Drupal, что позволяет вам разрабатывать, тестировать и публиковать свой портал в безопасной среде.

В следующих разделах описывается, как использовать Acquia для разработки и управления вашим порталом.

Доступ к интерфейсу Acquia Cloud

После настройки вашей учетной записи Acquia Cloud вы можете получить доступ к своему порталу через интерфейс Acquia Cloud по адресу https://cloud.acquia.com/ .

При первом входе в систему отображается страница «Приложения» , как показано на следующем рисунке.

На странице «Приложения» отображаются все приложения, к которым у вас есть доступ и которые размещены в Acquia Cloud. Приложение — это программный объект, которым вы управляете в облаке Acquia, например, ваш сайт портала на базе Drupal.

В следующих разделах описано, как использовать интерфейс Acquia Cloud для управления содержимым вашего портала.

Дополнительные сведения об интерфейсе Acquia Cloud см. в разделах «Вход в интерфейс Acquia Cloud» и «Управление приложениями с помощью Acquia Cloud» документации Acquia Cloud.

Управление вашей средой

Откройте интерфейс Acquia Cloud и на странице «Приложения» нажмите «Управление» , связанное с сайтом вашего портала, чтобы получить доступ к его панели управления.

Для управления вашим рабочим процессом предусмотрены три среды для разработки, тестирования и публикации вашего портала, как показано в следующей таблице. Ваш портал развертывается в каждой среде, но может находиться в другом состоянии с уникальной веткой кода или тегом, базой данных и т. д. См. Развертывание кода в средах вашего портала .

Среда Описание URL-адрес по умолчанию
Дев Разрабатывайте новые функции и настраивайте свой портал. http://{ application-name } xxxxxx .devcloud.acquia-sites.com/

Где application-name — это имя вашего приложения, а xxxxxx — уникальная строка символов, используемая для различения Dev и Stage.

Этап Протестируйте последний код, прежде чем отправлять его в производственную среду. http://{ application-name } yyyyyy .devcloud.acquia-sites.com/

Где application-name — это имя вашего приложения, а yyyyyy — уникальная строка символов, используемая для различения Dev и Stage.

Прод Опубликуйте свой портал в рабочей среде (в реальном времени). http://{ application-name }.devcloud.acquia-sites.com/

Где application-name — это имя вашего приложения.

Примечание. См. также раздел «Настройка личного домена» .

Дополнительную информацию см. в разделе «Работа со средами» документации Acquia Cloud.

Разработка вашего портала

В следующих разделах описывается, как разработать портал.

Кроме того, обратитесь к следующим разделам для получения более подробной информации о настройке вашего портала.

Если вы хотите...

Ты можешь

Дополнительная информация

Изменить внешний вид сайта

Базовый — используйте пункт меню «Внешний вид» на сайте портала, чтобы внести изменения, например изменить логотип и цвета сайта.

См . Настройка внешнего вида.

Расширенный — чтобы внести изменения во внешний вид сайта, расширьте адаптивную тему Apigee.

См. Настройка темы.

Изменить поведение функционала сайта

Базовый — используйте настройки администратора на портале, чтобы изменить/настроить поведение сайта.

См. документацию Apigee, начиная здесь.

Дополнительно . Создайте собственный модуль для изменения любого поведения сайта.

См. Создание пользовательских модулей в документации Drupal.

Обзор репозитория Git

Репозиторий Git для вашего кода Drupal содержит весь код вашего портала и организован с использованием следующей структуры.

Примечание . Изменяйте содержимое только в каталоге /sites/all . Если вы измените содержимое, находящееся за пределами каталога /sites/all , у вас возникнут проблемы при обновлении до новых версий и могут возникнуть конфликты слияния при проверке изменений в Git.

Папка в репозитории Git

Описание

/profiles/apigee

Apigee поддерживает модули и темы, в том числе:

  • /profiles/apigee/modules/contrib : модули Drupal Contrib, поддерживаемые Apigee.
  • /profiles/apigee/themes/contrib : темы Drupal, поддерживаемые Apigee.
  • /profiles/apigee/modules/custom : пользовательские модули, созданные Apigee.
  • /profiles/apigee/themes/custom : пользовательские темы, созданные Apigee.

Примечание . Не изменяйте содержимое каталога /profiles/apigee , иначе у вас возникнут проблемы при обновлении до новых версий и могут возникнуть конфликты слияния при регистрации изменений в Git. Рекомендации по использованию Drupal см. в разделе Никогда не взламывайте ядро .

/sites/all

Ваши собственные модули и темы Drupal. Информацию об управлении содержимым в этой папке см. в разделах «Добавление пользовательских модулей и тем» и «Переопределение модулей и тем профиля Drupal» .

Примечание . Изменяйте содержимое только в каталоге /sites/all .

Доступ к вашему коду

Чтобы получить доступ к репозиторию кода в Git, вам необходимо выполнить задачи, описанные в следующих разделах:

См. также Как получить доступ к исходному коду портала разработчиков Drupal 7?

Включение SSH-доступа к вашему серверу

Прежде чем вы сможете использовать Git для управления своим кодом Drupal, вы должны включить SSH для доступа к вашему серверу. Дополнительную информацию см. в разделе «Включение доступа по SSH» в документации Acquia Cloud.

Чтобы включить доступ по SSH:

  1. Войдите в интерфейс учетных записей Acquia по адресу https://accounts.acquia.com .
  2. Нажмите «Учетные данные» .
  3. При появлении запроса повторно введите пароль, чтобы подтвердить свою личность.
  4. В разделе «Ключи SSH» нажмите «Добавить ключ SSH» .
  5. Введите следующую информацию:
    Поле Описание
    Псевдоним Псевдоним для ключа SSH. Псевдоним может содержать буквенно-цифровые символы и символы подчеркивания.
    Открытый ключ Открытый ключ.

    Информацию о создании открытого ключа SSH см. в разделе «Генерация открытого ключа SSH» документации Acquia Cloud.

  6. Нажмите Добавить ключ .

Доступ к вашему хранилищу кода в Git

Репозиторий Git содержит весь код вашего сайта портала. Вы можете добавить новый код или настроить существующий код для настройки вашего портала. Дополнительную информацию см. в разделе «Использование репозитория кода» документации Acquia Cloud.

Чтобы получить доступ к вашему хранилищу кода в репозитории Git:

  1. Войдите в интерфейс Acquia Cloud по адресу https://cloud.acquia.com/ .
  2. На странице «Приложения» нажмите «Управление» , чтобы просмотреть подробную информацию о портале.
  3. Нажмите «Информация о приложении» на панели навигации.

  4. Скопируйте команду клонирования в диалоговом окне «Информация о приложении».
  5. Клонируйте репозиторий Git в локальную среду, выполнив одну из следующих команд Git:

    Чтобы клонировать репозиторий Git и создать новую ветку:

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

    Чтобы клонировать репозиторий Git из основной ветки:

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

  6. Повторите эти шаги, когда будете готовы подготовить, зафиксировать и отправить изменения в репозиторий Git, используя соответствующие команды, показанные в окне приложения.

    Когда вы фиксируете ветку в своем репозитории, Acquia Cloud обновляет среду, в которой выполняется эта ветка кода. Вы можете развернуть код в средах вашего портала, как описано в следующем разделе.

Развертывание кода в средах вашего портала

Чтобы развернуть, переключить или отменить код в среде портала, переместить код между средами или узнать больше о структуре репозитория и рекомендуемом рабочем процессе, см. раздел Работа с сайтами в Aquia Cloud документации Acquia Cloud. Когда вы развертываете новый код в среде, вам нужно будет запустить update.php , чтобы выполнить необходимые обновления базы данных.

Добавление пользовательских модулей и тем

Вы можете расширить функциональность портала, добавив свои собственные модули и темы в папки, перечисленные в следующей таблице.

Примечание . Изменяйте содержимое только в каталоге /sites/all . Если вы изменяете контент, находящийся за пределами каталога /sites/all , у вас могут возникнуть конфликты слияния при проверке изменений в Git.

Модуль/Тема Папка в репозитории Git Дополнительная информация (документация Drupal)
Пользовательские модули sites/all/modules/custom Создание пользовательских модулей
Пользовательские темы sites/all/themes Настройка темы
Темизация Drupal 7

После добавления пользовательского модуля или темы в среду разработки вы можете развернуть его в тестовой среде для тестирования, а затем в рабочей среде Live , как описано в разделе Развертывание кода в средах портала .

Переопределение модулей и тем профиля Drupal

Модули и темы в следующих каталогах переопределяют модули и темы профиля Drupal, поддерживаемые и распространяемые Apigee в /profiles/apigee . См . Обзор вашего репозитория Git .

Например, вы можете захотеть переопределить модуль в дистрибутиве Apigee Drupal в следующих сценариях:

  • Вы хотите использовать другую версию определенного модуля.
  • Вы хотите установить обновление безопасности до следующего запланированного выпуска Apigee.
Модуль/Тема Папка в репозитории Git Дополнительная информация (документация Drupal)
Модули, предоставленные Drupal sites/all/modules/contrib

Примечание . Модули, хранящиеся в каталоге /sites/all/modules переопределяют модули распространения Apigee Drupal.

 Предоставленные модули

Примечание . Модули, предоставленные Drupal в этом каталоге, переопределяют эквивалентные модули, поддерживаемые и распространяемые Apigee в /profiles/apigee/modules . Удалите все дубликаты модулей, которые вы добавили в эту папку, если вы хотите использовать модули профиля Drupal, поддерживаемые Apigee.

Темы, предоставленные Drupal sites/all/themes Предоставленные темы

Примечание . Темы, предоставленные Drupal в этом каталоге, переопределяют эквивалентные модули, поддерживаемые и распространяемые Apigee в /profiles/apigee/themes . Удалите все дубликаты модулей, которые вы добавили в эту папку, если хотите использовать темы профиля, поддерживаемые Apigee.

Включение SSL

Чтобы обеспечить безопасный доступ к вашему сайту с помощью HTTPS, необходимо включить SSL.

Чтобы включить SSL :

  1. Получите сертификат SSL от центра сертификации (CA) или поставщика сертификата SSL. См. Включение SSL .
  2. Загрузите сертификат SSL на странице SSL в интерфейсе Acquia Cloud. См. Управление сертификатами SSL .

Защита вашей производственной среды

Когда вы впервые создаете приложение, вы можете свободно управлять производственной средой и распространять изменения из сред разработки и промежуточной среды. После публикации контента вы можете заблокировать производственную среду, чтобы предотвратить несанкционированные или случайные обновления контента. Дополнительную информацию см. в разделе «Использование производственного режима для защиты вашего работающего приложения» в документации Acquia Cloud.

Чтобы защитить вашу производственную среду:

  1. Войдите в интерфейс Acquia Cloud по адресу https://cloud.acquia.com/ .
  2. На странице «Приложения» нажмите «Управление» , чтобы просмотреть сведения о сайте вашего портала.
  3. Нажмите Prod , чтобы просмотреть сведения о производственной среде.
  4. Нажмите «Производственный режим» на панели навигации.
  5. Нажмите «Включить», чтобы включить производственный режим.

Применение обновлений модулей и тем на портале

Периодически Apigee автоматически обновляет модули и темы на вашем портале до последней версии. Обновления производятся только в среде разработки и помечаются тегами, указывающими на необходимость переноса в другие среды портала.

Если ваш сайт не является частью биллинговой организации Apigee Acquia (например, новый сайт перенесен от другого хостинг-провайдера в вашу собственную организацию), вы должны разрешить Apigee доступ к вашему репозиторию Git, чтобы получать автоматические обновления Devportal. Свяжитесь со службой поддержки Apigee для получения дополнительной информации.

Если вы добавили какие-либо пользовательские модули или темы, вам придется обновить их вручную.

В следующей таблице приведены шаги, необходимые для применения обновлений модулей и тем на портале.

Модули/Темы Описание
Модули Apigee Edge

Apigee автоматически применяет обновления только к среде разработки .

После тестирования обновлений перенесите их из среды разработки в среду Stage в среду Prod , как описано в разделе Развертывание кода в средах портала .

Адаптивная тема Apigee

Apigee автоматически применяет обновления только к среде разработки .

После тестирования обновлений перенесите их из среды разработки в среду Stage в среду Prod , как описано в разделе Развертывание кода в средах портала .

Ядро Drupal и дополнительные модули

Apigee автоматически применяет обновления только к среде разработки .

После тестирования обновлений перенесите их из среды разработки в среду Stage в среду Prod , как описано в разделе Развертывание кода в средах портала .

Пользовательские модули и темы

Если вы добавили на свой портал пользовательские модули и темы, как описано в разделе Добавление пользовательских модулей и тем , вам необходимо установить обновления вручную.

Загрузите последнюю версию в свой локальный каталог вручную или с помощью Drush . Затем подготовьте, зафиксируйте и отправьте обновления в репозиторий Git. После тестирования обновлений перенесите их из среды разработки в среду Stage в среду Prod , как описано в разделе Развертывание кода в средах портала .

Перенос ваших пользовательских функций

Если вы добавляете на портал пользовательский код или конфигурации, вам необходимо поддерживать и переносить их из среды разработки в среду Stage в среду Prod .

Для кода в репозитории Git вы можете использовать процесс, описанный в разделе Развертывание кода в средах вашего портала , чтобы перенести код из Dev в Stage в Prod .

Если вы создали какие-либо пользовательские конфигурации, воспользуйтесь одним из следующих методов для их миграции:

Метод Описание
Экспортируйте свою конфигурацию в код Многие распространенные конфигурации можно «экспортировать» в код с помощью модуля «Функции» . Например, представления, панели, кэш изображений и т. д.
Реализовать hook_update_N() Drupal управляет изменениями базы данных и конфигурации с помощью функцииook_update_N() .

Если у вас есть собственный модуль, вы можете:

  • Добавьте hook_update_N() в файл .install вашего модуля для обработки ваших изменений.
  • Разверните эти изменения вместе с вашим кодом.
  • Запустите update.php , чтобы перенести изменения в средах Stage и Prod.

Настройка личного домена

Как отмечено в разделе «Управление средами» , все доменные имена по умолчанию для сред портала заканчиваются на acquia-sites.com . Рекомендуется предоставить собственное доменное имя, которое персонализирует и лучше передает цель вашего сайта. Например, популярная альтернатива:

https://developers.mycompany.com

Чтобы настроить личный домен :

  1. Добавьте свой домен в среду сайта портала. См. «Управление доменами» в документации Acquia Cloud.
  2. Настройте свой личный домен у своего DNS-провайдера, указав запись DNS вашего доменного имени на общедоступный IP-адрес (а не на домен acquia-sites.com ). См. раздел «Указание DNS-записей на ваши общедоступные IP-адреса» в документации Acquia Cloud.

    Примечание . Не указывайте запись CNAME доменного имени как домен acquia-sites.com . Это может привести к проблемам с задержкой или простою вашего сайта портала.

Мониторинг вашего портала с помощью Acquia Insight

Acquia Insight — это набор инструментов, который позволяет оптимизировать сайт портала, отслеживая его производительность, безопасность и оптимизацию для поисковых систем. Для получения дополнительной информации см. Acquia Insight .

Резервное копирование вашего портала

В следующих таблицах суммированы варианты, доступные для резервного копирования компонентов вашего портала.

Компонент Сведения о резервном копировании Дополнительная информация в документации Acquia Cloud.
Код
  • Код поддерживается системой контроля версий и помечается тегами каждый раз, когда вы совершаете коммит.
  • Синхронизируйте или вернитесь к определенному тегу в любое время.
База данных
  • Ежедневное резервное копирование выполняется и сохраняется в течение трех дней.
  • Запланируйте автоматическое резервное копирование и резервное копирование по требованию.
  • Снимки всех данных во время внутренних аварий создаются каждый час.
Файлы Выполните резервное копирование вручную или запланируйте задание cron.
Полное приложение Выполните резервное копирование вручную с помощью Drush.
.
Файловая система Друпал Выполните резервное копирование вручную, используя один из следующих вариантов:
  • Скопируйте файлы с помощью FTP-клиента или инструментов командной строки ( rsync и scp ).
  • Создайте сжатый архив с помощью Drush.

Примечание. Модуль резервного копирования и миграции не поддерживается в Acquia Cloud. Для получения дополнительной информации см. Модуль резервного копирования и миграции, не поддерживаемый в Acquia Cloud .

Просмотр уведомлений об активности

Вы можете просматривать уведомления об активности, чтобы отслеживать важные действия, происходящие на вашем сайте портала, такие как установка или копирование кода между средами, обновления и резервные копии баз данных, изменения на сервере и многое другое. Дополнительную информацию см. в разделе «Просмотр уведомлений об активности» документации Acquia Cloud.

Чтобы просмотреть список уведомлений:

  1. Войдите в интерфейс Acquia Cloud по адресу https://cloud.acquia.com/ .
  2. На странице «Приложения» нажмите «Управление» , чтобы просмотреть сведения о сайте вашего портала.
  3. Нажмите значок колокольчика в правом верхнем углу панели навигации, чтобы просмотреть последние уведомления.

  4. Нажмите стрелку рядом с уведомлением, чтобы просмотреть дополнительную информацию о действии.

Подписка на обновления статуса

Вы можете подписаться на выпуск Apigee и обновления статуса на сайте status.apigee.com . Нажмите «Подписаться на обновления» , при появлении запроса введите свою контактную информацию, например адрес электронной почты, и нажмите «Подписаться» . На странице управления уведомлениями по электронной почте убедитесь, что выбран «Портал разработчика» , при необходимости измените другие параметры уведомлений и нажмите «Обновить настройки» .

Вы можете подписаться на обновления статуса Acquia, чтобы получать уведомления о любых перебоях в обслуживании, экстренном обслуживании или обновлениях безопасности, выпускаемых на платформе. Чтобы подписаться на обновления Acquia Cloud:

  1. Перейдите на страницу статуса Acquia .
  2. Нажмите «Подписаться на обновления» .
  3. Выберите метод, который вы хотите использовать для получения обновлений (электронная почта, SMS и т. д.).
  4. На странице «Уведомления» выберите продукты, для которых вы хотите получать обновления статуса. Например, Acquia Cloud Enterprise.
  5. Нажмите «Обновить настройки» .