Seongsiks

Being A DevOpser. Powered by
Obtvse, highlight.js, theme toc Creative Commons License
Seongsiks Twitter Github Email
DevOps Ruby On Rails Chef Projects Misc Movies & Drama ME

Chef Cookbook만들기 #1

Overview

Chef Cookbook

아무리 웹을 돌아다녀도 chef의 cookbook 작성법에 대해서는 좀.. 설명이 자세히 나온 곳이 없어서 제가 만든 java 설치 cookbook작성한것을 공유합니다.

cookbook 제약사항

  • java는 root계정으로 설치하나 public하게 사용할 수 있어야한다.
  • openjdk가 아닌 oracle jdk를 설치한다.(사내에 미러 서버가 있음.)
  • 설치 경로는 /home/server/java로 soft link를 걸어서 사용한다.

java cookbook구하기

knife 명령으로 java cookbook구하기

$ knife cookbook site download java

github에서 구하기

[opscode public cookbook repo]에서 java cookbook을 clone해 사용하거나, [opscode community site]에 가서 다운 받으면 됩니다.

recipe::oracle

다운로드 속도를 향상 시키고 항상 같은(어차피 되지만 혹시 모르니) tar를 가져다가 설치하기 위해서 이 recipe를 변경 하려고 합니다. 먼저 java/recipe/oracle.rb를 살펴 보도록 하겠습니다. 실제로 여기서 고쳐야 할것은 별로 없습니다.

#
# Author:: Bryan W. Berry (<bryan.berry@gmail.com>)
# Cookbook Name:: java
# Recipe:: oracle
#
# Copyright 2011, Bryan w. Berry
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.


java_home = node['java']["java_home"]
arch = node['java']['arch']
jdk_version = node['java']['jdk_version']

#convert version number to a string if it isn't already
if jdk_version.instance_of? Fixnum
  jdk_version = jdk_version.to_s
end

case jdk_version
when "6"
  tarball_url = node['java']['jdk']['6'][arch]['url']
  tarball_checksum = node['java']['jdk']['6'][arch]['checksum']
  bin_cmds = node['java']['jdk']['6']['bin_cmds']
when "7"
  tarball_url = node['java']['jdk']['7'][arch]['url']
  tarball_checksum = node['java']['jdk']['7'][arch]['checksum']
  bin_cmds = node['java']['jdk']['7']['bin_cmds']
end

if tarball_url =~ /example.com/
  Chef::Application.fatal!("You must change the download link to your private repository. You can no longer download java directly from http://download.oracle.com without a web broswer")
end

ruby_block  "set-env-java-home" do
  block do
    ENV["JAVA_HOME"] = java_home
  end
  not_if { ENV["JAVA_HOME"] == java_home }
end

file "/etc/profile.d/jdk.sh" do
  content <<-EOS
    export JAVA_HOME=#{node['java']['java_home']}
  EOS
  mode 0755
end

java_ark "jdk" do
  url tarball_url
  checksum tarball_checksum
  app_home java_home
  bin_cmds bin_cmds
  alternatives_priority 1062
  action :install
end

Attributes

Recipe를 살펴보다보면 ruby의 해시를 많이 사용하고 있는것을 확인할 수 있습니다. 거의 어떤 설정 값들을 가져올 때 사용하고 있네요.

java_home = node['java']["java_home"]
arch = node['java']['arch']
jdk_version = node['java']['jdk_version']

위 코드처럼 node라는 해시에서 java라는 propertie를 읽어와 java_home이나 어떤 아카이브를 사용하는지 어떤 버전의 java를 사용하는 지 같은 각종 설정들을 할당하고 있는데요.. 도대체 이것들은 어디에 정의 되어 있을까요? 바로 java/attributes/default.rb에 정의 되어 있습니다. 살짝 파일을 들여다 볼까요?

# default jdk attributes
default['java']['install_flavor'] = "openjdk"
default['java']['jdk_version'] = '6'
default['java']['arch'] = kernel['machine'] =~ /x86_64/ ? "x86_64" : "i586"

case platform
when "centos","redhat","fedora","scientific","amazon","oracle"
  default['java']['java_home'] = "/usr/lib/jvm/java"
when "freebsd"
  default['java']['java_home'] = "/usr/local/openjdk#{java['jdk_version']}"
when "arch"
  default['java']['java_home'] = "/usr/lib/jvm/java-#{java['jdk_version']}-openjdk"
when "windows"
  default['java']['install_flavor'] = "windows"
  default['java']['windows']['url'] = nil
  default['java']['windows']['package_name'] = "Java(TM) SE Development Kit 7 (64-bit)"
else
  default['java']['java_home'] = "/usr/lib/jvm/default-java"
end

이렇게 os에 따라서 어떤 설정값이 들어갈 것인가 뭐 그런 설정들을 선언하고 있습니다. 여기서 눈치빠른 분들은 이상한것을 느끼실겁니다.

recipe에서는 node라는 해시를 참조했는데 여기에는 default밖에 없자나?!

네 맞습니다. node는 없습니다. attribute에는 우선순위가 있어서 서로를 override하는 구조를 가지고 있습니다.

chef attribute layer

위 그림과 같이 cookbook에 들어있는 것은 default이고 이 값들은 Nomal이나 Overrides계층의 attributes로 덮어 버릴 수 있습니다. 이런 계층은 선언하는 위치에 따라서 취할 수 있는 계층이 달라집니다.

chef attribute type

cookbook에서는 세가지 모두 선언 가능하고 Role에서는 default나 overrides만 Node에서는 Normal만 가능합니다. 이미지에 오타가 있네요?? 수정하기 귀찮으니 패스!

ruby block

ruby_block  "set-env-java-home" do
  block do
    ENV["JAVA_HOME"] = java_home
  end
  not_if { ENV["JAVA_HOME"] == java_home }
end

위 코드와 같이 rubyblock이라는 키워는 chef에서 resource라고 부릅니다. 기본적으로 recipe는 chef server에서 실행됩니다. 그러나 이렇게 rubyblock으로 감싸아 주면 해당 코드는 remote node에서 실행됩니다. 자세한 설명을 보려면 [여기]

file

이 파일도 resource중에 한 종류입니다.

file "/etc/profile.d/jdk.sh" do
  content <<-EOS
    export JAVA_HOME=#{node['java']['java_home']}
  EOS
  mode 0755
end

직관적이죠? /etc/profile.d/jdk.sh라는 파일을 755접근권한을 만들고 JAVA_HOME 환경 변수를 설정합니다.

java_ark

java_ark "jdk" do
  url tarball_url
  checksum tarball_checksum
  app_home java_home
  bin_cmds bin_cmds
  alternatives_priority 1062
  action :install
end

이 부분이 어쩌면 가장 중요한 부분인데요. java_ark라는 이 자바 Cookbook에서만 사용하는 Custom Resource라고 생각하시면 됩니다. 이는 여러가지 파라미터를 받는데 java를 다운 받을 경로라든가 자바 홈이라던가 executable이 어디 있는 지 같은것들이죠. 이 resource는 .chef / chef-repo / cookbooks / java / resources / ark.rb에 정의 되어 있습니다 .

#
# Author:: Bryan W. Berry (<bryan.berry@gmail.com>)
# Cookbook Name:: java
# Resource:: ark
#
# Copyright 2011, Bryan w. Berry
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

actions :install, :remove

attribute :url, :regex => /^https:\/\/.*(tar.gz|bin|zip)$/, :default => nil
attribute :mirrorlist, :kind_of => Array, :default => nil
attribute :checksum, :regex => /^[a-zA-Z0-9]{64}$/, :default => nil
attribute :app_home, :kind_of => String, :default => nil
attribute :app_home_mode, :kind_of => Integer, :default => 0755
attribute :bin_cmds, :kind_of => Array, :default => nil
attribute :owner, :default => "root"
attribute :default, :equal_to => [true, false], :default => true

# we have to set default for the supports attribute
# in initializer since it is a 'reserved' attribute name
def initialize(*args)
  super
  @action = :install
  @supports = {:report => true, :exception => true}
end

실제로 여기까지는 opscode에서 다운받은 cookbook에서 수정한게 없습니다. resource파일을 자세히 보면 action에 "install"이 있습니다. 그런데 아직까지 이 install을 어떻게 실제로 어떤 작업을 포함하는지 아직 살펴 보질 못했죠? 이런 것들은 providers에 있습니다. 경로는 .chef / chef-repo / cookbooks / java / providers / ark.rb 이부분은 중요한 부분이니 다음 다음 포스트에서 ^^

comments powered by Disqus
Back to Chef