기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # OpsWorks Stacks 데이터 백 참조 **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. OpsWorks Stacks는 레시피에 Chef 데이터 백 콘텐츠로 다양한 설정을 노출합니다. 이 참조에는 이 데이터 백 콘텐츠가 나열되어 있습니다. *데이터 백*은 Chef 개념의 하나입니다. 데이터 백은 JSON 데이터로 저장되는 인스턴스에 대한 전역 변수로서, 이 JSON 데이터는 Chef에서 액세스할 수 있습니다. 예를 들어 데이터 백은 앱의 소스 URL, 인스턴스의 호스트 이름 및 연결된 스택의 VPC 식별자와 같은 전역 변수를 저장할 수 있습니다. OpsWorks Stacks는 각 스택의 인스턴스에 데이터 백을 저장합니다. Linux 인스턴스에서 OpsWorks Stacks는 `/var/chef/runs/run-ID/data_bags` 디렉터리에 데이터 백을 저장합니다. Windows 인스턴스에서는 데이터 백이 `drive:\chef\runs\run-id\data_bags` 디렉터리에 저장됩니다. 두 경우 모두 *run-ID*는 OpsWorks Stacks가 인스턴스의 각 Chef 실행에 할당하는 고유한 ID입니다. 이들 디렉터리에는 데이터 백 세트가 포함됩니다(하위 디렉터리). 각 데이터 백에는 여러 개의 데이터 백 콘텐츠를 포함하는 JSON 형식 파일인 데이터 백 항목이 0개 이상 들어 있습니다. **참고** OpsWorks Stacks는 암호화된 데이터 백을 지원하지 않습니다. 암호나 인증서 등 암호화된 형식의 민감한 데이터를 저장해야 하는 경우, 프라이빗 S3 버킷에 저장하는 것이 좋습니다. 그런 다음 [Ruby용 Amazon SDK](https://aws.amazon.com/documentation/sdk-for-ruby/)를 사용하는 사용자 지정 레시피를 생성해 데이터를 검색할 수 있습니다. 예제는 [ SDK for Ruby 사용](cookbooks-101-opsworks-s3.md) 섹션을 참조하세요. 데이터 백 콘텐츠는 다음 콘텐츠를 포함할 수 있습니다. + **문자열** 콘텐츠 - 표준 Ruby 구문을 따르며 작은따옴표 또는 큰따옴표를 사용할 수 있습니다. 단, 일부 특수 문자를 포함하는 문자열은 반드시 큰따옴표가 있어야 합니다. 자세한 정보는 [Ruby](http://www.ruby-lang.org/en/documentation/) 설명서 사이트를 참조하세요. + **부울** 콘텐츠 - `true` 또는 `false`입니다(따옴표 없음). + **숫자** 콘텐츠 - 정수(예: `4`) 또는 소수(예: `2.5`)입니다(따옴표 없음). + **목록** 콘텐츠 - 대괄호로 묶인 쉼표로 구분된 값(예: `[ '80', '443' ]`)입니다(따옴표 없음). + **JSON 객체** - 추가 데이터 백 콘텐츠(예: `"my-app": {"elastic_ip": null,...}`)를 포함합니다. Chef 레시피는 Chef 검색을 통해 또는 직접 데이터 백, 데이터 백 항목 및 데이터 백 콘텐츠에 액세스할 수 있습니다. 이제부터 두 액세스 접근 방식을 사용하는 방법을 설명합니다(Chef 검색이 선호됨). Chef 검색을 통해 데이터 백에 액세스하려면 [원하는 검색](https://docs.chef.io/dsl_recipe.html#search) 인덱스를 지정하여 검색 방법을 사용합니다. OpsWorks Stacks는 다음과 같은 검색 인덱스를 제공합니다. + [aws\$1opsworks\$1app](data-bag-json-app.md) - 특정 스택의 배포된 앱 세트를 나타냅니다. + [aws\$1opsworks\$1command](data-bag-json-command.md) - 특정 스택에서 실행된 명령 세트를 나타냅니다. + [aws\$1opsworks\$1ecs\$1cluster](data-bag-json-ecs-cluster.md) - 특정 스택의 Amazon Elastic Container Service(Amazon ECS) 클러스터 인스턴스 집합을 나타냅니다. + [aws\$1opsworks\$1elastic\$1load\$1balancer](data-bag-json-elb.md) - 특정 스택의 Elastic Load Balancing 로드 밸런서 집합을 나타냅니다. + [aws\$1opsworks\$1instance](data-bag-json-instance.md) - 특정 스택의 인스턴스 집합을 나타냅니다. + [aws\$1opsworks\$1layer](data-bag-json-layer.md) - 특정 스택의 계층 집합을 나타냅니다. + [aws\$1opsworks\$1rds\$1db\$1instance](data-bag-json-rds.md) - 특정 스택의 Amazon Relational Database Service(RDS) 인스턴스 집합을 나타냅니다. + [aws\$1opsworks\$1stack](data-bag-json-stack.md) - 특정 스택을 나타냅니다. + [aws\$1opsworks\$1user](data-bag-json-user.md) - 특정 스택의 사용자 집합을 나타냅니다. 검색 인덱스 이름을 알면 해당 검색 인덱스의 데이터 백의 콘텐츠에 액세스할 수 있습니다. 예를 들어 다음 레시피 코드는 `aws_opsworks_app` 검색 인덱스를 사용하여 `aws_opsworks_app` 데이터 백(`aws_opsworks_app` 디렉터리)에서 첫 번째 데이터 백 항목(첫 번째 JSON 파일)의 콘텐츠를 가져옵니다. 그런 다음 코드는 Chef 로그에 메시지 2개를 기록합니다. 한 메시지는 앱의 짧은 이름 데이터 백 콘텐츠(JSON 파일 내 문자열)를 포함하고 다른 메시지는 앱의 소스 URL 데이터 백 콘텐츠(JSON 파일 내 다른 문자열)를 포함합니다. ``` app = search("aws_opsworks_app").first Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") ``` 여기서 `['shortname']` 및 `['app_source']['url']`은 해당 JSON 파일에서 다음 데이터 백 콘텐츠를 지정합니다. ``` { ... "shortname": "mylinuxdemoapp", ... "app_source": { ... "url": "https://s3.amazonaws.com/opsworks-demo-assets/opsworks-linux-demo-nodejs.tar.gz", }, ... } ``` 검색 가능한 데이터 백 콘텐츠의 목록은 이 섹션의 참조 항목 단원을 참조하세요. 또한 한 데이터 백 안의 여러 데이터 백 항목에 대해 반복할 수 있습니다. 예를 들어 다음 레시피 코드는 이전 예제와 비슷합니다. 이 코드는 데이터 백 항목이 여러 개일 경우 데이터 백의 각 데이터 백 항목을 반복합니다. ``` search("aws_opsworks_app").each do |app| Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") end ``` 특정 데이터 백 콘텐츠의 존재를 알고 있다면 다음 구문을 사용하여 해당 데이터 백 항목을 찾을 수 있습니다. ``` search("search_index", "key:value").first ``` 예를 들어 다음 레시피 코드는 `aws_opsworks_app` 검색 인덱스를 사용하여 `mylinuxdemoapp`의 짧은 이름을 포함하는 데이터 백 항목을 찾습니다. 그런 다음 데이터 백 항목의 콘텐츠를 사용하여 해당 앱의 짧은 이름 및 소스 URL을 포함하는 메시지를 Chef 로그에 기록합니다. ``` app = search("aws_opsworks_app", "shortname:mylinuxdemoapp").first Chef::Log.info("********** For the app with the short name '#{app['shortname']}', the app's URL is '#{app['app_source']['url']}' **********") ``` `aws_opsworks_instance` 검색 인덱스에 한해, `self:true`를 지정하여 현재 레시피가 실행되고 있는 인스턴스를 나타낼 수 있습니다. 다음 레시피 코드는 해당 데이터 백 항목의 콘텐츠를 사용하여 해당 인스턴스의 OpsWorks Stacks 생성 ID 및 운영 체제와 함께 Chef 로그에 메시지를 작성합니다. ``` instance = search("aws_opsworks_instance", "self:true").first Chef::Log.info("********** For instance '#{instance['instance_id']}', the instance's operating system is '#{instance['os']}' **********") ``` Chef 검색을 사용하여 데이터 백, 데이터 백 항목 및 데이터 백 콘텐츠에 액세스하는 대신, 직접 이들에 액세스할 수 있습니다. 이렇게 하려면 [data\$1bag](https://docs.chef.io/dsl_recipe.html#data-bag) 및 [data\$1bag\$1item](https://docs.chef.io/dsl_recipe.html#data-bag-item) 메서드를 사용하여 각각 데이터 백 및 데이터 백 항목에 액세스합니다. 예를 들어 다음 레시피 코드는 앞서의 예제와 동일한 작업을 수행하지만, 데이터 백 항목이 여러 개일 경우 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목에 직접 액세스하는 것이 다릅니다. ``` # Syntax: data_bag_item("the data bag name", "the file name in the data bag without the file extension") app = data_bag_item("aws_opsworks_app", "mylinuxdemoapp") Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") data_bag("aws_opsworks_app").each do |data_bag_item| app = data_bag_item("aws_opsworks_app", data_bag_item) Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") end ``` 두 접근 방식 중 Chef 검색을 사용할 것을 권장합니다. 이 설명서의 관련 예제에서는 모두 이 접근 방식을 예시합니다. **Topics** + [앱 데이터 백(aws\$1opsworks\$1app)](data-bag-json-app.md) + [명령 데이터 백(aws\$1opsworks\$1command)](data-bag-json-command.md) + [Amazon 클러스터 데이터 백(aws\$1opsworks\$1ecs\$1cluster)](data-bag-json-ecs-cluster.md) + [Elastic Load Balancing 데이터 백(aws\$1opsworks\$1elastic\$1load\$1balancer)](data-bag-json-elb.md) + [인스턴스 데이터 백(aws\$1opsworks\$1instance)](data-bag-json-instance.md) + [계층 데이터 백(aws\$1opsworks\$1layer)](data-bag-json-layer.md) + [Amazon RDS 데이터 백(aws\$1opsworks\$1rds\$1db\$1instance)](data-bag-json-rds.md) + [스택 데이터 백(aws\$1opsworks\$1stack)](data-bag-json-stack.md) + [사용자 데이터 백(aws\$1opsworks\$1user)](data-bag-json-user.md) # 앱 데이터 백(aws\$1opsworks\$1app) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. [Deploy 이벤트](workingcookbook-events.md) 또는 [레시피 실행 스택 명령](workingstacks-commands.md)의 경우, 앱의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 앱의 짧은 이름과 소스 URL을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` app = search("aws_opsworks_app").first Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") search("aws_opsworks_app").each do |app| Chef::Log.info("********** The app's short name is '#{app['shortname']}' **********") Chef::Log.info("********** The app's URL is '#{app['app_source']['url']}' **********") end ``` **** | | | | | --- |--- |--- | | [app\$1id](#data-bag-json-app-app-id) | [app\$1source](#data-bag-json-app-app-source) | [data\$1sources](#data-bag-json-app-app-data-source) | | [배포](#data-bag-json-app-deploy) | [attributes](#data-bag-json-app-attributes) | [domains](#data-bag-json-app-app-domains) | | [enable\$1ssl](#data-bag-json-app-enable-ssl) | [환경](#data-bag-json-app-app-environment) | [이름](#data-bag-json-app-app-name) | | [shortname](#data-bag-json-app-app-shortname) | [ssl\$1configuration](#data-bag-json-app-app-ssl-config) | [type](#data-bag-json-app-app-type) | **app\$1id** 앱 ID(문자열). 앱을 식별하는 GUID입니다. **app\$1source** Stacks가 소스 제어 OpsWorks 리포지토리에서 앱을 배포하는 데 사용하는 정보를 지정하는 콘텐츠 세트입니다. 콘텐츠는 리포지토리 유형에 따라 다릅니다. **암호** 프라이빗 리포지토리의 경우에는 암호, 퍼블릭 리포지토리의 경우 `"null"`(문자열). 프라이빗 S3 버킷의 경우, 이 콘텐츠가 암호 키로 설정됩니다. **개정** 리포지토리에 여러 브랜치가 있는 경우, 이 콘텐츠는 `"version1"`과 같이 앱의 브랜치 또는 버전을 지정합니다(문자열). 그렇지 않으면 `"null"`로 설정됩니다. **ssh\$1key** 프라이빗 Git 리포지토리에 액세스하는 경우에는 [배포 SSH 키](workingapps-deploykeys.md), 퍼블릭 리포지토리의 경우에는 `"null"`(문자열). **type** 앱의 소스 위치(문자열). 유효한 값으로는 다음이 포함됩니다. + `"archive"` + `"git"` + `"other"` + `"s3"` **url** 앱 소스의 위치(문자열). **user** 프라이빗 리포지토리의 경우에는 사용자 이름, 퍼블릭 리포지토리의 경우 `"null"`(문자열). 프라이빗 S3 버킷의 경우, 이 콘텐츠는 액세스 키로 설정됩니다. **attributes** 앱의 디렉터리 구조 및 콘텐츠를 설명하는 콘텐츠 세트. **document\$1root** 문서 트리의 루트 디렉터리. 배포 디렉터리를 기준으로 문서 루트의 경로 또는 앱 홈 페이지의 위치(예: `home_html`)를 정의합니다. 이 속성이 지정되지 않으면 document\$1root는 기본적으로 `public`입니다. `document_root`의 값은 `a-z`, `A-Z`, `0-9`, `_`(밑줄) 또는 `-`(하이픈) 문자로만 시작할 수 있습니다. **data\$1sources** 앱의 데이터베이스에 연결하는 데 필요한 정보. 앱에 연결된 데이터베이스 계층이 있는 경우 OpsWorks Stacks는이 콘텐츠에 적절한 값을 자동으로 할당합니다. data\$1sources의 값은 어레이이고, 어레이는 키가 아니라 내장 오프셋에 의해 액세스됩니다. 예를 들어 앱의 첫 번째 데이터 원본에 액세스하려면 `app[:data_sources][0][:type]`을 사용합니다. **database\$1name** 일반적으로 앱의 짧은 이름인 데이터베이스 이름(문자열). **type** 일반적으로 `"RdsDbInstance"`인 데이터베이스 인스턴스의 유형(문자열). **arn** 데이터베이스 인스턴스의 Amazon 리소스 이름(ARN)(문자열). **배포** 앱을 배포할지 여부(부울). Deploy 수명 주기 이벤트에서 배포할 앱의 경우 `true`입니다. 설정 수명 주기 이벤트에서는 이 콘텐츠가 모든 앱에 대해 `true`입니다. 인스턴스에 배포될 앱을 결정하려면 인스턴스가 속한 계층에 확인 표시를 합니다. **domains** 앱의 도메인 목록(문자열의 목록). **enable\$1ssl** SSL 지원이 활성화되는지 여부(부울). **환경** 앱에 대해 정의된 사용자 지정 환경 변수의 모음. 앱의 환경 변수를 정의하는 방법에 대한 자세한 정보는 [앱 추가](workingapps-creating.md) 단원을 참조하세요. 각 콘텐츠 이름은 환경 변수 이름으로 설정되고 해당 값은 변수의 값으로 설정됩니다. **이름** 표시용으로 사용되는 앱 이름(문자열). **shortname** OpsWorks Stacks가 이름(문자열)에서 생성하는 앱의 짧은 이름입니다. 짧은 이름은 레시피 내부에서 사용되며, 앱 파일이 설치되는 디렉터리의 이름으로 사용됩니다. **ssl\$1configuration** **인증서** SSL 지원을 활성화한 경우에는 앱의 SSL 인증서, 그렇지 않은 경우에는 `"null"`(문자열). **chain** SSL이 활성화된 경우, 중간 인증서 발급 기관 공개 키 또는 클라이언트 인증을 지정하기 위한 콘텐츠(문자열). **private\$1key** SSL 지원을 활성화한 경우에는 앱의 SSL 프라이빗 키, 그렇지 않은 경우에는 `"null"`(문자열). **type** 앱의 유형(문자열). Chef 12 Linux 및 Chef 12.2 Windows 스택의 경우 항상 `"other"`로 설정됩니다. # 명령 데이터 백(aws\$1opsworks\$1command) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. OpsWorks Stacks가 하나 이상의 인스턴스에서 실행하는 명령의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 명령의 유형과 전송 시점을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` command = search("aws_opsworks_command").first Chef::Log.info("********** The command's type is '#{command['type']}' **********") Chef::Log.info("********** The command was sent at '#{command['sent_at']}' **********") search("aws_opsworks_command").each do |command| Chef::Log.info("********** The command's type is '#{command['type']}' **********") Chef::Log.info("********** The command was sent at '#{command['sent_at']}' **********") end ``` **** | | | | | --- |--- |--- | | [args](#data-bag-json-command-args) | [command\$1id](#data-bag-json-command-command-id) | [iam\$1user\$1arn](#data-bag-json-command-iam-user-arn) | | [instance-id](#data-bag-json-command-instance-id) | [sent\$1at](#data-bag-json-command-sent-at) | [type](#data-bag-json-command-type) | **args** 명령의 인수(문자열). **command\$1id** OpsWorks Stacks에서 할당한 명령의 무작위 고유 식별자(문자열). **iam\$1user\$1arn** 명령이 고객에 의해 생성되는 경우, 명령을 생성한 사용자의 Amazon 리소스 이름(ARN)(문자열). **instance-id** 명령이 실행되는 인스턴스의 식별자(문자열). **sent\$1at** OpsWorks Stacks가 명령을 실행한 시점의 타임스탬프(문자열). **type** 명령 유형(문자열). 유효한 값으로는 다음이 포함됩니다. + `"configure"` + `"deploy"` + `"deregister"` + `"execute_recipes"` + `"grant_remote_access"` + `"install_dependencies"` + `"restart"` + `"revoke_remote_access"` + `"rollback"` + `"setup"` + `"shutdown"` + `"start"` + `"stop"` + `"sync_remote_users"` + `"undeploy"` + `"update_agent"` + `"update_custom_cookbooks"` + `"update_dependencies"` # Amazon 클러스터 데이터 백(aws\$1opsworks\$1ecs\$1cluster) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. Amazon ECS 클러스터 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 Amazon ECS 클러스터의 이름과 Amazon 리소스 이름(ARN)을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` ecs_cluster = search("aws_opsworks_ecs_cluster").first Chef::Log.info("********** The ECS cluster's name is '#{ecs_cluster['ecs_cluster_name']}' **********") Chef::Log.info("********** The ECS cluster's ARN is '#{ecs_cluster['ecs_cluster_arn']}' **********") search("aws_opsworks_ecs_cluster").each do |ecs_cluster| Chef::Log.info("********** The ECS cluster's name is '#{ecs_cluster['ecs_cluster_name']}' **********") Chef::Log.info("********** The ECS cluster's ARN is '#{ecs_cluster['ecs_cluster_arn']}' **********") end ``` **** | | | | --- |--- | | [ecs\$1cluster\$1arn](#data-bag-json-ecs-cluster-ecs-cluster-arn) | [ecs\$1cluster\$1name](#data-bag-json-ecs-cluster-ecs-cluster-name) | **ecs\$1cluster\$1arn** 클러스터의 Amazon 리소스 이름(ARN)(문자열). **ecs\$1cluster\$1name** 클러스터의 이름(문자열). # Elastic Load Balancing 데이터 백(aws\$1opsworks\$1elastic\$1load\$1balancer) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. Elastic Load Balancing 로드 밸런서의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 Elastic Load Balancing 로드 밸런서의 이름과 DNS 이름을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` elastic_load_balancer = search("aws_opsworks_elastic_load_balancer").first Chef::Log.info("********** The ELB's name is '#{elastic_load_balancer['elastic_load_balancer_name']}' **********") Chef::Log.info("********** The ELB's DNS name is '#{elastic_load_balancer['dns_name']}' **********") search("aws_opsworks_elastic_load_balancer").each do |elastic_load_balancer| Chef::Log.info("********** The ELB's name is '#{elastic_load_balancer['elastic_load_balancer_name']}' **********") Chef::Log.info("********** The ELB's DNS name is '#{elastic_load_balancer['dns_name']}' **********") end ``` **** | | | | | --- |--- |--- | | [elastic\$1load\$1balancer\$1name](#data-bag-json-elb-elastic-load-balancer-name) | [dns\$1name](#data-bag-json-elb-dns-name) | [layer\$1id](#data-bag-json-elb-layer-id) | **elastic\$1load\$1balancer\$1name** 로드 밸런서의 이름(문자열). **dns\$1name** 로드 밸런서의 DNS 이름(문자열). **layer\$1id** 로드 OpsWorks 밸런서가 할당된 계층의 Stacks ID(문자열). # 인스턴스 데이터 백(aws\$1opsworks\$1instance) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. 인스턴스의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 인스턴스의 호스트 이름과 ID를 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` instance = search("aws_opsworks_instance").first Chef::Log.info("********** The instance's hostname is '#{instance['hostname']}' **********") Chef::Log.info("********** The instance's ID is '#{instance['instance_id']}' **********") search("aws_opsworks_instance").each do |instance| Chef::Log.info("********** The instance's hostname is '#{instance['hostname']}' **********") Chef::Log.info("********** The instance's ID is '#{instance['instance_id']}' **********") end ``` 다음 예제는 다중 데이터 백 항목을 검색하여 지정된 Amazon EC2 인스턴스 ID를 포함하는 데이터 백 항목을 찾기 위해 Chef 검색을 사용하는 다양한 방법을 보여줍니다. 그런 다음 이 예제는 데이터 백 항목의 콘텐츠를 사용하여 해당 인스턴스의 퍼블릭 IP 주소를 포함하는 메시지를 Chef 로그에 기록합니다. ``` instance = search("aws_opsworks_instance", "ec2_instance_id:i-12345678").first Chef::Log.info("********** For instance '#{instance['ec2_instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********") search("aws_opsworks_instance").each do |instance| if instance['ec2_instance_id'] == 'i-12345678' Chef::Log.info("********** For instance '#{instance['ec2_instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********") end end ``` 다음 예제는 `self:true`로 설정된 Chef 검색을 사용하여 레시피가 실행되는 인스턴스와 관련된 정보를 포함하는 데이터 항목을 찾는 방법을 보여줍니다. 그런 다음이 예제에서는 데이터 백 항목의 콘텐츠를 사용하여 해당 인스턴스의 OpsWorks Stacks 생성 ID와 인스턴스의 퍼블릭 IP 주소를 사용하여 Chef 로그에 메시지를 작성합니다. ``` instance = search("aws_opsworks_instance", "self:true").first Chef::Log.info("********** For instance '#{instance['instance_id']}', the instance's public IP address is '#{instance['public_ip']}' **********") ``` **** | | | | | --- |--- |--- | | [ami\$1id](#data-bag-json-instance-ami) | [구조](#data-bag-json-instance-arch) | [auto\$1scaling\$1type](#data-bag-json-instance-autoscaling) | | [availability\$1zone](#data-bag-json-instance-az) | [created\$1at](#data-bag-json-instance-created-at) | [ebs\$1optimized](#data-bag-json-instance-ebs-optimized) | | [ec2\$1instance\$1id](#data-bag-json-instance-ec2-id) | [elastic\$1ip](#data-bag-json-instance-elastic-ip) | [hostname](#data-bag-json-instance-hostname) | | [instance-id](#data-bag-json-instance-id) | [instance\$1type](#data-bag-json-instance-type) | [layer\$1ids](#data-bag-json-instance-layers) | | [os](#data-bag-json-instance-os) | [private\$1dns](#data-bag-json-instance-private-dns) | [private\$1ip](#data-bag-json-instance-private-ip) | | [public\$1dns](#data-bag-json-instance-public-dns) | [public\$1ip](#data-bag-json-instance-public-ip) | [root\$1device\$1type](#data-bag-json-instance-root-device-type) | | [root\$1device\$1volume\$1id](#data-bag-json-instance-root-device-volume-id) | [self](#data-bag-json-instance-self) | [ssh\$1host\$1dsa\$1key\$1fingerprint](#data-bag-json-instance-ssh-host-dsa-key-fingerprint) | | [ssh\$1host\$1dsa\$1key\$1private](#data-bag-json-instance-ssh-host-dsa-key-private) | [ssh\$1host\$1dsa\$1key\$1public](#data-bag-json-instance-ssh-host-dsa-key-public) | [ssh\$1host\$1rsa\$1key\$1fingerprint](#data-bag-json-instance-ssh-host-rsa-key-fingerprint) | | [ssh\$1host\$1rsa\$1key\$1private](#data-bag-json-instance-ssh-host-rsa-key-private) | [ssh\$1host\$1rsa\$1key\$1public](#data-bag-json-instance-ssh-host-rsa-key-public) | [status](#data-bag-json-instance-status) | | [subnet\$1id](#data-bag-json-instance-subnet-id) | [virtualization\$1type](#data-bag-json-instance-virt-type) | | **ami\$1id** 인스턴스의 AMI(Amazon 머신 이미지) ID(문자열). **구조** 인스턴스의 아키텍처(문자열). 항상 `"x86_64"`로 설정됩니다. **auto\$1scaling\$1type** 인스턴스의 조정 유형(문자열): `null`, `timer` 또는 `load`. **availability\$1zone** 인스턴스의 가용 영역(AZ)(문자열), 예: `"us-west-2a"`. **created\$1at** 인스턴스가 생성된 UTC `"yyyy-mm-dddThh:mm:ss+hh:mm"` 형식 시간(문자열). 예를 들어 `"2013-10-01T08:35:22+00:00"`은 2013년 10월 10일 8:35:22에 해당합니다(시간대 오프셋 없음). 자세한 정보는 [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601)를 참조하세요. **ebs\$1optimized** 인스턴스가 EBS 최적화되었는지 여부(부울). **ec2\$1instance\$1id** EC2 인스턴스 ID(문자열). **elastic\$1ip** 탄력적 IP 주소(문자열). 인스턴스에 탄력적 IP 주소가 없으면 `"null"`로 설정됩니다. **hostname** 호스트 이름(문자열), 예: `"demo1"`. **instance-id** 인스턴스를 고유하게 식별하는 OpsWorks Stacks 생성 GUID인 인스턴스 ID(문자열). **instance\$1type** 인스턴스 유형(문자열), 예: `"c1.medium"`. **layer\$1ids** 고유 ID(예: `307ut64c-c7e4-40cc-52f0-67d5k1f9992c`)로 식별되는 인스턴스 내 계층의 목록. **os** 인스턴스의 운영 체제(문자열). 유효한 값으로는 다음이 포함됩니다. + `"Amazon Linux 2"` + `"Amazon Linux 2018.03"` + `"Amazon Linux 2017.09"` + `"Amazon Linux 2017.03"` + `"Amazon Linux 2016.09"` + `"Custom"` + `"Microsoft Windows Server 2022 Base"` + `"Microsoft Windows Server 2022 with SQL Server Express"` + `"Microsoft Windows Server 2022 with SQL Server Standard"` + `"Microsoft Windows Server 2022 with SQL Server Web"` + `"Microsoft Windows Server 2019 Base"` + `"Microsoft Windows Server 2019 with SQL Server Express"` + `"Microsoft Windows Server 2019 with SQL Server Standard"` + `"Microsoft Windows Server 2019 with SQL Server Web"` + `"CentOS 7"` + `"Red Hat Enterprise Linux 7"` + `"Ubuntu 20.04 LTS"` + `"Ubuntu 18.04 LTS"` + `"Ubuntu 16.04 LTS"` + `"Ubuntu 14.04 LTS"` **private\$1dns** 프라이빗 DNS 이름(문자열). **private\$1ip** 프라이빗 IP 주소(문자열). **public\$1dns** 퍼블릭 DNS 이름(문자열). **public\$1ip** 퍼블릭 IP 주소(문자열). **root\$1device\$1type** 루트 디바이스 유형(문자열). 유효한 값으로는 다음이 포함됩니다. + `"ebs` + `"instance-store"` **root\$1device\$1volume\$1id** 루트 디바이스의 볼륨 ID(문자열). **self** 이 데이터 백 항목에 레시피가 실행되는 인스턴스에 대한 정보가 포함되면 `true`, 그렇지 않으면 `false`(부울). 이 값은 OpsWorks Stacks API를 통하지 않고 레시피에만 사용할 수 있습니다. **ssh\$1host\$1dsa\$1key\$1fingerprint** 더 긴 DSA 퍼블릭 키를 식별하는 더 짧은 바이트 시퀀스(문자열). **ssh\$1host\$1dsa\$1key\$1private** 인스턴스에 대한 SSH 인증용 DSA 생성 프라이빗 키(문자열). **ssh\$1host\$1dsa\$1key\$1public** 인스턴스에 대한 SSH 인증용 DSA 생성 퍼블릭 키(문자열). **ssh\$1host\$1rsa\$1key\$1fingerprint** 더 긴 RSA 퍼블릭 키를 식별하는 더 짧은 바이트 시퀀스(문자열). **ssh\$1host\$1rsa\$1key\$1private** 인스턴스에 대한 SSH 인증용 RSA 생성 프라이빗 키(문자열). **ssh\$1host\$1rsa\$1key\$1public** 인스턴스에 대한 SSH 인증용 RSA 생성 퍼블릭 키(문자열). **status** 인스턴스의 상태(문자열). 유효한 값으로는 다음이 포함됩니다. + `"requested"` + `"booting"` + `"running_setup"` + `"online"` + `"setup_failed"` + `"start_failed"` + `"terminating"` + `"terminated"` + `"stopped"` + `"connection_lost"` **subnet\$1id** 인스턴스의 서브넷 ID(문자열). **virtualization\$1type** 인스턴스의 가상화 유형(문자열). # 계층 데이터 백(aws\$1opsworks\$1layer) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. 계층의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 계층의 이름과 짧은 이름을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` layer = search("aws_opsworks_layer").first Chef::Log.info("********** The layer's name is '#{layer['name']}' **********") Chef::Log.info("********** The layer's shortname is '#{layer['shortname']}' **********") search("aws_opsworks_layer").each do |layer| Chef::Log.info("********** The layer's name is '#{layer['name']}' **********") Chef::Log.info("********** The layer's shortname is '#{layer['shortname']}' **********") end ``` **** | | | | | --- |--- |--- | | [ecs\$1cluster\$1arn](#data-bag-json-ecs-cluster-arn) | [layer\$1id](#data-bag-json-layer-id) | [이름](#data-bag-json-layer-name) | | [packages](#data-bag-json-layer-packages) | [shortname](#data-bag-json-layer-shortname) | [type](#data-bag-json-layer-type) | | [volume\$1configurations](#data-bag-json-layer-volume-config) | | | **ecs\$1cluster\$1arn** 계층에 Amazon ECS 클러스터가 할당된 경우 Amazon ECS 클러스터의 Amazon 리소스 이름(ARN)(문자열). **encrypted** EBS 볼륨이 암호화된 경우 `true`이고, 그렇지 않으면 `false`(부울)입니다. **layer\$1id** 계층 ID는 OpsWorks Stacks에서 생성하고 계층(문자열)을 고유하게 식별하는 GUID입니다. **이름** 콘솔에서 계층을 나타내는 데 사용되는 계층의 이름(문자열). 사용자 정의 이름일 수 있으며 반드시 고유할 필요는 없습니다. **packages** 설치할 패키지의 목록(문자열의 목록). **shortname** 계층의 사용자 정의 짧은 이름(문자열). **type** 계층의 유형(문자열). Chef 12 Linux 및 Chef 12.2 Windows의 경우 항상 `"custom"`으로 설정됩니다. **volume\$1configurations** Amazon EBS 볼륨 구성 목록입니다. **iops** 볼륨이 지원할 수 있는 초당 I/O 작업 수. **mount\$1point** 볼륨의 탑재 지점 디렉터리. **number\$1of\$1disks** 볼륨에 있는 디스크의 수입니다. **raid\$1level** 볼륨의 RAID 구성 수준. **size** GiB 단위의 볼륨 크기. **volume\$1type** 볼륨의 유형: 범용, 마그네틱, 프로비저닝된 IOPS, 처리량에 최적화된 HDD 또는 콜드 HDD입니다. # Amazon RDS 데이터 백(aws\$1opsworks\$1rds\$1db\$1instance) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. 다음과 같이 Amazon Relational Database Service(RDS) 인스턴스의 구성을 지정하는 데이터 백 콘텐츠 세트. **** | | | | | --- |--- |--- | | [address](#data-bag-json-rds-address) | [db\$1instance\$1identifier](#data-bag-json-rds-id) | [db\$1password](#data-bag-json-rds-password) | | [db\$1user](#data-bag-json-rds-user) | [engine](#data-bag-json-rds-engine) | [rds\$1db\$1instance\$1arn](#data-bag-json-rds-arn) | | [리전](#data-bag-json-rds-region) | | | 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 Amazon RDS 인스턴스의 주소와 데이터베이스 엔진 유형을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` rds_db_instance = search("aws_opsworks_rds_db_instance").first Chef::Log.info("********** The RDS instance's address is '#{rds_db_instance['address']}' **********") Chef::Log.info("********** The RDS instance's database engine type is '#{rds_db_instance['engine']}' **********") search("aws_opsworks_rds_db_instance").each do |rds_db_instance| Chef::Log.info("********** The RDS instance's address is '#{rds_db_instance['address']}' **********") Chef::Log.info("********** The RDS instance's database engine type is '#{rds_db_instance['engine']}' **********") end ``` **address** 인스턴스의 DNS 이름. **포트** 인스턴스의 포트. **db\$1instance\$1identifier** 인스턴스의 ID. **db\$1password** 인스턴스의 마스터 암호. **db\$1user** 인스턴스의 마스터 사용자 이름. **engine** 인스턴스의 데이터베이스 엔진, 예: `mysql`. **rds\$1db\$1instance\$1arn** 인스턴스의 Amazon 리소스 이름(ARN). **리전** 인스턴스의 AWS 리전, 예: `us-west-2`. # 스택 데이터 백(aws\$1opsworks\$1stack) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. 스택의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 스택의 이름과 쿡북의 소스 URL을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` stack = search("aws_opsworks_stack").first Chef::Log.info("********** The stack's name is '#{stack['name']}' **********") Chef::Log.info("********** The stack's cookbook URL is '#{stack['custom_cookbooks_source']['url']}' **********") ``` **** | | | | | --- |--- |--- | | [arn](#data-bag-json-stack-arn) | [custom\$1cookbooks\$1source](#data-bag-json-stack-cookbook-source) | [이름](#data-bag-json-stack-name) | | [리전](#data-bag-json-stack-region) | [stack\$1id](#data-bag-json-stack-id) | [use\$1custom\$1cookbooks](#data-bag-json-stack-use-cookbooks) | | [vpc\$1id](#data-bag-json-stack-vpc-id) | | | **arn** 스택의 Amazon 리소스 이름(ARN)(문자열). **custom\$1cookbooks\$1source** 사용자 지정 쿡북의 소스 리포지토리를 지정하는 콘텐츠 세트. **type** 리포지토리 유형(문자열). 유효한 값으로는 다음이 포함됩니다. + `"archive"` + `"git"` + `"s3"` **url** `"git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git"`와 같은 리포지토리 URL(문자열). **사용자 이름** 프라이빗 리포지토리의 경우에는 사용자 이름, 퍼블릭 리포지토리의 경우 `null`(문자열). 프라이빗 Amazon Simple Storage Service(Amazon S3) 버킷의 경우 콘텐츠가 액세스 키로 설정됩니다. **암호** 프라이빗 리포지토리의 경우에는 암호, 퍼블릭 리포지토리의 경우 `null`(문자열). 프라이빗 S3 버킷의 경우, 이 콘텐츠가 암호 키로 설정됩니다. **ssh\$1key** 프라이빗 Git 리포지토리에 액세스하는 경우에는 [배포 SSH 키](workingapps-deploykeys.md), 퍼블릭 리포지토리의 경우에는 `null`(문자열). **개정** 리포지토리에 여러 브랜치가 있는 경우, 이 콘텐츠는 `"version1"`과 같이 앱의 브랜치 또는 버전을 지정합니다(문자열). 그렇지 않으면 `null`로 설정됩니다. **이름** 스택의 이름(문자열). **리전** 스택의 AWS 리전(문자열). **stack\$1id** 스택을 식별하는 GUID(문자열). **use\$1custom\$1cookbooks** 사용자 지정 쿡북이 활성화되었는지 여부(부울). **vpc\$1id** 스택이 VPC에서 실행 중인 경우, VPC ID(문자열). # 사용자 데이터 백(aws\$1opsworks\$1user) **중요** 이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요. 사용자의 설정을 나타냅니다. 다음 예제는 Chef 검색을 사용하여 단일 데이터 백 항목, 그런 다음 다중 데이터 백 항목을 검색하여 사용자의 사용자 이름과 Amazon 리소스 이름(ARN)을 포함하는 메시지를 Chef 로그에 기록하는 방법을 보여줍니다. ``` user = search("aws_opsworks_user").first Chef::Log.info("********** The user's user name is '#{user['username']}' **********") Chef::Log.info("********** The user's user ARN is '#{user['iam_user_arn']}' **********") # Or... search("aws_opsworks_user").each do |user| Chef::Log.info("********** The user's user name is '#{user['username']}' **********") Chef::Log.info("********** The user's user ARN is '#{user['iam_user_arn']}' **********") end ``` **** | | | | | --- |--- |--- | | [administrator\$1privileges](#data-bag-json-user-admin) | [iam\$1user\$1arn](#data-bag-json-user-arn) | [remote\$1access](#data-bag-json-user-rdp) | | [ssh\$1public\$1key](#data-bag-json-user-ssh-public-key) | [unix\$1user\$1id](#data-bag-json-user-unix-id) | [사용자 이름](#data-bag-json-user-username) | **administrator\$1privileges** 사용자에게 관리자 권한이 있는지 여부(부울). **iam\$1user\$1arn** 사용자의 Amazon 리소스 이름(ARN)(문자열). **remote\$1access** 사용자가 RDP를 사용하여 인스턴스에 로그인할 수 있는지 여부(부울). **ssh\$1public\$1key** OpsWorks Stacks 콘솔 또는 API(문자열)를 통해 제공되는 사용자의 퍼블릭 키입니다. **unix\$1user\$1id** 사용자의 Unix ID(숫자). **사용자 이름** 사용자 이름(문자열).