#Containers

#理解 Containers

请参考 Kubernetes 官方网站文档：Containers。

Container 是一个轻量级、可执行的软件包，包含运行应用程序所需的一切：代码、运行时、系统工具、系统库和设置。虽然 Pod 是最小的可部署单元，但 containers 是 Pod 内的核心组件。

#理解 Ephemeral Containers

调试 Containers
请参考 Kubernetes 官方网站文档：Ephemeral Containers

Kubernetes 的 Ephemeral Containers 功能提供了一种强大的方式，通过向现有 Pod 注入专用的调试工具（系统、网络和磁盘工具）来调试正在运行的 containers。

虽然通常可以使用 kubectl exec 直接在运行中的 container 内执行命令，但许多生产环境的 container 镜像故意保持精简，可能缺少关键的调试工具（例如 bash、net-tools、tcpdump），以减小镜像体积和攻击面。Ephemeral Containers 解决了这一限制，提供了一个预配置的环境，内置丰富的调试工具，非常适合以下场景：

• 故障诊断：当主应用 container 出现问题（如意外崩溃、性能下降、网络连接异常）时，除了查看标准的 Pod 事件和日志外，通常需要在 Pod 的运行环境中进行更深入的交互式排查。
• 配置调优与实验：如果当前应用配置表现不佳，可能需要临时调整组件设置或测试新配置，直接在运行中的 container 内观察即时效果并制定改进方案。

#实现原理：利用 Ephemeral Containers

调试功能是通过 Ephemeral Containers 实现的。Ephemeral Container 是一种专门用于内省和调试的特殊 container。它与现有的主 containers 共享 Pod 的网络命名空间和进程命名空间（如果启用），可以直接与应用进程交互和观察。

你可以动态地向运行中的 Pod 添加一个 Ephemeral Container（例如 my-app-debug），并使用其预装的调试工具。该 Ephemeral Container 的诊断结果直接关联于同一 Pod 内主应用 containers 的行为和状态。

#使用 CLI 调试 Ephemeral Containers

Kubernetes 1.25+ 提供了 kubectl debug 命令来创建 ephemeral containers。此方法为调试提供了强大的命令行替代方案。

命令

kubectl debug -it <pod-name> --image=<debug-image> --target=<target-container-name> -n <namespace>
# --image：指定包含必要工具的调试镜像（例如 busybox、ubuntu、nicolaka/netshoot）。
# --target：（可选）指定 Pod 中目标 container 的名称。若省略且只有一个 container，则默认该 container；若有多个，则默认第一个。
# -n：指定命名空间。

Pod YAML 文件示例

示例：调试 my-nginx-pod 中的 nginx

• 首先，确保有一个正在运行的 Pod：

  kubectl apply -f pod-example.yaml

• 现在，在 my-nginx-pod 内创建一个名为 debugger 的 ephemeral 调试 container，目标为 my-nginx-container，使用 busybox 镜像：

  kubectl debug -it my-nginx-pod --image=busybox --target=nginx -- /bin/sh

  该命令会将你连接到 debugger ephemeral container 内的 shell，可以使用 busybox 工具调试 my-nginx-container。

• 查看 Pod 附加的 ephemeral containers：

  kubectl describe pod my-nginx-pod

  在输出中查找 Ephemeral Containers 部分。

#使用 Web 控制台调试 Ephemeral Containers

1. 进入 Container Platform，在左侧导航栏选择 Workloads > Pods。

2. 找到想要查看的 Pod，点击 ⋮ > Debug。

3. 选择 Pod 中想要调试的具体 container。

4. （可选）如果界面提示需要 初始化（例如设置必要的调试环境），点击 Initialize。

   INFO

   初始化 Debug 功能后，只要 Pod 未被重建，即可直接进入 Ephemeral Container（例如 Container A-debug）进行调试。

5. 等待调试终端窗口准备就绪，开始调试操作。
   提示：点击终端右上角的“命令查询”选项，可查看常用调试工具及其使用示例。

   INFO

   点击右上角的命令查询查看常用工具及用法。

6. 调试完成后，关闭终端窗口。

#与 Containers 交互

你可以使用 kubectl exec 命令直接与运行中的 container 内部实例交互，执行任意命令行操作。此外，Kubernetes 还提供了方便的文件上传和下载功能。

#使用 CLI 与 Containers 交互

#Exec

在 Pod 中的特定 container 内执行命令（例如获取 shell、运行诊断命令等）：

kubectl exec -it <pod-name> -c <container-name> -n <namespace> -- <command>
# -it：确保交互模式和伪终端（TTY），适合 shell 会话。
# -c：指定 Pod 中目标 container 名称。Pod 仅有一个 container 时可省略。
# --：分隔 kubectl 参数和容器内执行的命令。

• 示例：进入 my-nginx-pod 中 nginx 的 Bash shell

  kubectl exec -it my-nginx-pod -c nginx -n default -- /bin/bash

• 示例：列出 container /tmp 目录下的文件

  kubectl exec my-nginx-pod -c nginx -n default -- ls /tmp

#文件传输

• 从本地复制文件到 Pod 中的 container：

  kubectl cp <local-file-path> <namespace>/<pod-name>:<container-file-path> -c <container-name>
  # -c：（可选）指定 Pod 中目标 container 名称（多 container Pod 时需要）。
  
  # 示例：上传 my-config.txt 到 Nginx 的 HTML 目录
  kubectl cp my-config.txt default/my-nginx-pod:/usr/share/nginx/html/my-config.txt -c nginx

• 从 Pod 中的 container 复制文件到本地：

  kubectl cp <namespace>/<pod-name>:<container-file-path> <local-file-path> -c <container-name>
  
  # 示例：下载 Nginx 访问日志
  kubectl cp default/my-nginx-pod:/var/log/nginx/access.log ./nginx_access.log -c nginx

#使用 Web 控制台与 Containers 交互

#通过 Applications 进入 Container

你可以使用 kubectl exec 命令进入 container 内部实例，在 Web 控制台窗口执行命令行操作。同时，支持文件上传和下载功能，方便在 container 内传输文件。

1. 进入 Container Platform，在左侧导航栏选择 Application > Applications。

2. 点击 Application Name。

3. 找到关联的工作负载（如 Deployment、StatefulSet），点击 EXEC，然后选择想要进入的具体 Pod Name。再选择 EXEC > Container Name。

4. 输入想要执行的命令。

5. 点击 OK，进入 Web 控制台窗口，执行命令行操作。

6. 点击 File Transfer。

   • 输入 Upload Path，将本地文件上传到 container（例如测试用配置文件）。
   • 输入 Download Path，将日志、诊断数据或其他文件从 container 下载到本地进行分析。

#通过 Pod 进入 Container

1. 进入 Container Platform，在左侧导航栏选择 Workloads > Pods。

2. 找到目标 Pod，点击其旁边的垂直省略号（⋮），选择 EXEC，然后选择该 Pod 中想要进入的具体 Container Name。

3. 输入想要执行的命令。

4. 点击 OK，进入 Web 控制台窗口，执行命令行操作。

5. 点击 File Transfer。

   • 输入 Upload Path，将本地文件上传到 container（例如测试用配置文件）。
   • 输入 Download Path，将日志、诊断数据或其他文件从 container 下载到本地进行分析。