Gerenciar modelos de regras de aprovação - AWS CodeCommit
Gerenciar modelos de regras de aprovação (console)Gerenciar modelos de regra de aprovação (AWS CLI)

AWS CodeCommit não está mais disponível para novos clientes. Os clientes existentes do AWS CodeCommit podem continuar usando o serviço normalmente. Saiba mais”

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciar modelos de regras de aprovação

É possível gerenciar os modelos de regras de aprovação em uma Região da AWS para ajudar a entender como eles estão sendo usados e para que servem. Por exemplo, é possível editar os nomes e as descrições dos modelos de regras de aprovação para ajudar outras pessoas a entenderem sua finalidade. É possível listar todos os modelos de regras de aprovação em uma Região da AWS e obter informações sobre o conteúdo e a estrutura de um modelo. É possível revisar quais modelos estão associados a um repositório e quais repositórios estão associados a um modelo.

Para obter mais informações sobre políticas e permissões gerenciadas para modelos de regras de aprovação, consulte Permissões para ações em modelos de regras de aprovação e AWS políticas gerenciadas para CodeCommit.

Gerenciar modelos de regras de aprovação (console)

É possível visualizar e gerenciar seus modelos de regra de aprovação no console do CodeCommit.

Como gerenciar modelos de regras de aprovação

  1. Abra o console do CodeCommit em https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Escolha Modelos de regras de aprovação para visualizar a lista de modelos de regras de aprovação na Região da AWS onde você está conectado.

    nota

    Os modelos de regra de aprovação só estão disponíveis na Região da AWS onde foram criados.

  3. Se você deseja fazer alterações em um modelo, escolha-o na lista e escolha Edit (Editar).

  4. Faça suas alterações e escolha Salvar.

Gerenciar modelos de regra de aprovação (AWS CLI)

É possível gerenciar seus modelos de regra de aprovação com os seguintes comandos da AWS CLI:

Para listar todos os modelos de regra de aprovação em uma Região da AWS

  1. No terminal ou na linha de comando, execute o comando list-approval-rule-templates. Por exemplo, para listar todos os modelos de regras de aprovação na região Leste dos EUA (Ohio):

    aws codecommit list-approval-rule-templates --region us-east-2

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplateNames": [
        "2-approver-rule-for-main",
        "1-approver-rule-for-all-pull-requests"
    ]
}

Como obter o conteúdo de um modelo de regra de aprovação

  1. No terminal ou na linha de comando, execute o comando get-approval-rule-template, especificando o nome do modelo de regra de aprovação:

    aws codecommit get-approval-rule-template --approval-rule-template-name 1-approver-rule-for-all-pull-requests

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplate": {
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "ruleContentSha256": "621181bbEXAMPLE",
        "lastModifiedDate": 1571356106.936,
        "creationDate": 1571356106.936,
        "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan",
        "approvalRuleTemplateId": "a29abb15-EXAMPLE",
        "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team."
    }
}

Como atualizar o conteúdo de um modelo de regra de aprovação

  1. No terminal ou prompt de comando, execute o comando update-approval-rule-template-content, especificando o nome do modelo e o conteúdo alterado. Por exemplo, para alterar o conteúdo de um modelo de regra de aprovação chamado 1-approver-rule para redefinir o grupo de aprovações para usuários que assumem a função de CodeCommitReview:

    aws codecommit update-approval-rule-template-content --approval-rule-template-name 1-approver-rule --new-rule-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplate": {
        "creationDate": 1571352720.773,
        "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
        "lastModifiedDate": 1571358728.41,
        "approvalRuleTemplateId": "41de97b7-EXAMPLE",
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
        "ruleContentSha256": "2f6c21a5EXAMPLE",
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
    }
}

Como atualizar o nome de um modelo de regra de aprovação

  1. No terminal ou prompt de comando, execute o comando update-approval-rule-template-name, especificando o nome atual e o nome para o qual você deseja alterá-lo. Por exemplo, para alterar o nome de um modelo de regra de aprovação de 1-approver-rule para 1-approver-rule-for-all-pull-requests:

    aws codecommit update-approval-rule-template-name --old-approval-rule-template-name "1-approver-rule" --new-approval-rule-template-name "1-approver-rule-for-all-pull-requests"

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplate": {
        "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
        "lastModifiedDate": 1571358241.619,
        "approvalRuleTemplateId": "41de97b7-EXAMPLE",
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "creationDate": 1571352720.773,
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major",
        "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team.",
        "ruleContentSha256": "2f6c21a5cEXAMPLE"
    }
}

Como atualizar a descrição de um modelo de regra de aprovação

  1. No terminal ou na linha de comando, execute o comando update-approval-rule-template-description, especificando o nome do modelo de regra de aprovação e a nova descrição:

    aws codecommit update-approval-rule-template-description --approval-rule-template-name "1-approver-rule-for-all-pull-requests" --approval-rule-template-description "Requires 1 approval for all pull requests from the CodeCommitReview pool"

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplate": {
        "creationDate": 1571352720.773,
        "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool",
        "lastModifiedDate": 1571358728.41,
        "approvalRuleTemplateId": "41de97b7-EXAMPLE",
        "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}",
        "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests",
        "ruleContentSha256": "2f6c21a5EXAMPLE",
        "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan"
    }
}

Como listar todos os repositórios associados a um modelo

  1. Na linha de comando ou terminal, execute o comando list-repositories-for-approval-rule-template, especificando o nome do modelo:

    aws codecommit list-repositories-for-approval-rule-template --approval-rule-template-name 2-approver-rule-for-main

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "repositoryNames": [
        "MyDemoRepo",
        "MyClonedRepo"
    ]
}

Como listar todos os modelos associados a um repositório

  1. Na linha de comando ou terminal, execute o comando list-associated-approval-rule-templates-for-repository, especificando o nome do repositório:

    aws codecommit list-associated-approval-rule-templates-for-repository --repository-name MyDemoRepo

  2. Se houver êxito, o comando gerará uma saída semelhante à seguinte:

    {
    "approvalRuleTemplateNames": [
        "2-approver-rule-for-main",
        "1-approver-rule-for-all-pull-requests"
    ]
}