Amazon Elastic Container Service
開発者ガイド (API バージョン 2014-11-13)

設定ファイルの移行

Amazon ECS CLI を設定するプロセスは最新バージョン (v1.0.0) で大幅に変更され、新機能の追加が可能になりました。古い (v0.6.6 以前) 設定ファイルを最新の形式に変換する移行コマンドが導入されました。古い設定ファイルは廃止されているため、新しい機能を活用するには、設定を最新の形式に変換することをお勧めします。新しい YAML 形式の設定ファイルの v1.0.0 で導入された設定に関連する変更と新機能には以下があります。

  • 認証情報とクラスター関連の設定情報の 2 つの個別のファイルへの分割。認証情報は ~/.ecs/credentials に保存され、クラスター設定情報は ~/.ecs/config に保存されます。

  • 設定ファイルは YAML 形式でフォーマットされます。

  • 複数の名前付き設定を保存するサポート。

  • フィールド compose-service-name-prefix の廃止 (サービス <compose_service_name_prefix> + <project_name> を作成するために使用される名前)。このフィールドは引き続き設定できます。ただし、設定されていない場合、デフォルト値は割り当てられなくなりました。Amazon ECS CLI v0.6.6 以前では、デフォルトは ecscompose-service- でした。

  • フィールド compose-project-name-prefix の削除 (タスク定義 <compose_project_name_prefix> + <project_name> を作成するために使用される名前)。Amazon ECS CLI v1.0.0 以降では引き続き古い設定ファイルを読み取ることができるため、このフィールドが存在する場合は、引き続き読み取られて使用されます。ただし、ecs-cli configure コマンドを使用したこのフィールドの設定は v1.0.0 以降ではサポートされていないため、このフィールドを手動で v1.0.0 以降の設定ファイルに追加すると、Amazon ECS CLI はエラーをスローします。

  • このフィールド cfn-stack-name-prefix (CFN スタック <cfn_stack_name_prefix> + <cluster_name> の作成に使用される名前) は cfn-stack-name に変更されました。プレフィックスを指定する代わりに、CloudFormation テンプレートの正確な名前を設定できます。

  • Amazon ECS CLI v0.6.6 以前では、システムの ~/.aws/credentials ファイルから名前付き AWS プロファイルを使用して認証情報を設定することができました。この機能は削除されました。ただし、新しいフラグ --aws-profile が追加されました。これにより、認証情報を必要とするすべてのコマンドで、AWS プロファイルをインラインで参照できます。

注記

--project-name フラグを使用してプロジェクト名を設定できます。

古い設定ファイルの v1.0.0 以降の形式への移行

すべてのバージョンの Amazon ECSCLI で古い設定ファイル形式からの読み取りがサポートされますが、いくつかの新機能 (複数の名前付きクラスタープロファイルの使用など) を利用するには、新しい形式へのアップグレードが必要です。レガシー設定ファイルの新しい形式への移行は、ecs-cli configure migrate コマンドにより簡単に行うことができます。このコマンドは、古い形式で ~/.ecs/config に保存された設定情報を受け取り、新しい形式でファイルのペアに変換し、そのプロセスで古い設定ファイルを上書きします。

ecs-cli configure migrate コマンドを実行中に、古い設定ファイルとともに警告メッセージが表示され、新しい設定ファイルのプレビューが表示されます。移行を続行するには、ユーザーの確認が必要です。--force フラグが使用されている場合、警告メッセージは表示されず、確認なしで移行が続行します。cfn-stack-name-prefix がレガシーファイルで使用されている場合、cfn-stack-name が新しいファイルに <cfn_stack_name_prefix> + <cluster_name> として保存されます。

詳細については、Amazon Elastic Container Service Developer Guide の「Amazon ECS コマンドラインリファレンス」を参照してください。