akeneo/pim-deployer

镜像概述

本Docker镜像集成了云原生开发与运维场景中常用的工具链，包括gcloud、kubectl、bash、python3、openssh-client、curl、git、helm及yq，旨在提供统一、便捷的工具环境，简化开发、部署及运维流程，减少因环境差异导致的问题。

核心功能与特性

• 全面的工具集成：包含以下关键工具，覆盖云服务操作、容器编排、版本控制、脚本开发等场景：

  • gcloud：Google Cloud平台命令行工具，用于管理云资源、配置服务账号等
  • kubectl：Kubernetes集群命令行工具，用于部署、管理Kubernetes资源
  • bash：GNU Bourne-Again Shell，提供脚本执行和交互终端环境
  • python3：Python 3运行环境，支持编写和执行Python自动化脚本
  • openssh-client：SSH客户端工具，支持远程服务器连接与文件传输
  • curl：网络请求工具，支持HTTP/HTTPS等协议的数据传输
  • git：分布式版本控制系统，用于代码拉取、提交及分支管理
  • helm：Kubernetes包管理工具，用于打包、分发、安装和升级Kubernetes应用
  • yq：YAML/JSON处理工具，支持查询、修改YAML文件内容

• 即开即用：无需手动安装依赖，拉取镜像后即可使用所有工具，降低环境配置成本

• 环境一致性：统一工具版本和运行环境，避免因本地环境差异导致的"在我这能跑"问题

• 灵活扩展：支持挂载外部配置文件、工作目录，适配不同场景下的个性化需求

使用场景

• 云原生开发环境：本地开发时快速获取完整工具链，编写、测试Kubernetes配置文件或云服务操作脚本

• CI/CD流水线：作为CI/CD任务的执行环境，完成代码拉取、依赖安装、应用构建、镜像推送、Kubernetes部署等流程

• 云资源与集群管理：通过gcloud管理Google Cloud资源，结合kubectl、helm操作Kubernetes集群，执行日常运维任务

• 自动化脚本执行：利用python3、bash编写运维脚本，结合curl、git等工具实现数据采集、文件同步、服务监控等自动化流程

• 临时故障排查：快速启动容器，使用工具链诊断Kubernetes集群、云服务或网络问题

使用方法

基本使用

通过以下命令拉取并启动镜像，进入交互shell环境：

bash
docker run -it --rm [镜像名称] bash

说明：-it 启用交互模式并分配终端，--rm 退出后自动删除容器，避免残留

挂载外部配置

挂载Kubernetes配置

将本地kubeconfig文件挂载到容器内，使kubectl可访问目标集群：

bash
docker run -it --rm -v ~/.kube/config:/root/.kube/config [镜像名称] kubectl get pods

挂载工作目录

挂载本地工作目录到容器内，方便操作本地文件：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像名称]

说明：-w /workspace 设置容器内工作目录为/workspace

挂载SSH密钥

挂载SSH密钥用于Git仓库访问或远程服务器连接：

bash
docker run -it --rm -v ~/.ssh/id_rsa:/root/.ssh/id_rsa [镜像名称] git clone git@github.com:example/repo.git

环境变量配置

通过-e参数设置环境变量，如配置gcloud默认项目：

bash
docker run -it --rm -e GCLOUD_PROJECT=my-gcp-project [镜像名称] gcloud config set project $GCLOUD_PROJECT

docker-compose配置示例

创建docker-compose.yml文件，定义常用配置：

yaml
version: '3'
services:
  dev-tools:
    image: [镜像名称]
    volumes:
      - ~/.kube/config:/root/.kube/config  # 挂载kubeconfig
      - ~/.ssh:/root/.ssh                  # 挂载SSH密钥
      - ./workspace:/workspace             # 挂载工作目录
    working_dir: /workspace
    environment:
      - GCLOUD_PROJECT=my-gcp-project      # 设置gcloud项目
      - HELM_HOME=/root/.helm              # 配置helm家目录
    tty: true
    stdin_open: true

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec dev-tools bash

工具使用示例

使用kubectl管理集群

bash
# 查看集群节点
kubectl get nodes

# 部署应用
kubectl apply -f deployment.yaml

使用gcloud操作云资源

bash
# 列出GCP项目
gcloud projects list

# 启动Compute Engine实例
gcloud compute instances start my-instance --zone us-central1-a

使用helm管理应用

bash
# 添加helm仓库
helm repo add bitnami https://charts.bitnami.com/bitnami

# 安装应用
helm install my-nginx bitnami/nginx

使用yq处理YAML文件

bash
# 修改deployment.yaml中的镜像版本
yq eval '.spec.template.spec.containers[0].image = "nginx:1.23"' -i deployment.yaml

注意事项

• 镜像中工具版本请以实际构建信息为准，建议使用固定版本标签避免自动更新导致的兼容性问题
• 敏感信息（如云服务密钥、SSH密钥）建议通过环境变量或外部文件挂载传入，避免硬编码到镜像中
• 长期运行场景下建议挂载持久卷保存工具配置（如gcloud、helm的配置文件），避免重复配置