Compare commits
22 Commits
release-dr
...
master
Author | SHA1 | Date | |
---|---|---|---|
|
799edd7863 | ||
|
6606e8e2ca | ||
|
662aa8f512 | ||
|
ffa1268a2a | ||
|
3338cbeb22 | ||
|
9a547c67a9 | ||
|
1c52589095 | ||
|
281b5f317f | ||
|
ef8830e636 | ||
|
a8911b1359 | ||
|
1f32908c23 | ||
|
360324353f | ||
|
e5b0fedfe6 | ||
|
d588f2ff65 | ||
|
01fe85d74c | ||
|
abd9cd631d | ||
|
d397322bae | ||
|
ae716aed3d | ||
|
ad516bdfd6 | ||
|
87e8b49794 | ||
|
a0aa5324dc | ||
|
731f83da2b |
12
.env
12
.env
@ -1,8 +1,14 @@
|
||||
IMAGE_REPO=zammad/zammad-docker-compose
|
||||
ELASTICSEARCH_VERSION=8.8.0
|
||||
IMAGE_REPO=ghcr.io/zammad/zammad
|
||||
MEMCACHE_SERVERS=zammad-memcached:11211
|
||||
MEMCACHE_VERSION=1.6.20-alpine
|
||||
POSTGRES_DB=zammad_production
|
||||
POSTGRES_PASS=zammad
|
||||
POSTGRES_USER=zammad
|
||||
POSTGRES_HOST=zammad-postgresql
|
||||
POSTGRES_PORT=5432
|
||||
POSTGRES_VERSION=15.3-alpine
|
||||
REDIS_URL=redis://zammad-redis:6379
|
||||
REDIS_VERSION=7.0.5-alpine
|
||||
RESTART=always
|
||||
# don't forget to add the minus before the version
|
||||
VERSION=-5.2.3-32
|
||||
VERSION=6.0.0-66
|
||||
|
6
.github/release-drafter.yml
vendored
6
.github/release-drafter.yml
vendored
@ -1,5 +1,5 @@
|
||||
name-template: "$RESOLVED_VERSION"
|
||||
tag-template: "$RESOLVED_VERSION"
|
||||
name-template: "v$RESOLVED_VERSION"
|
||||
tag-template: "v$RESOLVED_VERSION"
|
||||
categories:
|
||||
- title: "🚀 Features"
|
||||
labels:
|
||||
@ -33,3 +33,5 @@ template: |
|
||||
## Changes
|
||||
|
||||
$CHANGES
|
||||
|
||||
**Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION
|
||||
|
16
.github/tests.sh
vendored
16
.github/tests.sh
vendored
@ -23,16 +23,28 @@ echo
|
||||
echo "Execute autowizard..."
|
||||
echo
|
||||
|
||||
docker exec zammad-docker-compose_zammad-railsserver_1 rake zammad:setup:auto_wizard
|
||||
docker exec --env=AUTOWIZARD_RELATIVE_PATH=var/auto_wizard.json --env=DATABASE_URL=postgres://zammad:zammad@zammad-postgresql:5432/zammad_production zammad-docker-compose_zammad-railsserver_1 rake zammad:setup:auto_wizard
|
||||
|
||||
echo
|
||||
echo "Autowizard executed successful :)"
|
||||
echo
|
||||
|
||||
|
||||
echo
|
||||
echo "Check DB for AutoWizard user"
|
||||
echo
|
||||
|
||||
docker exec --env=DATABASE_URL=postgres://zammad:zammad@zammad-postgresql:5432/zammad_production zammad-docker-compose_zammad-railsserver_1 rails r "p User.find_by(email: 'info@zammad.org')" | grep 'info@zammad.org'
|
||||
|
||||
echo
|
||||
echo "Check DB for AutoWizard user successfull :)"
|
||||
echo
|
||||
|
||||
echo
|
||||
echo "Fill DB with some random data"
|
||||
docker exec zammad-docker-compose_zammad-railsserver_1 rails r "FillDb.load(agents: 1,customers: 1,groups: 1,organizations: 1,overviews: 1,tickets: 1)"
|
||||
echo
|
||||
|
||||
docker exec --env=DATABASE_URL=postgres://zammad:zammad@zammad-postgresql:5432/zammad_production zammad-docker-compose_zammad-railsserver_1 rails r "FillDb.load(agents: 1,customers: 1,groups: 1,organizations: 1,overviews: 1,tickets: 1)"
|
||||
|
||||
echo
|
||||
echo "DB fill successful :)"
|
||||
|
2
.github/workflows/ci-remote-image.yaml
vendored
2
.github/workflows/ci-remote-image.yaml
vendored
@ -19,7 +19,7 @@ jobs:
|
||||
run: docker-compose up --detach
|
||||
|
||||
- name: add autowizard file
|
||||
run: docker cp .github/auto_wizard.json zammad-docker-compose_zammad-railsserver_1:/opt/zammad
|
||||
run: docker cp .github/auto_wizard.json zammad-docker-compose_zammad-railsserver_1:/opt/zammad/var
|
||||
|
||||
- name: run tests
|
||||
run: .github/tests.sh
|
||||
|
2
.github/workflows/ci.yaml
vendored
2
.github/workflows/ci.yaml
vendored
@ -23,7 +23,7 @@ jobs:
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Lint Code Base
|
||||
uses: github/super-linter/slim@v4
|
||||
uses: github/super-linter/slim@v5
|
||||
env:
|
||||
DEFAULT_BRANCH: master
|
||||
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||
|
98
README.md
98
README.md
@ -6,17 +6,24 @@ twitter, chat and emails. It is distributed under the GNU AFFERO General Public
|
||||
License (AGPL). Do you receive many emails and want to answer them with a team of agents?
|
||||
You're going to love Zammad!
|
||||
|
||||
## Use case for this repository
|
||||
## Use cases
|
||||
|
||||
This repository is meant to be the starting point for somebody who likes to use dockerized multi-container Zammad in production.
|
||||
This repository is the starting point if you want to:
|
||||
|
||||
## Getting started with zammad-docker-compose
|
||||
- deploy Zammad in a containerized production environment
|
||||
- test the current `stable` or `develop` versions of Zammad
|
||||
|
||||
[Learn more on Zammads documentation](https://docs.zammad.org/en/latest/install/docker-compose.html)
|
||||
## Getting started
|
||||
|
||||
[Learn more on Zammad’s documentation](https://docs.zammad.org/en/latest/install/docker-compose.html)
|
||||
|
||||
## Upgrading
|
||||
|
||||
For upgrading instructions see our [Releases](https://github.com/zammad/zammad-docker-compose/releases).
|
||||
|
||||
## Status
|
||||
|
||||
[![CI Status](https://github.com/zammad/zammad-docker-compose/workflows/ci/badge.svg)](https://github.com/zammad/zammad-docker-compose/actions) [![Docker Pulls](https://badgen.net/docker/pulls/zammad/zammad-docker-compose?icon=docker&label=pulls)](https://hub.docker.com/r/zammad/zammad-docker-compose/)
|
||||
[![ci-remote-image](https://github.com/zammad/zammad-docker-compose/actions/workflows/ci-remote-image.yaml/badge.svg)](https://github.com/zammad/zammad-docker-compose/actions/workflows/ci-remote-image.yaml) [![Dockerhub Pulls](https://badgen.net/docker/pulls/zammad/zammad-docker-compose?icon=docker&label=pulls)](https://hub.docker.com/r/zammad/zammad-docker-compose/)
|
||||
|
||||
## Using a reverse proxy
|
||||
|
||||
@ -42,83 +49,4 @@ RANCHER_URL=http://RANCHER_HOST:8080 rancher-compose --env-file=.env up
|
||||
|
||||
Elasticsearch is an optional, but strongly recommended dependency for Zammad. More details can be found in the [documentation](https://docs.zammad.org/en/latest/prerequisites/software.html#elasticsearch-optional). There are however certain scenarios when running without Elasticsearch may be desired, e.g. for very small teams, for teams with limited budget or as a temporary solution for an unplanned Elasticsearch downtime or planned cluster upgrade.
|
||||
|
||||
Elasticsearch is enabled by default in the example `docker-compose.yml` file. It is also by default required to run the "zammad-init" command. Disabling Elasticsearch is possible by setting a special environment variable: `ELASTICSEARCH_ENABLED=false` for the `zammad-init` container and removing all references to Elasticsearch everywhere else: the `zammad-elasticsearch` container, it's volume and links to it.
|
||||
|
||||
## Upgrading
|
||||
|
||||
### From =< to 5.0.0 to 5.2.3-32
|
||||
|
||||
* Elasticsearch was updated from 7.17.3 to 8.5.0 using the Bitnami image
|
||||
* We don't use a custom build of the docker image anymore as ingest-attachment is no longer a plugin but instead a module packaged with this distribution of Elasticsearch
|
||||
* ELASTICSEARCH_REINDEX var should be set to true
|
||||
|
||||
* PostgreSql was updated from 9.6.24 to 15.0.0
|
||||
* We don't use a custom build of the docker image anymore as we just mount the backup script to the postgres container now
|
||||
* backup / restore ins needed to update
|
||||
* you can create a new backup (with your old postgres 9.6 version / still in previous git version) by:
|
||||
* if you already have checked out the newest commit
|
||||
* `git checkout cd424e98689b8dc49878a37b9aab67192c36fd24`
|
||||
* docker-compose stop
|
||||
* docker-compose up
|
||||
* check docker logs until "backup finished :)" is shown as last(!) entry
|
||||
* `docker logs -f zammad-docker-compose_zammad-backup_1`
|
||||
* `docker-compose stop`
|
||||
* you can restore the backup in postgres 15 like
|
||||
* update git epository
|
||||
* `git checkout master`
|
||||
* `git pull`
|
||||
* stop docker-compose if it's running
|
||||
* `docker-compose stop`
|
||||
* delete old zammad postgre container and volume (data is lost! get sure your backups are in place!)
|
||||
* `docker container rm zammad-docker-compose_zammad-postgresql_1`
|
||||
* `docker volume rm zammad-docker-compose_postgresql-data`
|
||||
* recreate zammads postgres volume
|
||||
* `docker volume create zammad-docker-compose_postgresql-data`
|
||||
* start a temporary restore container (adjust username & password vars if needed)
|
||||
* `docker run -it --rm --name postgres-restore -v zammad-docker-compose_zammad-backup:/var/tmp/zammad:ro -v zammad-docker-compose_postgresql-data:/var/lib/postgresql/data -e POSTGRES_USER=zammad -e POSTGRES_PASSWORD=zammad postgres:15.0-alpine`
|
||||
* in a second bash shell run:
|
||||
* show available backups
|
||||
* `docker exec -it postgres-restore bash -c "ls -al /var/tmp/zammad/"`
|
||||
* create zammad_production db
|
||||
* `docker exec -it postgres-restore bash -c "psql -U zammad --command='CREATE DATABASE zammad_production'"`
|
||||
* restore old data with adjusted filename you got from the ls command above
|
||||
* `docker exec -it postgres-restore bash -c "gunzip -kc /var/tmp/zammad/!!!ENTER_PSQL_FILE_NAME_FROM_COMMAND_ABOVE!!!_zammad_db.psql.gz | psql -U zammad" -d zammad_production`
|
||||
* stop the restore container
|
||||
* `docker stop postgres-restore`
|
||||
* in your first bash shell
|
||||
* `docker-compose up`
|
||||
|
||||
### From =< 4.0.0 to 5.0.0
|
||||
|
||||
Memchached config changed. If you use the old env vars `MEMCACHED_HOST` & `MEMCACHED_PORT` adapt to `MEMCACHE_SERVERS`.
|
||||
Redis is a dependency for the Websocket server now.
|
||||
|
||||
### From =< 3.6.0-65
|
||||
|
||||
To be able to run Zammad container with an unprivileged user we had to change the port Nginx uses from 80 to 8080, so Zammad needs to be accessed via <http://localhost:8080> instead of <http://localhost> now!
|
||||
|
||||
This change will also affect you, if you use a reverse proxy, like Traefik or Haproxy, in front of Zammad as your reverse proxy configuration needs to be adapted to point to port 8080 now.
|
||||
|
||||
### From =< 3.3.0-12
|
||||
|
||||
We've updated the Elasticsearch image from 5.6 to 7.6.
|
||||
As there is no direct upgrade path we have to delete all Elasticsearch indices and rebuild them.
|
||||
This will depend on the name of your docker container and volume, which depends on the checkout directory (`zammad-docker-compose` by default):
|
||||
|
||||
```console
|
||||
docker-compose stop
|
||||
docker container rm zammad-docker-compose_zammad-elasticsearch_1
|
||||
docker volume rm zammad-docker-compose_elasticsearch-data
|
||||
docker-compose up --no-recreate
|
||||
```
|
||||
|
||||
To workaround the [changes in the PostgreSQL 9.6 container](https://github.com/docker-library/postgres/commit/f1bc8782e7e57cc403d0b32c0e24599535859f76) do the following:
|
||||
|
||||
```console
|
||||
docker-compose start
|
||||
docker exec -it zammaddockercompose_zammad-postgresql_1 bash
|
||||
psql --username postgres --dbname zammad_production
|
||||
CREATE USER zammad;
|
||||
ALTER USER zammad WITH PASSWORD 'zammad';
|
||||
ALTER USER zammad WITH SUPERUSER CREATEDB;
|
||||
```
|
||||
Elasticsearch is enabled by default in the example `docker-compose.yml` file. It is also by default required to run the "zammad-init" command. Disabling Elasticsearch is possible by setting a special environment variable: `ELASTICSEARCH_ENABLED=false` for the `zammad-init` container and removing all references to Elasticsearch everywhere else: the `zammad-elasticsearch` container, its volume and links to it.
|
||||
|
@ -1,5 +1,5 @@
|
||||
---
|
||||
version: '3'
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
|
||||
@ -10,19 +10,21 @@ services:
|
||||
- zammad-postgresql
|
||||
entrypoint: /usr/local/bin/backup.sh
|
||||
environment:
|
||||
- BACKUP_SLEEP=86400
|
||||
- BACKUP_TIME=03:00
|
||||
- HOLD_DAYS=10
|
||||
- POSTGRESQL_DB=${POSTGRES_DB}
|
||||
- POSTGRESQL_USER=${POSTGRES_USER}
|
||||
- POSTGRESQL_PASSWORD=${POSTGRES_PASS}
|
||||
image: postgres:15.0-alpine
|
||||
- TZ=Europe/Berlin
|
||||
image: postgres:${POSTGRES_VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- zammad-backup:/var/tmp/zammad
|
||||
- zammad-data:/opt/zammad:ro
|
||||
- zammad-var:/opt/zammad/var:ro
|
||||
- ./scripts/backup.sh:/usr/local/bin/backup.sh:ro
|
||||
|
||||
zammad-elasticsearch:
|
||||
image: bitnami/elasticsearch:8.5.0
|
||||
image: bitnami/elasticsearch:${ELASTICSEARCH_VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- elasticsearch-data:/bitnami/elasticsearch/data
|
||||
@ -33,17 +35,17 @@ services:
|
||||
- zammad-postgresql
|
||||
environment:
|
||||
- MEMCACHE_SERVERS=${MEMCACHE_SERVERS}
|
||||
- POSTGRESQL_USER=${POSTGRES_USER}
|
||||
- POSTGRESQL_PASS=${POSTGRES_PASS}
|
||||
- REDIS_URL=${REDIS_URL}
|
||||
image: ${IMAGE_REPO}:zammad${VERSION}
|
||||
image: ${IMAGE_REPO}:${VERSION}
|
||||
restart: on-failure
|
||||
user: 0:0
|
||||
volumes:
|
||||
- zammad-data:/opt/zammad
|
||||
- zammad-config-nginx:/etc/nginx/sites-enabled
|
||||
- zammad-var:/opt/zammad/var
|
||||
|
||||
zammad-memcached:
|
||||
command: memcached -m 256M
|
||||
image: memcached:1.6.17-alpine
|
||||
image: memcached:${MEMCACHE_VERSION}
|
||||
restart: ${RESTART}
|
||||
|
||||
zammad-nginx:
|
||||
@ -52,16 +54,18 @@ services:
|
||||
- "8080"
|
||||
depends_on:
|
||||
- zammad-railsserver
|
||||
image: ${IMAGE_REPO}:zammad${VERSION}
|
||||
image: ${IMAGE_REPO}:${VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- zammad-data:/opt/zammad
|
||||
- zammad-config-nginx:/etc/nginx/sites-enabled:ro
|
||||
- zammad-var:/opt/zammad/var:ro
|
||||
|
||||
zammad-postgresql:
|
||||
environment:
|
||||
- POSTGRES_DB=${POSTGRES_DB}
|
||||
- POSTGRES_USER=${POSTGRES_USER}
|
||||
- POSTGRES_PASSWORD=${POSTGRES_PASS}
|
||||
image: postgres:15.0-alpine
|
||||
image: postgres:${POSTGRES_VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- postgresql-data:/var/lib/postgresql/data
|
||||
@ -75,14 +79,16 @@ services:
|
||||
environment:
|
||||
- MEMCACHE_SERVERS=${MEMCACHE_SERVERS}
|
||||
- REDIS_URL=${REDIS_URL}
|
||||
image: ${IMAGE_REPO}:zammad${VERSION}
|
||||
image: ${IMAGE_REPO}:${VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- zammad-data:/opt/zammad
|
||||
- zammad-var:/opt/zammad/var
|
||||
|
||||
zammad-redis:
|
||||
image: redis:6.2.5-alpine
|
||||
image: redis:${REDIS_VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- redis-data:/data
|
||||
|
||||
zammad-scheduler:
|
||||
command: ["zammad-scheduler"]
|
||||
@ -93,10 +99,10 @@ services:
|
||||
environment:
|
||||
- MEMCACHE_SERVERS=${MEMCACHE_SERVERS}
|
||||
- REDIS_URL=${REDIS_URL}
|
||||
image: ${IMAGE_REPO}:zammad${VERSION}
|
||||
image: ${IMAGE_REPO}:${VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- zammad-data:/opt/zammad
|
||||
- zammad-var:/opt/zammad/var
|
||||
|
||||
zammad-websocket:
|
||||
command: ["zammad-websocket"]
|
||||
@ -107,17 +113,21 @@ services:
|
||||
environment:
|
||||
- MEMCACHE_SERVERS=${MEMCACHE_SERVERS}
|
||||
- REDIS_URL=${REDIS_URL}
|
||||
image: ${IMAGE_REPO}:zammad${VERSION}
|
||||
image: ${IMAGE_REPO}:${VERSION}
|
||||
restart: ${RESTART}
|
||||
volumes:
|
||||
- zammad-data:/opt/zammad
|
||||
- zammad-var:/opt/zammad/var
|
||||
|
||||
volumes:
|
||||
elasticsearch-data:
|
||||
driver: local
|
||||
postgresql-data:
|
||||
driver: local
|
||||
redis-data:
|
||||
driver: local
|
||||
zammad-backup:
|
||||
driver: local
|
||||
zammad-data:
|
||||
zammad-config-nginx:
|
||||
driver: local
|
||||
zammad-var:
|
||||
driver: local
|
||||
|
@ -2,7 +2,7 @@
|
||||
|
||||
set -e
|
||||
|
||||
: "${ZAMMAD_DIR:=/opt/zammad}"
|
||||
: "${ZAMMAD_DIR:=/opt/zammad/var}"
|
||||
: "${BACKUP_DIR:=/var/tmp/zammad}"
|
||||
: "${ZAMMAD_RAILSSERVER_HOST:=zammad-railsserver}"
|
||||
: "${ZAMMAD_RAILSSERVER_PORT:=3000}"
|
||||
@ -11,7 +11,7 @@ set -e
|
||||
: "${POSTGRESQL_DB:=zammad_production}"
|
||||
|
||||
function check_railsserver_available {
|
||||
until (echo > /dev/tcp/${ZAMMAD_RAILSSERVER_HOST}/${ZAMMAD_RAILSSERVER_PORT}) &> /dev/null; do
|
||||
until (echo > "/dev/tcp/$ZAMMAD_RAILSSERVER_HOST/$ZAMMAD_RAILSSERVER_PORT") &> /dev/null; do
|
||||
echo "waiting for railsserver to be ready..."
|
||||
sleep 60
|
||||
done
|
||||
@ -43,10 +43,15 @@ if [ "$1" = 'zammad-backup' ]; then
|
||||
check_railsserver_available
|
||||
|
||||
while true; do
|
||||
NOW_TIMESTAMP=$(date +%s)
|
||||
TOMORROW_DATE=$(date -d@"$((NOW_TIMESTAMP + 24*60*60))" +%Y-%m-%d)
|
||||
|
||||
zammad_backup
|
||||
|
||||
# wait until next backup
|
||||
sleep "${BACKUP_SLEEP}"
|
||||
NEXT_TIMESTAMP=$(date -d "$TOMORROW_DATE $BACKUP_TIME" +%s)
|
||||
NOW_TIMESTAMP=$(date +%s)
|
||||
|
||||
sleep $((NEXT_TIMESTAMP - NOW_TIMESTAMP))
|
||||
done
|
||||
fi
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user