集成omnibus-ctl 开发一个专业的软件包管理工具
前边有转发过来自chef 团队的一篇omnibus-ctl 介绍文章，以下尝试进行项目试用
就是简单的集成，没有多少复杂的操作
环境准备
- ruby
ruby 使用2.6.3使用rbenv安装，可以参考rbenv mac&&linux 安装简单说明 - bundle
bundler 的安装可以直接使用gem，其他途径存在版本的问题，安装方法
gem install bundler
- 可选配置gem source
gem source -r https://rubygems.org/
gem source -a https://gems.ruby-china.com/
- 安装omnibus
脚手架模式
gem install omnibus
简单项目集成omnibus-ctl
项目是一个简单的模拟gitlab 的软件包，没有多少操作
- 初始化项目
omnibus new gitlab
- 项目结构
├── Berksfile
├── Gemfile
├── Gemfile.lock
├── README.md
├── config
│ ├── projects
│ │ └── gitlab.rb
│ └── software
│ ├── gitlab-ctl.rb
│ └── preparation.rb
├── files
│ └── gitlab-ctl-commands
│ └── config.rb
├── omnibus.rb
└── package-scripts
└── gitlab
├── postinst
├── postrm
├── preinst
└── prerm
- 说明
以上config/software/gitlab-ctl.rb，files/gitlab-ctl-commands是添加的文件 - 代码说明
Gemfile因为需要集成omnibus-ctl所以需要引用gem 包,我修改了source 为国内的
source 'https://gems.ruby-china.com/'
# Install omnibus
gem 'omnibus', '~> 6.0'
# gem 'omnibus-ctl', '~> 0.6.0'
gem 'omnibus-software', git: 'https://github.com/chef/omnibus-software.git'
# Use Chef's software definitions. It is recommended that you write your own
# software definitions, but you can clone/fork Chef's to get you started.
# gem 'omnibus-software', github: 'chef/omnibus-software'
# This development group is installed by default when you run `bundle install`,
# but if you are using Omnibus in a CI-based infrastructure, you do not need
# the Test Kitchen-based build lab. You can skip these unnecessary dependencies
# by running `bundle install --without development` to speed up build times.
group :development do
# Use Berkshelf for resolving cookbook dependencies
gem 'berkshelf'
# Use Test Kitchen with Vagrant for converging the build environment
gem 'test-kitchen'
gem 'kitchen-vagrant'
end
config/project/gitlab.rb 项目包信息描述，包含依赖以及项目信息
#
# Copyright 2019 YOUR NAME
#
# All Rights Reserved.
#
name "gitlab"
maintainer "rongfengliang"
homepage "https://github.com/rongfengliang"
# Defaults to C:/my on Windows
# and /opt/my on all other platforms
install_dir "#{default_root}/#{name}"
build_version Omnibus::BuildVersion.semver
build_iteration 1
# Creates required build directories
dependency "preparation"
dependency "gitlab-ctl" # 我们需要依赖的soft 定义
# my dependencies/components
# dependency "somedep"
exclude "**/.git"
exclude "**/bundler/git"
config/software/gitlab-ctl.rb 我们的包软件定义：
这个实际上就是对omnibus-ctl 的一个包装
name "gitlab-ctl"
dependency "omnibus-ctl"
source :path => File.expand_path("files/gitlab-ctl-commands", RbConfig::CONFIG['project_root'])
build do
block do
open("#{install_dir}/embedded/bin/gitlab-ctl", "w") do |file|
file.print <<-EOH
#!/bin/bash
# Ruby environment if gitlab-ctl is called from a Ruby script.
for ruby_env_var in RUBYOPT \\
BUNDLE_BIN_PATH \\
BUNDLE_GEMFILE \\
GEM_PATH \\
GEM_HOME
do
unset $ruby_env_var
done
#{install_dir}/embedded/bin/omnibus-ctl gitlab #{install_dir}/embedded/service/omnibus-ctl $@
EOH
end
end
command "chmod 755 #{install_dir}/embedded/bin/gitlab-ctl"
# additional omnibus-ctl commands
sync "#{project_dir}/", "#{install_dir}/embedded/service/omnibus-ctl/"
end
files/gitlab-ctl-commands 自定义命令：
add_command 'config', 'reconfig for gitlab server', 1 do |cmd_name|
puts 'run config'
reconfigure
end
运行&&测试
- 初始化依赖
bundle install --binstubs
- 构建
sudo bin/omnibus build gitlab
- 效果
tree pkg/
pkg/
├── gitlab-0.0.0+20190701053352-1.el7.x86_64.rpm
├── gitlab-0.0.0+20190701053352-1.el7.x86_64.rpm.metadata.json
├── gitlab-0.0.0+20190701062746-1.el7.x86_64.rpm
├── gitlab-0.0.0+20190701062746-1.el7.x86_64.rpm.metadata.json
└── version-manifest.json
- 安装软件包
yum install gitlab-0.0.0+20190701062746-1.el7.x86_64.rpm
已加载插件：fastestmirror
正在检查 gitlab-0.0.0+20190701062746-1.el7.x86_64.rpm: gitlab-0.0.0+20190701062746-1.el7.x86_64
gitlab-0.0.0+20190701062746-1.el7.x86_64.rpm 将被安装
正在解决依赖关系
--> 正在检查事务
---> 软件包 gitlab.x86_64.0.0.0.0+20190701062746-1.el7 将被 安装
--> 解决依赖关系完成
依赖关系解决
===============================================================================================================
Package 架构 版本 源 大小
===============================================================================================================
正在安装:
gitlab x86_64 0.0.0+20190701062746-1.el7 /gitlab-0.0.0+20190701062746-1.el7.x86_64 46 M
事务概要
========================================
- 生成的软件包目录结构
tree -L 3 /opt/gitlab/
/opt/gitlab/
├── bin
├── embedded
│ ├── bin
│ │ ├── bundle
│ │ ├── bundler
│ │ ├── c_rehash
│ │ ├── erb
│ │ ├── gem
│ │ ├── gitlab-ctl
│ │ ├── irb
│ │ ├── libtool
│ │ ├── libtoolize
│ │ ├── makedepend
│ │ ├── omnibus-ctl
│ │ ├── openssl
│ │ ├── pkg-config
│ │ ├── rake
│ │ ├── rdoc
│ │ ├── ri
│ │ ├── ruby
│ │ └── update_rubygems
│ ├── include
│ │ ├── ffi.h
│ │ ├── ffitarget.h
│ │ ├── libltdl
│ │ ├── ltdl.h
│ │ ├── openssl
│ │ ├── ruby-2.6.0
│ │ ├── X11
│ │ ├── yaml.h
│ │ ├── zconf.h
│ │ └── zlib.h
│ ├── lib
│ │ ├── config_guess
│ │ ├── engines
│ │ ├── libcrypto.a
│ │ ├── libcrypto.so -> libcrypto.so.1.0.0
│ │ ├── libcrypto.so.1.0.0
│ │ ├── libffi-3.2.1
│ │ ├── libffi.a
│ │ ├── libffi.la
│ │ ├── libffi.so -> libffi.so.6.0.4
│ │ ├── libffi.so.6 -> libffi.so.6.0.4
│ │ ├── libffi.so.6.0.4
│ │ ├── libltdl.a
│ │ ├── libltdl.la
│ │ ├── libltdl.so -> libltdl.so.7.3.0
│ │ ├── libltdl.so.7 -> libltdl.so.7.3.0
│ │ ├── libltdl.so.7.3.0
│ │ ├── libruby.so -> libruby.so.2.6.3
│ │ ├── libruby.so.2.6 -> libruby.so.2.6.3
│ │ ├── libruby.so.2.6.3
│ │ ├── libssl.a
│ │ ├── libssl.so -> libssl.so.1.0.0
│ │ ├── libssl.so.1.0.0
│ │ ├── libyaml-0.so.2 -> libyaml-0.so.2.0.5
│ │ ├── libyaml-0.so.2.0.5
│ │ ├── libyaml.a
│ │ ├── libyaml.la
│ │ ├── libyaml.so -> libyaml-0.so.2.0.5
│ │ ├── libz.a
│ │ ├── libz.so -> libz.so.1.2.11
│ │ ├── libz.so.1 -> libz.so.1.2.11
│ │ ├── libz.so.1.2.11
│ │ ├── pkgconfig
│ │ └── ruby
│ ├── service
│ │ └── omnibus-ctl
│ ├── share
│ │ ├── aclocal
│ │ ├── doc
│ │ ├── info
│ │ ├── libtool
│ │ ├── man
│ │ ├── pkgconfig
│ │ └── util-macros
│ └── ssl
│ ├── cert.pem -> certs/cacert.pem
│ ├── certs
│ ├── misc
│ └── openssl.cnf
├── LICENSE
├── LICENSES
│ ├── bundler-LICENSE.md
│ ├── cacerts-index.815ca599c9df.txt
│ ├── config_guess-config.guess
│ ├── config_guess-config.sub
│ ├── libffi-LICENSE
│ ├── libtool-COPYING
│ ├── libyaml-LICENSE
│ ├── makedepend-COPYING
│ ├── omnibus-ctl-LICENSE
│ ├── openssl-LICENSE
│ ├── pkg-config-lite-COPYING
│ ├── ruby-BSDL
│ ├── ruby-COPYING
│ ├── rubygems-LICENSE.txt
│ ├── ruby-LEGAL
│ ├── util-macros-COPYING
│ ├── xproto-COPYING
│ └── zlib-README
├── version-manifest.json
└── version-manifest.txt
- 使用gitlab-ctl
因为打包制作的比较简单，配置path 路径我们就可以直接使用gitlab-ctl了
export PATH=$PATH:/opt/gitlab/embedded
使用命令：
gitlab-ctl
I don't know that command.
/opt/gitlab/embedded/bin/omnibus-ctl: command (subcommand)
config
reconfig for gitlab server
General Commands:
cleanse
Delete *all* my data, and start from scratch.
help
Print this help message.
reconfigure
Reconfigure the application.
show-config
Show the configuration that would be generated by reconfigure.
uninstall
Kill all processes and uninstall the process supervisor (data will be preserved).
Service Management Commands:
graceful-kill
Attempt a graceful stop, then SIGKILL the entire process group.
hup
Send the services a HUP.
int
Send the services an INT.
kill
Send the services a KILL.
once
Start the services if they are down. Do not restart them if they stop.
restart
Stop the services if they are running, then start them again.
service-list
List all the services (enabled services appear with a *.)
start
Start services if they are down, and restart them if they stop.
status
Show the status of all the services.
stop
Stop the services, and do not restart them.
tail
Watch the service logs of all enabled services.
term
Send the services a TERM.
- 说明
可以看出我们这样就搞出来了一个和gitlab安装包类似的ctl 了，实际上gitlab 安装包也是集成的omnibus-ctl,只是里面功能更复杂而已。
通过项目omnibus-gitlab 我们可以了解到更多关于omnibus-ctl的用法
参考资料
https://github.com/gitlabhq/omnibus-gitlab
https://blog.chef.io/2015/05/26/omnibus-ctl-what-is-it-and-what-can-it-do-for-you/
https://github.com/rongfengliang/omnibus-ctl-demo
