4장. 설정

OpenStack 모듈에 기여하기 전에 Puppet 모듈을 생성하는 구성 요소를 이해해야 합니다.

일부 소프트웨어에는 패키지 설치가 필요합니다. Puppet 모듈에서 수행할 수 있는 기능 중 하나입니다. 여기에는 특정 패키지에 대한 구성을 정의하는 리소스 정의가 필요합니다.

예를 들어 mymodule 모듈을 통해 httpd 패키지를 설치하려면 mymodule 모듈의 Puppet 매니페스트에 다음 내용을 추가합니다.

class mymodule::httpd {
  package { 'httpd':
    ensure => installed,
  }
}

이 코드는 httpd 라는 mymodule 의 하위 클래스를 정의한 다음 httpd 패키지에 대한 패키지 리소스 선언을 정의합니다. ensure => installed 속성은 패키지가 설치되어 있는지 확인하도록 Puppet에 지시합니다. 설치되지 않은 경우 Puppet은 yum 을 실행하여 설치합니다.

패키지를 설치한 후 서비스를 시작하려고 할 수 있습니다. service 라는 다른 리소스 선언을 사용합니다. 이를 위해서는 다음 콘텐츠를 사용하여 매니페스트를 편집해야 합니다.

class mymodule::httpd {
  package { 'httpd':
    ensure => installed,
  }
  service { 'httpd':
    ensure => running,
    enable => true,
    require => Package["httpd"],
  }
}

다음과 같은 몇 가지 작업을 수행할 수 있습니다.

이전 두 단계에서는 Puppet을 통해 서비스를 설치하고 활성화하는 방법을 보여줍니다. 그러나 서비스에 일부 사용자 지정 구성을 제공할 수 있습니다. 이 예에서 HTTP 서버는 이미 포트 80에 웹 호스트를 제공하는 /etc/httpd/conf/httpd.conf 에 몇 가지 기본 구성을 제공합니다. 이 섹션에서는 사용자 지정 포트에 추가 웹 호스트를 제공하기 위해 몇 가지 추가 구성을 추가합니다.

이 경우 템플릿 파일을 사용하여 HTTP 구성 파일을 저장합니다. 이는 사용자 정의 포트에 변수 입력이 필요하기 때문입니다. 모듈의 templates 디렉터리에 다음 내용이 포함된 myserver.conf.erb 라는 파일을 추가합니다.

Listen <%= @httpd_port %>
NameVirtualHost *:<%= @httpd_port %>
<VirtualHost *:<%= @httpd_port %>>
  DocumentRoot /var/www/myserver/
  ServerName *:<%= @fqdn %>>
  <Directory "/var/www/myserver/">
    Options All Indexes FollowSymLinks
    Order allow,deny
    Allow from all
  </Directory>
</VirtualHost>

이 템플릿은 Apache 웹 서버 구성에 대한 표준 구문을 따릅니다. 유일한 차이점은 모듈에서 변수를 삽입하는 Ruby 이스케이프 문자의 포함입니다. 예를 들어 웹 서버 포트를 지정하는 데 사용하는 httpd_port 입니다.

시스템의 정규화된 도메인 이름을 저장하는 변수인 fqdn 도 포함됩니다. 이를 시스템 사실 이라고 합니다. 시스템 사실은 각 시스템의 Puppet 카탈로그를 생성하기 전에 각 시스템에서 수집됩니다. Puppet은 facter 명령을 사용하여 이러한 시스템 팩트를 수집하고 팩트를 실행하여 이러한 사실 목록을 볼 수도 있습니다.

이 파일을 저장한 후 모듈의 Puppet 매니페스트에 리소스를 추가합니다.

class mymodule::httpd {
  package { 'httpd':
    ensure => installed,
  }
  service { 'httpd':
    ensure => running,
    enable => true,
    require => Package["httpd"],
  }
  file {'/etc/httpd/conf.d/myserver.conf':
  notify => Service["httpd"],
    ensure => file,
    require => Package["httpd"],
    content => template("mymodule/myserver.conf.erb"),
  }
  file { "/var/www/myserver":
    ensure => "directory",
  }
}

이렇게 하면 다음이 수행됩니다.