百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
M

middleman-deploy

> 编程语言
开源

通过 rsync、ftp、stfp 或 git (例如 GitHub 上的 gh-pages)部署中间人构建的站点。

548 stars0 点赞10 次浏览
访问官网GitHub

工具介绍

通过 rsync、ftp、stfp 或 git (例如 GitHub 上的 gh-pages)部署中间人构建的站点。

Middleman Deploy

Deploy your Middleman build via rsync, ftp, sftp, or git (e.g. gh-pages on github).

Installation

ruby
gem 'middleman-deploy', '~> 1.0'

Usage

$ middleman build [--clean]
$ middleman deploy [--build-before]

Possible Configurations

Middleman-deploy can deploy a site via rsync, ftp, sftp, or git. Checkout the wiki for advanced set-up options.

Rsync

Make sure that rsync is installed, and activate the extension by adding the following to config.rb:

ruby
activate :deploy do |deploy|
  deploy.method = :rsync
  deploy.host          = 'www.example.com'
  deploy.path          = '/srv/www/site'
  # Optional Settings
  # deploy.user  = 'tvaughan' # no default
  # deploy.port  = 5309 # ssh port, default: 22
  # deploy.clean = true # remove orphaned files on remote host, default: false
  # deploy.flags = '-rltgoDvzO --no-p --del' # add custom flags, default: -avz
end

Git (e.g. GitHub Pages)

Make sure that git is installed, and activate the extension by adding the following to config.rb:

ruby
activate :deploy do |deploy|
  deploy.method = :git
  # Optional Settings
  # deploy.remote   = 'custom-remote' # remote name or git url, default: origin
  # deploy.branch   = 'custom-branch' # default: gh-pages
  # deploy.strategy = :submodule      # commit strategy: can be :force_push or :submodule, default: :force_push
  # deploy.commit_message = 'custom-message'      # commit message (can be empty), default: Automated commit at `timestamp` by middleman-deploy `version`
end

If you use a remote name, you must first add it using git remote add. Run git remote -v to see a list of possible remote names. If you use a git url, it must end with '.git'.

Afterwards, the build directory will become a git repo.

If you use the force push strategy, this branch will be created on the remote if it doesn't already exist. But if you use the submodule strategy, you must first initialize build folder as a submodule. See git submodule add documentation.

FTP

Activate the extension by adding the following to config.rb:

ruby
activate :deploy do |deploy|
  deploy.method   = :ftp
  deploy.host            = 'ftp.example.com'
  deploy.path            = '/srv/www/site'
  deploy.user            = 'tvaughan'
  deploy.password        = 'secret'
end

SFTP

Activate the extension by adding the following to config.rb:

ruby
activate :deploy do |deploy|
  deploy.method   = :sftp
  deploy.host            = 'sftp.example.com'
  deploy.port            = 22
  deploy.path            = '/srv/www/site'
  # Optional Settings
  # deploy.user     = 'tvaughan' # no default
  # deploy.password = 'secret' # no default
end

Run Automatically

To automatically run middleman build during middleman deploy, turn on the build_before option while activating the deploy extension:

ruby
activate :deploy do |deploy|
  # ...
  deploy.build_before = true # default: false
end

Multiple Environments

Deploy your site to more than one configuration using environment variables.

ruby
# config.rb
case ENV['TARGET'].to_s.downcase
when 'production'
  activate :deploy do |deploy|
    deploy.method   = :rsync
    deploy.host            = 'www.example.com'
    deploy.path            = '/srv/www/production-site'
  end
else
  activate :deploy do |deploy|
    deploy.method   = :rsync
    deploy.host            = 'staging.example.com'
    deploy.path            = '/srv/www/staging-site'
  end
end
ruby
# Rakefile
namespace :deploy do
  def deploy(env)
    puts "Deploying to #{env}"
    system "TARGET=#{env} bundle exec middleman deploy"
  end

  task :staging do
    deploy :staging
  end

  task :production do
    deploy :production
  end
end
$ rake deploy:staging
$ rake deploy:production

Badges

Supported Ruby Versions

This library aims to support and is tested against the following Ruby implementations:

  • Ruby 2.1.0
  • Ruby 2.0.0
  • Ruby 1.9.3
  • JRuby
  • Rubinius

Credits

A BIG thanks to everyone who has contributed! Almost all pull requests are accepted.

Inspiration:

  • The rsync task in Octopress

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言