Установка Akeneo PIM на Ubuntu 18.04

Иллюстрация Akeneo PIM

Akeneo — бесплатная, с открытым исходным кодом и корпоративная платформа управления информацией о товарах (PIM), построенная на Symfony2. Она проста в использовании и гибко настраивается: позволяет совместно управлять каталогами, автоматизировать обмен данными и публиковать контент на разных устройствах. Akeneo содержит расширяемый движок импорта данных, который упрощает загрузку данных из любых источников. Вы можете редактировать атрибуты, заполнять карточки товаров, переводить информацию на несколько языков, добавлять медиафайлы и отслеживать историю изменений.

Кому подходит это руководство

Системным администраторам и DevOps-инженерам, которым нужно развернуть Akeneo на собственном сервере.
Командам, которые предпочитают классический LAMP-стек (не Docker).

Требования

Сервер с Ubuntu 18.04 LTS.
Нерыночный пользователь с правами sudo.
Доступ в интернет для загрузки пакетов и зависимостей.
Рекомендуем минимум 4 ГБ оперативной памяти для небольших инсталляций; для продакшена — 8+ ГБ.

Шаг 1 — Установка LAMP

Перед установкой Akeneo нужно развернуть Apache, PHP и MariaDB.

Сначала установите Apache и MariaDB:

sudo apt-get install apache2 mariadb-server -y

Запустите службы и включите автозапуск:

sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl start mysql
sudo systemctl enable mysql

По умолчанию в Ubuntu 18.04 нет новейшей версии PHP в стандартных репозиториях, поэтому добавим PPA Ondřej Surý:

sudo apt-get install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php

Обновите индекс пакетов и установите PHP 7.1 и нужные расширения:

sudo apt-get update -y
sudo apt-get install php7.1 libapache2-mod-php7.1 php7.1-apcu php7.1-bcmath php7.1-common php7.1-mbstring php7.1-xmlrpc php7.1-soap php7.1-gd php7.1-xml php7.1-intl php7.1-mysql php7.1-cli php7.1-mcrypt php7.1-ldap php7.1-zip php7.1-curl -y

Отредактируйте php.ini для Apache:

sudo nano /etc/php/7.1/apache2/php.ini

Внесите следующие изменения или убедитесь, что значения совпадают:

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 256M
upload_max_filesize = 120M
max_execution_time = 300
max_input_vars = 1500
date.timezone = Asia/Kolkata

Сохраните и закройте файл.

Важно: при необходимости замените date.timezone на ваш локальный часовой пояс (например, Europe/Moscow).

Шаг 2 — Настройка MariaDB

По умолчанию MariaDB небезопасна — запустите скрипт её первичной настройки:

sudo mysql_secure_installation

Рекомендуемые ответы (пример):

Enter current password for root (enter for none): 
Set root password? [Y/n]: N
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]:  Y
Reload privilege tables now? [Y/n]:  Y

Затем войдите в оболочку MariaDB и создайте базу и пользователя для Akeneo:

mysql -u root -p

Внутри MariaDB выполните:

MariaDB [(none)]> CREATE DATABASE akeneodb;
MariaDB [(none)]> CREATE USER 'akeneouser'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> GRANT ALL ON akeneodb.* TO 'akeneouser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit

Замените ‘password’ на надёжный пароль. Для продакшна используйте отдельную учётную запись с ограниченными правами.

Шаг 3 — Скачивание и установка Akeneo

Скачайте архив Akeneo (пример для версии 2.2 community с Icecat):

wget wget http://download.akeneo.com/pim-community-standard-v2.2-latest-icecat.tar.gz

Создайте каталог в корне Apache и распакуйте архив туда:

sudo mkdir /var/www/html/akeneo
sudo tar -xvzf pim-community-standard-v2.2-latest-icecat.tar.gz -C /var/www/html/akeneo

Перейдите в каталог и выполните установку зависимостей через composer (в примере используется локальный composer.phar):

cd /var/www/html/akeneo/pim-community-standard
sudo php -d memory_limit=3G ../composer.phar install --optimize-autoloader --prefer-dist

Ожидаемый фрагмент вывода показывает установку ассетов как относительных символьных ссылок и успешную установку.

Очистите кэш и установите ассеты приложения для продакшена:

sudo php bin/console cache:clear --no-warmup --env=prod

sudo php bin/console pim:installer:assets --symlink --clean --env=prod

Назначьте корректные права и владельца:

sudo chown -R www-data:www-data /var/www/html/akeneo/
sudo chmod -R 755 /var/www/html/akeneo/

Совет по безопасности: для продакшна лучше ограничить права каталогов (например, 750) и минимизировать количество исполняемых бит.

Шаг 4 — Конфигурация Apache

Создайте виртуальный хост Apache для Akeneo:

sudo nano /etc/apache2/sites-available/akeneo.conf

Добавьте конфигурацию:


     ServerAdmin [email protected]
     DocumentRoot /var/www/html/akeneo/pim-community-standard/web
     ServerName example.com

     
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     

     ErrorLog ${APACHE_LOG_DIR}/akeneo_error.log
     CustomLog ${APACHE_LOG_DIR}/akeneo_access.log combined

Включите сайт и модуль rewrite, затем перезапустите Apache:

sudo a2ensite akeneo.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Откройте в браузере http://example.com и продолжите установку через веб-интерфейс Akeneo.

Экран управления Akeneo PIM

Критерии приёмки

Веб-интерфейс Akeneo доступен по указанному ServerName.
Приложение не возвращает ошибок 500 на главной странице.
Каталоги web, var и другие имеют корректного владельца (www-data) и права доступа.
Возможность входа в админ-панель и создания первого товара.

Отладка и распространённые проблемы

500 Internal Server Error: проверьте логи Apache (/var/log/apache2/akeneo_error.log) и Symfony-логи в /var/www/html/akeneo/pim-community-standard/var/logs.
Ошибки связи с БД: проверьте строку подключения в app/config/parameters.yml и учетные данные MariaDB.
Проблемы с composer: убедитесь, что у вас достаточно memory_limit при запуске composer; в примере запускается с php -d memory_limit=3G.
Символьные ссылки ассетов не создаются: проверьте опцию AllowOverride и наличие прав для создания ссылок.

Important: никогда не используйте слабые пароли для базы данных в продакшене.

Альтернативные подходы

Контейнеризация: разверните Akeneo с Docker Compose — это упрощает изоляцию зависимостей и портирование между средами.
Управляемый хостинг: используйте платформу, поддерживающую Symfony/Php для упрощённого управления (PaaS).
Используйте более новые версии PHP/Ubuntu, если Akeneo и ваши зависимости это поддерживают (проверяйте совместимость версий).

Мини-методология: быстрый план развертывания (playbook)

Подготовить сервер: обновить пакеты, настроить пользователя sudo.
Установить Apache и MariaDB, настроить безопасную MariaDB.
Добавить PPA PHP, установить PHP 7.1 и расширения.
Скачать и распаковать Akeneo, установить зависимости через composer.
Настроить права и виртуальный хост Apache.
Тестировать веб-интерфейс, выполнять проверку логов и настроек безопасности.

Роль‑ориентированные чек-листы

Системный администратор: установить пакеты, настроить MariaDB, SSL, firewall.
DevOps: автоматизировать установку через скрипты или Docker, настроить мониторинг.
Менеджер контента: проверить возможность импорта и локализации атрибутов.

Мероприятия при инциденте (быстрая инструкция)

Если сайт недоступен — проверить состояние Apache: sudo systemctl status apache2.
Проверить логи ошибок Apache и Symfony.
Перезапустить службы: sudo systemctl restart apache2 mysql.
Восстановить из последней рабочей резервной копии, если необходим откат.

Небольшая диаграмма процесса развертывания

flowchart TD
  A[Подготовка сервера] --> B[Установка Apache/MariaDB/PHP]
  B --> C[Настройка MariaDB]
  C --> D[Скачивание Akeneo]
  D --> E[Установка зависимостей Composer]
  E --> F[Конфигурация Apache и права]
  F --> G[Тестирование и запуск]

Короткий глоссарий

PIM — Product Information Management, система управления информацией о товарах.
Composer — менеджер зависимостей для PHP.
Symfony — PHP-фреймворк, на котором построен Akeneo.

Советы по миграции и совместимости

Проверьте требования конкретной версии Akeneo перед обновлением (PHP, расширения, БД).
Тестируйте обновление в staging-среде прежде чем обновлять продакшн.

Дополнительные ресурсы

Akeneo: https://www.akeneo.com

Итог

Установка Akeneo PIM на Ubuntu 18.04 включает установку LAMP-стека, настройку MariaDB, развёртывание пакета Akeneo и настройку виртуального хоста Apache. После установки убедитесь в корректных правах доступа, настройках безопасности и тестировании функциональности.

Ссылки

Akeneo