Explore ProPro
Ask me anything
Ithy
Sign in

打造包含便捷操作 Kubernetes 工具的定制镜像

Manage your Kubernetes cluster with Lens | Opensource.com

在现代的 Kubernetes 环境中，高效地管理和操作集群是至关重要的。为此，使用一系列命令行工具如 kubens、kubectx、neat 和 stern 能够显著提高工作效率。本文将详细介绍如何通过创建一个自定义的 Docker 镜像，集成这些便捷的 Kubernetes 操作工具，确保开发者和运维人员能够更加高效地进行日常管理任务。

为何选择自定义 Docker 镜像

使用自定义 Docker 镜像集成 Kubernetes 工具有以下优势：

  • 一致的开发环境：确保所有团队成员使用相同版本的工具，避免环境差异导致的问题。
  • 易于分发和部署：通过容器化工具链，简化环境配置和依赖管理。
  • 可扩展性：方便集成更多工具，根据项目需求灵活调整。
  • 安全性：通过受控的镜像构建过程，减少潜在的安全风险。

所需工具简介

在此自定义镜像中，我们将集成以下工具：

  • kubectl：Kubernetes 的命令行工具，用于与 Kubernetes 集群进行交互。
  • kubectx：快速在多个 Kubernetes 集群之间切换上下文。
  • kubens：快速在 Kubernetes 命名空间之间切换。
  • neat：简化和美化 kubectl 的输出，使其更易读。
  • stern：用于实时跟踪和查看多个 Pod 日志的工具。

构建自定义 Docker 镜像的详细步骤

1. 选择基础镜像

选择一个轻量级且适合安装所需工具的基础镜像。Alpine Linux 是一个极佳的选择，因为它体积小、安全性高，且包管理方便。

2. 安装必要的依赖项

我们需要安装一些基础工具和包，以支持后续工具的安装和运行。

FROM alpine:latest

# 更新包管理器并安装基础依赖
RUN apk update && apk add --no-cache \
    bash \
    curl \
    git \
    ca-certificates \
    wget \
    tar \
    gzip

3. 安装 kubectl

kubectl 是与 Kubernetes 集群交互的核心工具。以下步骤将下载并安装最新版本的 kubectl。

# 设置 kubectl 版本
ENV KUBECTL_VERSION=v1.25.0

# 下载并安装 kubectl
RUN curl -LO "https://storage.googleapis.com/kubernetes-release/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl" && \
    chmod +x kubectl && \
    mv kubectl /usr/local/bin/

4. 安装 kubectx 和 kubens

kubectx 和 kubens 是用于快速切换 Kubernetes 上下文和命名空间的工具。以下步骤将通过下载脚本并赋予执行权限来安装它们。

# 安装 kubectx 和 kubens
RUN curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubectx && \
    curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubens && \
    chmod +x kubectx kubens && \
    mv kubectx kubens /usr/local/bin/

5. 安装 neat

neat 是一个用于简化和美化 kubectl 输出的工具。我们将通过其 GitHub 发布页面下载最新版本的二进制文件并安装。

# 安装 neat
ENV NEAT_VERSION=v0.6.0

RUN curl -LO "https://github.com/itaysk/neat/releases/download/${NEAT_VERSION}/neat_${NEAT_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf neat_${NEAT_VERSION}_linux_amd64.tar.gz && \
    mv neat /usr/local/bin/ && \
    rm neat_${NEAT_VERSION}_linux_amd64.tar.gz

6. 安装 stern

stern 是一个用于实时跟踪多个 Pod 日志的工具。我们将通过其 GitHub 发布页面下载最新版本的二进制文件并安装。

# 安装 stern
ENV STERN_VERSION=v1.31.0

RUN curl -LO "https://github.com/stern/stern/releases/download/${STERN_VERSION}/stern_${STERN_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf stern_${STERN_VERSION}_linux_amd64.tar.gz && \
    mv stern /usr/local/bin/ && \
    rm stern_${STERN_VERSION}_linux_amd64.tar.gz

7. 清理不必要的文件

为了减小镜像体积和提升安全性，我们应当删除在安装过程中引入的临时文件和不必要的包。

# 清理临时文件
RUN apk del curl git tar gzip && \
    rm -rf /var/cache/apk/*

8. 设置工作目录和默认命令

最后，设置容器的工作目录和默认命令，以便在容器启动时进入指定的目录并使用 bash 作为默认 shell。

# 设置工作目录
WORKDIR /workspace

# 默认命令
CMD ["/bin/bash"]

优化与最佳实践

使用多阶段构建优化镜像体积

多阶段构建可以显著减小最终镜像的体积，通过在构建阶段安装所需工具，再将它们复制到一个精简的基础镜像中。

# 第一阶段: 构建阶段
FROM alpine:latest AS builder

RUN apk update && apk add --no-cache \
    bash \
    curl \
    git \
    ca-certificates \
    wget \
    tar \
    gzip

# 安装 kubectl
ENV KUBECTL_VERSION=v1.25.0
RUN curl -LO "https://storage.googleapis.com/kubernetes-release/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl" && \
    chmod +x kubectl

# 安装 kubectx 和 kubens
RUN curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubectx && \
    curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubens && \
    chmod +x kubectx kubens

# 安装 neat
ENV NEAT_VERSION=v0.6.0
RUN curl -LO "https://github.com/itaysk/neat/releases/download/${NEAT_VERSION}/neat_${NEAT_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf neat_${NEAT_VERSION}_linux_amd64.tar.gz && \
    chmod +x neat

# 安装 stern
ENV STERN_VERSION=v1.31.0
RUN curl -LO "https://github.com/stern/stern/releases/download/${STERN_VERSION}/stern_${STERN_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf stern_${STERN_VERSION}_linux_amd64.tar.gz && \
    chmod +x stern

# 第二阶段: 运行阶段
FROM alpine:latest

# 安装基础运行时依赖
RUN apk update && apk add --no-cache bash

# 复制工具到运行阶段
COPY --from=builder /kubectl /usr/local/bin/
COPY --from=builder /kubectx /usr/local/bin/
COPY --from=builder /kubens /usr/local/bin/
COPY --from=builder /neat /usr/local/bin/
COPY --from=builder /stern /usr/local/bin/

# 设置工作目录
WORKDIR /workspace

# 默认命令
CMD ["/bin/bash"]

通过这种方式，最终镜像仅包含运行时所需的工具和最小的基础环境，显著减小了镜像体积。

自动化版本管理

为了确保工具始终保持最新版本，可以引入自动化脚本或使用环境变量来动态设置版本号。这不仅简化了更新过程，还能避免因版本不一致而导致的问题。

# 示例: 使用 ARG 指令动态设置版本
ARG KUBECTL_VERSION=v1.25.0
ARG NEAT_VERSION=v0.6.0
ARG STERN_VERSION=v1.31.0

ENV KUBECTL_VERSION=${KUBECTL_VERSION}
ENV NEAT_VERSION=${NEAT_VERSION}
ENV STERN_VERSION=${STERN_VERSION}

在构建镜像时，可以通过传递参数来指定不同的版本：

docker build --build-arg KUBECTL_VERSION=v1.26.0 --build-arg NEAT_VERSION=v0.7.0 --build-arg STERN_VERSION=v1.32.0 -t k8s-tools:latest .

安全性考虑

在构建自定义镜像时，需注意以下安全性事项：

  • 最小化基础镜像：选择体积小且经过良好维护的基础镜像，减少潜在的安全漏洞。
  • 定期更新工具版本：确保所有工具均为最新版本，以获得最新的安全补丁和功能。
  • 使用可信来源：仅从官方渠道或可信的发布页面下载工具，避免引入恶意软件。
  • 限制权限：在可能的情况下，以非 root 用户运行容器，减少被攻击面。

完整的 Dockerfile 示例

下面是一个集成所有上述步骤的完整 Dockerfile 示例：

# 多阶段构建 Dockerfile

# 第一阶段: 构建工具
FROM alpine:latest AS builder

# 环境变量定义
ARG KUBECTL_VERSION=v1.25.0
ARG NEAT_VERSION=v0.6.0
ARG STERN_VERSION=v1.31.0

ENV KUBECTL_VERSION=${KUBECTL_VERSION} \
    NEAT_VERSION=${NEAT_VERSION} \
    STERN_VERSION=${STERN_VERSION}

# 安装基础依赖
RUN apk update && apk add --no-cache \
    bash \
    curl \
    git \
    ca-certificates \
    wget \
    tar \
    gzip

# 安装 kubectl
RUN curl -LO "https://storage.googleapis.com/kubernetes-release/release/${KUBECTL_VERSION}/bin/linux/amd64/kubectl" && \
    chmod +x kubectl

# 安装 kubectx 和 kubens
RUN curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubectx && \
    curl -LO https://raw.githubusercontent.com/ahmetb/kubectx/master/kubens && \
    chmod +x kubectx kubens

# 安装 neat
RUN curl -LO "https://github.com/itaysk/neat/releases/download/${NEAT_VERSION}/neat_${NEAT_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf neat_${NEAT_VERSION}_linux_amd64.tar.gz && \
    chmod +x neat

# 安装 stern
RUN curl -LO "https://github.com/stern/stern/releases/download/${STERN_VERSION}/stern_${STERN_VERSION}_linux_amd64.tar.gz" && \
    tar -xvzf stern_${STERN_VERSION}_linux_amd64.tar.gz && \
    chmod +x stern

# 第二阶段: 运行镜像
FROM alpine:latest

# 安装运行时依赖
RUN apk update && apk add --no-cache \
    bash \
    ca-certificates

# 复制工具
COPY --from=builder /kubectl /usr/local/bin/
COPY --from=builder /kubectx /usr/local/bin/
COPY --from=builder /kubens /usr/local/bin/
COPY --from=builder /neat /usr/local/bin/
COPY --from=builder /stern /usr/local/bin/

# 设置工作目录
WORKDIR /workspace

# 默认命令
CMD ["/bin/bash"]

构建与运行镜像

构建镜像

将上述 Dockerfile 保存为 Dockerfile，然后在该文件所在的目录中运行以下命令以构建镜像：

docker build -t k8s-tools:latest .

运行容器

构建完成后，可以使用以下命令启动一个交互式容器：

docker run -it --rm k8s-tools:latest

进入容器后，您将能够使用以下命令行工具：

  • kubectl
  • kubectx
  • kubens
  • neat
  • stern

进一步的改进与扩展

引入更多 Kubernetes 工具

根据项目需求，可以进一步集成更多的 Kubernetes 工具，如：

  • k9s：用于在终端中以交互方式管理 Kubernetes 集群。
  • helm：Kubernetes 的包管理工具。
  • kustomize：用于配置 Kubernetes 资源的工具。

例如，添加 helm 的安装步骤：

# 安装 helm
ENV HELM_VERSION=v3.8.2

RUN curl -LO "https://get.helm.sh/helm-${HELM_VERSION}-linux-amd64.tar.gz" && \
    tar -xvzf helm-${HELM_VERSION}-linux-amd64.tar.gz && \
    mv linux-amd64/helm /usr/local/bin/ && \
    rm -rf linux-amd64 helm-${HELM_VERSION}-linux-amd64.tar.gz

挂载 kubeconfig 文件

为了使容器能够访问 Kubernetes 集群，通常需要挂载主机的 kubeconfig 文件。可以通过以下方式运行容器：

docker run -it --rm -v ~/.kube/config:/root/.kube/config k8s-tools:latest

这样，容器内的 kubectl 等工具即可使用主机的 Kubernetes 配置。

持续集成与自动化构建

为了确保工具始终保持最新版本，可以将镜像构建过程集成到 CI/CD 管道中。例如，使用 GitHub Actions 可以自动触发镜像构建并推送到 Docker Hub：

name: Build and Push Docker Image

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v2

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v1

      - name: Log in to Docker Hub
        uses: docker/login-action@v1
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push
        uses: docker/build-push-action@v2
        with:
          push: true
          tags: yourdockerhubusername/k8s-tools:latest

版本控制与标签

为了便于管理和回滚，可以使用标签策略对镜像进行版本控制。例如：

  • k8s-tools:v1.0.0 - 初始版本
  • k8s-tools:v1.1.0 - 添加新工具或功能
  • k8s-tools:latest - 指向最新的稳定版本

参考资源

github.com
kubectx GitHub
github.com
stern GitHub
k9scli.io
k9s 官方网站

结论

通过创建一个包含 kubectl、kubectx、kubens、neat 和 stern 等工具的自定义 Docker 镜像，可以大幅提升 Kubernetes 集群管理的效率和便捷性。遵循本文提供的详细步骤和最佳实践，您可以构建一个安全、高效且易于维护的工具链环境，为您的开发和运维工作提供强大的支持。

此外，随着项目需求的变化和工具的更新，建议定期审查和更新镜像内容，确保所有工具均处于最新和安全的版本。同时，结合持续集成和持续部署（CI/CD）流程，自动化镜像构建和发布，进一步提升工作效率和可靠性。

希望本文能够帮助您成功构建一个高效的 Kubernetes 工具镜像，支持您的开发和运维工作。


Last updated January 7, 2025

AI-assisted research. Sources, methodology and corrections · Source-checked guides and tools · Explore published answers

Ask a follow-up