CPAN Artifact Repository Manager —— Carmel 使用教程

1. 项目介绍

Carmel 是一个 CPAN 模块管理器，它不同于传统的 CPAN 模块安装程序。Carmel 会将你的依赖构建保存在一个中央仓库中，然后在运行时动态选择包含的库路径。这对于在开发环境中使用非常有用。Carmel 还允许你将所有文件滚动到一个传统的 Perl INC 目录结构中，这对于在容器等生产环境中使用非常有帮助。

2. 项目快速启动

首先，确保你的系统中已经安装了 cpanm（CPAN 模块安装器）。

安装 Carmel

cpanm Carmel

初始化项目

在你的项目中创建一个 cpanfile 文件，列出你的依赖项：

requires 'Plack', '0.9980';
requires 'Starman', '0.2000';

然后，运行以下命令来安装这些依赖项：

carmel install

将 .carmel 目录添加到 .gitignore 文件中，以避免将其提交到版本控制系统：

echo /.carmel >> .gitignore

提交 cpanfile、cpanfile.snapshot 和 .gitignore 文件到你的版本控制系统：

git add cpanfile cpanfile.snapshot .gitignore
git commit -m "初始化 Carmel 依赖"

运行应用

要运行你的应用程序，可以使用 carmel exec 命令：

carmel exec starman -p 8080 myapp.psgi

3. 应用案例和最佳实践

开发流程

• 在开发环境中，每次设置新环境或更改 cpanfile 时，运行 carmel install。
• 使用 carmel exec 来运行你的应用程序，它会使用 cpanfile 和 cpanfile.snapshot 中指定的版本。
• 提交 cpanfile.snapshot 文件以保持依赖版本的一致性。

生产部署

• 使用 carmel rollout 命令将构建工件滚动到 local 目录，以便在 production 中使用，无需 carmel exec。
• 使用 carmel package 命令创建一个包含模块 tarballs 和 CPAN 风格包索引文件的目录，可以传递给 cpanm 在目标机器上进行安装。

4. 典型生态项目

Carmel 可以与多个 Perl 生态项目配合使用，例如：

• Plack：Perl 的 Web 框架和应用服务器工具集。
• Carton：另一个 CPAN 模块打包工具。
• Starman：一个基于 PSGI 的简单 HTTP 服务器。

通过上述教程，你应该能够开始使用 Carmel 来管理和部署你的 Perl 项目了。