wlijo/concourse-ssh-resource

SSH资源（Concourse CI）

镜像概述

本镜像fork自edtan/concourse-ssh-resource，基于轻量Alpine Linux构建，新增了对hostname和port变量的支持，是Concourse CI的扩展资源，主要用于通过SSH在远程服务器执行命令，满足简单部署场景的自动化需求。

核心功能

• 支持自定义远程服务器的hostname和port参数
• 通过SSH执行指定命令，实现远程部署或脚本运行
• 基于Alpine镜像，资源占用低且启动快速

使用场景

• Concourse CI流水线中需要远程服务器部署应用的场景
• 自动化执行远程服务器脚本或命令的任务
• 轻量级远程操作的CI/CD集成需求

配置说明

1. 安装资源类型

在Concourse pipeline配置的resource_types部分添加：

yaml
---
resource_types:
- name: concourse-ssh-resource
  type: docker-image
  source:
    repository: wlijo/concourse-ssh-resource

2. 资源配置

在resources部分定义SSH资源：

yaml
---
resources:
- name: my-server-ssh
  type: concourse-ssh-resource
  source:
    username: my-username
    private_key: ((ssh-private-key)) # 使用Concourse凭证管理器存储私钥

必填参数：

• username：远程服务器登录用户名
• private_key：SSH私钥（建议通过凭证管理器管理）

3. 执行远程命令（out操作）

在pipeline的plan中使用put动作执行命令：

yaml
plan:
- put: my-server-ssh
  params:
    hostname: my-server.example.com
    port: 22 # 可选，默认22
    command: ./deploy.sh

必填参数：

• hostname：远程服务器地址
• command：需要执行的命令或脚本 可选参数：
• port：SSH端口，默认22

注意事项

• check和in操作目前无实际功能（no-op）
• 私钥需通过Concourse凭证管理器安全存储，避免明文暴露
• 建议设置合理的连接超时和主机密钥检查策略（镜像已默认关闭StrictHostKeyChecking并设置5秒超时）