アプリケーションデータバッグ (aws_opsworks_app)

重要

AWS OpsWorks Stacks は新規顧客を受け付けなくなりました。既存のお客様は、2024 年 5 月 26 日までは OpsWorks コンソール、 API、 CLI、および CloudFormation リソースを通常どおり使用できますが、その時点でこれらのリソースは廃止されます。この移行に備えて、できるだけ早くスタックを AWS Systems Manager に移行することをおすすめします。詳細については、AWS OpsWorks Stacks サポート終了に関する FAQ および AWS Systems Manager アプリケーションマネージャへの AWS OpsWorks Stacks アプリケーションの移行 を参照してください。

Deploy イベントまたは Execute Recipes スタックコマンドでは、アプリケーションの設定を表します。

以下の例は、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_id	app_source	data_sources
デプロイ	attributes	domains
enable_ssl	環境	name
shortname	ssl_configuration	type

app_id

アプリケーション ID (文字列)。アプリケーションを識別する GUID。

app_source

ソース管理リポジトリからアプリケーションをデプロイするために AWS OpsWorks スタックで使用される情報を指定するコンテンツのセット。コンテンツはリポジトリのタイプによって異なります。

password

プライベートリポジトリの場合はパスワード、パブリックリポジトリの場合は "null" (文字列)。プライベート S3 バケットでは、このコンテンツはシークレットキーに設定されます。

revision

リポジトリに複数のブランチがある場合、そのコンテンツはアプリケーションのブランチまたはバージョンを指定します"version1" (など) (文字列)。それ以外の場合は、"null" に設定されます。

ssh_key

プライベート Git リポジトリにアクセスする場合はデプロイ SSH キー、パブリックリポジトリの場合は (文字列)。"null"

type

アプリケーションのソースの場所 (文字列)。有効な値を次に示します。

• "archive"

• "git"

• "other"

• "s3"

url

アプリケーションが存在する場所 (文字列)。

ユーザー

プライベートリポジトリの場合はユーザー名、パブリックリポジトリの場合は "null" (文字列)。プライベート S3 バケットでは、このコンテンツはアクセスキーに設定されます。

attributes

アプリのディレクトリ構造と内容を説明する一連のコンテンツ。

document_root

ドキュメントツリーのルートディレクトリです。デプロイメントディレクトリに関連するドキュメントルートへのパス (またはアプリケーションのホームページの場所 (home_html など) ) を定義します。この属性を指定しない場合、document_root はデフォルトの public になります。document_root の値は、必ず、a-z、A-Z、0-9、_ (アンダースコア) または - (ハイフン) で始まります。

data_sources

アプリケーションのデータベースに接続するために必要な情報。アプリケーションにデータベースレイヤーがアタッチされている場合、AWS OpsWorks スタックは自動的にこのコンテンツに適切な値を割り当てます。

data_sources の値は配列で、配列はキーではなく整数の補正値によってアクセスされます。例えば、アプリの最初のデータソースにアクセスするには、app[:data_sources][0][:type] を使用します。

database_name

データベース名 (文字列)。通常はアプリケーションの短縮名です。

type

データベースインスタンスのタイプ。通常は "RdsDbInstance" (文字列) です。

arn

データベースインスタンスの Amazon リソースネーム (ARN) (文字列)。

デプロイ

アプリケーションを展開する必要があるかどうか (ブール)。Deploy ライフサイクルイベントでは、デプロイする必要があるアプリケーションに対して true です。Setup ライフサイクルイベントで、このコンテンツはすべてのアプリケーションに対して true になります。いずれのアプリケーションをインスタンスにデプロイする必要があるかを調べるには、インスタンスが属するレイヤーを確認します。

domains

アプリケーションのドメインのリスト (文字列のリスト)。

enable_ssl

SSL のサポートが有効かどうか (ブール)。

環境

アプリケーションに対して定義されたユーザー指定の環境変数の集合。アプリケーション環境変数の定義方法の詳細については、「アプリケーションの追加」を参照してください。各コンテンツ名が環境変数名に設定され、対応する値が変数の値に設定されます。

name

表示の目的で使用されるアプリケーションの名前 (文字列)。

shortname

アプリケーションの短縮名。AWS OpsWorks スタックによってアプリケーションの名前から生成されます (文字列)。内部的に、およびレシピでは短縮名が使用されます。短縮名は、アプリファイルのインストール先ディレクトリ名として使用されます。

ssl_configuration

証明書

SSL サポートを有効にした場合はアプリケーションの SSL 証明書、それ以外の場合は "null" (文字列)。

chain

SSL が有効である場合は、中間認証局キーまたはクライアント認証を指定するためのコンテンツ (文字列)。

private_key

SSL サポートを有効にした場合はアプリケーションの SSL プライベートキー、それ以外の場合は "null" (文字列)。

type

Chef 12 Linux と Chef 12.2 Windows スタックでは常に "other" に設定されるアプリケーションのタイプ (文字列)。