| Dir : /opt/puppetlabs/puppet/vendor_modules/augeas_core/ |
| Server: Linux server1.ngambekcore.com 4.18.0-553.51.1.el8_10.x86_64 #1 SMP Wed Apr 30 04:00:07 EDT 2025 x86_64 IP: 159.198.77.92 |
| Dir : //opt/puppetlabs/puppet/vendor_modules/augeas_core/README_ja_JP.md |
# augeas_core
#### 目次
1. [説明](#description)
2. [セットアップ - augeas_coreå°Žå…¥ã®åŸºæœ¬](#setup)
* [セットアップè¦ä»¶](#setup-requirements)
* [augeas_coreモジュールã®åˆ©ç”¨æ–¹æ³•](#beginning-with-augeas)
3. [使用 - è¨å®šã‚ªãƒ—ションã¨è¿½åŠ 機能](#usage)
4. [å‚考 - モジュールã®æ©Ÿèƒ½ã¨å‹•ä½œã«ã¤ã„ã¦](#reference)
5. [制約 - OS互æ›æ€§ãªã©](#limitations)
6. [開発 - モジュール貢献ã«ã¤ã„ã¦ã®ã‚¬ã‚¤ãƒ‰](#development)
<a id="description"></a>
## 説明
`augeas_core`モジュールã¯ã€Augeasを用ã„ãŸè¨å®šã®ç®¡ç†ã«ä½¿ç”¨ã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€Augeasライブラリã¨Rubyãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãŒå˜åœ¨ã™ã‚‹ãƒ›ã‚¹ãƒˆã«é©ã—ã¦ã„ã¾ã™ã€‚
<a id="setup"></a>
## セットアップ
<a id="setup-requirements"></a>
### セットアップè¦ä»¶
ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã‚’使用ã™ã‚‹ã«ã¯ã€Augeasライブラリã¨Rubyãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ã‚’インストールã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚`puppet-agent`パッケージを使用ã—ã¦ã„ã‚‹å ´åˆã¯ã€ã»ã¨ã‚“ã©ã®ãƒ—ラットフォームã§ã“ã®å‰ææ¡ä»¶ã¯æº€ãŸã•ã‚Œã¦ã„ã¾ã™ã€‚
<a id="beginning-with-augeas"></a>
### 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"'
]
}
```
<a id="usage"></a>
## 使用
å‚考文書ã«ã¤ã„ã¦ã¯REFERENCE.mdã‚’ã€ä½¿ç”¨æ³•ã®è©³ç´°ã«ã¤ã„ã¦ã¯[例](https://puppet.com/docs/puppet/latest/resources_augeas.html)ã‚’å‚ç…§ã—ã¦ãã ã•ã„。
<a id="reference"></a>
## リファレンス
リファレンス文書ã«ã¤ã„ã¦ã¯ã€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å½¢å¼ã®ã‚³ãƒ¡ãƒ³ãƒˆã‹ã‚‰ç”Ÿæˆã•ã‚Œã¾ã™ã€‚ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã«é–¢ã—ã¦ä½•ã‚‰ã‹ã®é–‹ç™ºã‚’ã™ã‚‹å ´åˆã¯ã€å½±éŸ¿ã‚’å—ã‘る文書も更新ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚
<a id="limitations"></a>
## 制約
ã“ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ã¯ã€AugeasライブラリãŠã‚ˆã³Rubyãƒã‚¤ãƒ³ãƒ‡ã‚£ãƒ³ã‚°ãŒã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚ŒãŸãƒ—ラットフォームã§ã®ã¿ä½¿ç”¨ã§ãã¾ã™ã€‚
<a id="development"></a>
## 開発
Puppet Forgeã®Puppet Labsモジュールã¯ã€ã‚ªãƒ¼ãƒ—ンプãƒã‚¸ã‚§ã‚¯ãƒˆã§ã™ã€‚プãƒã‚¸ã‚§ã‚¯ãƒˆã‚’ã•ã‚‰ã«ç™ºå±•ã•ã›ã‚‹ã«ã¯ã€ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ã¸ã®è²¢çŒ®ãŒä¸å¯æ¬ ã§ã™ã€‚PuppetãŒå½¹ç«‹ã¤å¯èƒ½æ€§ã®ã‚る膨大ãªæ•°ã®ãƒ—ラットフォームã€ç„¡æ•°ã®ãƒãƒ¼ãƒ‰ã‚¦ã‚§ã‚¢ã€ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã€ãƒ‡ãƒ—ãƒã‚¤ãƒ¡ãƒ³ãƒˆæ§‹æˆã«æˆ‘々ãŒã‚¢ã‚¯ã‚»ã‚¹ã™ã‚‹ã“ã¨ã¯ã§ãã¾ã›ã‚“。
弊社ã¯ã€ã§ãã‚‹ã ã‘変更ã«è²¢çŒ®ã—ã‚„ã™ãã—ã¦ã€å¼Šç¤¾ã®ãƒ¢ã‚¸ãƒ¥ãƒ¼ãƒ«ãŒãƒ¦ãƒ¼ã‚¶ã®ç’°å¢ƒã§æ©Ÿèƒ½ã™ã‚‹çŠ¶æ…‹ã‚’ç¶æŒã—ãŸã„ã¨è€ƒãˆã¦ã„ã¾ã™ã€‚弊社ã§ã¯ã€çŠ¶æ³ã‚’把æ¡ã§ãるよã†ã€è²¢çŒ®è€…ã«å¾“ã£ã¦ã„ãŸã ãã¹ãã„ãã¤ã‹ã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’è¨ã‘ã¦ã„ã¾ã™ã€‚
詳細ã«ã¤ã„ã¦ã¯ã€[モジュール貢献ガイド](https://docs.puppetlabs.com/forge/contributing.html)ã‚’å‚ç…§ã—ã¦ãã ã•ã„。