如何使用Docker.DotNet启动Dockerfile或Docker Compose定义的容器？

一、Dockerfile相关操作 #

可以用Docker.DotNet启动Dockerfile定义的容器，但必须先通过BuildImageFromDockerfileAsync构建镜像——这个方法要求的tar流，本质是把Dockerfile所在的构建上下文目录（包含Dockerfile及所有依赖文件，比如项目代码、配置文件等）打包成tar格式。具体步骤如下：

• 手动将Dockerfile所在目录打包为tar流
• 调用BuildImageFromDockerfileAsync构建镜像
• 镜像构建完成后，依次调用CreateContainerAsync和StartContainerAsync创建并启动容器

示例代码片段：

using Docker.DotNet;
using Docker.DotNet.Models;
using System.IO.Compression;

// 初始化Docker客户端（Windows用npipe，Linux用unix:///var/run/docker.sock）
var dockerClient = new DockerClientConfiguration(new Uri("npipe://./pipe/docker_engine")).CreateClient();

// 打包Dockerfile所在目录为tar流
var tarStream = new MemoryStream();
using (var archive = new ZipArchive(tarStream, ZipArchiveMode.Create, true))
{
    // 添加Dockerfile到tar包
    var dockerfileEntry = archive.CreateEntry("Dockerfile");
    using (var entryStream = dockerfileEntry.Open())
    using (var fileStream = File.OpenRead("./your/dockerfile/path/Dockerfile"))
    {
        await fileStream.CopyToAsync(entryStream);
    }
    // 若有其他上下文文件（如appsettings.json），需一并添加
}
tarStream.Position = 0;

// 构建镜像
var buildParams = new ImageBuildParameters
{
    Dockerfile = "Dockerfile",
    Tags = new List<string> { "my-app-image:latest" }
};
await dockerClient.Images.BuildImageFromDockerfileAsync(buildParams, tarStream);

// 创建并启动容器
var createParams = new CreateContainerParameters
{
    Image = "my-app-image:latest",
    HostConfig = new HostConfig
    {
        PortBindings = new Dictionary<string, IList<PortBinding>>
        {
            { "80/tcp", new List<PortBinding> { new PortBinding { HostPort = "8080" } } }
        }
    }
};
var containerResp = await dockerClient.Containers.CreateContainerAsync(createParams);
await dockerClient.Containers.StartContainerAsync(containerResp.ID, new ContainerStartParameters());

二、Docker Compose相关操作 #

Docker.DotNet没有官方原生支持Docker Compose的API，因为Compose是独立于Docker Engine的上层工具。你可以用两种替代方案：

• 方案一：直接调用系统命令执行docker compose up，通过C#的Process类实现：

using System.Diagnostics;

var composeProcess = new Process
{
    StartInfo = new ProcessStartInfo
    {
        FileName = "docker",
        Arguments = "compose up -d",
        WorkingDirectory = "./your/compose/file/directory",
        RedirectStandardOutput = true,
        RedirectStandardError = true,
        UseShellExecute = false,
        CreateNoWindow = true
    }
};
composeProcess.Start();
await composeProcess.WaitForExitAsync();

// 可读取执行日志
var output = await composeProcess.StandardOutput.ReadToEndAsync();
var error = await composeProcess.StandardError.ReadToEndAsync();

• 方案二：使用社区维护的第三方库（如Docker.DotNet.Compose），它封装了Compose的操作逻辑，本质是解析Compose文件后调用Docker Engine API，或直接调用Compose命令。

内容的提问来源于stack exchange，提问作者Jonathan Byrne