Puppet4.xではじめるサーバ設定自動化の、実行編です。
全体的な目次は、ここを参照してください。

実行コマンド

スタンドアローンで実行する方法を紹介します。

実行で反映させる定義（マニフェスト）を、用意します。カレントディレクトリに下記の、sample.ppをエディタで編集してつくります。今回は/tmpディレクトリに、hello_puppet.txtを作るマニフェストです。

sample.pp

file { "/tmp/hello_puppet.txt":
  content => "Hello Puppet!\n",
}

実行する

puppetのマニフェストをスタンドアローンで実行する場合、applyを使います。

/opt/puppetlabs/bin/puppet apply <反映するマニフェストファイル>

先ほどのマニフェストで実行してみます。※もし、すでに/tmp/hello_puppet.txtがある場合は、事前に移動させておいてください。

# /opt/puppetlabs/bin/puppet apply sample.pp
Notice: Compiled catalog for 8fd260a416a1 in environment production in 0.03 seconds
Notice: /Stage[main]/Main/File[/tmp/hello_puppet.txt]/ensure: defined content as '{md5}65a0b93ae3ce3b139b50be784e4d286e'
Notice: Applied catalog in 0.03 seconds

# cat /tmp/hello_puppet.txt
Hello Puppet!

よく使うオプション

applyでよく使うオプションの紹介です。

--noop: Puppetをno-opモード(dry-runモード)で実行するオプション。実際に変更せずに、Puppetで何が変わるかを、事前に確認するときに便利です。
--test: 下記のオプションがつきます。-tでも同じです。
- verbose: より多くの情報を表示
- detailed-exitcodes: リータンコードが詳細になります。
  - 0: puppet実行成功。サーバへの変更なし、マニフェストのエラーなし。
  - 1: puppet実行失敗。
  - 2: puppet実行成功。サーバへの変更あり。
  - 4: puppet実行成功。サーバへの変更で失敗。
  - 6: puppet実行成功。サーバへの変更あり。一部変更に失敗。
- show_diff: テストファイル内の変更diffを表示
--modulepath: moduleを使う場合のパス指定。Puppetでは、共通的な部品を、クラスで定義できます。そのクラスを使う場合にパスを指定します。

noop

noopオプションの例です。
先ほどのマニフェストで実行してみます。※もし、すでに/tmp/hello_puppet.txtがある場合は、事前に移動させておいてください。

実際には変更されていないので、ログに(noop)がでます。

# /opt/puppetlabs/bin/puppet apply sample.pp --noop
Notice: Compiled catalog for 8fd260a416a1 in environment production in 0.03 seconds
Notice: /Stage[main]/Main/File[/tmp/hello_puppet.txt]/ensure: current_value absent, should be file (noop)
Notice: Class[Main]: Would have triggered 'refresh' from 1 events
Notice: Stage[main]: Would have triggered 'refresh' from 1 events
Notice: Applied catalog in 0.02 seconds

# cat /tmp/hello_puppet.txt
cat: /tmp/hello_puppet.txt: No such file or directory

test

testオプションの例です。
先ほどのマニフェストで実行してみます。※もし、すでに/tmp/hello_puppet.txtがある場合は、事前に移動させておいてください。

※今回は、差分でるか確認するためなので、一緒にnoopオプションもつけていますが、testオプションだけでも実行できます。

テキストファイルがない場合は、テキストの中身の差分は表示されません。

# /opt/puppetlabs/bin/puppet apply sample.pp -t --noop
Notice: Compiled catalog for 8fd260a416a1 in environment production in 0.03 seconds
Info: Applying configuration version '1460769891'
Notice: /Stage[main]/Main/File[/tmp/hello_puppet.txt]/ensure: current_value absent, should be file (noop)
Notice: Class[Main]: Would have triggered 'refresh' from 1 events
Notice: Stage[main]: Would have triggered 'refresh' from 1 events
Notice: Applied catalog in 0.02 seconds

すでにファイルがあって、内容に差分がある場合は、diff結果が表示されます。

# touch /tmp/hello_puppet.txt

# /opt/puppetlabs/bin/puppet apply sample.pp -t --noop
Notice: Compiled catalog for 8fd260a416a1 in environment production in 0.03 seconds
Info: Applying configuration version '1460770131'
Notice: /Stage[main]/Main/File[/tmp/hello_puppet.txt]/content: 
--- /tmp/hello_puppet.txt	2016-04-16 01:28:46.997698218 +0000
+++ /tmp/puppet-file20160416-45-1156wf4	2016-04-16 01:28:51.177698218 +0000
@@ -0,0 +1 @@
+Hello Puppet!

Notice: /Stage[main]/Main/File[/tmp/hello_puppet.txt]/content: current_value {md5}d41d8cd98f00b204e9800998ecf8427e, should be {md5}65a0b93ae3ce3b139b50be784e4d286e (noop)
Notice: Class[Main]: Would have triggered 'refresh' from 1 events
Notice: Stage[main]: Would have triggered 'refresh' from 1 events
Notice: Applied catalog in 0.03 seconds

参考

puppet applyのより詳しい情報は、下記参照。

https://docs.puppet.com/puppet/latest/reference/man/apply.html