Инсталација пакета

Zammad се може покренути преко Docker Compose. Можете чак користити и графички интерфејс за Docker као што је Portainer.

INFO

Не пружамо техничку подршку у вези проблема са Docker (Compose) или Portainer инсталацијама. Уколико одлучите да користите Zammad путем Docker-а, подршка је могућа само за Zammad апликацију.

Предуслови

• Уверите се да ваше Docker Compose окружење испуњава захтеве које можете пронаћи у README фајлу Zammad-овог Docker Compose репозиторијума.

• Обезбедите најмање 4 GB RAM за контејнере.

• Подесите ваш сервер да правилно извршава Elasticsearch сервис:

  sudo sysctl -w vm.max_map_count=262144

Покретање преко Docker Compose

Корак 1: Клонирање GitHub репозиторија

git clone https://github.com/zammad/zammad-docker-compose.git

Обавезно често извршавајте git pull команду за ажурирање. Алтернативно, можете преузети датотеке са странице издања.

Корак 2: Подешавање окружења по потреби

Ако ваше подразумевано окружење није оно које тражите, можете прилагодити стацк користећи унапред дефинисане сценарије и подесити променљиве окружења. Погледајте секцију за прилагођавање испод за више информација.

Корак 3: Покретање stack-а

cd zammad-docker-compose

docker compose up -d

Опционално: Користите додатни .yml фајл за коришћење унапред дефинисаног сценарија. Прочитајте више у секцији Прилагођавање Zammad стацк-а.

Након што је stack спреман, можете приступити Zammad-у преко подешеног Docker хоста и порта, нпр. http://localhost:8080/.

Покретање преко Portainer-а

Најлакши начин да покренете Zammad је преко графичког Docker интерфејса. Препоручујемо Portainer. За упутство инсталације, погледајте званичну Portainer документацију.

Корак 1: Додавање stack-а

У графичком интерфејсу Portainer-а (нпр. https://yourdomain.tld:9443), идите на циљно окружење, одаберите Stacks и кликните на Add stack као на снимку екрана испод.

Корак 2: Инсталација из репозиторија

Пребаците се на метод изградње Репозиторијум и унесите информације испод:

• Име: унесите жељено име стацк-а
• URL адреса репозиторија: https://github.com/zammad/zammad-docker-compose
• Референца repo-зиторијума: refs/heads/master
• Путања Compose-а: docker-compose.yml (подразумевано)

Ако ваше подразумевано окружење није оно које тражите, можете прилагодити стацк користећи унапред дефинисане сценарије и подесити променљиве окружења. Погледајте секцију за прилагођавање испод за више информација.

Корак 3: Покретање stack-а

На крају, кликните на дугме Deploy the stack. Први пут може потрајати неко време док се Docker имиџи не преузму.

Након што је stack спреман, можете приступити Zammad-у преко подешеног Docker хоста и порта, нпр. http://localhost:8080/.

Излагање стацк-а преко HTTPS-а

Да бисте објавили Zammad стацк на интернету, мора бити заштићен путем HTTPS протокола. Да бисте то постигли без измене Zammad стацк-а, можете:

• Користите реверзни прокси као што је Nginx Proxy Manager (NPM). Он има GUI који омогућава једноставну интеграцију са Let'с Encrypt.
• Користите Cloudflare тунел, који пружа SSL терминацију.

Оба сценарија су објашњена на одвојеној страници Docker Compose Scenarios.

Single sign-on with Kerberos uses the same reverse proxy, see Single sign-on with Kerberos.

Прилагођавање Zammad stack-а

Zammad Docker Compose stack је спреман за покретање са подразумеваним подешавањима. Можете га прилагодити свом окружењу учитавањем унапред дефинисаних фајлова сценарија, подешавањем променљивих окружења и додавањем фајлова специфичних за вашу инстанцу.

Погледајте страницу о Docker Compose сценаријима за подржане случајеве употребе и детаљна упутства за учитавање фајлова сценарија. За промену појединачних подешавања користите Docker специфичне променљиве окружења.

Ако сте stack покренули помоћу Docker Compose-а клонирањем репозиторијума, користите његов директоријум local/ за фајлове који припадају само вашој инстанци. За детаље погледајте одељак локално прилагођавање stack-а.

Извршавање команди у stack-у

Покрените команде у вашем Docker стацк-у тако што ћете позвати rails или rake путем једне од следећих метода користећи bundle exec.

Директно извршите одређену команду:

docker compose run --rm zammad-railsserver bundle exec rails r '...your rails command here...'

Покрените интерактивну Rails конзолу да бисте ручно унели Rails команде:

docker compose run --rm zammad-railsserver bundle exec rails c

Преко docker compose exec:

docker compose exec zammad-railsserver bundle exec rails r '...your rails command here...'

TIP

Уколико желите да добијете информације од вашег rails сервера, можете, нпр. да укључите pp (pretty print) испред ваших rails команди. Ово ће довести до излаза на вашем терминалу.