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

mitamae

> 编程语言
开源

mitamae 是一款快速、简单、单二进制的配置管理工具,类似 Chef。

391 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

mitamae 是一款快速、简单、单二进制的配置管理工具,类似 Chef。

:sushi: mitamae

mitamae is a tool to automate configuration management using a Chef-like DSL powered by mruby.

It's been used for provisioning servers, e.g. RubyCI servers and Ruby's git server, and setting up local environments with dotfiles.

Key Features

  • Fast - mitamae is optimized for local execution. It uses C functions via mruby libraries for core operations where possible, instead of executing commands on a shell or over a SSH connection like other tools, which is very slow.

  • Simple - Running mitamae doesn't require Chef Server, Berkshelf, Data Bags, or even RubyGems. The mitamae core provides only essential features. You can quickly be a master of mitamae.

  • Single Binary - mitamae can be deployed by just transferring a single binary to servers. You don't need to rely on slow operations over a SSH connection to workaround deployment problems.

Installation

Download a binary for your platform from GitHub Releases.

bash
curl -O -L https://github.com/itamae-kitchen/mitamae/releases/latest/download/mitamae-x86_64-linux
chmod +x ./mitamae-x86_64-linux
./mitamae-x86_64-linux help

Getting Started

Create a recipe file as recipe.rb:

rb
package 'nginx' do
  action :install
end

service 'nginx' do
  action [:enable, :start]
end

And then execute mitamae local command to apply a recipe to a local machine.

diff
$ mv mitamae-x86_64-linux mitamae
$ ./mitamae local recipe.rb
 INFO : Starting mitamae...
 INFO : Recipe: /home/user/recipe.rb
 INFO :   package[nginx] installed will change from 'false' to 'true'
 INFO :   service[nginx] enabled will change from 'false' to 'true'
 INFO :   service[nginx] running will change from 'false' to 'true'

See mitamae help local for available options. --log-level=debug is helpful to inspect what's executed in detail.

Documentation

mitamae was built as an alternative implementation of Itamae. Therefore you may refer to resources related to Itamae for mitamae as well.

How to write recipes

Please refer to Itamae wiki:

  • Resources
    • directory resource
    • execute resource
    • file resource
    • gem_package resource
    • git resource
    • group resource
    • http_request resource
    • link resource
    • local_ruby_block resource
    • package resource
    • remote_directory resource
    • remote_file resource
    • service resource
    • template resource
    • user resource
  • Definitions
  • Including Recipes
  • Node Attributes
  • run_command
  • Host Inventory

mitamae's original features

They should be ported to Itamae at some point.

  • not_if / only_if can take a block instead of a command
  • file, remote_file, and template resources have atomic_update attribute
  • run_command streams log output with --log-level debug or log_output: true option.

Plugins

Please see PLUGINS.md for how to install or create plugins for mitamae.

Find mitamae plugins and Itamae plugins supporting mitamae on GitHub.

mruby features

The DSL is based on mruby instead of standard Ruby unlike Chef and Itamae. You may use the following mruby features in mitamae recipes.

  • mruby's built-in features
    • Some features may not be available if not specified or used by mrbgem.rake dependencies.
    • Check MRUBY_VERSION used by mitamae and Latest News on mruby.org.
  • mruby-at_exit
  • mruby-dir-glob
  • mruby-dir
  • mruby-env
  • mruby-erb
  • mruby-etc
  • mruby-file-stat
  • mruby-hashie
  • mruby-json
  • mruby-open3
  • mruby-shellwords
  • mruby-tempfile
  • mruby-uri
  • mruby-yaml

Supported platforms

  • See Releases for supported architectures.
  • All operating systems supported by Serverspec are supported since they share their underlying library, Specinfra.
    • See CHANGELOG or mruby-specinfra to find what Specinfra version is used.

Running mitamae on servers

When you want to use mitamae on remote servers, you need to distribute a mitamae binary and recipes to the servers and run them remotely. There are at least the following ways to do it:

  • rsync and ssh - It's handy to send them using rsync and run them using ssh when you apply recipes to a few servers. hocho is a convenient tool to do this. While it's over a SSH connection, it's much faster than other tools which establish a SSH connection for each operation like itamae ssh.
  • deployment tool - A more scalable way is to install an agent to each server and notify the agents to fetch mitamae and recipes from an object storage and run them. Deployment tools like AWS CodeDeploy are useful to achieve them.

Example recipes

The following recipes are open-source usages of mitamae.

  • ruby/ruby-infra-recipe
  • ruby/git.ruby-lang.org
  • k0kubun/dotfiles

Migrating from Chef

While the DSL is inspired by Chef, there are some differences you need to keep in mind when you migrate Chef recipes to mitamae recipes.

Chef mitamae
cookbook_file Use remote_file or template, specifying a path with source.
directory's recursive true directory is recursive true by default
ruby_block Use local_ruby_block.
shell_out! Use run_command. Open3.capture3 or system might suffice too.
Chef::Log.* MItamae.logger.*
Digest::*.hexdigest Use *sum command (e.g. sha1sum) as a workaround.
bash Just use execute or specify bash -c ... with it.
mitamae's --shell=/bin/bash might also help.
cron You may use mitamae-plugin-resource-cron.
deploy_revision You may use mitamae-plugin-resource-deploy_revision.
See also: mitamae-plugin-resource-deploy_directory
runit_service You may use mitamae-plugin-resource-runit_service.

Change Log

See CHANGELOG.md.

Contributing

When you develop your local changes, you can write an integration test under spec/ and run it like:

bundle install
bundle exec rake test:integration

This requires Docker on your local environment.

License

MIT License

Issues· 0 开放

查看全部 Issues在 GitHub 打开

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

> 标签

Rubyinfrastructure-as-coderuby

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

> 工具信息

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

> 相关工具

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