翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Windows サーバーでのソフトウェアのカスタマイズ

アプリケーションが依存するソフトウェアをカスタマイズして設定できます。これらのファイルは、例えば、実行する必要のある追加パッケージやサービスなど、アプリケーションが必要とするいずれかの依存関係です。Elastic Beanstalk 環境のカスタマイズと設定に関する一般的な情報については、「Elastic Beanstalk 環境の設定」を参照してください。

設定ファイルは、アプリケーションが実行している Windows サーバーに影響する次のキーをサポートします。

キーは、上に表示した順に処理されます。

設定ファイルの作成およびテスト中は、環境のイベントを監視します。Elastic Beanstalk は、無効なキーなどの検証エラーが含まれている設定ファイルを無視し、同じファイルに含まれている他のキーを一切処理しません。これが発生すると、Elastic Beanstalk は警告イベントをイベントログに追加します。

パッケージ

packages キーを使用して、パッケージ済みのアプリケーションとコンポーネントをダウンロードしてインストールします。

Windows 環境では、Elastic Beanstalk は MSI パッケージのダウンロードとインストールをサポートしています。(Linux 環境は、追加のパッケージマネージャをサポートします。詳細については、Linux サーバーでのソフトウェアのカスタマイズページで パッケージ を参照してください)。

Amazon Simple Storage Service (Amazon S3) オブジェクトなどの外部の場所は、その URL がパブリックアクセス可能であれば参照できます。

複数の msi: パッケージを指定する場合、それらのインストール順序は保証されません。

構文

パッケージ名として選択した名前と、値としての MSI ファイルの場所への URL を指定します。msi: キーの下に複数のパッケージを指定できます。

packages: 
  msi:
    package name: package url
    ...

例

次の例では、https://dev.mysql.com/ から [mysql] をダウンロードする URL を指定します。

packages:
  msi:
    mysql: https://dev.mysql.com/get/Downloads/Connector-Net/mysql-connector-net-8.0.11.msi

次の例では、MSI ファイルの場所として Amazon S3 オブジェクトを指定しています。

packages:
  msi:
    mymsi: https://mybucket.s3.amazonaws.com/myobject.msi

ソース

sources キーを使用して、公開 URL からアーカイブファイルをダウンロードし、EC2 インスタンス上のターゲットディレクトリに解凍します。

構文

sources:  
  target directory: location of archive file

サポートされる形式

Windows 環境では、Elastic Beanstalk は .zip 形式をサポートしています。(Linux 環境は、追加の形式をサポートします。詳細については、Linux サーバーでのソフトウェアのカスタマイズページで [Sources] (出典) を参照してください)。

Amazon Simple Storage Service (Amazon S3) オブジェクトなどの外部の場所は、その URL がパブリックアクセス可能であれば参照できます。

例

以下の例では、Amazon S3 バケットから公開 .zip ファイルをダウンロードし、c:/myproject/myapp に解凍しています。

sources:  
  "c:/myproject/myapp": https://mybucket.s3.amazonaws.com/myobject.zip

ファイル

files キーを使用して、EC2 インスタンス上にファイルを作成できます。内容は、設定ファイルでインラインとするか、URL から指定できます。ファイルは辞書式順序でディスクに書き込まれます。Amazon S3 からプライベートファイルをダウンロードするには、認可のインスタンスプロファイルを指定します。

構文

files:  
  "target file location on disk":
    source: URL
    authentication: authentication name:

  "target file location on disk":
    content: |
      this is my content
    encoding: encoding format

オプション

例

次の例は、ファイルコンテンツを提供する 2 つの方法である、URL からと設定ファイルのインラインからの方法を示しています。

files:
  "c:\\targetdirectory\\targetfile.txt":
    source: http://foo.bar/myfile
 
  "c:/targetdirectory/targetfile.txt":
    content: |
      # this is my file
      # with content

次の例では、リソースキーを使用して S3Auth という認証方法を追加して、Amazon S3 バケットから秘密ファイルをダウンロードするのに使用します。

files:
  "c:\\targetdirectory\\targetfile.zip":
    source: https://elasticbeanstalk-us-east-2-123456789012.s3.amazonaws.com/prefix/myfile.zip
    authentication: S3Auth

Resources:
  AWSEBAutoScalingGroup:
    Metadata:
      AWS::CloudFormation::Authentication:
        S3Auth:
          type: "s3"
          buckets: ["elasticbeanstalk-us-east-2-123456789012"]
          roleName:
            "Fn::GetOptionSetting":
              Namespace: "aws:autoscaling:launchconfiguration"
              OptionName: "IamInstanceProfile"
              DefaultValue: "aws-elasticbeanstalk-ec2-role"

コマンド

commands キーを使用して、EC2 インスタンスでコマンドを実行します。コマンドは、名前のアルファベット順に処理され、アプリケーションとウェブサーバーが設定されてアプリケーションバージョンファイルが抽出される前に実行されます。

指定されたコマンドが管理者ユーザーとして実行されます。

コマンドの問題をトラブルシューティングするには、インスタンスログで出力を確認できます。

構文

commands:
  command name: 
    command: command to run

オプション

例

次の例は、指定されたファイルに set コマンドの出力を保存します。後続のコマンドがある場合、Elastic Beanstalk は、このコマンドの完了直後にそのコマンドを実行します。このコマンドで再起動が必要な場合、Elastic Beanstalk はコマンドが完了すると、直後にインスタンスを再起動します。

commands:
  test: 
    command: set > c:\\myapp\\set.txt
    waitAfterCompletion: 0

サービス

services キーを使用して、インスタンスが起動されるときに開始または停止する必要のあるサービスを定義できます。また、services キーではソース、パッケージ、ファイルへの依存関係も指定でき、インストールされているファイルのために再起動が必要になった場合に、Elastic Beanstalk がサービスの再起動を処理します。

構文

services: 
  windows:
    name of service:
      files:
        - "file name"
      sources: 
        - "directory"	
      packages: 
        name of package manager:
            "package name[: version]"
      commands: 
        - "name of command"

オプション

例

services: 
  windows:
    myservice:
      enabled: true
      ensureRunning: true

コンテナコマンド

container_commands キーを使用して、アプリケーションのソースコードに影響するコマンドを実行します。コンテナコマンドは、アプリケーションおよびウェブサーバーが設定され、アプリケーションバージョンアーカイブが抽出された後、アプリケーションバージョンがデプロイされる前に実行されます。コンテナ以外のコマンドと他のカスタマイズオペレーションは、アプリケーションソースコードが抽出される前に実行されます。

コンテナコマンドは、ソースコードがアプリケーションサーバーにデプロイされる前に抽出されたステージングディレクトリから実行されます。コンテナコマンドを使用してステージングディレクトリにあるソースコードに対して行うすべての変更は、ソースが最終的な場所にデプロイされる際に含まれます。

コンテナコマンドの問題をトラブルシューティングするには、インスタンスログで出力を確認できます。

leader_only オプションを使用して、1 つのインスタンスでコマンドを実行するか、テストコマンドが test と評価される場合のみコマンドを実行するよう true を設定します。リーダー専用コンテナコマンドは、環境の作成およびデプロイ中のみ実行されます。他のコマンドやサーバーカスタマイズオペレーションは、インスタンスがプロビジョニングまたは更新されるたびに実行されます。リーダー専用コンテナコマンドは、AMI ID やインスタンスタイプの変更などの起動設定の変更によって実行されることはありません。

構文

container_commands:
  name of container_command:
    command: command to run

オプション

例

次の例は、指定されたファイルに set コマンドの出力を保存します。Elastic Beanstalk は 1 つのインスタンスでコマンドを実行し、コマンドが完了すると、直後にインスタンスを再起動します。

container_commands:
  foo:
    command: set > c:\\myapp\\set.txt
    leader_only: true
    waitAfterCompletion: 0