人形-事実と事実
Puppetは、環境変数として複数の値を保持することをサポートしています。この機能は、Puppetで次を使用してサポートされていますfacter。Puppetでは、facterは環境レベル変数を保持するスタンドアロンツールです。Inは、BashまたはLinuxのenv変数に類似していると見なすことができます。ファクトに格納されている情報とマシンの環境変数が重複している場合があります。Puppetでは、キーと値のペアは「ファクト」と呼ばれます。各リソースには独自のファクトがあり、Puppetではユーザーは独自のカスタムファクトを構築するためのレバレッジを持っています。
# facter
Facter commandさまざまな環境変数とそれに関連する値をすべて一覧表示するために使用できます。これらのファクトのコレクションには、すぐに使用できるファクトが付属しており、コアファクトと呼ばれます。コレクションにカスタムファクトを追加できます。
1つの変数のみを表示したい場合。次のコマンドを使用して実行できます。
# facter {Variable Name}
Example
[root@puppetmaster ~]# facter virtual
virtualbox
ファクトがPuppetにとって重要である理由は、ファクトとファクトがPuppetコード全体で次のように利用できるためです。 “global variable”、つまり、他の参照なしでいつでもコードで使用できます。
テストする例
[root@puppetmaster modules]# tree brcle_account
brcle_account
└── manifests └── init.pp [root@puppetmaster modules]# cat brcle_account/manifests/init.pp
class brcle_account {
user { 'G01063908':
ensure => 'present',
uid => '121',
shell => '/bin/bash',
home => '/home/G01063908',
}
file {'/tmp/userfile.txt':
ensure => file,
content => "the value for the 'OperatingSystem' fact is: $OperatingSystem \n",
}
}
それをテストする
[root@puppetmaster modules]# puppet agent --test
Notice: /Stage[main]/Activemq::Service/Service[activemq]/ensure:
ensure changed 'stopped' to 'running'
Info: /Stage[main]/Activemq::Service/Service[activemq]:
Unscheduling refresh on Service[activemq]
Notice: Finished catalog run in 4.09 seconds
[root@puppetmaster modules]# cat /tmp/testfile.txt
the value for the 'OperatingSystem' fact is: Linux
[root@puppetmaster modules]# facter OperatingSystem
Linux
上記のコードスニペットでわかるように、定義していません OperatingSystem。値をソフトコード化された値に置き換えました$OperatingSystem 正規変数として。
Puppetには、使用および定義できる3つのタイプのファクトがあります-
- コアファクト
- カスタムファクト
- 外部の事実
コアファクトはトップレベルで定義され、コードの任意の時点ですべての人がアクセスできます。
人形の事実
エージェントがマスターにカタログを要求する直前に、エージェントはまず、キーと値のペアの形式で、それ自体で利用可能な情報の完全なリストをコンパイルします。エージェントに関する情報は、facterと呼ばれるツールによって収集され、各キーと値のペアはファクトと呼ばれます。以下は、エージェントに関する事実の一般的な出力です。
[root@puppetagent1 ~]# facter
architecture => x86_64
augeasversion => 1.0.0
bios_release_date => 13/09/2012
bios_vendor => innotek GmbH
bios_version => VirtualBox
blockdevice_sda_model => VBOX HARDDISK
blockdevice_sda_size => 22020587520
blockdevice_sda_vendor => ATA
blockdevice_sr0_model => CD-ROM
blockdevice_sr0_size => 1073741312
blockdevice_sr0_vendor => VBOX
blockdevices => sda,sr0
boardmanufacturer => Oracle Corporation
boardproductname => VirtualBox
boardserialnumber => 0
domain => codingbee.dyndns.org
facterversion => 2.1.0
filesystems => ext4,iso9660
fqdn => puppetagent1.codingbee.dyndns.org
hardwareisa => x86_64
hardwaremodel => x86_64
hostname => puppetagent1
id => root
interfaces => eth0,lo
ipaddress => 172.228.24.01
ipaddress_eth0 => 172.228.24.01
ipaddress_lo => 127.0.0.1
is_virtual => true
kernel => Linux
kernelmajversion => 2.6
kernelrelease => 2.6.32-431.23.3.el6.x86_64
kernelversion => 2.6.32
lsbdistcodename => Final
lsbdistdescription => CentOS release 6.5 (Final)
lsbdistid => CentOS
lsbdistrelease => 6.5
lsbmajdistrelease => 6
lsbrelease => :base-4.0-amd64:base-4.0-noarch:core-4.0-amd64:core-4.0noarch:graphics-4.0-amd64:
graphics-4.0-noarch:printing-4.0-amd64:printing-4.0noarch
macaddress => 05:00:22:47:H9:77
macaddress_eth0 => 05:00:22:47:H9:77
manufacturer => innotek GmbH
memoryfree => 125.86 GB
memoryfree_mb => 805.86
memorysize => 500 GB
memorysize_mb => 996.14
mtu_eth0 => 1500
mtu_lo => 16436
netmask => 255.255.255.0
netmask_eth0 => 255.255.255.0
network_lo => 127.0.0.0
operatingsystem => CentOS
operatingsystemmajrelease => 6
operatingsystemrelease => 6.5
osfamily => RedHat
partitions => {"sda1"=>{
"uuid"=>"d74a4fa8-0883-4873-8db0-b09d91e2ee8d", "size" =>"1024000",
"mount" => "/boot", "filesystem" => "ext4"}, "sda2"=>{"size" => "41981952",
"filesystem" => "LVM2_member"}
}
path => /usr/lib64/qt3.3/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
physicalprocessorcount => 1
processor0 => Intel(R) Core(TM) i7 CPU 920 @ 2.67GHz
processor1 => Intel(R) Core(TM) i7 CPU 920 @ 2.67GHz
processor2 => Intel(R) Core(TM) i7 CPU 920 @ 2.67GHz
processorcount => 3
productname => VirtualBox
ps => ps -ef
puppetversion => 3.6.2
rubysitedir => /usr/lib/ruby/site_ruby/1.8
rubyversion => 1.8.7
selinux => true
selinux_config_mode => enforcing
selinux_config_policy => targeted
selinux_current_mode => enforcing
selinux_enforced => true
selinux_policyversion => 24
serialnumber => 0
sshdsakey => AAAAB3NzaC1kc3MAAACBAK5fYwRM3UtOs8zBCtRTjuHLw56p94X/E0UZBZwFR3q7
WH0x5+MNsjfmdCxKvpY/WlIIUcFJzvlfjXm4qDaTYalbzSZJMT266njNbw5WwLJcJ74KdW92ds76pjgm
CsjAh+R9YnyKCEE35GsYjGH7whw0gl/rZVrjvWYKQDOmJA2dAAAAFQCoYABgjpv3EkTWgjLIMnxA0Gfud
QAAAIBM4U6/nerfn6Qvt43FC2iybvwVo8ufixJl5YSEhs92uzsW6jiw68aaZ32q095/gEqYzeF7a2knr
OpASgO9xXqStYKg8ExWQVaVGFTR1NwqhZvz0oRSbrN3h3tHgknoKETRAg/imZQ2P6tppAoQZ8wpuLrXU
CyhgJGZ04Phv8hinAAAAIBN4xaycuK0mdH/YdcgcLiSn8cjgtiETVzDYa+jF
swapfree => 3.55 GB
swapfree_mb => 2015.99
swapsize => 3.55 GB
swapsize_mb => 2015.99
timezone => GMT
type => Other
uniqueid => a8c0af01
uptime => 45:012 hours
uptime_days => 0
uptime_hours => 6
uptime_seconds => 21865
uuid => BD8B9D85-1BFD-4015-A633-BF71D9A6A741
virtual => virtualbox
上記のコードでは、データの一部がbashの「env」変数で利用可能な情報の一部と重複していることがわかります。Puppetはデータを直接使用せず、代わりにファクトデータを使用します。ファクトデータはグローバル変数として扱われます。
その後、ファクトはトップレベル変数として利用可能になり、Puppetマスターはそれらを使用して、要求元のエージェントのPuppetカタログをコンパイルできます。ファクトは、マニフェストで$プレフィックス付きの正規変数として呼び出されます。
例
if ($OperatingSystem == "Linux") {
$message = "This machine OS is of the type $OperatingSystem \n"
} else {
$message = "This machine is unknown \n"
}
file { "/tmp/machineOperatingSystem.txt":
ensure => file,
content => "$message"
}
上記のマニフェストファイルは、と呼ばれる単一のファイルについてのみ気にします machineOperatingSystem.txt、このファイルの内容は、と呼ばれる事実によって差し引かれます OperatingSystem。
[root@puppetagent1 /]# facter OperatingSystem
Linux
[root@puppetagent1 /]# puppet apply /tmp/ostype.pp
Notice: Compiled catalog for puppetagent1.codingbee.dyndns.org
in environment production in 0.07 seconds
Notice: /Stage[main]/Main/File[/tmp/machineOperatingSystem.txt]/ensure:
defined content as '{md5}f59dc5797d5402b1122c28c6da54d073'
Notice: Finished catalog run in 0.04 seconds
[root@puppetagent1 /]# cat /tmp/machinetype.txt
This machine OS is of the type Linux
カスタムファクト
私たちが見た上記のすべての事実は、マシンのコアファクトです。このカスタムファクトを次の方法でノードに追加できます-
- 「exportFACTER…構文」の使用
- $ LOAD_PATH設定の使用
- FACTERLIB
- Pluginsync
「exportFACTER」構文の使用
export FACTER_ {fact's name}構文を使用して、ファクトを手動で追加できます。
例
[root@puppetagent1 facter]# export FACTER_tallest_mountain="Everest"
[root@puppetagent1 facter]# facter tallest_mountain Everest
$ LOAD_PATH設定の使用
Rubyでは、$ LOAD_PATHはBashの特別なパラメーターと同等です。これはbashの$ PATH変数に似ていますが、実際には$ LOAD_PATHは環境変数ではなく、事前定義された変数です。
$ LOAD_PATHの同義語は「$:」です。この変数は、値を検索してロードするための配列です。
[root@puppetagent1 ~]# ruby -e 'puts $LOAD_PATH'
# note you have to use single quotes.
/usr/lib/ruby/site_ruby/1.6
/usr/lib64/ruby/site_ruby/1.6
/usr/lib64/ruby/site_ruby/1.6/x86_64-linux
/usr/lib/ruby/site_ruby
/usr/lib64/ruby/site_ruby
/usr/lib64/site_ruby/1.6
/usr/lib64/site_ruby/1.6/x86_64-linux
/usr/lib64/site_ruby
/usr/lib/ruby/1.6
/usr/lib64/ruby/1.6
/usr/lib64/ruby/1.6/x86_64-linux
ディレクトリファクトを作成して追加する例を見てみましょう。 .pp ファイルとそれにコンテンツを追加します。
[root@puppetagent1 ~]# cd /usr/lib/ruby/site_ruby/
[root@puppetagent1 site_ruby]# mkdir facter
[root@puppetagent1 site_ruby]# cd facter/
[root@puppetagent1 facter]# ls
[root@puppetagent1 facter]# touch newadded_facts.rb
次のコンテンツをcustom_facts.rbファイルに追加します。
[root@puppetagent1 facter]# cat newadded_facts.rb
Facter.add('tallest_mountain') do
setcode "echo Everest"
end
Facterは、$ LOAD_PATHにリストされているすべてのフォルダーをスキャンする方法で機能し、facterと呼ばれるディレクターを探します。その特定のフォルダが見つかると、フォルダ構造内の任意の場所にそれらをロードします。このフォルダーが見つかると、そのファクトフォルダー内のRubyファイルを検索し、メモリ内の特定の構成について定義されているすべてのファクトをロードします。
FACTERLIBの使用
Puppetでは、FACTERLIBは$ LOAD_PATHと非常によく似ていますが、重要な違いが1つだけあります。それは、Rubyの特殊変数ではなくOSレベルの環境パラメーターです。デフォルトでは、環境変数は設定されていない可能性があります。
[root@puppetagent1 facter]# env | grep "FACTERLIB"
[root@puppetagent1 facter]#
FACTERLIBをテストするには、次の手順を実行する必要があります。
次の構造でtest_factsというフォルダーを作成します。
[root@puppetagent1 tmp]# tree /tmp/test_facts/
/tmp/some_facts/
├── vipin
│ └── longest_river.rb
└── testing
└── longest_wall.rb
次の内容を.rbファイルに追加します。
[root@puppetagent1 vipin]# cat longest_river.rb
Facter.add('longest_river') do
setcode "echo Nile"
end
[root@puppetagent1 testing]# cat longest_wall.rb
Facter.add('longest_wall') do
setcode "echo 'China Wall'"
end
exportステートメントを使用します。
[root@puppetagent1 /]# export
FACTERLIB = "/tmp/some_facts/river:/tmp/some_facts/wall"
[root@puppetagent1 /]# env | grep "FACTERLIB"
FACTERLIB = /tmp/some_facts/river:/tmp/some_facts/wall
新しいファクターをテストします。
[root@puppetagent1 /]# facter longest_river
Nile
[root@puppetagent1 /]# facter longest_wall
China Wall
外部の事実
外部ファクトは、ユーザーがプロビジョニング時に作成されたいくつかの新しいファクトを適用したい場合に非常に役立ちます。外部ファクトは、プロビジョニング段階でVMにメタデータを適用する重要な方法の1つです(vSphere、OpenStack、AWSなどを使用)。
作成されたすべてのメタデータとその詳細をPuppetで使用して、適用されるカタログにどの詳細を含めるかを決定できます。
外部ファクトの作成
エージェントマシンでは、以下のようにディレクトリを作成する必要があります。
$ mkdir -p /etc/facter/facts.d
次の内容のディレクトリにシェルスクリプトを作成します。
$ ls -l /etc/facter/facts.d
total 4
-rwxrwxrwx. 1 root root 65 Sep 18 13:11 external-factstest.sh
$ cat /etc/facter/facts.d/external-factstest.sh
#!/bin/bash
echo "hostgroup = dev"
echo "environment = development"
スクリプトファイルの権限を変更します。
$ chmod u+x /etc/facter/facts.d/external-facts.sh
完了すると、キーと値のペアに存在する変数を確認できます。
$ facter hostgroup
dev
$ facter environment
development
Puppetでカスタムファクトを書くことができます。参考までに、Puppetサイトから次のリンクを使用してください。
https://docs.puppet.com/facter/latest/fact_overview.html#writing-structured-facts