hfroger/decidim

Decidim on Docker

参与式民主框架

面向城市和组织的免费开源参与式民主、公民参与和开放***平台。
探索文档 »

加入我们的Matrix.org聊天群组。

功能 · https://github.com/decidim/decidim/projects/16 · https://github.com/decidim/docker/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22type%3A+bug%22 · 提议新功能 · https://github.com/decidim/decidim

我们每天会发布基于不同发行版（默认是ubuntu:questing）的三个Decidim版本镜像。若想快速开始使用Decidim，请遵循我们的▶️ 5分钟教程。

可用标签

如需使用其他发行版，以下版本可用：

▶️ 5分钟教程

想在5分钟内本地搭建Decidim实例？遵循我们的5分钟教程，使用Docker在本地设置Decidim。

环境配置

🔐：请务必阅读良好实践 ;)

所有DECIDIM_前缀的变量均可用。https://github.com/decidim/decidim/blob/v0.30.2/docs/modules/configure/pages/environment_variables.adoc%E3%80%82

Cron配置

Cron配置为每15分钟、每小时、每天、每周运行脚本。到时间后，将执行/etc/periodic目录中的所有脚本。默认情况下，执行以下脚本：

sh
├── daily
│   └── change_active_steps.sh
│   ├── daily_digest.sh
│   ├── open_data_export.sh
│   └── reminders_all.sh
├── hourly
│   ├── compute_metrics.sh
│   └── delete_download_your_data_files.sh
├── monthly
└── weekly
    ├── clean_registration_forms.sh
    └── weekly_digest.sh

如需自定义，可复制此cron.d目录，修改脚本并映射卷。注意，这些脚本需要执行权限，新增脚本需执行chmod +x。

# 将容器内目录复制到本地
docker cp decidim:/home/decidim/crontab.d crontab.d

并更新docker-compose配置：

diff
    container_name: decidim
    image: decidim/decidim:latest
    ports:
      - 3000:3000
    volumes:
      - storage:/home/decidim/storage
+     - ./crontab.d:/etc/decidim/crontab.d
+   environment:
-   environment:    

若不使用Docker镜像运行cron而倾向于使用调度器，可在crontab文件中获取命令。

入口点

运行Docker命令前，将执行入口点脚本。这些命令在每次容器重启时运行：

• 10_remove_pids：移除旧的Puma PID文件（如有）。
• 15_wait_for_it：对依赖项执行wait-for-it检查，支持REDIS_URL、DATABASE_URL和MEMCACHE_SERVERS。
• 35_bundle_check：检查所有gem是否已安装。
• 36_db_check：检查数据库是否启动，如未启动则尝试迁移。
• 50_upsert-sysadmin：根据环境变量DECIDIM_SYSTEM_EMAIL和DECIDIM_SYSTEM_PASSWORD，更新首个/system管理员。

命令

可将docker-compose命令更新为任意值。常见命令如下：

• bundle exec rails server -b 0.0.0.0：启动Puma服务器。
• bundle exec sidekiq：启动Sidekiq工作器。
• cron start -f：在前台启动cron。
• sleep infinity：不执行操作，允许通过docker exec decidim在容器内执行进程。

贡献

详见CONTRIBUTING.md。欢迎提交PR ❤️

工作原理

本仓库自动将Decidim版本发布为Docker容器，并生成使用文档。

Decidim版本管理

• lib/decidim/decidim_version.rb：针对特定Decidim版本，获取依赖项（Ruby、Node.js、Bundler）版本。
• lib/docker/docker_image.rb：将依赖项与正确的Ruby Docker镜像匹配。
• lib/docker.rb：提供Docker相关任务和辅助工具。
• lib/：其他支持文件和模块。

Docker镜像自动化

• bundle exec rake docker:build:ubuntu[version]：为给定Decidim版本（dev、last或prev）构建基于Ubuntu的镜像。
• bundle exec rake docker:build:redhat[version]：为给定Decidim版本（dev、last或prev）构建基于Redhat的镜像。

文档生成

• bundle exec rake docker:docs：从templates/文件自动生成文档。

DockerHub API Ruby客户端

• yarn dockerhub:update：下载最新版DockerHub API定义，并在contrib/中构建Ruby客户端。

仓库结构

• contrib/：Nginx和Docker Hub API的支持文件。
• docker/：Docker上下文文件、旧版附加脚本（如cron和入口点）。
• docker/{ubuntu,redhat}/Dockerfile：各发行版的Dockerfile。
• lib/：包含版本管理和Docker镜像创建的核心类和模块。
• templates/：存放Docker配置和文档的ERB模板。
• Rakefile：定义本仓库的rake任务。

许可证

本仓库采用GNU Affero通用公共许可证v3。