octree/voca-decidim

Decidim Docker镜像文档

镜像概述和主要用途

Decidim是一个开源的参与式民主平台，该Docker镜像(hfroger/decidim:jammy-0.29)旨在简化其本地开发环境的搭建。当克隆新的Decidim项目目录时，本地的.rbenv和.bundle目录通常为空，这些目录实际在Docker容器内创建。本镜像提供了从容器复制这些必要配置目录到本地文件系统的方法，确保开发环境依赖和配置正确。

核心功能和特性

• 支持从Docker容器复制关键开发配置目录（.rbenv和.bundle）到本地文件系统
• 提供两种灵活的复制方式：通过临时容器创建或直接使用已运行的容器
• 适配Docker Compose环境，支持已运行容器的目录复制

使用场景和适用范围

适用于Decidim项目的本地开发环境搭建，特别是在以下场景：

• 首次克隆Decidim项目目录后，需要初始化本地开发环境配置
• 本地.rbenv或.bundle目录损坏或丢失，需从容器恢复配置
• 多环境开发时，需要统一开发依赖和Ruby环境配置

使用方法和配置说明

方法一：通过临时容器复制目录

当需要创建临时容器来获取配置目录时，执行以下步骤：

1. 构建并创建临时容器，获取容器ID：

   bash
   container_id=$(docker create hfroger/decidim:jammy-0.29)
   

2. 复制.rbenv目录到本地：

   bash
   docker cp $container_id:/home/decidim/.rbenv .
   

3. 复制.bundle目录到本地：

   bash
   docker cp $container_id:/home/decidim/.bundle .
   

4. 清理临时容器：

   bash
   docker rm $container_id
   

方法二：通过已运行的Docker Compose容器复制

如果已通过docker compose up启动容器，可直接使用容器名称复制目录：

1. 复制.rbenv目录（假设容器名称为decidim-voca）：

   bash
   docker cp decidim-voca:/home/decidim/.rbenv .
   

2. 复制.bundle目录：

   bash
   docker cp decidim-voca:/home/decidim/.bundle .
   

注意：容器名称需根据实际docker-compose.yml配置中的服务名称确定，上述示例中的decidim-voca仅为参考。