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. # Referencia de estructura de las reglas En esta sección se hace referencia únicamente a la configuración de reglas. Para obtener información general conceptual sobre la estructura de la canalización, consulte [CodePipeline referencia de estructura de tubería](reference-pipeline-structure.md). Cada proveedor de reglas de CodePipeline utiliza un conjunto de campos de configuración obligatorios y opcionales en la estructura de la canalización. En esta sección se proporciona la siguiente información de referencia según el proveedor de reglas: + Valores válidos para los campos `RuleType` incluidos en el bloque de regla de estructura de canalización, como, por ejemplo, `Owner` y `Provider`. + Descripciones y otra información de referencia sobre los parámetros `Configuration` (obligatorios y opcionales) incluidos en la sección de regla de estructura de canalización. + Ejemplos de campos de configuración de reglas JSON y YAML válidos. La información de referencia está disponible para los siguientes proveedores de reglas: **Topics** + [CloudWatchAlarm](rule-reference-CloudWatchAlarm.md) + [Regla de CodeBuild](rule-reference-CodeBuild.md) + [Comandos](rule-reference-Commands.md) + [DeploymentWindow](rule-reference-DeploymentWindow.md) + [LambdaInvoke](rule-reference-LambdaInvoke.md) + [VariableCheck](rule-reference-VariableCheck.md) # CloudWatchAlarm Al crear una condición, puede agregar la regla `CloudWatchAlarm`. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). Debes haber creado ya una alarma en Amazon CloudWatch como recurso independiente. **Topics** + [Tipo de regla](#rule-reference-CloudWatchAlarm-type) + [Parámetros de configuración](#rule-reference-CloudWatchAlarm-config) + [Ejemplo de configuraciones de regla](#rule-reference-CloudWatchAlarm-example) + [Véase también](#rule-reference-CloudWatchAlarm-links) ## Tipo de regla + Categoría: `Rule` + Propietario: `AWS` + Proveedor: `CloudWatchAlarm` + Versión: `1` ## Parámetros de configuración **AlarmName** Obligatorio: sí El nombre de la CloudWatch alarma. Se trata de un recurso independiente creado en CloudWatch. **AlarmStates** Obligatorio: no Los estados de CloudWatch alarma deseados para que la regla los supervise. Los valores válidos son ALARM, OK y INSUFFICIENT\$1DATA. **WaitTime** Obligatorio: no El tiempo de espera en minutos para permitir un cambio de estado antes de ejecutar el resultado de la regla. Por ejemplo, configure 20 minutos para esperar a que un estado de alarma cambie a OK antes de aplicar el resultado de la regla. ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` rules: - name: MyMonitorRule ruleTypeId: category: Rule owner: AWS provider: CloudWatchAlarm version: '1' configuration: AlarmName: CWAlarm WaitTime: '1' inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyMonitorRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CloudWatchAlarm", "version": "1" }, "configuration": { "AlarmName": "CWAlarm", "WaitTime": "1" }, "inputArtifacts": [], "region": "us-east-1" } ] } ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + [Creación de condiciones de fallo](stage-conditions.md#stage-conditions-onfailure): en esta sección se proporcionan los pasos necesarios para crear una condición de fallo con una regla de alarma. # Regla de CodeBuild Al crear una condición, puede agregar la regla de CodeBuild. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). Puede usar la regla de CodeBuild para crear una condición para que la ejecución del proyecto de compilación sea correcta si cumple los criterios de la regla, por ejemplo, que la ejecución de la compilación sea correcta para una condición beforeEntry. **nota** Para las condiciones beforeEntry que se configuran con el resultado **Skip**, solo están disponibles las reglas `LambdaInvoke` y `VariableCheck`. **Topics** + [Permisos para las políticas de roles de servicio](#rule-reference-Commands-policy) + [Tipo de regla](#rule-reference-Commands-type) + [Parámetros de configuración](#rule-reference-Commands-config) + [Ejemplo de configuraciones de regla](#rule-reference-Commands-example) + [Véase también](#rule-reference-Commands-links) ## Permisos para las políticas de roles de servicio Para conceder permisos a esta regla, agregue lo siguiente a la declaración de la política de rol de servicio de CodePipeline. Reduzca los permisos al nivel de recurso. ``` { "Effect": "Allow", "Action": [ "codebuild:BatchGetBuilds", "codebuild:StartBuild" ], "Resource": "resource_ARN" }, ``` ## Tipo de regla + Categoría: `Rule` + Propietario: : `AWS` + Proveedor: `CodeBuild` + Versión: `1` ## Parámetros de configuración **ProjectName** Obligatorio: sí `ProjectName` es el nombre del proyecto de compilación de CodeBuild. **PrimarySource** Obligatorio: condicional El valor del parámetro `PrimarySource` debe ser el nombre de uno de los artefactos de entrada de la acción. CodeBuild busca el archivo buildspec y ejecuta los comandos buildspec en el directorio que contiene la versión descomprimida de este artefacto. Este parámetro es necesario si se especifican varios artefactos de entrada para una acción de CodeBuild. Cuando solo hay un artefacto de origen para la acción, el artefacto `PrimarySource` se establece como valor predeterminado de dicho artefacto. **BatchEnabled** Obligatorio: no El valor booleano del parámetro `BatchEnabled` permite que la acción ejecute varias compilaciones en la misma ejecución de compilación. Cuando esta opción está habilitada, la opción `CombineArtifacts` está disponible. Para ver ejemplos de canalizaciones con compilaciones por lotes habilitadas, consulte [Integración de CodePipeline con CodeBuild y compilaciones por lotes](https://docs.aws.amazon.com/codebuild/latest/userguide/sample-pipeline-batch.html). **CombineArtifacts** Obligatorio: no El valor booleano del parámetro `CombineArtifacts` combina todos los artefactos de compilación de una compilación por lotes en un único archivo de artefactos para la acción de compilación. Para utilizar esta opción, el parámetro `BatchEnabled` debe estar activado. **EnvironmentVariables** Obligatorio: no El valor de este parámetro se utiliza para establecer variables de entorno para la acción de CodeBuild de la canalización. El valor del parámetro `EnvironmentVariables` toma la forma de una matriz JSON de objetos de variables de entorno. Consulte el parámetro de ejemplo en [Declaración de acción (CodeBuild ejemplo)](action-reference-CodeBuild.md#action-reference-CodeBuild-example). Cada objeto tiene tres partes, todas las cuales son cadenas: + `name`: el nombre o la clave de la variable de entorno. + `value`: el valor de la variable de entorno. Al utilizar el tipo `PARAMETER_STORE` o `SECRETS_MANAGER`, este valor debe ser el nombre de un parámetro que ya haya almacenado en el almacén de parámetros de AWS Systems Manager o un secreto en el que ya haya almacenado en AWS Secrets Manager, respectivamente. **nota** Se desaconseja usar variables de entorno para almacenar valores confidenciales, especialmente las credenciales de AWS. Cuando utiliza la consola de CodeBuild o la CLI de AWS, las variables de entorno se muestran en texto sin formato. Para valores confidenciales, se recomienda utilizar el tipo `SECRETS_MANAGER`en su lugar. + `type`: (opcional) el tipo de la variable de entorno. Los valores válidos son `PARAMETER_STORE`, `SECRETS_MANAGER` o `PLAINTEXT`. Si no se especifica, toma el valor predeterminado `PLAINTEXT`. Cuando introduzca los valores `name`, `value`, y `type` de configuración de las variables de entorno, especialmente si la variable de entorno contiene sintaxis de variable de salida de CodePipeline, no supere el límite de 1000 caracteres del campo de valor de la configuración. Cuando se supera este límite, se devuelve un error de validación. Para obtener más información, consulte [EnvironmentVariable](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_EnvironmentVariable.html) en la AWS CodeBuildAPI Reference. Para ver un ejemplo de acción de CodeBuild con una variable de entorno que se resuelva en el nombre de la ramificación de GitHub, consulte [Ejemplo: usa una BranchName variable con variables de CodeBuild entorno](actions-variables.md#actions-variables-examples-env-branchname). ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` name: codebuild-rule ruleTypeId: category: Rule owner: AWS provider: CodeBuild version: '1' configuration: ProjectName: my-buildproject EnvironmentVariables: '[{"name":"VAR1","value":"variable","type":"PLAINTEXT"}]' inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "name": "codebuild-rule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "CodeBuild", "version": "1" }, "configuration": { "ProjectName": "my-buildproject" }, "inputArtifacts": [ { "name": "SourceArtifact", "EnvironmentVariables": "[{\"name\":\"VAR1\",\"value\":\"variable\",\"type\":\"PLAINTEXT\"}]" } ], "region": "us-east-1" } ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + Para obtener más información sobre las reglas y condiciones, consulte [Condition](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html), [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html) y [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html) en la *Guía de la API de CodePipeline*. # Comandos Al crear una condición, puede agregar la regla `Commands`. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). Puede usar la regla `Commands` para crear una condición en virtud de la cual, para la correcta ejecución de los comandos, se deben cumplir los criterios de la regla, como que la salida y la ruta del archivo de los comandos sean correctos para una condición beforeEntry. **nota** Para las condiciones beforeEntry que se configuran con el resultado **Skip**, solo están disponibles las reglas `LambdaInvoke` y `VariableCheck`. **Topics** + [Consideraciones sobre la regla de comandos](#rule-reference-Commands-considerations) + [Permisos para las políticas de roles de servicio](#rule-reference-Commands-policy) + [Tipo de regla](#rule-reference-Commands-type) + [Parámetros de configuración](#rule-reference-Commands-config) + [Ejemplo de configuraciones de regla](#rule-reference-Commands-example) + [Véase también](#rule-reference-Commands-links) ## Consideraciones sobre la regla de comandos Las siguientes consideraciones se aplican a la regla de comandos. + La regla de comandos usa CodeBuild recursos similares a los de la CodeBuild acción y, al mismo tiempo, permite los comandos del entorno de shell en una instancia de cómputo virtual sin necesidad de asociar o crear un proyecto de compilación. **nota** La ejecución de la regla de comandos generará cargos separados. AWS CodeBuild + Como la regla de comandos CodePipeline utiliza CodeBuild recursos, las compilaciones ejecutadas por la acción se atribuirán a los límites de creación de tu cuenta en CodeBuild. Las compilaciones ejecutadas por la regla de comandos se tendrán en cuenta para los límites de compilación simultánea configurados para esa cuenta. + El tiempo de espera para las compilaciones con la regla de comandos es de 55 minutos, según las CodeBuild compilaciones. + La instancia de procesamiento utiliza un entorno de compilación aislado en CodeBuild. **nota** Debido a que el entorno de compilación aislado se usa a nivel de cuenta, es posible que una instancia se reutilice para otra ejecución de canalización. + Se admiten todos los formatos, excepto los formatos multilínea. Debe utilizar el formato de una sola línea al introducir comandos. + Para esta regla, CodePipeline asumirá la función de servicio de canalización y la usará para permitir el acceso a los recursos en tiempo de ejecución. Se recomienda configurar el rol de servicio para que los permisos se limiten al nivel de acción. + Los permisos agregados a la función CodePipeline de servicio se detallan en[Agrega permisos al rol de CodePipeline servicio](how-to-custom-role.md#how-to-update-role-new-services). + El permiso necesario para ver los registros en la consola se detalla en [Permisos necesarios para ver los registros de procesamiento en la consola](security-iam-permissions-console-logs.md). En las siguientes pantallas de ejemplo, utilice el enlace **Registros** para ver los registros y ver si una regla de comandos en los CloudWatch registros es correcta. ![\[Página Estado de una canalización con la regla de comandos\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/images/commands-rule-status.png) ![\[La página de registros es una canalización con la regla de comandos CloudWatch\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/images/commands-rule-logs.png) + A diferencia de otras acciones CodePipeline, no se establecen campos en la configuración de acciones; se establecen los campos de configuración de acciones fuera de la configuración de acciones. ## Permisos para las políticas de roles de servicio Cuando CodePipeline se ejecuta la regla, CodePipeline crea un grupo de registros con el nombre de la canalización, tal como se indica a continuación. Esto permite reducir los permisos para registrar los recursos mediante el nombre de la canalización. ``` /aws/codepipeline/MyPipelineName ``` Si utiliza un rol de servicio existente, para utilizar la acción de Comandos tendrá que agregar los siguientes permisos para el rol de servicio. + registros: CreateLogGroup + registros: CreateLogStream + registros: PutLogEvents En la declaración de las políticas de roles de servicio, limite los permisos al nivel de la canalización como se muestra en el siguiente ejemplo. ``` { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:YOUR_AWS_ACCOUNT_ID:log-group:/aws/codepipeline/YOUR_PIPELINE_NAME:*" } ``` Para ver los registros en la consola mediante la página del cuadro de diálogo de detalles de la acción, se debe agregar el permiso para ver los registros al rol de la consola. Para obtener más información, consulte el ejemplo de política de permisos para consolas en [Permisos necesarios para ver los registros de procesamiento en la consola](security-iam-permissions-console-logs.md). ## Tipo de regla + Categoría: `Rule` + Propietario: `AWS` + Proveedor: `Commands` + Versión: `1` ## Parámetros de configuración **Comandos** Obligatorio: sí Puede proporcionar comandos del intérprete de comandos para que se ejecute la regla `Commands`. En la consola, los comandos se introducen en líneas separadas. En la CLI, los comandos se introducen como cadenas independientes. Los formatos multilínea no son compatibles y generarán un mensaje de error. Se debe utilizar el formato de una sola línea para introducir comandos en el campo **Comandos**. Los siguientes detalles proporcionan la computación predeterminada que se utiliza para la regla de comandos. Para obtener más información, consulte la referencia de [tipos y modos de procesamiento del entorno de compilación](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) en la Guía del CodeBuild usuario. + **CodeBuild imagen: aws/codebuild/amazonlinux 2-x86\$164-standard:5.0** + **Tipo de computación:** Linux Small + Valor de **ComputEtype del entorno**: BUILD\$1 \$1SMALL GENERAL1 + **Valor del tipo de entorno:** LINUX\$1CONTAINER ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` result: FAIL rules: - name: CommandsRule ruleTypeId: category: Rule owner: AWS provider: Commands version: '1' configuration: {} commands: - ls - printenv inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` { "result": "FAIL", "rules": [ { "name": "CommandsRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "Commands", "version": "1" }, "configuration": {}, "commands": [ "ls", "printenv" ], "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] } ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + *Para obtener más información sobre las reglas y condiciones, consulte [Condición](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) y [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)en la Guía de [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)API. CodePipeline * # DeploymentWindow Al crear una condición, puede agregar la regla `DeploymentWindow`. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). **Topics** + [Tipo de regla](#rule-reference-DeploymentWindow-type) + [Parámetros de configuración](#rule-reference-DeploymentWindow-config) + [Ejemplo de configuraciones de regla](#rule-reference-DeploymentWindow-example) + [Véase también](#rule-reference-DeploymentWindow-links) ## Tipo de regla + Categoría: `Rule` + Propietario: `AWS` + Proveedor: `DeploymentWindow` + Versión: `1` ## Parámetros de configuración **Cron** Obligatorio: sí La expresión que define los días y las horas en que se permitirá la implementación. Las expresiones cron se componen de 6 campos obligatorios y un campo opcional separados por un espacio en blanco. Los campos de expresión cron permiten especificar un patrón de programación con una expresión cron de la siguiente manera. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/rule-reference-DeploymentWindow.html) + El carácter “\$1” se utiliza para especificar todos los valores. Por ejemplo, “\$1” en el campo Minutos significa “cada minuto”. + ¿El '?' se permite el carácter en los day-of-week campos day-of-month y. Se usa para especificar que “no hay ningún valor específico”. Esto resulta útil cuando necesite especificar algo en uno de los dos campos, pero no en el otro. + El carácter “-” se utiliza para especificar intervalos. Por ejemplo, “10-12” en el campo Horas significa “las horas 10, 11 y 12”. + El carácter “,” se utiliza para especificar valores adicionales. Por ejemplo, «LUNES, MIÉRCOLES, VIERNES» en el day-of-week campo significa «los días lunes, miércoles y viernes». + El carácter “/” se usa para especificar los incrementos. Por ejemplo, “0/15” en el campo Segundos significa “los segundos 0, 15, 30 y 45”. Y “5/15" en el campo Segundos significa “los segundos 5, 20, 35 y 50”. Si se especifica “\$1” antes del carácter “/”, equivale a especificar que 0 es el valor con el que empezar. + Se permite el carácter «L» en los day-of-week campos day-of-month y. Este carácter es la abreviatura de la palabra inglesa “last” (último), pero tiene un significado diferente en cada uno de esos dos campos. Por ejemplo, el valor «L» del day-of-month campo significa «el último día del mes»: el día 31 de enero y el día 28 de febrero en los años no bisiestos. Si se utiliza en el day-of-week campo por sí solo, significa simplemente «7» o «SAT». Pero si se usa en el day-of-week campo después de otro valor, significa «el último día del mes»; por ejemplo, «6L» significa «el último viernes del mes». También puedes especificar un desfase con respecto al último día del mes, como «L-3", que significaría el third-to-last día del mes natural. + Se permite el carácter «W» en el day-of-month campo. Este carácter se utiliza para especificar el día entre semana (de lunes a viernes) más cercano a un día determinado. Por ejemplo, si especificara «15W» como valor para el day-of-month campo, el significado sería: «el día de la semana más cercano al día 15 del mes». Por lo tanto, si el día 15 fuera sábado, el desencadenador se activaría el viernes 14. Si el día 15 fuera domingo, el desencadenador se activaría el lunes 16. Si el día 15 fuera martes, el desencadenador se activaría el mismo martes 15. + Los caracteres «L» y «W» también se pueden combinar para que la day-of-month expresión arroje «LW», que se traduce como «último día de la semana del mes». + Se permite el carácter «\$1» en el day-of-week campo. Este carácter se utiliza para especificar el “.er” o “.º” día del mes. Por ejemplo, el valor «6 \$13" en el day-of-week campo significa el tercer viernes del mes (día 6 = viernes y "\$13" = el tercer viernes del mes). + Los caracteres legales y los nombres de los meses y días de la semana no distinguen mayúsculas de minúsculas. **TimeZone** Obligatorio: no La zona horaria de la ventana de implementación. La expresión regular coincide con los patrones de los siguientes formatos: + **Formato de región/ciudad**. El valor coincide con una zona horaria con el formato Region/City Region/City\$1City. Por ejemplo, `America/New_York` o `Europe/Berlin`. + **Formato UTC**. El valor coincide con la cadena UTC seguida, opcionalmente, de un desfase en el formato \$1HH:MM o -HH:MM. Por ejemplo `UTC`, `UTC+05:30`, o `UTC-03:00`. Este es el formato predeterminado si el parámetro no está establecido de otro modo. + **Formato de abreviatura**. El valor coincide con una abreviatura de entre 3 y 5 caracteres para una zona horaria. Por ejemplo, `EST` o `IST`. [Para ver una tabla de valores de TimeZone ID válidos, consulte 1221/ .html. https://docs.oracle.com/middleware/ wcs/tag-ref/MISC/TimeZones](https://docs.oracle.com/middleware/1221/wcs/tag-ref/MISC/TimeZones.html) Tenga en cuenta que algunas abreviaturas son abreviaturas duplicadas, como por ejemplo CST, que puede referirse a la hora estándar central, a la hora estándar de China y a la hora estándar de Cuba. ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` - name: MyDeploymentRule ruleTypeId: category: Rule owner: AWS provider: DeploymentWindow version: '1' configuration: Cron: 0 0 9-17 ? * MON-FRI * TimeZone: PST inputArtifacts: [] region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyDeploymentRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "DeploymentWindow", "version": "1" }, "configuration": { "Cron": "0 0 9-17 ? * MON-FRI *", "TimeZone": "PST" }, "inputArtifacts": [], "region": "us-east-1" } ] ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + [Creación de condiciones de éxito](stage-conditions.md#stage-conditions-onsuccess): en esta sección se proporcionan los pasos para crear una condición de éxito con una regla de ventana de implementación. + *Para obtener más información sobre las reglas y condiciones, consulte [Condición](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) y [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)en la [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)Guía de la CodePipeline API.* # LambdaInvoke Al crear una condición, puede agregar la regla `LambdaInvoke`. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). Debe haber creado previamente una función en Lambda como recurso independiente. **Topics** + [Tipo de regla](#rule-reference-CloudWatchAlarm-type) + [Parámetros de configuración](#rule-reference-LambdaInvoke-config) + [Ejemplo de configuraciones de regla](#rule-reference-LambdaInvoke-example) + [Véase también](#rule-reference-LambdaInvoke-links) ## Tipo de regla + Categoría: `Rule` + Propietario: : `AWS` + Proveedor: `LambdaInvoke` + Versión: `1` ## Parámetros de configuración **FunctionName** Obligatorio: sí El nombre de la función de Lambda. **UserParameters** Obligatorio: no Estos son parámetros que se proporcionan como entrada para la función en formato de par clave-valor. ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` - name: MyLambdaRule ruleTypeId: category: Rule owner: AWS provider: LambdaInvoke version: '1' configuration: FunctionName: my-function inputArtifacts: - name: SourceArtifact region: us-east-1 ``` ------ #### [ JSON ] ``` [ { "name": "MyLambdaRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "LambdaInvoke", "version": "1" }, "configuration": { "FunctionName": "my-function" }, "inputArtifacts": [ { "name": "SourceArtifact" } ], "region": "us-east-1" } ] ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + [Creación de condiciones de fallo](stage-conditions.md#stage-conditions-onfailure): en esta sección se proporcionan los pasos necesarios para crear una condición de fallo con una regla de alarma. # VariableCheck Al crear una condición, puede agregar la regla `VariableCheck`. En esta sección, se proporciona una referencia para los parámetros de reglas. Para obtener más información acerca de las reglas y condiciones, consulte [Funcionamiento de las condiciones de las etapas](concepts-how-it-works-conditions.md). Es posible usar la regla `VariableCheck` para crear una condición en la que la variable de salida se compare con una expresión proporcionada. La regla supera la comprobación cuando el valor de la variable cumple los criterios de la regla, por ejemplo, si el valor es igual o mayor que una variable de salida especificada. **Topics** + [Tipo de regla](#rule-reference-VariableCheck-type) + [Parámetros de configuración](#rule-reference-VariableCheck-config) + [Ejemplo de configuraciones de regla](#rule-reference-VariableCheck-example) + [Véase también](#rule-reference-VariableCheck-links) ## Tipo de regla + Categoría: `Rule` + Propietario: `AWS` + Proveedor: `VariableCheck` + Versión: `1` ## Parámetros de configuración **Operador** Obligatorio: sí El operador que indica qué operación se debe realizar para la verificación de la variable. En el siguiente ejemplo, se comprobará si la variable de salida del nombre del repositorio es igual a `MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` Los siguientes operadores están disponibles para crear una expresión de la siguiente manera. + **Es igual a**: elija este operador para comprobar si la variable es igual al valor de la cadena. **Parámetro de la CLI:** `EQ` + **Contiene**: elija este operador para comprobar si la variable contiene el valor de la cadena como una subcadena. **Parámetro de la CLI:** `CONTAINS` + **Coincide**: elija este operador para comprobar si la variable coincide con una expresión regex determinada como valor de cadena. Todas las expresiones regulares se CodePipeline ajustan a la sintaxis de expresiones regulares de Java. Para obtener una descripción completa de la sintaxis de expresiones regulares de Java y sus constructos, consulte [java.util.regex.Pattern](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html). **Parámetro de la CLI:** `MATCHES` + **No es igual a**: elija este operador para comprobar si la variable no es igual al valor de la cadena. **Parámetro de la CLI:** `NE` **Variable** Obligatorio: sí Las variables de canalización que se van a comprobar. **Valor** Obligatorio: sí El valor de la expresión que se va a comparar. En el siguiente ejemplo, se comprobará si la variable de salida del nombre del repositorio es igual a `MyDemoRepo`. ``` "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, ``` En el siguiente ejemplo de JSON, se definen dos reglas distintas, una para una sentencia `EQ` (equals) que comprueba el nombre del repositorio y de la rama con el formato \$1 \$1. SourceVariables RepositoryName\$1 y otra `CONTAINS` comprueba la variable de salida del mensaje de confirmación con el formato \$1 \$1. SourceVariables CommitMessage\$1 contra el valor proporcionado «update». ``` "beforeEntry": { "conditions": [ { "result": "FAIL", "rules": [ { "name": "MyVarCheckRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "EQ", "Value": "MyDemoRepo", "Variable": "#{SourceVariables.RepositoryName}" }, "inputArtifacts": [], "region": "us-east-1" }, { "name": "MyVarCheckRuleContains", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Operator": "CONTAINS", "Value": "update", "Variable": "#{SourceVariables.CommitMessage}" }, "inputArtifacts": [], "region": "us-east-1" } ] } ] } } ], ``` ## Ejemplo de configuraciones de regla ------ #### [ YAML ] ``` - name: MyVariableCheck ruleTypeId: category: Rule owner: AWS provider: VariableCheck version: '1' configuration: Variable: "#{SourceVariables.RepositoryName}" Value: MyDemoRepo Operator: EQ inputArtifacts: [] region: us-west-2 ``` ------ #### [ JSON ] ``` "rules": [ { "name": "MyVariableCheck", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "VariableCheck", "version": "1" }, "configuration": { "Variable": "#{SourceVariables.RepositoryName}", "Value": "MyDemoRepo", "Operator": "EQ" }, "inputArtifacts": [], "region": "us-west-2" } ] ``` ------ ## Véase también Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta regla. + [Tutorial: Cómo crear una regla de verificación de variables para una canalización como una condición de entrada](tutorials-varcheckrule.md): en esta sección se proporciona un tutorial con los pasos para crear una condición de entrada con una regla de verificación de variables. + [Referencia de variables](reference-variables.md): en esta sección se proporciona información de referencia y ejemplos de las variables de canalización. + Para obtener más información sobre las reglas y condiciones, consulte [Condición](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) y [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)en la *Guía de la CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)