3단계: 사용자 지정 쿡북 생성 및 배포

중요

이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두 사용할 수 없습니다. 고객은 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션할 것을 강력히 권장합니다. 마이그레이션에 대해 궁금한 점이 있으면 AWS re:Post 또는 Premium AWS Support를 통해 AWS Support 팀에 문의하세요.

현재 상태로는 스택이 아직 제 기능을 발휘할 수 없습니다. 애플리케이션이 Redis 서버에 액세스할 수 있도록 설정해야 합니다. 가장 유연한 방법은 액세스 정보를 포함하는 YAML 파일을 애플리케이션의 config 하위 폴더에 배치하는 것입니다. 그러면 애플리케이션이 파일에서 정보를 가져올 수 있습니다. 이 방법을 사용하면 애플리케이션을 재작성 및 재배포하지 않아도 연결 정보를 변경할 수 있습니다. 이 예시에서는 다음과 같이 파일 이름을 redis.yml 지정하고 ElastiCache 클러스터의 호스트 이름과 포트를 포함해야 합니다.

host: cache-cluster-hostname
port: cache-cluster-port

이 파일을 서버에 수동으로 복사할 수도 있지만 더 나은 방법은 Chef 레시피를 구현하여 파일을 생성하고 AWS OpsWorks Stacks가 모든 서버에서 레시피를 실행하도록 하는 것입니다. Chef 레시피는 AWS OpsWorks Stacks가 패키지 설치 또는 구성 파일 생성과 같은 인스턴스에 대한 작업을 수행하는 데 사용하는 특수 Ruby 애플리케이션입니다. 레시피는 여러 레시피와 구성 파일 템플릿 같은 관련 파일을 포함할 수 있는 쿡북에 패키징되어 있습니다. 쿡북은 과 같은 리포지토리에 GitHub 위치하며 표준 디렉터리 구조를 가져야 합니다. 사용자 지정 쿡북 리포지토리가 없는 경우, 쿡북 리포지토리에서 설정 방법 단원을 참조하세요.

이 예제에서는 다음 콘텐츠를 포함하는 redis-config라는 쿡북을 쿡북 리포지토리에 추가합니다.

my_cookbook_repository
  redis-config
    recipes
      generate.rb
    templates
      default
        redis.yml.erb

recipes 폴더에는 다음과 같이 generate.rb로부터 애플리케이션의 구성 파일을 생성하는 레시피 redis.yml.erb가 들어 있습니다.

node[:deploy].each do |app_name, deploy_config|
  # determine root folder of new app deployment
  app_root = "#{deploy_config[:deploy_to]}/current"

  # use template 'redis.yml.erb' to generate 'config/redis.yml'
  template "#{app_root}/config/redis.yml" do
    source "redis.yml.erb"
    cookbook "redis-config"

    # set mode, group and owner of generated file
    mode "0660"
    group deploy_config[:group]
    owner deploy_config[:user]

    # define variable “@redis” to be used in the ERB template
    variables(
      :redis => deploy_config[:redis] || {}
    )

    # only generate a file if there is Redis configuration
    not_if do
      deploy_config[:redis].blank?
    end
  end
end

레시피는 각 인스턴스에 설치되며 스택 및 배포된 앱에 대한 세부 정보를 포함하는 AWS OpsWorks Stacks 스택 구성 및 배포 JSON 객체의 데이터에 따라 달라집니다. 이 객체의 deploy 노드는 다음과 같은 구조입니다.

{
   ...
  "deploy": {
    "app1": {
      "application" : "short_name",
      ...
    }
    "app2": {
      ...
    }
    ...
  }
}

배포 노드에는 배포된 각 앱마다 앱의 짧은 이름으로 명명된 포함된 JSON 객체 세트가 포함됩니다. 각각의 앱 객체에는 문서 루트와 애플리케이션 유형 같은 앱의 구성을 정의하는 속성 세트가 포함됩니다. 배포 속성의 목록은 deploy 속성 단원을 참조하세요. 레시피는 Chef 속성 구문을 사용하여 스택 구성 및 배포 JSON 값을 나타낼 수 있습니다. 예를 들어 [:deploy][:app1][:application]은 app1 애플리케이션의 짧은 이름을 나타냅니다.

[:deploy] 내 각 앱에 대해 레시피가 연결된 코드 블록을 실행합니다. 여기서 deploy_config는 앱 속성을 나타냅니다. 먼저 레시피는 app_root를 앱의 루트 디렉터리 [:deploy][:app_name][:deploy_to]/current로 설정합니다. 그런 다음 Chef 템플릿 리소스를 사용하여 redis.yml.erb로부터 구성 파일을 생성하고 app_root/config에 저장합니다.

구성 파일은 일반적으로 템플릿으로부터 생성되며, 이 경우 설정이 대부분 Chef 속성에 의해 정의됩니다. 속성의 경우, 나중에 설명하듯이 템플릿 파일을 재작성하지 않고 사용자 지정 JSON을 사용하여 설정을 변경할 수 있습니다. redis.yml.erb 템플릿에는 다음 항목이 포함됩니다.

host: <%= @redis[:host] %>
port: <%= @redis[:port] || 6379 %>

<%... %> 요소는 속성 값을 나타내는 자리 표시자입니다.

• <%= @redis[:host] %>는 캐시 클러스터의 호스트 이름을 나타내는 redis[:host]의 값입니다.

• <%= @redis[:port] || 6379 %>는 redis[:port]의 값을 나타내며, 해당 속성이 정의되지 않은 경우에는 기본 포트 값 6379입니다.

template 리소스는 다음과 같이 작동합니다.

• source 및 cookbook은 각각 템플릿 이름과 쿡북 이름을 지정합니다.

• mode, group 및 owner는 구성 파일에 애플리케이션과 동일한 액세스 권한을 부여합니다.

• variables 섹션은 템플릿에 사용되는 @redis 변수를 애플리케이션의 [:redis] 속성 값으로 설정합니다.

  [:redis] 속성의 값은 나중에 설명하듯이 사용자 지정 JSON을 사용하여 설정됩니다. 이 속성은 표준 앱 속성이 아닙니다.

• not_if 명령은 레시피가 이미 존재하는 구성 파일은 생성하지 않게 해줍니다.

쿡북을 작성한 후에는 각 인스턴스의 쿡북 캐시로 배포해야 합니다. 이 작업은 레시피는 실행하지 않고 새 쿡북을 스택의 인스턴스에 설치하기만 합니다. 일반적으로 레시피는 나중에 설명하듯이 계층의 수명 주기 이벤트에 할당하여 실행합니다.

사용자 지정 쿡북을 배포하려면

1. 스택 스택 페이지에서 AWS OpsWorks 스택 설정을 클릭한 다음 편집을 클릭합니다.

2. [구성 관리] 섹션에서 [사용자 지정 Chef 쿡북 사용]을 [예]로 설정하고, 쿡북 리포지토리 정보를 입력한 다음 [저장]을 클릭하여 스택 구성을 업데이트합니다.

   

3. [스택] 페이지에서 [명령 실행]을 클릭하고 [사용자 지정 쿡북 업데이트] 스택 명령을 선택한 다음 [사용자 지정 쿡북 업데이트]를 클릭하여 인스턴스의 쿡북 캐시에 새 쿡북을 설치합니다.

   

쿡북을 수정한 경우 [사용자 지정 쿡북 업데이트]를 다시 실행하면 업데이트된 버전이 설치됩니다. 이 절차에 대한 자세한 정보는 사용자 지정 쿡북 설치 단원을 참조하세요.