Deploy 레시피

Deploy 레시피는 계층의 Deploy 수명 주기 이벤트에 할당됩니다. 이 이벤트는 일반적으로 앱이 배포될 때마다 스택의 모든 인스턴스에서 발생합니다. 하지만 선택적으로 이벤트를 지정된 인스턴스로만 제한할 수 있습니다. AWS OpsWorks 또한 Stacks는 설정 레시피가 완료된 후 새 인스턴스에도 Deploy 레시피를 실행합니다. Deploy 레시피의 주된 목적은 코드와 관련 파일을 리포지토리에서 애플리케이션 서버 계층의 인스턴스에 배포하는 것입니다. 하지만 다른 계층에서도 Deploy 레시피를 실행하는 경우가 종종 있습니다. 그러면 예를 들어 해당 계층의 인스턴스가 구성을 업데이트하여 새로 개발된 앱을 수용할 수 있습니다. Deploy 레시피를 구현할 때 Deploy 이벤트가 반드시 앱이 인스턴스에 배포되는 것을 의미하지는 않음을 염두에 두어야 합니다. 단지 인스턴스가 필요한 업데이트를 할 수 있도록 스택 내 다른 인스턴스에 앱이 배포되고 있다는 알림일 수도 있습니다. 이 레시피는 적절히 대응할 수 있어야 합니다. 이는 아무 작업도 하지 않음을 의미하기도 합니다.

AWS OpsWorks Stacks는 표준 앱 유형의 앱을 해당하는 내장 애플리케이션 서버 계층에 자동으로 배포합니다. 앱을 사용자 지정 계층에 배포하려면 앱의 파일을 리포지토리에서 인스턴스 내 적절한 위치로 다운로드하는 사용자 지정 Deploy 레시피를 구현해야 합니다. 하지만 내장 배포 쿡북을 사용하여 배포의 일부 측면을 처리함으로써 작성할 코드의 양을 줄일 수도 있습니다. 예를 들어 파일을 지원되는 리포지토리 중 하나에 저장할 경우 내장 쿡북이 리포지토리에서 계층의 인스턴스로 파일을 다운로드하는 세부 작업을 처리할 수 있습니다.

tomcat::deploy 레시피는 Deploy 수명 주기 이벤트에 할당됩니다.

include_recipe 'deploy'

node[:deploy].each do |application, deploy|
  opsworks_deploy_dir do
    user deploy[:user]
    group deploy[:group]
    path deploy[:deploy_to]
  end

  opsworks_deploy do
    deploy_data deploy
    app application
  end
...

tomcat::deploy 레시피는 애플리케이션에 고유하지 않은 배포에 대해 내장 배포 쿡북을 사용합니다. deploy 레시피(내장 deploy::default 레시피의 약칭)는 deploy 속성의 데이터를 기반으로 사용자, 그룹 등을 설정하는 세부 작업을 처리하는 내장 레시피입니다.

이 레시피는 두 개의 내장 Chef 정의 opsworks_deploy_dir 및 opworks_deploy를 사용하여 애플리케이션을 설치합니다.

opsworks_deploy_dir정의는 앱 배포 데이터를 기반으로 디렉토리 구조를 설정합니다. JSON 정의는 기본적으로 리소스 정의를 패키징하는 편리한 방법으로, definitions 디렉터리에 위치합니다. 레시피는 사용자 정의를 리소스와 거의 비슷하게 사용할 수 있지만, 정의 자체에는 연결된 공급자가 없고 정의에 포함된 리소스만 있습니다. 레시피에서 변수를 정의할 수 있습니다. 그러면 해당 변수가 기본 리소스 정의로 전달됩니다. tomcat::deploy레시피 세트 usergroup, path 변수는 배포 데이터를 기반으로 JSON 합니다. 이들 변수는 정의의 디렉터리를 관리하는 디렉터리 리소스로 전달됩니다.

다른 정의 opsworks_deploy는 deploy 속성에 포함된 데이터를 기반으로 앱의 코드와 관련 파일을 리포지토리에서 체크아웃하고 인스턴스에 배포하는 세부 작업을 처리합니다. 이 정의는 모든 앱 유형에 사용할 수 있습니다. 디렉터리 이름과 같은 배포 세부 정보는 콘솔이나 를 통해 지정되거나 deploy 속성에 입력됩니다. API 하지만 지원되는 네 가지 리포지토리 유형인 Git, Subversion, S3 및 에서만 opsworks_deploy 작동합니다. HTTP 다른 리포지토리 유형을 사용하려면 이 코드를 직접 구현해야 합니다.

앱의 파일은 Tomcat webapps 디렉터리에 설치합니다. 일반적인 방법은 파일을 webapps에 직접 복사하는 것입니다. 하지만 AWS OpsWorks 스택 배포는 인스턴스에 최대 5개 버전의 앱을 유지하도록 설계되었으므로 필요한 경우 이전 버전으로 롤백할 수 있습니다. AWS OpsWorks 따라서 Stacks가 다음을 수행합니다.

이전 버전으로 롤백해야 할 경우 current symlink를 해당하는 타임스탬프가 있는 고유 디렉터리를 가리키도록 수정합니다(예를 들어 /srv/www/my_1st_jsp/current의 링크 대상 변경).

tomcat::deploy의 중간 부분은 symlink를 설정합니다.

  ...
  current_dir = ::File.join(deploy[:deploy_to], 'current')
  webapp_dir = ::File.join(node['tomcat']['webapps_base_dir'], deploy[:document_root].blank? ? application : deploy[:document_root])

  # opsworks_deploy creates some stub dirs, which are not needed for typical webapps
  ruby_block "remove unnecessary directory entries in #{current_dir}" do
    block do
      node['tomcat']['webapps_dir_entries_to_delete'].each do |dir_entry|
        ::FileUtils.rm_rf(::File.join(current_dir, dir_entry), :secure => true)
      end
    end
  end

  link webapp_dir do
    to current_dir
    action :create
  end
  ...

이 레시피는 먼저 두 개의 변수 current_dir 및 webapp_dir을 생성하여 각각 current 및 webapp 디렉터리를 표시합니다. 그런 다음 link 리소스를 사용하여 webapp_dir를 current_dir에 링크합니다. The AWS OpsWorks 스택 deploy::default 레시피는 이 예제에 필요하지 않은 일부 스텁 디렉터리를 생성하므로 발췌문 중간 부분에서 해당 디렉터리를 제거합니다.

tomcat::deploy의 마지막 부분은 필요할 경우 Tomcat 서비스를 재시작합니다.

  ...
  include_recipe 'tomcat::service'

  execute 'trigger tomcat service restart' do
    command '/bin/true'
    not_if { node['tomcat']['auto_deploy'].to_s == 'true' }
    notifies :restart, resources(:service => 'tomcat')
  end
end

include_recipe 'tomcat::context'

이 레시피는 먼저 tomcat::service를 실행하여 서비스가 이 Chef 실행에 대해 정의되도록 합니다. 그런 다음 실행 리소스를 사용하여 ['tomcat']['auto_deploy']가 'true'로 설정된 경우에만 서비스를 재시작하라고 알립니다. 그렇지 않은 경우에는 Tomcat이 webapps 디렉터리의 변경 사항을 수신 대기합니다. 그러므로 명시적 Tomcat 서비스 재시작은 필요하지 않습니다.

마지막으로, tomcat::deploy는 tomcat::context를 실행합니다. 이는 백 엔드 데이터베이스가 변경된 경우 웹 앱 컨텍스트 구성 파일을 업데이트합니다.