Delta.bg MarketplaceMarketplace
PrestaShop (AlmaLinux 8)

PrestaShop (AlmaLinux 8)

  • Операционна система: almalinux 8

Описание

Този образ комбинира PrestaShop с AlmaLinux 8, за да започнете с готова за работа среда вместо ръчно първоначално конфигуриране. Оптимизиран е за внедряване на e-commerce магазини, като същевременно запазва операционната система стабилна и лесна за поддръжка в дългосрочен план. Изберете този стек, когато искате да намалите времето за настройка, да стандартизирате инфраструктурата и да стартирате PrestaShop среди върху AlmaLinux 8 по-бързо.

  1. Включен софтуер
  2. Първоначално стартиране на услугата
  3. Бързи настройки и често задавани въпроси
  4. Използване на собствен SSL сертификат
  5. Допълнителни настройки при Docker
    1. PrestaShop конфигурационни опции
  6. SSL сертификати
    1. Използване на собствени (платени) SSL сертификати
    2. Издаване на сертификати с Let's Encrypt
  7. Работа с Docker
    1. Рестартиране на всички услуги
    2. Пресъздаване на Docker контейнери
    3. Проверка на статуса на Docker приложението
    4. Промяна на настройки

Включен софтуер

Пакет Версия
PrestaShop latest
Docker 3.20.10
Docker compose 2.12.2
containerd.io 1.6.10

Първоначално стартиране на услугата

Това приложение използва Docker, за да осигури по-бързо стартиране на прилежащия софтуер (PrestaShop) и директно започване на употребата му. По този начин се елиминира нуждата от запознаване със спецификите му по отношение на конфигурация и инсталация. За да започнете директна работа с приложението, единственото, което трябва да направите е да посетите IP адреса, който е назначен за виртуалната Ви машина в браузъра си, за да видите новата си PrestaShop инсталация.

Забележка: По подразбиране, PrestaShop може да се достъпи директно по IP адрес. За да започнете да използвате PrestaShop с реалния си домейн, първо трябва да насочите въпросния домейн към IP адреса си и да промените настройките за това от къде се отваря PrestaShop през неговия административен панел.

Бързи настройки и често задавани въпроси

  • Входът в клауд услугата се извършва посредством SSH ключ или парола, която сте посочили.
  • Docker е инсталиран според препоръките от официалната Docker документация.
  • Стандартните команди docker и docker compose са вече достъпни в това приложение.
  • При първо стартиране на виртуалната машина, отнема няколко минути, преди да се стартира Docker контейнер, съдържащ PrestaShop.
  • PRESTASHOP data е настроена да бъде persistent и се намира в /opt/prestashop/data/. MariaDB също е persistent и съхранява базите си данни в /opt/mariadb/data/.
  • Потребителят за достъп до PrestaShop административния панел е admin, а паролата е P@ssw0rd!.

Забележка: По подразбиране, PRESTASHOP_HOST е настроен да бъде първият адрес на виртуалната машина. Целта е да разполагете с достъп веднага след стартиране на машината. За да започнете да използвате PrestaShop с реалния си домейн, първо трябва да насочите въпросния домейн към IP адреса си и да промените настройките за това от къде се отваря PrestaShop през неговия административен панел.

Използване на собствен SSL сертификат

В това приложение, което осигурява целия нужен софтуерен стек, нужен за да задвижи PrestaShop, е включен и уебсървър Apache. Ако желаете да ползвате собствен SSL сертификат, то моля, прочетете как да направите тези настройки в документацията ни за Apache за AlmaLinux 8.

Допълнителни настройки при Docker

Допълнителните настройки за PrestaShop, които можете да променяте и които се контролират директно от Docker са зададени като променливи стойности в конфигурационния файл /opt/docker-prestashop/docker-compose.yml:

Забележка: След промяна на която и да е от стойностите, трябва да пресъздадете Docker контейнерите, върху който работи приложението. За повече информация, моля, прочетете секцията за пресъздаване на Docker контейнери.

PrestaShop конфигурационни опции

Генерални опции

  • АPACHE_HTTP_PORT_NUMBER: HTTP порт, използван от Apache. Default: 8080
  • APACHE_HTTPS_PORT_NUMBER: HTTPS порт, използван от Apache. Default: 8443
  • PRESTASHOP_FIRST_NAME: PrestaShop име на потребителя. Default: Admin
  • PRESTASHOP_LAST_NAME: PrestaShop фамилия на потребителя. Default: User
  • PRESTASHOP_PASSWORD: PrestaShop парола за административен панел. Default: P@ssw0rd!
  • PRESTASHOP_EMAIL: PrestaShop email. Default: user@example.com
  • PRESTASHOP_HOST: PrestaShop хостнейм/адрес.
  • PRESTASHOP_ENABLE_HTTPS: Дали да се ползва HTTPS по подразбиране. Default: no.
  • PRESTASHOP_EXTERNAL_HTTP_PORT_NUMBER: Порт, използван от PrestaShop за достъп отвън използвайки HTTP протокол. Използва се и за вътрешни пътища в PrestaShop. Default 80.
  • PRESTASHOP_EXTERNAL_HTTPS_PORT_NUMBER: Порт, използван от PrestaShop за достъп отвън използвайки HTTPS протокол. Използва се и за вътрешни пътища в PrestaShop. Default 443.
  • PRESTASHOP_COOKIE_CHECK_IP: Дали да се проверява IP адреса в cookie или не. Default: yes.
  • PRESTASHOP_COUNTRY: Държава по подразбиране в магазина. Default: bg.
  • PRESTASHOP_LANGUAGE: Език по подразбиране в магазина (iso код). Default: en.
  • PRESTASHOP_SKIP_BOOTSTRAP: Дали да се пропусне първоначален bootstrapping на PrestaShop. Default: no

Използване на вече съществуваща база данни

  • PRESTASHOP_DATABASE_HOST: Хостнейм на MariaDB сървър. Default: mariadb
  • PRESTASHOP_DATABASE_PORT_NUMBER: Порт, използван от MariaDB сървъра. Default: 3306
  • PRESTASHOP_DATABASE_NAME: Име на базата данни, което PrestaShop ще използва за връзка. Default: bitnami_prestashop
  • PRESTASHOP_DATABASE_USER: Потребител за базата данни, което PrestaShop ще използва за връзка. Default: bn_prestashop
  • PRESTASHOP_DATABASE_PASSWORD: Парола на потребителя за базата данни, което PrestaShop ще използва за връзка. Без defaults.
  • PRESTASHOP_DATABASE_PREFIX: Префикс на таблиците в базата данни. Default: ps_
  • ALLOW_EMPTY_PASSWORD: Използва се за връзка към базата данни с празни пароли. Default: no

SMTP конфигурационни опции

  • PRESTASHOP_SMTP_HOST: SMTP хост.
  • PRESTASHOP_SMTP_PORT: SMTP порт.
  • PRESTASHOP_SMTP_USER: SMTP потребител.
  • PRESTASHOP_SMTP_PASSWORD: SMTP парола.

PHP конфигурационни опции

  • PHP_ENABLE_OPCACHE: Включване на OPcache за PHP. Default: yes
  • PHP_EXPOSE_PHP: Показване на HTTP header в PHP. Без default.
  • PHP_MAX_EXECUTION_TIME: Максимално време за изпълнение на PHP скриптовете. Без default.
  • PHP_MAX_INPUT_TIME: Maximum input време за PHP скриптовете. Без default.
  • PHP_MAX_INPUT_VARS: Максимален брой променливи PHP скриптовете. Без default.
  • PHP_MEMORY_LIMIT: Лимит на паметта за PHP скриптовете. Default: 512M
  • PHP_POST_MAX_SIZE: Максимален размер на PHP POST заявки. Без default.
  • PHP_UPLOAD_MAX_FILESIZE: Максимален обем за качване на файлове за PHP PHP скриптовете. Без default.

SSL сертификати

Използване на собствени (платени) SSL сертификати

Ако вече разполагате с готови, валидни сертификати, трябва да направите няколко модификации върху конфигурацията, преди да можете да ги използвате. За да постигнете това, моля следвайте следните стъпки:

Стъпка 1 - поставяне на сертификатите

Създайте директория, където сертификатите ще се съхраняват:

mkdir /opt/certs/

Копирайте сертификатите в директорията, която създадохте току-що и модифицирайте техните права:

chown 1001:1001 /opt/certs/ -R

Стъпка 2 - модифицирайте Docker конфигурацията

Отворете Docker конфигурационния файл /opt/docker-prestashop/docker-compose.yml с текстов редактор и намерете следния фрагмент:

  prestashop:
    image: docker.io/bitnami/prestashop:8
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - PRESTASHOP_HOST=localhost
      - PRESTASHOP_DATABASE_HOST=mariadb
      - PRESTASHOP_DATABASE_PORT_NUMBER=3306
      - PRESTASHOP_DATABASE_USER=prestashop
      - PRESTASHOP_DATABASE_NAME=prestashop
      - ALLOW_EMPTY_PASSWORD=yes
      - PRESTASHOP_PASSWORD=P@ssw0rd!
      - PRESTASHOP_EMAIL=admin@example.com
      - PRESTASHOP_FIRST_NAME=Admin
      - PRESTASHOP_LAST_NAME=User
    volumes:
      - '/opt/prestashop/data/:/bitnami/prestashop'

Редактирайте го, така че да изглежда по следния начин:

  prestashop:
    image: docker.io/bitnami/prestashop:8
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - PRESTASHOP_HOST=localhost
      - PRESTASHOP_DATABASE_HOST=mariadb
      - PRESTASHOP_DATABASE_PORT_NUMBER=3306
      - PRESTASHOP_DATABASE_USER=prestashop
      - PRESTASHOP_DATABASE_NAME=prestashop
      - ALLOW_EMPTY_PASSWORD=yes
      - PRESTASHOP_PASSWORD=P@ssw0rd!
      - PRESTASHOP_EMAIL=admin@example.com
      - PRESTASHOP_FIRST_NAME=Admin
      - PRESTASHOP_LAST_NAME=User
    volumes:
      - '/opt/prestashop/data/:/bitnami/prestashop'
      - '/opt/certs/cert.pem:/opt/bitnami/apache/conf/bitnami/certs/server.crt'
      - '/opt/certs/privkey.pem:/opt/bitnami/apache/conf/bitnami/certs/server.key'

Обърнете внимание, че /opt/certs/cert.pem е пътят до сертификата, а /opt/certs/privkey.pem е пътят до частния ключ. Можете да именувате файловете и директориите както пожелаете, но трябва да са посочени правилно в конфигурацията

Стъпка 3 - рестартирайте Docker контейнерите

cd /opt/docker-prestashop/
docker compose up -d

Издаване на сертификати с Let's Encrypt

Ако желаете, винаги можете да издадете и безплатни сертификати от Let's Encrypt. За целта, моля следвайте следните стъпки:

Стъпка 1 - инсталиране на нужните пакети

Влезте в сървъра си, като добиете root права и изпълнете следните команди:

dnf install -y epel-release
dnf install -y certbot

Стъпка 2 - издаване на сертификата

Моля имайте предвид, че за да бъде издаден безплатен сертификат, то е нужно да можете да верифицирате по някакъв начин собствеността на домейна си. Let's Encrypt предоставя няколко възможности за верификация на домейните ви, в този пример ще използваме верификация чрез стартиране на временен уеб сървър.

За целта, спрете временно контейнера с командата docker stop docker-prestashop-prestashop-1. Важно: Изпълнявайки тази стъпка, сайтът ви ще спре да работи временно. Уверете се, че искате да изпълните това действие във време, когато най-малко ще афектира потребителите ви.

Издайте сертификата с командата certbot certonly --standalone --preferred-challenges http -d example.com, като замените "example.com" с домейна, който сте насочили към IP адреса на Cloud сървъра си.

Стъпка 3 - поставете новите сертификати в конфигурацията

Отворете Docker конфигурационния файл /opt/docker-prestashop/docker-compose.yml с текстов редактор и намерете следния фрагмент:

  prestashop:
    image: docker.io/bitnami/prestashop:8
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - PRESTASHOP_HOST=localhost
      - PRESTASHOP_DATABASE_HOST=mariadb
      - PRESTASHOP_DATABASE_PORT_NUMBER=3306
      - PRESTASHOP_DATABASE_USER=prestashop
      - PRESTASHOP_DATABASE_NAME=prestashop
      - ALLOW_EMPTY_PASSWORD=yes
      - PRESTASHOP_PASSWORD=P@ssw0rd!
      - PRESTASHOP_EMAIL=admin@example.com
      - PRESTASHOP_FIRST_NAME=Admin
      - PRESTASHOP_LAST_NAME=User
    volumes:
      - '/opt/prestashop/data/:/bitnami/prestashop'

Редактирайте го, така че да изглежда по следния начин:

  prestashop:
    image: docker.io/bitnami/prestashop:8
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - PRESTASHOP_HOST=localhost
      - PRESTASHOP_DATABASE_HOST=mariadb
      - PRESTASHOP_DATABASE_PORT_NUMBER=3306
      - PRESTASHOP_DATABASE_USER=prestashop
      - PRESTASHOP_DATABASE_NAME=prestashop
      - ALLOW_EMPTY_PASSWORD=yes
      - PRESTASHOP_PASSWORD=P@ssw0rd!
      - PRESTASHOP_EMAIL=admin@example.com
      - PRESTASHOP_FIRST_NAME=Admin
      - PRESTASHOP_LAST_NAME=User
    volumes:
      - '/opt/prestashop/data/:/bitnami/prestashop'
      - '/etc/letsencrypt/live/example.com/cert.pem:/opt/bitnami/apache/conf/bitnami/certs/server.crt'
      - '/etc/letsencrypt/live/example.com/privkey.pem:/opt/bitnami/apache/conf/bitnami/certs/server.key'

С тази модификация оказвате, че "свързвате" външните сертификати, издадени от Let's Encrypt с конфигурацията, която се намира вътре в docker контейнера. Заменете "example.com" с името на домейна си. След като подмените конфигурацията, е нужно да поправите правата на сертификатите с командата chown 1001:1001 /etc/letsencrypt/archive/example.com/ -R, като отново замените "example.com" с името на домейна си.

Стъпка 4 - стартиране на услугите

Тъй като Docker контейнерът е временно спрян, то трябва да се приложи новата конфигурация и да го стартираме. Моля изпълнете следните команди:

cd /opt/docker-prestashop/
docker compose up -d

Стъпка 5 (опционално) - автоматично подновяване на сертификата

Автоматичното подновяване може да бъде организирано чрез cron. Можете да зададете следната cron конфигурация, за да се случи автоматичното подновяване:

# Автоматично подновяване на Let's Encrypt
0 0 * * * /usr/bin/certbot renew --pre-hook 'docker stop docker-prestashop-prestashop-1' --post-hook 'chown 1001:1001 /etc/letsencrypt/archive/example.com/ -R; docker start docker-prestashop-prestashop-1'

Разбира се, можете да промените времето на изпълнение, когато пожелаете. В горния пример, тази задача ще се изпълнява всеки ден в 00:00 часа.

Работа с Docker

Организацията на това приложение е осъществена изцяло посредством Docker. По този начин можем да Ви предоставим готови приложения по-бързо. Освен това, конфигурацията им е по-гъвкава и е доста контролируема. За да можете да го контролирате това приложение обаче, е нужно да знаете някои базови Docker функционалности и особености.

Рестартиране на всички услуги

Рестартирането на базата данни и Docker контейнера, който съдържа самия PrestaShop, заедно с останалия софтуер, може да бъде извършено по два начина:

  1. Чрез рестартиране на цялата виртуална машина
  2. Рестартиране на Docker контейнерите, което е по-бързият вариант. За целта, достъпете машината си чрез SSH, и изпълнете следните команди:
sudo su -
cd /opt/docker-prestashop
docker compose restart

Пресъздаване на Docker контейнери

Пресъздаването може да се наложи, в случай че сме променяли конфигурацията в docker-compose.yml. При тази ситуация, трябва да следвате следните стъпки:

cd /opt/docker-prestashop
docker compose stop
docker compose up -d

Проверка на статуса на Docker приложението

За да направите проверка, трябва да изпълните следните команди:

sudo su -
docker ps -a

Моля, обърнете внимание на колоната STATUS. Тя трябва да показва от колко време работи услугата, например Up X minutes. Ако статуса е Restarting, то трябва да се провери какво не е наред с приложението. В такъв случай, можете да направите проверка, като проследите логовете на приложението по следния начин:

  1. Вземете името на приложението, което можете да видите в колоната NAMES от изхода на командата docker ps -a. Вижте логовете с командата docker logs <NAME>, където е името на контейнера.

Промяна на настройки

Описаните настройки в секцията Допълнителни настройки при Docker могат да бъдат нагласяни в docker-compose.yml файла. Пътят до него е описан отново в тази секция. За да промените настройка, отворете конфигурационния файл и обърнете внимание на секцията environment, намираща се под prestashop. Всяка една конфигурационна опция трябва да бъде описана на нов ред с тире отпред по следния примерен начин:

    environment:
      - PRESTASHOP_FIRST_NAME=admin
      - PRESTASHOP_PASSWORD=P@ssw0rd!

Моля, обърнете внимание, че трябва да се спазва и правилната индентация (брой празни места), тъй като това е важно за конфигурационни файлове от тип yaml.