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.
# Testen Sie einen benutzerdefinierten Hook in Ihrem AWS-Konto
Nachdem Sie Ihre Handler-Funktionen codiert haben, die einem Aufrufpunkt entsprechen, ist es an der Zeit, Ihren benutzerdefinierten Hook auf einem CloudFormation Stack zu testen.
Der Hook-Fehlermodus ist auf eingestellt, `FAIL` wenn die CloudFormation Vorlage keinen S3-Bucket mit den folgenden Eigenschaften bereitgestellt hat:
+ Die Amazon S3 S3-Bucket-Verschlüsselung ist eingestellt.
+ Der Amazon S3 S3-Bucket-Schlüssel ist für den Bucket aktiviert.
+ Der für den Amazon S3 S3-Bucket festgelegte Verschlüsselungsalgorithmus ist der richtige erforderliche Algorithmus.
+ Die AWS Key Management Service Schlüssel-ID ist festgelegt.
Erstellen Sie im folgenden Beispiel eine Vorlage, die `my-failed-bucket-stack.yml` mit dem Stack-Namen aufgerufen wird und bei der `my-hook-stack` die Stack-Konfiguration fehlschlägt und beendet wird, bevor die Ressource bereitgestellt wird.
## Testen von Hooks durch Bereitstellung eines Stacks
### Beispiel 1: Um einen Stack bereitzustellen
**Stellen Sie einen nicht konformen Stack bereit**
1. Verfassen Sie eine Vorlage, die einen S3-Bucket spezifiziert. Beispiel, `my-failed-bucket-stack.yml`.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
S3Bucket:
Type: AWS::S3::Bucket
Properties: {}
```
1. Erstellen Sie einen Stack und geben Sie Ihre Vorlage im AWS Command Line Interface (AWS CLI) an. Geben Sie im folgenden Beispiel den Stacknamen als `my-hook-stack` und den Vorlagennamen als an`my-failed-bucket-stack.yml`.
```
$ aws cloudformation create-stack \
--stack-name my-hook-stack \
--template-body file://my-failed-bucket-stack.yml
```
1. (Optional) Zeigen Sie Ihren Stack-Fortschritt an, indem Sie Ihren Stack-Namen angeben. Geben Sie im folgenden Beispiel den Stack-Namen an`my-hook-stack`.
```
$ aws cloudformation describe-stack-events \
--stack-name my-hook-stack
```
Verwenden Sie den `describe-stack-events` Vorgang, um den Hook-Fehler beim Erstellen des Buckets zu überprüfen. Im Folgenden finden Sie ein Beispiel für die Ausgabe des Befehls.
```
{
"StackEvents": [
...
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-hook-stack/2c693970-f57e-11eb-a0fb-061a2a83f0b9",
"EventId": "S3Bucket-CREATE_FAILED-2021-08-04T23:47:03.305Z",
"StackName": "my-hook-stack",
"LogicalResourceId": "S3Bucket",
"PhysicalResourceId": "",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:47:03.305000+00:00",
"ResourceStatus": "CREATE_FAILED",
"ResourceStatusReason": "The following hook(s) failed: [MyCompany::Testing::MyTestHook]",
"ResourceProperties": "{}",
"ClientRequestToken": "Console-CreateStack-abe71ac2-ade4-a762-0499-8d34d91d6a92"
},
...
]
}
```
*Ergebnisse*: Der Hook-Aufruf hat die Stack-Konfiguration nicht bestanden und die Ressource konnte nicht bereitgestellt werden.
**Verwenden Sie eine CloudFormation Vorlage, um die Hook-Validierung zu bestehen**
1. Um einen Stack zu erstellen und die Hook-Validierung zu bestehen, aktualisieren Sie die Vorlage so, dass Ihre Ressource einen verschlüsselten S3-Bucket verwendet. In diesem Beispiel wird die Vorlage verwendet`my-encrypted-bucket-stack.yml`.
```
AWSTemplateFormatVersion: 2010-09-09
Description: |
This CloudFormation template provisions an encrypted S3 Bucket
Resources:
EncryptedS3Bucket:
Type: AWS::S3::Bucket
Properties:
BucketName: !Sub encryptedbucket-${AWS::Region}-${AWS::AccountId}
BucketEncryption:
ServerSideEncryptionConfiguration:
- ServerSideEncryptionByDefault:
SSEAlgorithm: 'aws:kms'
KMSMasterKeyID: !Ref EncryptionKey
BucketKeyEnabled: true
EncryptionKey:
Type: AWS::KMS::Key
DeletionPolicy: Retain
Properties:
Description: KMS key used to encrypt the resource type artifacts
EnableKeyRotation: true
KeyPolicy:
Version: 2012-10-17
Statement:
- Sid: Enable full access for owning account
Effect: Allow
Principal:
AWS: !Ref AWS::AccountId
Action: 'kms:*'
Resource: '*'
Outputs:
EncryptedBucketName:
Value: !Ref EncryptedS3Bucket
```
**Anmerkung**
Hooks werden nicht für übersprungene Ressourcen aufgerufen.
1. Erstelle einen Stapel und spezifiziere deine Vorlage. In diesem Beispiel lautet der Stack-Name`my-encrypted-bucket-stack`.
```
$ aws cloudformation create-stack \
--stack-name my-encrypted-bucket-stack \
--template-body file://my-encrypted-bucket-stack.yml \
```
1. (Optional) Zeigen Sie Ihren Stack-Fortschritt an, indem Sie den Stack-Namen angeben.
```
$ aws cloudformation describe-stack-events \
--stack-name my-encrypted-bucket-stack
```
Verwenden Sie den `describe-stack-events` Befehl, um die Antwort anzuzeigen. Im Folgenden finden Sie ein Beispiel für den `describe-stack-events`-Befehl.
```
{
"StackEvents": [
...
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-CREATE_COMPLETE-2021-08-04T23:23:20.973Z",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "encryptedbucket-us-west-2-123456789012",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:23:20.973000+00:00",
"ResourceStatus": "CREATE_COMPLETE",
"ResourceProperties": "{\"BucketName\":\"encryptedbucket-us-west-2-123456789012\",\"BucketEncryption\":{\"ServerSideEncryptionConfiguration\":[{\"BucketKeyEnabled\":\"true\",\"ServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"ENCRYPTION_KEY_ARN\"}}]}}",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-CREATE_IN_PROGRESS-2021-08-04T23:22:59.410Z",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "encryptedbucket-us-west-2-123456789012",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:22:59.410000+00:00",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceStatusReason": "Resource creation Initiated",
"ResourceProperties": "{\"BucketName\":\"encryptedbucket-us-west-2-123456789012\",\"BucketEncryption\":{\"ServerSideEncryptionConfiguration\":[{\"BucketKeyEnabled\":\"true\",\"ServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"ENCRYPTION_KEY_ARN\"}}]}}",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-6516081f-c1f2-4bfe-a0f0-cefa28679994",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:22:58.349000+00:00",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceStatusReason": "Hook invocations complete. Resource creation initiated",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
...
]
}
```
*Ergebnisse*: Der Stack wurde CloudFormation erfolgreich erstellt. Die Logik des Hooks überprüfte vor der Bereitstellung der `AWS::S3::Bucket` Ressource, ob die Ressource serverseitige Verschlüsselung enthielt.
### Beispiel 2: Um einen Stack bereitzustellen
**Stellen Sie einen nicht konformen Stack bereit**
1. Verfassen Sie eine Vorlage, die einen S3-Bucket spezifiziert. Zum Beispiel `aes256-bucket.yml`.
```
AWSTemplateFormatVersion: 2010-09-09
Description: |
This CloudFormation template provisions an encrypted S3 Bucket
Resources:
EncryptedS3Bucket:
Type: AWS::S3::Bucket
Properties:
BucketName: !Sub encryptedbucket-${AWS::Region}-${AWS::AccountId}
BucketEncryption:
ServerSideEncryptionConfiguration:
- ServerSideEncryptionByDefault:
SSEAlgorithm: AES256
BucketKeyEnabled: true
Outputs:
EncryptedBucketName:
Value: !Ref EncryptedS3Bucket
```
1. Erstellen Sie einen Stack und geben Sie Ihre Vorlage im an AWS CLI. Geben Sie im folgenden Beispiel den Stacknamen als `my-hook-stack` und den Vorlagennamen als an`aes256-bucket.yml`.
```
$ aws cloudformation create-stack \
--stack-name my-hook-stack \
--template-body file://aes256-bucket.yml
```
1. (Optional) Zeigen Sie Ihren Stack-Fortschritt an, indem Sie Ihren Stack-Namen angeben. Geben Sie im folgenden Beispiel den Stack-Namen an`my-hook-stack`.
```
$ aws cloudformation describe-stack-events \
--stack-name my-hook-stack
```
Verwenden Sie den `describe-stack-events` Vorgang, um den Hook-Fehler beim Erstellen des Buckets zu überprüfen. Im Folgenden finden Sie ein Beispiel für die Ausgabe des Befehls.
```
{
"StackEvents": [
...
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-hook-stack/2c693970-f57e-11eb-a0fb-061a2a83f0b9",
"EventId": "S3Bucket-CREATE_FAILED-2021-08-04T23:47:03.305Z",
"StackName": "my-hook-stack",
"LogicalResourceId": "S3Bucket",
"PhysicalResourceId": "",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:47:03.305000+00:00",
"ResourceStatus": "CREATE_FAILED",
"ResourceStatusReason": "The following hook(s) failed: [MyCompany::Testing::MyTestHook]",
"ResourceProperties": "{}",
"ClientRequestToken": "Console-CreateStack-abe71ac2-ade4-a762-0499-8d34d91d6a92"
},
...
]
}
```
*Ergebnisse*: Der Hook-Aufruf hat die Stack-Konfiguration nicht bestanden und die Ressource konnte nicht bereitgestellt werden. Der Stack ist aufgrund der falsch konfigurierten S3-Bucket-Verschlüsselung fehlgeschlagen. Die Konfiguration vom Typ Hook erfordert, `aws:kms` solange dieser Bucket verwendet wird`AES256`.
**Verwenden Sie eine CloudFormation Vorlage, um die Hook-Validierung zu bestehen**
1. Um einen Stack zu erstellen und die Hook-Validierung zu bestehen, aktualisieren Sie die Vorlage so, dass Ihre Ressource einen verschlüsselten S3-Bucket verwendet. In diesem Beispiel wird die Vorlage verwendet`kms-bucket-and-queue.yml`.
```
AWSTemplateFormatVersion: 2010-09-09
Description: |
This CloudFormation template provisions an encrypted S3 Bucket
Resources:
EncryptedS3Bucket:
Type: AWS::S3::Bucket
Properties:
BucketName: !Sub encryptedbucket-${AWS::Region}-${AWS::AccountId}
BucketEncryption:
ServerSideEncryptionConfiguration:
- ServerSideEncryptionByDefault:
SSEAlgorithm: 'aws:kms'
KMSMasterKeyID: !Ref EncryptionKey
BucketKeyEnabled: true
EncryptedQueue:
Type: AWS::SQS::Queue
Properties:
QueueName: !Sub encryptedqueue-${AWS::Region}-${AWS::AccountId}
KmsMasterKeyId: !Ref EncryptionKey
EncryptionKey:
Type: AWS::KMS::Key
DeletionPolicy: Retain
Properties:
Description: KMS key used to encrypt the resource type artifacts
EnableKeyRotation: true
KeyPolicy:
Version: 2012-10-17
Statement:
- Sid: Enable full access for owning account
Effect: Allow
Principal:
AWS: !Ref AWS::AccountId
Action: 'kms:*'
Resource: '*'
Outputs:
EncryptedBucketName:
Value: !Ref EncryptedS3Bucket
EncryptedQueueName:
Value: !Ref EncryptedQueue
```
**Anmerkung**
Hooks werden nicht für übersprungene Ressourcen aufgerufen.
1. Erstelle einen Stapel und spezifiziere deine Vorlage. In diesem Beispiel lautet der Stack-Name`my-encrypted-bucket-stack`.
```
$ aws cloudformation create-stack \
--stack-name my-encrypted-bucket-stack \
--template-body file://kms-bucket-and-queue.yml
```
1. (Optional) Zeigen Sie Ihren Stack-Fortschritt an, indem Sie den Stack-Namen angeben.
```
$ aws cloudformation describe-stack-events \
--stack-name my-encrypted-bucket-stack
```
Verwenden Sie den `describe-stack-events` Befehl, um die Antwort anzuzeigen. Im Folgenden finden Sie ein Beispiel für den `describe-stack-events`-Befehl.
```
{
"StackEvents": [
...
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-CREATE_COMPLETE-2021-08-04T23:23:20.973Z",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "encryptedbucket-us-west-2-123456789012",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:23:20.973000+00:00",
"ResourceStatus": "CREATE_COMPLETE",
"ResourceProperties": "{\"BucketName\":\"encryptedbucket-us-west-2-123456789012\",\"BucketEncryption\":{\"ServerSideEncryptionConfiguration\":[{\"BucketKeyEnabled\":\"true\",\"ServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"ENCRYPTION_KEY_ARN\"}}]}}",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-CREATE_IN_PROGRESS-2021-08-04T23:22:59.410Z",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "encryptedbucket-us-west-2-123456789012",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:22:59.410000+00:00",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceStatusReason": "Resource creation Initiated",
"ResourceProperties": "{\"BucketName\":\"encryptedbucket-us-west-2-123456789012\",\"BucketEncryption\":{\"ServerSideEncryptionConfiguration\":[{\"BucketKeyEnabled\":\"true\",\"ServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"ENCRYPTION_KEY_ARN\"}}]}}",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-encrypted-bucket-stack/82a97150-f57a-11eb-8eb2-06a6bdcc7779",
"EventId": "EncryptedS3Bucket-6516081f-c1f2-4bfe-a0f0-cefa28679994",
"StackName": "my-encrypted-bucket-stack",
"LogicalResourceId": "EncryptedS3Bucket",
"PhysicalResourceId": "",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2021-08-04T23:22:58.349000+00:00",
"ResourceStatus": "CREATE_IN_PROGRESS",
"ResourceStatusReason": "Hook invocations complete. Resource creation initiated",
"ClientRequestToken": "Console-CreateStack-39df35ac-ca00-b7f6-5661-4e917478d075"
},
...
]
}
```
*Ergebnisse*: Der Stack wurde CloudFormation erfolgreich erstellt. Die Logik des Hooks überprüfte vor der Bereitstellung der `AWS::S3::Bucket` Ressource, ob die Ressource serverseitige Verschlüsselung enthielt.