3rdparty/modules/concat/readmes/README_ja_JP.md

   1 # concat
   2
   3 #### 目次
   4
   5 1. [概要](#overview)
   6 2. [説明 - モジュールの機能とその有益性](#module-description)
   7     * [concatを開始する](#beginning-with-concat)
   8 4. [使用方法 - 設定オプションと追加機能](#usage)
   9 5. [参考 - モジュールの機能と動作について](#reference)
  10     * [削除した機能](#removed-functionality)
  11 6. [制約事項 - OSの互換性など](#limitations)
  12 7. [開発 - モジュール貢献についてのガイド](#development)
  13
  14 <a id="overview"></a>
  15 ## 概要
  16
  17 concatモジュールでは、複数の順序付きテキストフラグメントからファイルを構築できます。
  18
  19 <a id="module-description"></a>
  20 ## モジュールの概要
  21
  22 concatモジュールでは、他のモジュールから`concat::fragment`リソースを収集し、それを単一の`concat` リソースを通じて整合性のあるファイルに並べることができます。
  23
  24 <a id="beginning-with-concat"></a>
  25 ### concatを開始する
  26
  27 concatを開始するには、以下の作成が必要です。
  28
  29 * 最終ファイルのconcat{}リソース。
  30 * 1つ以上のconcat::fragment{}。
  31
  32 最小限の例:
  33
  34 ~~~
  35 concat { '/tmp/file':
  36   ensure => present,
  37 }
  38
  39 concat::fragment { 'tmpfile':
  40   target  => '/tmp/file',
  41   content => 'test contents',
  42   order   => '01'
  43 }
  44 ~~~
  45
  46 <a id="usage"></a>
  47 ## 使用方法
  48
  49 ### ノードの主要モジュールのリストを維持します
  50
  51 いずれかのノードのモジュールをリストするmotdファイルを維持するには、まずファイルをフレームするクラスを作成します。
  52
  53 ~~~
  54 class motd {
  55   $motd = '/etc/motd'
  56
  57   concat { $motd:
  58     owner => 'root',
  59     group => 'root',
  60     mode  => '0644'
  61   }
  62
  63   concat::fragment{ 'motd_header':
  64     target  => $motd,
  65     content => "\nPuppet modules on this server:\n\n",
  66     order   => '01'
  67   }
  68
  69   # let local users add to the motd by creating a file called
  70   # /etc/motd.local
  71   concat::fragment{ 'motd_local':
  72     target => $motd,
  73     source => '/etc/motd.local',
  74     order  => '15'
  75   }
  76 }
  77
  78 # let other modules register themselves in the motd
  79 define motd::register($content="", $order='10') {
  80   if $content == "" {
  81     $body = $name
  82   } else {
  83     $body = $content
  84   }
  85
  86   concat::fragment{ "motd_fragment_$name":
  87     target  => '/etc/motd',
  88     order   => $order,
  89     content => "    -- $body\n"
  90   }
  91 }
  92 ~~~
  93
  94 次に、ノードの各モジュールの宣言に`motd::register{ 'Apache': }`を追加し、motdのモジュールを登録します。
  95
  96 ~~~
  97 class apache {
  98   include apache::install, apache::config, apache::service
  99
 100   motd::register{ 'Apache': }
 101 }
 102 ~~~
 103
 104 これらの2つのステップは、インストールされ、登録されたモジュールのリストを/etc/motdファイルに追加します。このファイルは、登録済みモジュールの`include`行を削除しただけであっても最新の状態を保ちます。システム管理者は、/etc/motd.localに書き込むことでリストにテキストを追加できます。
 105
 106 完成したmotdファイルは、以下のようになります。
 107
 108 ~~~
 109   Puppet modules on this server:
 110
 111     -- Apache
 112     -- MySQL
 113
 114   <contents of /etc/motd.local>
 115 ~~~
 116
 117 <a id="reference"></a>
 118 ## リファレンス
 119
 120 [REFERENCE.md](https://github.com/puppetlabs/puppetlabs-concat/blob/master/REFERENCE.md)を参照してください。
 121
 122 <a id="removed-functionality"></a>
 123 ### 削除した機能
 124
 125 次の機能は、concatモジュールの過去のバージョンには存在していましたが、バージョン2.0.0では削除されています。
 126
 127 `concat::fragment`から削除されたパラメータ:
 128 * `gnu`
 129 * `backup`
 130 * `group`
 131 * `mode`
 132 * `owner`
 133
 134 `concat::setup`クラスも削除されました。
 135
 136 バージョン2.0.0以前のconcatでは、`warn`パラメータを`true`、`false`、'yes'、'no'、'on'、または'off'の文字列値に設定すると、モジュールは文字列を対応するブール値に変換していました。concatバージョン2.0.0以降では、`warn_header`パラメータはこれらの値を他の文字列と同じように扱い、ヘッダメッセージの内容として使用します。これを回避するには、`true`および`false`値を文字列ではなくブール値として渡します。
 137
 138 <a id="limitations"></a>
 139 ## 制約事項
 140
 141 このモジュールは[PE対応のすべてのプラットフォーム](https://forge.puppetlabs.com/supported#compat-matrix)上でテスト済みであり、問題は発見されていません。
 142
 143 サポートされているオペレーティングシステムの一覧については、[metadata.json](https://github.com/puppetlabs/puppetlabs-concat/blob/master/metadata.json)を参照してください。
 144
 145 <a id="development"></a>
 146 ## 開発
 147
 148 Puppet Forge上のPuppetモジュールはオープンプロジェクトであり、その価値を維持するにはコミュニティからの貢献が欠かせません。Puppetが提供する膨大な数のプラットフォームや、無数のハードウェア、ソフトウェア、デプロイ設定に弊社がアクセスすることは不可能です。
 149
 150 弊社は、できるだけ変更に貢献しやすくして、弊社のモジュールがユーザの環境で機能する状態を維持したいと考えています。弊社では、状況を把握できるよう、貢献者に従っていただくべきいくつかのガイドラインを設けています。
 151
 152 詳細については、[モジュール貢献ガイド](https://docs.puppetlabs.com/forge/contributing.html)を参照してください。
 153
 154 ### コントリビュータ
 155
 156 Richard Pijnenburg ([@Richardp82](http://twitter.com/richardp82))
 157
 158 Joshua Hoblitt ([@jhoblitt](http://twitter.com/jhoblitt))
 159
 160 [その他のコントリビュータ](https://github.com/puppetlabs/puppetlabs-concat/graphs/contributors)