### 使用 C# 编写 Docker 相关代码或实现自定义功能 在现代开发环境中，Docker 已成为容器化技术的核心工具之一。为了通过编程方式管理 Docker 容器和服务，可以利用 Docker 提供的 REST API 接口或者第三方库来简化操作流程。 以下是关于如何使用 C# 来编写与 Docker 相关的功能的具体方法： #### 方法一：调用 Docker 的 REST API Docker 支持基于 HTTP 协议的远程接口访问，开发者可以直接发送 HTTP 请求到本地或远程的 Docker Daemon 进行交互。以下是一个简单的示例，展示如何通过 `HttpClient` 调用 Docker API 创建并启动一个容器。 ```csharp using System; using System.Net.Http; using System.Text.Json; using System.Threading.Tasks; public class DockerApiExample { private static readonly HttpClient client = new HttpClient(); public async Task CreateAndStartContainer() { var url = "http://localhost:2375/containers/create"; // 默认 Docker Socket URL var requestBody = JsonSerializer.Serialize(new { Image = "hello-world", // 镜像名 Cmd = new[] { "/bin/sh", "-c", "#(echo 'Hello from inside the container')" } // 启动命令 }); HttpContent content = new StringContent(requestBody, System.Text.Encoding.UTF8, "application/json"); HttpResponseMessage response = await client.PostAsync(url, content); string responseBody = await response.Content.ReadAsStringAsync(); if (response.IsSuccessStatusCode) { Console.WriteLine($"Container created successfully. Response: {responseBody}"); // 获取创建成功的容器ID dynamic jsonResponse = JsonDocument.Parse(responseBody).RootElement; string containerId = jsonResponse.Id.ToString(); // 启动容器 await StartContainer(containerId); } else { Console.WriteLine($"Failed to create container. Error: {responseBody}"); } } private async Task StartContainer(string containerId) { var url = $"http://localhost:2375/containers/{containerId}/start"; HttpResponseMessage response = await client.PostAsync(url, null); if (response.IsSuccessStatusCode) { Console.WriteLine("Container started successfully."); } else { string errorResponse = await response.Content.ReadAsStringAsync(); Console.WriteLine($"Failed to start container. Error: {errorResponse}"); } } } ``` 此代码片段展示了如何通过 POST 请求向 Docker 发送指令以创建和启动一个新的容器[^6]。 --- #### 方法二：使用第三方 NuGet 库 除了手动处理 HTTP 请求外，还可以借助专门针对 Docker 开发的 .NET 类库（如 [dockerdotnet](https://github.com/Microsoft/Docker.DotNet)），它提供了更高级别的抽象层，使开发者能够更加方便地管理和控制 Docker 环境。 下面是一段演示如何使用该库拉取镜像以及运行容器的例子： ```csharp using Docker.DotNet; using Docker.DotNet.Models; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; public class DockerDotNetExample { public async Task RunDockerCommands() { using (var dockerClient = new DockerClientConfiguration().CreateClient()) { try { // Pull image first. var pullParameters = new ImagesPullParameters() { Repository = "nginx" }; IAsyncEnumerable<ImageInspectResponse> pulledImages = await dockerClient.Images.PullImageAsync(pullParameters, null); foreach (var img in pulledImages) { Console.WriteLine($"Pulled image with ID: {img.ID}"); } // Now let's run a container based on this image. var hostConfig = new HostConfig { PortBindings = new Dictionary<string, IList<PortBinding>> { ["80/tcp"] = new List<PortBinding> { new PortBinding { HostIP = "0.0.0.0", HostPort = "8080" } } }, }; var config = new Config { Image = "nginx", Cmd = new JSONString[] { new JSONString("/bin/bash"), new JSONString("-c"), new JSONString("#(sleep infinity)") } }; var createParams = new ContainerCreateParameters(config, hostConfig); var result = await dockerClient.Containers.CreateContainerAsync(createParams); if (!string.IsNullOrEmpty(result?.Warnings)) { Console.WriteLine($"Warning during creation of container: {result.Warnings}"); } await dockerClient.Containers.StartContainerAsync(result.ID, null); Console.WriteLine($"Started container with id: {result.ID}"); } catch (Exception ex) { Console.Error.WriteLine(ex.Message); } } } } ``` 这段程序实现了从官方仓库下载 Nginx 镜像，并将其作为服务绑定至主机端口 8080 上的操作过程[^7]。 --- #### 注意事项 1. **权限配置** 如果是在 Linux 平台上部署，则需确保当前用户具有足够的权限去连接 Docker daemon；通常情况下可通过加入 `docker` 用户组解决这个问题。 2. **跨平台支持** Windows 和 macOS 对于 Docker socket 文件路径有所不同，在实际应用前应确认目标环境下的具体地址设置。 3. **错误捕获机制** 在生产环境下建议增加详细的日志记录逻辑以便快速定位潜在问题所在位置。 ---