OpenCart (AlmaLinux 8)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• АPACHE_HTTP_PORT_NUMBER: HTTP порт, използван от Apache. Default: 8080
• APACHE_HTTPS_PORT_NUMBER: HTTPS порт, използван от Apache. Default: 8443
• OPENCART_USERNAME: OpenCart потребител за достъп. Default: admin
• OPENCART_PASSWORD: OpenCart парола за потребителя. Default: P@ssw0rd!
• OPENCART_EMAIL: OpenCart email. Default: admin@example.com
• OPENCART_HOST: OpenCart хостнейм/адрес.
• OPENCART_ENABLE_HTTPS: Дали да се използва HTTPS по подразбиране. Default: no.
• OPENCART_EXTERNAL_HTTP_PORT_NUMBER: Порт, използван от OpenCart за достъп отвън използвайки HTTP протокол. Използва се и за вътрешни пътища в OpenCart. Default 80.
• OPENCART_EXTERNAL_HTTPS_PORT_NUMBER: Порт, използван от OpenCart за достъп отвън използвайки HTTPS протокол. Използва се и за вътрешни пътища в OpenCart. Default 443.
• OPENCART_SKIP_BOOTSTRAP: Дали да се пропусне първоначален bootstrapping на OpenCart. Default: no

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

• OPENCART_DATABASE_HOST: Хостнейм на MariaDB сървър. Default: mariadb
• OPENCART_DATABASE_PORT_NUMBER: Порт, използван от MariaDB сървъра. Default: 3306
• OPENCART_DATABASE_NAME: Име на базата данни, което OpenCart ще използва за връзка. Default: bitnami_opencart
• OPENCART_DATABASE_USER: Потребител за базата данни, което OpenCart ще използва за връзка. Default: bn_opencart
• OPENCART_DATABASE_PASSWORD: Парола на потребителя за базата данни, което OpenCart ще използва за връзка. No defaults.
• ALLOW_EMPTY_PASSWORD: Използва се за връзка към базата данни с празни пароли. Default: no

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

• OPENCART_SMTP_HOST: SMTP хост.
• OPENCART_SMTP_PORT: SMTP порт.
• OPENCART_SMTP_USER: SMTP потребител.
• OPENCART_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-opencart/docker-compose.yml с текстов редактор и намерете следния фрагмент:

  opencart:
    image: docker.io/bitnami/opencart:4
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - OPENCART_HOST=localhost
      - OPENCART_DATABASE_HOST=mariadb
      - OPENCART_DATABASE_PORT_NUMBER=3306
      - OPENCART_DATABASE_USER=opencart
      - OPENCART_DATABASE_NAME=opencart
      - ALLOW_EMPTY_PASSWORD=yes
      - OPENCART_USERNAME=admin
      - OPENCART_PASSWORD=P@ssw0rd!
      - OPENCART_EMAIL=admin@example.com
    volumes:
      - '/opt/opencart/opencart:/bitnami/opencart'
      - '/opt/opencart/opencart_storage_data:/bitnami/opencart_storage/'

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

  opencart:
    image: docker.io/bitnami/opencart:4
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - OPENCART_HOST=localhost
      - OPENCART_DATABASE_HOST=mariadb
      - OPENCART_DATABASE_PORT_NUMBER=3306
      - OPENCART_DATABASE_USER=opencart
      - OPENCART_DATABASE_NAME=opencart
      - ALLOW_EMPTY_PASSWORD=yes
      - OPENCART_USERNAME=admin
      - OPENCART_PASSWORD=P@ssw0rd!
      - OPENCART_EMAIL=admin@example.com
    volumes:
      - '/opt/opencart/opencart:/bitnami/opencart'
      - '/opt/opencart/opencart_storage_data:/bitnami/opencart_storage/'
      - '/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-opencart/
docker compose up -d

Издаване на сертификати с Letsencrypt

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

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

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

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

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

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

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

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

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

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

  opencart:
    image: docker.io/bitnami/opencart:4
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - OPENCART_HOST=localhost
      - OPENCART_DATABASE_HOST=mariadb
      - OPENCART_DATABASE_PORT_NUMBER=3306
      - OPENCART_DATABASE_USER=opencart
      - OPENCART_DATABASE_NAME=opencart
      - ALLOW_EMPTY_PASSWORD=yes
      - OPENCART_USERNAME=admin
      - OPENCART_PASSWORD=P@ssw0rd!
      - OPENCART_EMAIL=admin@example.com
    volumes:
      - '/opt/opencart/opencart:/bitnami/opencart'
      - '/opt/opencart/opencart_storage_data:/bitnami/opencart_storage/'

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

  opencart:
    image: docker.io/bitnami/opencart:4
    ports:
      - '80:8080'
      - '443:8443'
    environment:
      - OPENCART_HOST=localhost
      - OPENCART_DATABASE_HOST=mariadb
      - OPENCART_DATABASE_PORT_NUMBER=3306
      - OPENCART_DATABASE_USER=opencart
      - OPENCART_DATABASE_NAME=opencart
      - ALLOW_EMPTY_PASSWORD=yes
      - OPENCART_USERNAME=admin
      - OPENCART_PASSWORD=P@ssw0rd!
      - OPENCART_EMAIL=admin@example.com
    volumes:
      - '/opt/opencart/opencart:/bitnami/opencart'
      - '/opt/opencart/opencart_storage_data:/bitnami/opencart_storage/'
      - '/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'

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

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

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

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

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

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

# Automated Letsencrypt renewal
0 0 * * * /usr/bin/certbot renew --pre-hook 'docker stop docker-opencart-opencart-1' --post-hook 'chown 1001:1001 /etc/letsencrypt/archive/example.com/ -R; docker start docker-opencart-opencart-1'

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

Работа с Docker

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

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

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

1. Чрез рестартиране на цялата виртуална машина
2. Рестартиране на Docker контейнерите, което е по-бързия вариант. За целта, достъпете машината си чрез SSH, и изпълнете следните команди:

sudo su -
cd /opt/docker-opencart
docker compose restart

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

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

cd /opt/docker-opencart
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, намираща се под opencart. Всяка една конфигурационна опция трябва да бъде описана на нов ред с тире отпред по следния примерен начин:

    environment:
      - OPENCART_USERNAME=admin
      - OPENCART_PASSWORD=P@ssw0rd!

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