puppetlabs-augeas_core-1.4.0/ 0000755 0001750 0001750 00000000000 14502100567 015472 5 ustar jerome jerome puppetlabs-augeas_core-1.4.0/readmes/ 0000755 0001750 0001750 00000000000 14502100567 017112 5 ustar jerome jerome puppetlabs-augeas_core-1.4.0/readmes/README_ja_JP.md 0000644 0001750 0001750 00000007774 14502100567 021453 0 ustar jerome jerome
# augeas_core
#### 目次
1. [説明](#description)
2. [セットアップ - augeas_core導入の基本](#setup)
* [セットアップ要件](#setup-requirements)
* [augeas_coreモジュールの利用方法](#beginning-with-augeas)
3. [使用 - 設定オプションと追加機能](#usage)
4. [参考 - モジュールの機能と動作について](#reference)
5. [制約 - OS互換性など](#limitations)
6. [開発 - モジュール貢献についてのガイド](#development)
## 説明
`augeas_core`モジュールは、Augeasを用いた設定の管理に使用されます。このモジュールは、AugeasライブラリとRubyバインディングが存在するホストに適しています。
## セットアップ
### セットアップ要件
このモジュールを使用するには、AugeasライブラリとRubyバインディングをインストールする必要があります。`puppet-agent`パッケージを使用している場合は、ほとんどのプラットフォームでこの前提条件は満たされています。
### augeas_coreモジュールの利用方法
`augeas`を用いて設定ファイルを管理するには、以下のコードを使用します。
```
augeas { 'add_services_entry':
context => '/files/etc/services',
incl => '/etc/services',
lens => 'Services.lns',
changes => [
'ins service-name after service-name[last()]',
'set service-name[last()] "Doom"',
'set service-name[. = "Doom"]/port "666"',
'set service-name[. = "Doom"]/protocol "udp"'
]
}
```
## 使用
参考文書についてはREFERENCE.mdを、使用法の詳細については[例](https://puppet.com/docs/puppet/latest/resources_augeas.html)を参照してください。
## リファレンス
リファレンス文書については、REFERENCE.mdを参照してください。
このモジュールは、Puppet Stringsを用いて文書化されています。
Stringsの仕組みの簡単な概要については、Puppet Stringsに関する[こちらのブログ記事](https://puppet.com/blog/using-puppet-strings-generate-great-documentation-puppet-modules)または[README.md](https://github.com/puppetlabs/puppet-strings/blob/master/README.md)を参照してください。
文書をローカルで作成するには、以下のコマンドを実行します。
```
bundle install
bundle exec puppet strings generate ./lib/**/*.rb
```
このコマンドにより、閲覧可能な`_index.html`ファイルが`doc`ディレクトリに作成されます。ここで利用可能なリファレンスはすべて、コードベースに埋め込まれたYARD形式のコメントから生成されます。このモジュールに関して何らかの開発をする場合は、影響を受ける文書も更新する必要があります。
## 制約
このモジュールは、AugeasライブラリおよびRubyバインディングがインストールされたプラットフォームでのみ使用できます。
## 開発
Puppet ForgeのPuppet Labsモジュールは、オープンプロジェクトです。プロジェクトをさらに発展させるには、コミュニティへの貢献が不可欠です。Puppetが役立つ可能性のある膨大な数のプラットフォーム、無数のハードウェア、ソフトウェア、デプロイメント構成に我々がアクセスすることはできません。
弊社は、できるだけ変更に貢献しやすくして、弊社のモジュールがユーザの環境で機能する状態を維持したいと考えています。弊社では、状況を把握できるよう、貢献者に従っていただくべきいくつかのガイドラインを設けています。
詳細については、[モジュール貢献ガイド](https://docs.puppetlabs.com/forge/contributing.html)を参照してください。
puppetlabs-augeas_core-1.4.0/REFERENCE.md 0000644 0001750 0001750 00000014211 14502100567 017311 0 ustar jerome jerome # Reference
## Table of Contents
### Resource types
* [`augeas`](#augeas): Apply a change or an array of changes to the filesystem using the augeas tool.
## Resource types
### `augeas`
Requires:
- [Augeas](http://www.augeas.net)
- The ruby-augeas bindings
#### Examples
##### Sample usage with a string:
```puppet
augeas { "test1":
context => "/files/etc/sysconfig/firstboot",
changes => "set RUN_FIRSTBOOT YES",
onlyif => "match other_value size > 0",
}
```
##### Sample usage with an array and custom lenses:
```puppet
augeas { "jboss_conf":
context => "/files",
changes => [
"set etc/jbossas/jbossas.conf/JBOSS_IP $ipaddress",
"set etc/jbossas/jbossas.conf/JAVA_HOME /usr",
],
load_path => "$/usr/share/jbossas/lenses",
}
```
#### Properties
The following properties are available in the `augeas` type.
##### `returns`
The expected return code from the augeas command. Should not be set.
Default value: `0`
#### Parameters
The following parameters are available in the `augeas` type.
* [`changes`](#-augeas--changes)
* [`context`](#-augeas--context)
* [`force`](#-augeas--force)
* [`incl`](#-augeas--incl)
* [`lens`](#-augeas--lens)
* [`load_path`](#-augeas--load_path)
* [`name`](#-augeas--name)
* [`onlyif`](#-augeas--onlyif)
* [`provider`](#-augeas--provider)
* [`root`](#-augeas--root)
* [`show_diff`](#-augeas--show_diff)
* [`type_check`](#-augeas--type_check)
##### `changes`
The changes which should be applied to the filesystem. This
can be a command or an array of commands. The following commands are supported:
* `set ` --- Sets the value `VALUE` at location `PATH`
* `setm ` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `VALUE`
* `rm ` --- Removes the node at location `PATH`
* `remove ` --- Synonym for `rm`
* `clear ` --- Sets the node at `PATH` to `NULL`, creating it if needed
* `clearm ` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `NULL`
* `touch ` --- Creates `PATH` with the value `NULL` if it does not exist
* `ins