aecepoglu/concourse-ssh-deploy

concourse-ssh-deploy

http://hub.docker.com/r/aecepoglu/concourse-ssh-deploy

镜像概述

这是一个Concourse资源镜像，用于通过SSH连接远程主机，自动化将Docker镜像部署到目标服务器，适用于CI/CD流水线场景。

核心功能

• 作为Concourse资源类型，实现远程SSH主机的Docker镜像部署
• 支持端口映射、卷映射、环境变量等部署参数配置
• 可生成包含部署服务URL的信息文件，便于流水线后续步骤使用

使用场景

适用于Concourse CI/CD流水线中，将构建完成的Docker镜像自动部署到远程服务器的场景，例如Web应用、后端服务的持续部署。

配置说明

源配置（Source Configuration）

• private_key: 登录远程主机所需的SSH私钥（必填）

行为（Behaviour）

• Check: 无操作
• In: 无操作
• Out（部署参数）:
  • user: SSH用户名（必填）
  • host: SSH主机地址（必填）
  • from_image: 待部署的Docker镜像（必填）
  • port_mapping: 端口映射，格式同docker run（可选，例如：["80", "3001:4003"]）
  • volume_mapping: 卷映射，格式同docker run（可选，例如：["/host/directory:/container/directory"]）
  • build_url_for_port: 若指定端口，生成http://{host}:{port}格式的URL并写入info/url文件（可选）
  • env: 环境变量（可选，例如：{PORT: 3000, MONGO_URL: mongodb://192.168.2.101}）

示例（Concourse流水线配置）

以下流水线示例实现拉取代码、构建镜像、推送至registry并部署到远程主机：

yaml
resource_types:
- name: ssh-deploy-target
  type: docker-image
  source:
    repository: aecepoglu/concourse-ssh-deploy

resources:
- name: ssh-target
  type: ssh-deploy-target
  source:
    private_key: {{private_key}}

jobs:
- name: build-and-deploy
  plan:
  - put: ssh-target
    params:
      user: user123
      host: 192.168.2.100
      port_mapping: ["80", "3001:3000"]
      from_image: dockercloud/hello-world
      build_url_for_port: 80
  - task: "查看构建信息"
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: busybox, tag: "1.25"}
      inputs:
      - name: ssh-target
      run:
        path: sh
        args:
        - -exc
        - |
          ls ssh-target
          ls ssh-target/info
          cat ssh-target/info/url

查看构建信息任务的输出：

+ ls ssh-target
info
+ ls ssh-target/info
url
+ cat ssh-target/info/url
[***]