Crear una plantilla de regla de aprobación

Abra la consola de CodeCommit en https://console.aws.amazon.com/codesuite/codecommit/home.

Elija Approval rule templates (Plantillas de reglas de aprobación) y, a continuación, elija Create template (Crear plantilla).

En Approval rule template name (Nombre de plantilla de regla de aprobación), asigne a la plantilla un nombre descriptivo con el fin de saber para qué sirve. Por ejemplo, si desea requerir que una persona de un conjunto de desarrolladores sénior apruebe una solicitud de extracción para que se pueda combinar, puede asignar a la regla el nombre Require 1 approver from a senior developer.

(Opcional) En Description (Descripción), proporcione una descripción del propósito de esta plantilla. Esto puede ayudar a otros a decidir si esta plantilla es adecuada para sus repositorios.

En Number of approvals needed (Número de aprobaciones necesarias), introduzca el número que desee. El valor predeterminado es 1.

(Opcional) Si desea exigir que las aprobaciones de una solicitud de extracción procedan de un grupo específico de usuarios, en Approval rule members (Miembros de regla de aprobación), elija Add (Añadir). En Approver type (Tipo de aprobador), elija una de las opciones siguientes:

Si eligió el nombre de usuario de IAM o el rol asumido como tipo de aprobador, en Valor, introduzca el nombre del usuario de IAM o rol o el ARN completo del usuario o rol. Elija Add (Agregar) de nuevo para agregar más usuarios o roles, hasta que haya agregado todos los usuarios o roles cuyas aprobaciones se contabilizan en el número de aprobaciones necesarias.

Ambos tipos de aprobadores le permiten utilizar comodines (*) en los valores. Por ejemplo, si elige la opción de nombre de usuario de IAM o rol asumido y especifica CodeCommitReview/*, todos los usuarios que asumen el rol de CodeCommitReview se cuentan en el grupo de aprobación. Sus nombres de sesión de rol individuales se contabilizan en el número necesario de aprobadores. De esta manera, tanto Mary_Major como Li_Juan se contabilizan como aprobaciones al iniciar sesión y asumir el rol de CodeCommitReview. Para obtener más información acerca de los ARN de IAM, comodines y formatos, consulte Identificadores de IAM.

(Opcional) En Branch filters (Filtros de ramificación), introduzca los nombres de ramificación de destino para filtrar la creación de reglas de aprobación. Por ejemplo, si especifica principal, se crea una regla de aprobación para las solicitudes de extracción en los repositorios asociados solamente si la ramificación de destino para la solicitud de extracción es una ramificación denominada principal. Puede utilizar comodines (*) en los nombres de ramificación para aplicar reglas de aprobación a todos los nombres de ramificación que coincidan con los casos de comodín. Sin embargo, no se puede utilizar un comodín al principio del nombre de una ramificación. Puede especificar hasta 100 nombres de ramificación. Si no especifica ningún filtro, la plantilla se aplicará a todas las ramificaciones de un repositorio asociado.

(Opcional) En Repositorios asociados, en la lista Repositorios elija los repositorios de Región de AWS que desea asociar a esta regla de aprobación.

Seleccione Create (Crear).

En un terminal o en la línea de comandos, ejecute el comando create-approval-rule-template especificando lo siguiente:

Al crear el contenido de la regla de aprobación, puede especificar a los aprobadores de un grupo de aprobación de dos maneras:

Para obtener más información acerca de los ARN de IAM, comodines y formatos, consulte Identificadores de IAM.

En el ejemplo siguiente se crea una plantilla de regla de aprobación denominada 2-approver-rule-for-main y la descripción Requires two developers from the team to approve the pull request if the destination branch is main. La plantilla requiere que dos usuarios que asuman el rol de CodeCommitReview aprueben cualquier solicitud de extracción antes de que se pueda combinar con la ramificación main:

aws codecommit create-approval-rule-template --approval-rule-template-name 2-approver-rule-for-main --approval-rule-template-description "Requires two developers from the team to approve the pull request if the destination branch is main" --approval-rule-template-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

Si se ejecuta correctamente, este comando proporciona información similar a la siguiente:

{
    "approvalRuleTemplate": {
        "approvalRuleTemplateName": "2-approver-rule-for-main",
        "creationDate": 1571356106.936,
        "approvalRuleTemplateId": "dd8b17fe-EXAMPLE",
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
        "approvalRuleTemplateDescription": "Requires two developers from the team to approve the pull request if the destination branch is main",
        "lastModifiedDate": 1571356106.936,
        "ruleContentSha256": "4711b576EXAMPLE"
    }
}