还在为复杂的 docker run 命令头疼吗？还在手动编写 docker-compose.yml 文件吗？今天给大家介绍一个神器—— composerize，它能帮你把 docker run 命令瞬间变成 docker-compose.yml 文件，甚至还能与现有的 docker-compose.yml 文件无缝合并！简直是容器编排的福音！

一、项目介绍

composerize 是一个开源项目，其目标非常明确：将繁琐的 docker run 命令转化为易于管理和维护的 docker-compose.yml 文件。这个项目就像一个魔法棒，轻轻一挥，就能把复杂的命令变成结构化的配置，让你的容器编排工作更加高效和轻松。

项目地址：http://composerize.com

二、基本功能

1. 命令转换

composerize 的核心功能就是将 docker run 命令转换成 docker-compose.yml 文件。它能够解析 docker run 命令中的各种参数，如端口映射、数据卷挂载、重启策略等，并将其转化为 docker-compose.yml 文件中对应的配置项。

2. 文件合并

除了转换功能，composerize 还能将转换结果与已有的 docker-compose.yml 文件合并。这意味着你可以逐步构建你的容器编排配置，而无需担心覆盖或丢失已有的配置。

3. 多种使用方式

composerize 提供了多种使用方式，以满足不同用户的需求：

• CLI 工具: 通过命令行直接使用，方便快捷。
• Node.js 模块: 可以集成到你的 Node.js 项目中，实现自动化配置。

4. 版本和缩进控制

composerize 还支持指定 Docker Compose V2 的目标版本（2.x, 3.x 或 Common Specification），以及自定义缩进级别，让生成的 docker-compose.yml 文件更加符合你的需求。

三、部署方式

composerize 的部署方式非常简单，你可以根据自己的需求选择不同的方式：

1. CLI 安装

如果你想在命令行中使用 composerize，可以使用 npm 进行全局安装：

npm install composerize -g

2. Node.js 模块安装

如果你想在 Node.js 项目中使用 composerize，可以使用 npm 安装：

npm install composerize

3. Docker 镜像

如果你想快速体验 composerize，可以使用官方提供的 Docker 镜像，它包含了 composerize、decomposerize 和 composeverter 网站。

https://github.com/Oaklight/composerize-minimal/blob/master/README_en.md

四、使用方式

1. CLI 使用

安装完成后，你可以直接在命令行中使用 composerize 命令：

composerize docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

例如，将以下 docker run 命令转换为 docker-compose.yml 文件：

composerize docker run -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro --restart always --log-opt max-size=1g nginx

执行后，composerize 会输出对应的 docker-compose.yml 文件内容。

2. Node.js 使用

在 Node.js 项目中，你可以这样使用 composerize：

const composerize = require('composerize');

const dockerRunCommand = 'docker run -d -p 8080:80 --name my-web-app nginx:latest';

// 将 Docker run 命令转换为 Docker Compose 配置
const composeConfig = composerize(dockerRunCommand);
console.log(composeConfig);

// 与现有的 Docker Compose 配置合并
const existingComposeConfig = `
version: '3'
services:
  existing-service:
    image: my-existing-image:latest
    ports:
      - '8000:80'
`;
const mergedComposeConfig = composerize(dockerRunCommand, existingComposeConfig);
console.log(mergedComposeConfig);

// 指定 Docker Compose 版本 (v2x, v3x, latest)
const composeConfigV2x = composerize(dockerRunCommand, null, 'v2x');
console.log(composeConfigV2x);

// 指定缩进级别
const composeConfigIndented = composerize(dockerRunCommand, null, 'latest', 2);
console.log(composeConfigIndented);

五、反向工具

composerize 还有一个好兄弟，叫做 decomposerize，它可以将 docker-compose.yml 文件转换回 docker run 命令。此外，还有一个 composeverter 工具，可以转换 Docker Compose 文件格式。

• Decomposerize: http://decomposerize.com / Decomposerize
• Composeverter: http://composeverter.com / Composeverter

六、总结

作为一个开源项目，composerize 以其简洁高效的功能，为容器编排带来了极大的便利。无论是新手还是老手，都能从中受益。如果你还在为 docker run 命令和 docker-compose.yml 文件而烦恼，不妨试试 composerize，相信它会给你带来惊喜！