Arbeiten mit Provisioning-Änderungstypen () CTs - AMS-Leitfaden für fortgeschrittene Anwendungsentwickler
Finden Sie heraus, ob ein vorhandenes CT Ihren Anforderungen entsprichtFordern Sie ein neues CT anTesten Sie das neue CT

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit Provisioning-Änderungstypen () CTs

AMS ist für Ihre verwaltete Infrastruktur verantwortlich. Um Änderungen vornehmen zu können, müssen Sie einen RFC mit der richtigen CT-Klassifizierung (Kategorie, Unterkategorie, Artikel und Vorgang) einreichen. In diesem Abschnitt wird beschrieben, wie Sie herausfinden CTs, ob ein CT Ihren Anforderungen entspricht, und wie Sie ein neues CT anfordern können, falls es keine gibt.

Finden Sie heraus, ob ein vorhandenes CT Ihren Anforderungen entspricht

Sobald Sie festgelegt haben, was Sie mit AMS implementieren möchten, besteht der nächste Schritt darin, die vorhandenen CloudFormation Vorlagen CTs und Vorlagen zu untersuchen, um festzustellen, ob bereits eine Lösung existiert.

Wenn Sie einen RFC erstellen, müssen Sie den CT angeben. Sie können die AWS-Managementkonsole oder die AMS API/CLI verwenden. Beispiele für die Verwendung von beiden werden im Folgenden beschrieben.

Sie können die Konsole oder die verwenden API/CLI , um nach einer Änderungstyp-ID (CT) oder Version zu suchen. Es gibt zwei Methoden: entweder eine Suche oder die Auswahl der Klassifizierung. Für beide Auswahltypen können Sie die Suche sortieren, indem Sie entweder „Am häufigsten verwendet“, „Zuletzt verwendet“ oder „Alphabetisch“ auswählen.

YouTube Video: Wie erstelle ich einen RFC mit der AWS Managed Services CLI und wo finde ich das CT-Schema?

Gehen Sie in der AMS-Konsole auf der Seite RFCs-> RFC erstellen wie folgt vor:

  • Wenn „Nach Änderungstyp suchen“ ausgewählt ist (Standardeinstellung), können Sie entweder:

    • Verwenden Sie den Bereich Schnellerstellung, um aus den beliebtesten AMS-Programmen auszuwählen CTs. Klicken Sie auf ein Label und die Seite RFC ausführen wird geöffnet, auf der die Option Betreff automatisch für Sie ausgefüllt wird. Füllen Sie die verbleibenden Optionen nach Bedarf aus und klicken Sie auf Ausführen, um den RFC einzureichen.

    • Oder scrollen Sie nach unten zum Bereich Alle Änderungstypen und beginnen Sie, einen CT-Namen in das Optionsfeld einzugeben. Sie müssen nicht den genauen oder vollständigen Namen des Änderungstyps haben. Sie können auch anhand der ID des Änderungstyps, der Klassifizierung oder des Ausführungsmodus (automatisiert oder manuell) nach einem CT suchen, indem Sie die entsprechenden Wörter eingeben.

      Wenn die standardmäßige Kartenansicht ausgewählt ist, werden während der Eingabe passende CT-Karten angezeigt. Wählen Sie eine Karte aus und klicken Sie auf RFC erstellen. Wählen Sie bei ausgewählter Tabellenansicht das entsprechende CT aus und klicken Sie auf RFC erstellen. Bei beiden Methoden wird die Seite RFC ausführen geöffnet.

  • Klicken Sie alternativ oben auf der Seite auf Nach Kategorie auswählen, um eine Reihe von Drop-down-Optionsfeldern zu öffnen, um die Auswahlmöglichkeiten für den Änderungstyp zu erkunden.

  • Wählen Sie eine Kategorie, eine Unterkategorie, einen Artikel und einen Vorgang aus. Das Informationsfeld für diesen Änderungstyp wird angezeigt. Unten auf der Seite wird ein Bereich angezeigt.

  • Wenn Sie bereit sind, drücken Sie die EINGABETASTE. Daraufhin wird eine Liste der passenden Änderungstypen angezeigt.

  • Wählen Sie einen Änderungstyp aus der Liste aus. Das Informationsfeld für diesen Änderungstyp wird unten auf der Seite angezeigt.

  • Wenn Sie den richtigen Änderungstyp gefunden haben, wählen Sie Create RFC.

Anmerkung

Die AMS-CLI muss installiert sein, damit diese Befehle funktionieren. Um die AMS-API oder CLI zu installieren, rufen Sie die Seite Entwicklerressourcen der AMS-Konsole auf. Referenzmaterial zur AMS CM API oder AMS SKMS API finden Sie im Abschnitt AMS-Informationsressourcen im Benutzerhandbuch. Möglicherweise müssen Sie eine --profile Option für die Authentifizierung hinzufügen, aws amsskms ams-cli-command --profile SAML z. B.. Möglicherweise müssen Sie die --region Option auch hinzufügen, da allen AMS-Befehlen beispielsweise us-east-1 ausgeht. aws amscm ams-cli-command --region=us-east-1

Anmerkung

Die AMS-Endpunkte API/CLI (amscm und amsskms) befinden sich in der AWS-Region Nord-Virginia,. us-east-1 Je nachdem, wie Ihre Authentifizierung eingerichtet ist und in welcher AWS-Region sich Ihr Konto und Ihre Ressourcen befinden, müssen Sie --region us-east-1 bei der Ausgabe von Befehlen möglicherweise zusätzliche Informationen hinzufügen. Möglicherweise müssen Sie auch angeben--profile saml, ob dies Ihre Authentifizierungsmethode ist.

So suchen Sie mit der AMS CM API (siehe ListChangeTypeClassificationSummaries) oder CLI nach einem Änderungstyp:

Sie können einen Filter oder eine Abfrage für die Suche verwenden. Der ListChangeTypeClassificationSummaries Vorgang verfügt über Filteroptionen für CategorySubcategory,Item, undOperation, aber die Werte müssen exakt mit den vorhandenen Werten übereinstimmen. Für flexiblere Ergebnisse bei der Verwendung der CLI können Sie die --query Option verwenden.

Ändern Sie die Typfilterung mit der AMS CM API/CLI
Attribut Zulässige Werte Gültige/Standardbedingung Hinweise

ChangeTypeId

Jede Zeichenfolge, die a darstellt ChangeTypeId (Zum Beispiel: ct-abc123xyz7890)

Gleichheitszeichen

Informationen zum Änderungstyp finden Sie in der Referenz zum Änderungstyp. IDs

Informationen zum Änderungstyp IDs finden Sie unter Suche nach einem Änderungstyp oder CSIO.

Kategorie

Beliebiger Text in freier Form

Enthält

Reguläre Ausdrücke in jedem einzelnen Feld werden nicht unterstützt. Suche ohne Berücksichtigung von Groß- und Kleinschreibung

Unterkategorie

Item

Operation

  1. Hier sind einige Beispiele für Klassifizierungen nach der Art der Angebotsänderung:

    Der folgende Befehl listet alle Kategorien von Änderungstypen auf.

    aws amscm list-change-type-categories

    Der folgende Befehl listet die Unterkategorien auf, die zu einer bestimmten Kategorie gehören.

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

    Der folgende Befehl listet die Elemente auf, die zu einer bestimmten Kategorie und Unterkategorie gehören.

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. Hier sind einige Beispiele für die Suche nach Änderungstypen mit CLI-Abfragen:

    Der folgende Befehl durchsucht CT-Klassifikationszusammenfassungen nach solchen, die „S3" im Elementnamen enthalten, und erstellt eine Ausgabe der Kategorie-, Unterkategorie-, Element-, Vorgangs- und Änderungstyp-ID in Tabellenform. 

    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. Anschließend können Sie die Änderungstyp-ID verwenden, um das CT-Schema abzurufen und die Parameter zu untersuchen. Mit dem folgenden Befehl wird das Schema in eine JSON-Datei mit dem Namen CreateS3Params.schema.json ausgegeben.

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

    Informationen zur Verwendung von CLI-Abfragen finden Sie unter So filtern Sie die Ausgabe mit der Option --query und in der Referenz zur Abfragesprache, JMESPath Spezifikation.

  4. Nachdem Sie die Änderungstyp-ID erhalten haben, empfehlen wir, die Version für den Änderungstyp zu überprüfen, um sicherzustellen, dass es sich um die neueste Version handelt. Verwenden Sie diesen Befehl, um die Version für einen bestimmten Änderungstyp zu finden:

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

    Um die AutomationStatus für einen bestimmten Änderungstyp zu finden, führen Sie diesen Befehl aus:

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

    Führen Sie diesen Befehl aus, um ExpectedExecutionDurationInMinutes nach dem für einen bestimmten Änderungstyp zu suchen:

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

Wenn Sie ein CT gefunden haben, das Sie für geeignet halten, schauen Sie sich das zugehörige JSON-Schema mit den Ausführungsparametern an, um zu erfahren, ob es für Ihren Anwendungsfall geeignet ist.

Verwenden Sie diesen Befehl, um ein CT-Schema in eine nach dem CT benannte JSON-Datei auszugeben. In diesem Beispiel wird das Create S3-Speicherschema ausgegeben:

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

Schauen wir uns genauer an, was dieses Schema bietet.

S3-Bucket: Schema erstellen 
{	
  "$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"
  ]
}

Das Schema beginnt mit der CT („Beschreibung“), die Ihnen sagt, wofür das Schema gedacht ist. In diesem Fall, um einen S3-Speicher-Stack zu erstellen.

Als Nächstes haben Sie die erforderlichen und optionalen Eigenschaften, die Sie angeben können. Standardwerte für Eigenschaften sind angegeben. Die erforderlichen Eigenschaften sind am Ende des Schemas aufgeführt.

In diesem StackTemplateId Bereich sehen Sie, dass es für diesen CT und dieses Schema eine spezifische Stack-Vorlage gibt, deren ID ein erforderlicher Eigenschaftswert ist.

Das Schema ermöglicht es Ihnen, den Stapel, den Sie gerade erstellen, für interne Buchhaltungszwecke zu taggen. Darüber hinaus erfordern einige Optionen, wie Backup, die Tags key:Backup und value:True. Ausführliche Informationen finden Sie unter Tagging Your Amazon EC2 Resources.

Im Abschnitt „Parameter“ des CT-JSON-Schemas geben Sie die Ausführungsparameter an.

Für dieses Schema BucketName sind nur die ACL und die Ausführungsparameter erforderlich.

Fordern Sie ein neues CT an

Nachdem Sie das Schema geprüft haben, stellen Sie möglicherweise fest, dass es nicht genügend Parameter bietet, um die gewünschte Bereitstellung zu erstellen. Wenn das der Fall ist, überprüfen Sie die vorhandenen CloudFormation Vorlagen, um eine zu finden, die Ihren Vorstellungen am nächsten kommt. Sobald Sie wissen, welche zusätzlichen Parameter Sie benötigen, reichen Sie die Felder Management | Other | Other | Create CT ein.

Anmerkung

Alle anderen | Sonstige Erstellung und Aktualisierung CTs werden von einem AMS-Mitarbeiter bearbeitet, der sich mit Ihnen in Verbindung setzen wird, um das neue CT zu besprechen.

Um eine Anfrage für ein neues CT einzureichen, greifen Sie wie gewohnt auf die AMS-Konsole zu AWS-Managementkonsoleund folgen Sie dann diesen Schritten.

  1. Klicken Sie in der linken Navigationsleiste auf RFCs.

    Die RFCs Dashboard-Seite wird geöffnet.

  2. Klicken Sie auf Create.

    Die Seite Änderungsantrag erstellen wird geöffnet.

  3. Wählen Sie in der Dropdownliste Kategorie die Option Verwaltung und für die Unterkategorie und den Artikel die Option Andere aus. Wählen Sie für den Vorgang die Option Erstellen aus. Der RFC muss genehmigt werden, bevor er implementiert werden kann.

  4. Geben Sie Informationen ein, warum Sie das CT benötigen, zum Beispiel: Fordern Sie ein modifiziertes Create S3-Storage-CT an ACLs, das auf dem vorhandenen Create S3-Storage-CT basiert und ein benutzerdefiniertes ermöglicht. Dies sollte zu einem neuen CT führen: Bereitstellung | Erweiterte Stack-Komponenten | S3-Speicher | Benutzerdefinierte S3-ACL erstellen. Dieses neue CT könnte öffentlich sein.

  5. Klicken Sie auf Submit.

    Ihr RFC wird im RFC-Dashboard angezeigt.

Testen Sie das neue CT

Sobald AWS Managed Services diesen neuen CT erstellt hat, testen Sie ihn, indem Sie einen RFC zusammen mit ihm einreichen. Wenn Sie mit AMS zusammengearbeitet haben, um das neue CT vorab zu genehmigen, können Sie einfach einer standardmäßigen RFC-Einreichung folgen und auf das Ergebnis achten (Einzelheiten zur Einreichung finden Sie unter Erstellen und RFCs Einreichen eines RFC). Wenn das neue CT nicht vorab genehmigt wurde (Sie möchten sichergehen, dass es nie ohne ausdrückliche Genehmigung ausgeführt wird), müssen Sie seine Implementierung jedes Mal, wenn Sie es ausführen möchten, mit AMS besprechen.