Esta es la guía para desarrolladores de AWS CDK v2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
cdk drift
Detecte desviaciones en la configuración de los recursos que defina, gestione e implemente mediante el AWS Cloud Development Kit (AWS CDK). La desviación se produce cuando la configuración real de una pila difiere de la configuración esperada, lo que ocurre cuando los recursos se modifican fuera de AWS CloudFormation ella.
Este comando identifica los recursos que se han modificado (por ejemplo, mediante la AWS consola o la AWS CLI) comparando su estado actual con la configuración esperada. Estas modificaciones pueden provocar un comportamiento inesperado en la infraestructura.
Durante la detección de desviaciones, la CLI de CDK generará indicadores de progreso y resultados, que muestran:
-
Recursos que se han desviado de la configuración esperada.
-
El número total de recursos con desviación.
-
Un resumen que indica si se ha detectado una desviación en la pila.
importante
Los cdk diff comandos cdk drift y funcionan de forma diferente:
-
cdk driftCloudFormationllama a la operación de detección de desviaciones para comparar el estado real de los recursos en AWS («realidad») con su configuración esperada en CloudFormation. No todos los AWS recursos admiten la detección de desviaciones. Para ver la lista de recursos de admitidos, consulte Tipo de recursos compatibles en la AWS Guía del usuario de CloudFormation . -
cdk diffcompara la CloudFormation plantilla sintetizada a partir del código CDK local con la plantilla de la CloudFormation pila implementada.
Úselo cdk drift cuando necesite comprobar si los recursos se han modificado fuera de CloudFormation (por ejemplo, mediante la AWS consola o la AWS CLI). Úselo cdk diff cuando desee obtener una vista previa de cómo afectarían los cambios en el código local a su infraestructura antes de la implementación.
Uso
$ cdk drift <arguments> <options>
Argumentos
- Nombre de pila
-
El nombre de la pila en la que quieres comprobar si hay desviaciones. La pila debe estar desplegada previamente CloudFormation para poder detectar la desviación.
Tipo: cadena
Obligatorio: no
Si no se especifica ninguna pila, la detección de desviaciones se realizará en todas las pilas definidas en la aplicación CDK.
Opciones
Para obtener una lista de las opciones globales que funcionan con todos los comandos CLI de CDK, consulte Opciones globales.
-
--fail <BOOLEAN> -
Regrese con el código de salida 1 si detecta una desviación.
Valor predeterminado:
false
-
--help, -h <BOOLEAN> -
Muestra la información de referencia del comando
cdk drift.
Ejemplos
Compruebe la desviación de una pila específica
$ cdk drift MyStackName
El comando generará resultados similares a los siguientes:
Stack MyStackName Modified Resources [~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD └─ [~] /Description ├─ [-] My original hello world Lambda function └─ [+] My drifted hello world Lambda function 1 resource has drifted from their expected configuration ✨ Number of resources with drift: 1
Compruebe la desviación cuando se hayan eliminado los recursos
El siguiente ejemplo muestra cómo se ve el resultado cuando los recursos se han modificado y eliminado:
Stack MyStackName Modified Resources [~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD └─ [~] /Description ├─ [-] My original hello world Lambda function └─ [+] My drifted hello world Lambda function Deleted Resources [-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234 2 resources have drifted from their expected configuration ✨ Number of resources with drift: 2
Compruebe la deriva con el código de salida
Para que el comando devuelva un código de salida distinto de cero si se detecta una desviación:
$ cdk drift MyStackName --fail
Esto resulta útil en las canalizaciones de CI/CD para detectar y responder automáticamente a las desviaciones de la infraestructura.
