metacall/guix

Guix CI/CD Docker镜像

概述

本Docker镜像专为CI/CD环境设计，集成了Guix包管理器和系统配置工具，旨在为自动化构建、测试和部署流程提供一致、可复现的软件环境。通过预配置的Guix环境，开发者可在CI/CD pipeline中高效管理依赖、构建软件包并确保环境一致性。

核心功能和特性

• 预安装Guix环境：包含完整的Guix包管理器及工具链，无需手动安装配置
• CI/CD适配：优化用于自动化流程，支持与主流CI/CD平台（Jenkins、GitHub Actions、GitLab CI等）集成
• 依赖隔离：利用Guix的事务性包管理特性，实现构建环境的隔离与版本控制
• 环境一致性：确保不同CI/CD节点上的构建环境完全一致，消除"在我机器上能运行"问题
• 轻量级基础：基于精简基础镜像，平衡功能完整性与资源占用

使用场景和适用范围

• 持续集成流程：在自动化测试中提供一致的依赖环境
• 软件包构建：使用Guix构建跨平台或特定架构的软件包
• 多版本依赖测试：快速切换不同版本的依赖库进行兼容性测试
• 开源项目自动化部署：为开源项目提供标准化的构建与发布流程
• 企业内部开发流程：统一开发团队与CI/CD环境的依赖管理

使用方法和配置说明

基本使用（docker run）

bash
docker run --rm -v $(pwd):/workspace guix-ci-cd:latest guix build -f /workspace/guix.scm

Docker Compose配置示例

yaml
version: '3'
services:
  guix-build:
    image: guix-ci-cd:latest
    volumes:
      - ./project:/workspace
    command: guix build -f /workspace/guix.scm
    environment:
      - GUIX_PACKAGE_PATH=/workspace/packages
      - GUIX_PROFILE=/root/.guix-profile

环境变量配置

与GitHub Actions集成示例

yaml
name: Guix Build
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: guix-ci-cd:latest
    steps:
      - uses: actions/checkout@v4
      - name: Build with Guix
        run: guix build -f guix.scm

高级配置

如需自定义Guix通道或添加额外包，可以在项目根目录创建guix-channel.scm文件，并通过挂载方式注入：

bash
docker run --rm -v $(pwd):/workspace guix-ci-cd:latest \
  sh -c "guix pull -C /workspace/guix-channel.scm && guix build -f /workspace/guix.scm"