ebiwd/alpine-ssh Docker 镜像 - 轩辕镜像

alpine-ssh

镜像概述和主要用途

基于alpine:3.6构建的轻量级Docker镜像，专为CI/CD流水线设计。集成openssh和rsync核心工具，并内置多个实用脚本，简化SSH密钥管理、云服务凭证配置及网络参数设置等操作，满足持续集成/持续部署流程中的自动化需求。

核心功能和特性

基础环境

• 基于Alpine Linux 3.6，保持镜像体积小巧，资源占用低
• 预安装openssh（SSH服务与客户端）和rsync（文件同步工具）

实用脚本

• add-ssh-key <user> <key> [<user> <key>]
  为指定用户添加SSH公钥，支持同时配置多个用户-密钥对，自动完成密钥文件权限设置和用户目录配置。

• add-aws-key <user> <key> [region] [output]
  为指定用户配置AWS访问密钥，可选参数包括区域（region）和输出格式（output），自动生成AWS CLI配置文件。

• add-search-domain <domain>
  设置容器内DNS搜索域，简化短域名访问配置，适用于需要解析内部服务域名的场景。

使用场景和适用范围

• CI/CD流水线中通过SSH协议连接远程服务器执行部署操作
• 使用rsync进行代码或资源文件的增量同步
• 自动化配置构建环境中的SSH访问凭证
• 在容器化CI环境中快速配置AWS服务访问权限
• 需要自定义DNS搜索域的网络环境配置

使用方法和配置说明

基本运行方式

启动容器并保持运行：

bash
docker run -d --name alpine-ssh-runner alpine-ssh tail -f /dev/null

执行实用脚本

添加SSH密钥

将公钥内容直接传递给脚本：

bash
docker exec alpine-ssh-runner add-ssh-key deploy-user "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..."

从文件读取公钥（需先挂载密钥文件到容器）：

bash
docker run -d -v $(pwd)/id_rsa.pub:/keys/id_rsa.pub --name alpine-ssh-runner alpine-ssh
docker exec alpine-ssh-runner add-ssh-key deploy-user "$(cat /keys/id_rsa.pub)"

配置AWS密钥

基础配置（默认区域us-east-1，输出格式json）：

bash
docker exec alpine-ssh-runner add-aws-key aws-user "AKIAEXAMPLEKEY123"

指定区域和输出格式：

bash
docker exec alpine-ssh-runner add-aws-key aws-user "AKIAEXAMPLEKEY123" eu-west-1 table

设置DNS搜索域

bash
docker exec alpine-ssh-runner add-search-domain internal.example.com

docker-compose集成示例

yaml
version: '3.8'
services:
  ci-ssh-agent:
    image: alpine-ssh
    container_name: ci-ssh-agent
    volumes:
      - ./ci-keys:/ci-keys  # 挂载本地密钥目录
    command: >
      sh -c "add-ssh-key ci-user $$(cat /ci-keys/id_rsa.pub) &&
             add-aws-key aws-ci $$(cat /ci-keys/aws-access-key) us-west-2 json &&
             add-search-domain ci.example.com &&
             tail -f /dev/null"

通过以上配置，容器启动时将自动完成SSH密钥、AWS凭证和DNS搜索域的配置，可直接用于CI流水线中的后续操作。