プロビジョニング変更タイプ (CTsの使用 - AMS Advanced Application デベロッパーガイド

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

プロビジョニング変更タイプ (CTsの使用

AMS はマネージドインフラストラクチャに責任を負います。変更を加えるには、正しい CT 分類 (カテゴリ、サブカテゴリ、項目、オペレーション) の RFC を送信する必要があります。このセクションでは、CTs を検索し、ニーズに合ったものがあるかどうかを判断し、ニーズがない場合は新しい CT をリクエストする方法について説明します。

既存の CT が要件を満たしているかどうかを確認する

AMS でデプロイする内容を決定したら、次のステップとして、既存の CTs と CloudFormation テンプレートを調べて、ソリューションがすでに存在するかどうかを確認します。

RFC を作成するときは、CT を指定する必要があります。 AWS マネジメントコンソール または AMS API/CLI を使用できます。両方を使用する例を次に示します。

コンソールまたは API/CLI を使用して、変更タイプ ID (CT) またはバージョンを検索できます。検索または分類の選択の 2 つの方法があります。どちらの選択タイプでも、最も頻繁に使用される最近使用された、またはアルファベットのいずれかを選択して検索をソートできます。

YouTube 動画: AWS Managed Services CLI を使用して RFC を作成する方法と、CT スキーマの場所を教えてください。

AMS コンソールの RFCs -> RFC の作成ページで、次の操作を行います。

  • 変更タイプによる参照 (デフォルト) を選択した場合、次のいずれかを実行します。

    • クイック作成エリアを使用して、AMS の最も一般的な CTs から選択します。ラベルをクリックすると、RFC の実行ページが開き、件名オプションが自動的に入力されます。必要に応じて残りのオプションを完了し、実行をクリックして RFC を送信します。

    • または、すべての変更タイプ領域までスクロールダウンし、オプションボックスに CT 名を入力し始めます。変更タイプ名を完全または完全に設定する必要はありません。関連する単語を入力して、変更タイプ ID、分類、または実行モード (自動または手動) で CT を検索することもできます。

      デフォルトのカードビューを選択すると、入力時に一致する CT カードが表示され、カードを選択して RFC の作成をクリックします。テーブルビューを選択し、関連する CT を選択し、RFC の作成をクリックします。どちらの方法でも、RFC の実行ページが開きます。

  • または、変更タイプの選択肢を確認するには、ページ上部の「カテゴリ別に選択」をクリックして、一連のドロップダウンオプションボックスを開きます。

  • カテゴリサブカテゴリ項目オペレーションを選択します。その変更タイプの情報ボックスは、ページの下部にパネルが表示されます。

  • 準備ができたら、Enter キーを押すと、一致する変更タイプのリストが表示されます。

  • リストから変更タイプを選択します。その変更タイプの情報ボックスがページの下部に表示されます。

  • 正しい変更タイプを取得したら、RFC の作成を選択します。

注記

これらのコマンドを機能させるには、AMS CLI をインストールする必要があります。AMS API または CLI をインストールするには、AMS コンソールのデベロッパーリソースページに移動します。AMS CM API または AMS SKMS API のリファレンスマテリアルについては、「 ユーザーガイド」の「AMS 情報リソース」セクションを参照してください。認証--profileのオプションを追加する必要がある場合があります。例: aws amsskms ams-cli-command --profile SAML。また、 など、すべての AMS コマンドが us-east-1 を使い果たすため、 --regionオプションを追加する必要がある場合がありますaws amscm ams-cli-command --region=us-east-1

注記

AMS API/CLI (amscm および amsskms) エンドポイントは、AWS N. Virginia リージョン にありますus-east-1。認証の設定方法や、アカウントとリソースが存在する AWS リージョンによっては、コマンドの発行--region us-east-1時に追加が必要になる場合があります。認証方法である場合は--profile saml、 を追加する必要がある場合もあります。

AMS CM API (ListChangeTypeClassificationSummaries を参照) または CLI を使用して変更タイプを検索するには:

フィルターまたはクエリを使用して検索できます。ListChangeTypeClassificationSummaries オペレーションには、Category、、SubcategoryItem、および のフィルターオプションがありますがOperation、値は既存の値と完全に一致する必要があります。CLI を使用する際のより柔軟な結果を得るには、 --queryオプションを使用できます。

AMS CM API/CLI を使用した変更タイプのフィルタリング
属性 有効値 有効/デフォルト条件 注意

ChangeTypeId

ChangeTypeId を表す任意の文字列 (例: ct-abc123xyz7890)

Equals (等しい)

変更タイプ IDs「変更タイプリファレンス」を参照してください。

変更タイプ IDs「変更タイプまたは CSIO の検索」を参照してください。

カテゴリ

任意の自由形式のテキスト

を含む

個々のフィールドの正規表現はサポートされていません。大文字と小文字を区別しない検索

サブカテゴリ

Item

Operation

  1. 変更タイプの分類を一覧表示する例をいくつか示します。

    次のコマンドは、すべての変更タイプカテゴリを一覧表示します。

    aws amscm list-change-type-categories

    次の コマンドは、指定されたカテゴリに属するサブカテゴリを一覧表示します。

    aws amscm list-change-type-subcategories --category CATEGORY

    次の コマンドは、指定されたカテゴリとサブカテゴリに属する項目を一覧表示します。

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY
  2. CLI クエリで変更タイプを検索する例をいくつか示します。

    次のコマンドは、項目名に「S3」が含まれている CT 分類の概要を検索し、カテゴリ、サブカテゴリ、項目、オペレーション、変更タイプ ID の出力をテーブル形式で作成します。

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+ | ListChangeTypeClassificationSummaries | +----------+-------------------------+--+------+----------------+ |Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r| +----------+-------------------------+--+------+----------------+
  3. その後、変更タイプ ID を使用して CT スキーマを取得し、パラメータを調べることができます。次のコマンドは、CreateS3Params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    CLI クエリの使用の詳細については、「--query Option で出力をフィルタリングする方法」および「クエリ言語リファレンス」のJMESPath Specification」を参照してください。

  4. 変更タイプ ID を取得したら、変更タイプのバージョンを検証して最新バージョンであることを確認することをお勧めします。次のコマンドを使用して、指定された変更タイプのバージョンを検索します。

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    AutomationStatus 特定の変更タイプの を検索するには、次のコマンドを実行します。

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    ExpectedExecutionDurationInMinutes 特定の変更タイプの を検索するには、次のコマンドを実行します。

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"

適切と思われる CT を見つけたら、それに関連付けられた実行パラメータ JSON スキーマを調べて、ユースケースに対処しているかどうかを確認します。

このコマンドを使用して、CT スキーマを CT にちなんで という名前の JSON ファイルに出力します。この例では、Create S3 storage schema を出力します。

aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateBucketParams.json

このスキーマが提供する内容を詳しく見てみましょう。

S3 バケットスキーマの作成
{ "$schema": "http://json-schema.org/draft-04/schema#", "name": "Create S3 Storage "description": "Use to create an Amazon Simple Storage Service stack.", "type": "object", "properties": { "Description": { "description": "The description of the stack.", "type": "string", "minLength": 1, "maxLength": 500 }, "VpcId": { "description": "ID of the VPC to create the S3 Bucket in, in the form vpc-a1b2c3d4e5f67890e.", "type": "string", "pattern": "^vpc-[a-z0-9]{17}$" }, "StackTemplateId": { "description": "Required value: stm-s2b72beb000000000.", "type": "string", "enum": ["stm-s2b72beb000000000"] }, "Name":{ "description": "The name of the stack to create.", "type": "string", "minLength": 1, "maxLength": 255 }, "Tags": { "description": "Up to seven tags (key/value pairs) for the stack.", "type": "array", "items": { "type": "object", "properties": { "Key": { "type": "string", "minLength": 1, "maxLength": 127 }, "Value": { "type": "string", "minLength": 1, "maxLength": 255 } }, "additionalProperties": false, "required": [ "Key", "Value" ] }, "minItems": 1, "maxItems": 7 }, "TimeoutInMinutes": { "description": "The amount of time, in minutes, to allow for creation of the stack.", "type": "number", "minimum": 0, "maximum": 60 }, "Parameters": { "description": "Specifications for the stack.", "type": "object", "properties": { "AccessControl": { "description": "The canned (predefined) access control list (ACL) to assign to the bucket.", "type": "string", "enum": [ "Private", "PublicRead", "AuthenticatedRead", "BucketOwnerRead" ] }, "BucketName": { "description": "A name for the bucket. The bucket name must contain only lowercase letters, numbers, periods (.), and hyphens (-).", "type": "string", "pattern": "^[a-z0-9]([-.a-z0-9]+)[a-z0-9]$", "minLength": 3, "maxLength": 63 } }, "additionalProperties": false, "required": [ "AccessControl", "BucketName" ] } }, "additionalProperties": false, "required": [ "Description", "VpcId", "StackTemplateId", "Name", "TimeoutInMinutes", "Parameters" ] }

スキーマは、スキーマの目的を示す CT (「説明」) で始まります。この場合、S3 ストレージスタックを作成します。

次に、指定できる必須プロパティとオプションプロパティがあります。デフォルトのプロパティ値が指定されています。必要なプロパティは、スキーマの最後に一覧表示されます。

StackTemplateId エリアでは、この CT とスキーマに 1 つの特定のスタックテンプレートがあり、その ID が必須のプロパティ値であることがわかります。

スキーマを使用すると、内部の簿記目的で、作成するスタックにタグを付けることができます。さらに、バックアップなどの一部のオプションでは、Key:backup と Value:true のタグが必要です。詳細については、Amazon EC2 リソースのタグ付け」を参照してください。

CT JSON スキーマの Parameters セクションでは、実行パラメータを指定します。

このスキーマでは、ACL と BucketName のみが必須の実行パラメータです。

新しい CT をリクエストする

スキーマを調べた後、必要なデプロイを作成するのに十分なパラメータが提供されていないと判断できます。その場合は、既存の CloudFormation テンプレートを調べて、目的に近いものを見つけます。必要な追加パラメータがわかったら、管理 | その他 | その他 | CT を作成します。

注記

All Other | Other Create and Update CTs は、AMS オペレーターから通知を受け、オペレーターから連絡を受けて新しい CT について話し合います。

新しい CT のリクエストを送信するには、通常の から AMS コンソールにアクセスしAWS マネジメントコンソール、以下の手順に従います。

  1. 左側のナビゲーションで、RFCsをクリックします。

    RFCsページが開きます。

  2. [Create (作成)] をクリックします。

    変更リクエストの作成ページが開きます。

  3. 「カテゴリ」ドロップダウンリストの「管理」を選択し、「サブカテゴリと項目」の「その他」を選択します。 オペレーションで、作成 を選択します。RFC を実装するには、事前に承認が必要です。

  4. CT が必要な理由の情報を入力します。たとえば、既存の Create S3 storage CT に基づいてカスタム ACLs を許可する、変更された Create S3 storage CT をリクエストします。これにより、新しい CT: Deployment | Advanced Stack Components | S3 ストレージ | Create S3 custom ACL が作成されます。この新しい CT は公開されている可能性があります。

  5. 送信 をクリックします。

    RFC ダッシュボードに RFC が表示されます。

新しい CT をテストする

AWS Managed Services がその新しい CT を作成したら、RFC を送信してテストします。AMS を使用して新しい CT を事前承認した場合は、標準の RFC 送信に従って結果を監視できます (RFCs」を参照してください)。 https://docs.aws.amazon.com/managedservices/latest/userguide/create-rfcs.html新しい CT が事前承認されていない場合 (明示的な承認なしに実行されないようにしたい場合)、その実装を実行するたびに AMS と話し合う必要があります。