kroniak/ssh-client

alpine-ssh-client

镜像概述和主要用途

alpine-ssh-client是一个基于Alpine Linux的轻量级Docker镜像，集成了ssh-client（包含scp、ssh等工具）和bash shell。该镜像旨在提供一个简洁、高效的环境，用于需要SSH客户端功能的场景，如CI/CD流程中的远程服务器部署、自动化脚本执行、临时SSH连接等。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 完整SSH工具链：包含ssh-client，支持ssh、scp等远程连接和文件传输命令
• Bash支持：集成bash shell，提供比默认sh更丰富的交互和脚本功能
• 多版本支持：提供多个Alpine版本标签，满足不同环境需求

使用场景和适用范围

• GitLab CI/CD、Jenkins等CI/CD平台中的远程服务器部署流程
• 需要临时SSH客户端环境的开发或运维工作
• 自动化脚本中与远程服务器的文件传输和命令执行
• 容器化环境中需要SSH功能的轻量级集成

详细使用方法和配置说明

在GitLab CI中使用

以下是在GitLab CI流程中使用该镜像进行远程部署的示例：

yaml
deploy_staging:
  stage: deploy
  image: kroniak/ssh-client  # 使用本镜像
  environment:
    name: staging
    url: https://sample-app.net
  script:
    # 创建.ssh目录并设置权限
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh
    # 配置SSH，禁用严格主机密钥检查（避免首次连接确认）
    - echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config
    # 将CI变量中的SSH私钥写入文件并设置权限
    - echo "$SSH_PRIVATE_KEY_STAGING" > ~/.ssh/id_rsa
    - chmod 600 ~/.ssh/id_rsa  # SSH私钥必须设置为600权限
    # 使用scp传输部署文件到远程服务器
    - scp -r deploy/app_staging/. $DEPLOY_STAGING_SSH_HOST:~/app
    - scp -r src/project/conf/. $DEPLOY_STAGING_SSH_HOST:~/app/conf
    # 通过ssh在远程服务器执行命令
    - ssh $DEPLOY_STAGING_SSH_HOST 'chmod 700 ~/app/app.sh'  # 设置脚本可执行权限
    - ssh $DEPLOY_STAGING_SSH_HOST 'cd ~/app && ./app.sh --file docker-compose-staging.yml up'  # 启动服务
    - ssh $DEPLOY_STAGING_SSH_HOST 'cd ~/app && ./app.sh --file docker-compose-staging.yml update'  # 更新服务
  only:
    - dev  # 仅在dev分支触发

在Docker中直接使用

通过以下命令可直接启动容器并进入bash交互环境：

bash
docker run -it --rm kroniak/ssh-client bash

• -it：启用交互式终端
• --rm：容器退出后自动删除，避免残留
• bash：启动bash shell

支持的标签和Dockerfile链接

• 3.18：3.18/Dockerfile
• 3.19：3.19/Dockerfile
• 3.20：3.20/Dockerfile
• 3.21、latest：3.21/Dockerfile（latest标签默认指向最新稳定版3.21）