人形-事実と事実

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