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á. # Criar um grupo de relatórios Você pode usar o CodeBuild console AWS CLI, o ou um arquivo buildspec para criar um grupo de relatórios. Sua função do IAM deve ter as permissões necessárias para criar um grupo de relatórios. Para obter mais informações, consulte [Permissões de relatório de teste](test-permissions.md). **Topics** + [Criar um grupo de relatórios (buildspec)](#test-report-group-create-buildspec) + [Criar um grupo de relatórios (console)](#test-report-group-create-console) + [Criar um grupo de relatórios (CLI)](#test-report-group-create-cli) + [Criar um grupo de relatórios (CloudFormation)](#test-report-group-create-cfn) ## Criar um grupo de relatórios (buildspec) Um grupo de relatórios criado com o uso do buildspec não exporta arquivos de resultado de teste bruto. Você pode visualizar seu grupo de relatórios e especificar as configurações de exportação. Para obter mais informações, consulte [Atualizar um grupo de relatórios](report-group-export-settings.md). **Como criar um grupo de relatórios usando um arquivo buildspec** 1. Escolha um nome de grupo de relatórios que não esteja associado a um grupo de relatórios na sua AWS conta. 1. Configure a seção `reports` do arquivo buildspec com esse nome. Neste exemplo, o nome do grupo de relatórios é `new-report-group` e os casos de teste de uso são criados com a JUnit estrutura: ``` reports: new-report-group: #surefire junit reports files: - '**/*' base-directory: 'surefire/target/surefire-reports' ``` O nome do grupo de relatórios também pode ser especificado usando variáveis de ambiente no buildspec: ``` version: 0.2 env: variables: REPORT_GROUP_NAME: "new-report-group" phases: build: commands: - ... ... reports: $REPORT_GROUP_NAME: files: - '**/*' base-directory: 'surefire/target/surefire-reports' ``` Para obter mais informações, consulte [Especificar arquivos de teste](report-group-test-cases.md) e [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file). 1. Na seção `commands`, especifique o comando para executar seus testes. Para obter mais informações, consulte [Especificar comandos de teste](report-group-test-case-commands.md). 1. Execute o build. Quando a compilação estiver concluída, um grupo de relatórios será criado com um nome que usa o formato `project-name-report-group-name`. Para obter mais informações, consulte [Nomenclatura do grupo de relatórios](test-report-group-naming.md). ## Criar um grupo de relatórios (console) O procedimento a seguir cria um grupo de relatórios usando a Console de gerenciamento da AWS. **Para criar um grupo de relatórios** 1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home). 1. No painel de navegação, escolha **Grupos de relatórios**. 1. Escolha **Criar grupo de relatórios**. 1. Em **Report name group (Nome do grupo de relatórios)**, insira um nome para o grupo de relatórios. 1. (Opcional) Em **Tags**, insira o nome e o valor de todas as tags que você deseja que AWS os serviços de suporte usem. Use **Adicionar linha** para adicionar uma tag. É possível adicionar até 50 tags. 1. Se você quiser fazer upload dos dados brutos dos resultados do relatório de teste para um bucket do Amazon S3: 1. Selecione **Exportar para o Amazon S3**. 1. Em **Nome do bucket do S3**, insira o nome do bucket do S3. 1. (Opcional) Para **Proprietário do bucket do S3**, insira o identificador da conta da AWS que tem o bucket do S3. Isso permite que os dados do relatório sejam exportados para um bucket do Amazon S3 que pertence a uma conta diferente da conta que está executando a compilação. 1. Em **Prefixo do caminho**, insira o caminho no bucket do S3 onde deseja fazer upload dos resultados do teste. 1. Selecione **Compactar dados do resultado do teste em um arquivo zip** para compactar os arquivos de dados do resultado de teste bruto. 1. Expanda **Configuração adicional** para exibir opções de criptografia. Escolha uma das seguintes opções: + **Chave AWS gerenciada padrão** para usar a Chave gerenciada pela AWS para o Amazon S3. Para obter mais informações, consulte [Gerenciado pelo cliente CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) no *Guia AWS Key Management Service do usuário*. Esta é a opção de criptografia padrão. + **Escolher uma chave personalizada** para usar uma chave gerenciada pelo cliente criada e configurada por você. Para **Chave de criptografia do AWS KMS **, insira o ARN da chave de criptografia. O formato é ` arn:aws:kms:: :key/ `. Para obter mais informações, consulte [Criar chaves do KMS](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) no *Guia do usuário do AWS Key Management Service *. + **Desativar criptografia de artefatos** para desabilitar a criptografia. Você pode escolher isso se quiser compartilhar seus resultados de teste ou publicá-los em um site estático. (Um site dinâmico pode executar códigos para descriptografar os resultados de teste.) Para obter mais informações sobre criptografia de dados em repouso, consulte [Criptografia de dados](security-encryption.md). **nota** A função CodeBuild de serviço especificada no projeto é usada para obter permissões de upload para o bucket do S3. 1. Escolha **Criar grupo de relatórios**. ## Criar um grupo de relatórios (CLI) O procedimento a seguir cria um grupo de relatórios usando a AWS CLI. **Para criar um grupo de relatórios** 1. Crie um arquivo chamado `CreateReportGroup.json`. 1. Dependendo de suas necessidades, copie um dos seguintes trechos de código JSON para `CreateReportGroup.json`: + Use o seguinte JSON para especificar que o grupo de relatórios de teste exporta arquivos de resultado de teste bruto para um bucket do Amazon S3. ``` { "name": "", "type": "TEST", "exportConfig": { "exportConfigType": "S3", "s3Destination": { "bucket": "", "bucketOwner": "", "path": "", "packaging": "NONE | ZIP", "encryptionDisabled": "false", "encryptionKey": "" }, "tags": [ { "key": "tag-key", "value": "tag-value" } ] } } ``` + **Substitua pelo nome do bucket do Amazon S3 e ** pelo caminho no bucket para onde você deseja exportar os arquivos. + Se desejar compactar os arquivos exportados, para `packaging`, especifique `ZIP`. Caso contrário, especifique `NONE`. + `bucketOwner` é opcional e só será necessário se o bucket do Amazon S3 pertencer a uma conta diferente da conta que está executando a compilação. + Use `encryptionDisabled` para especificar se deseja criptografar os arquivos exportados. Se você criptografar os arquivos exportados, insira a chave gerenciada pelo cliente. Para obter mais informações, consulte [Atualizar um grupo de relatórios](report-group-export-settings.md). + Use o seguinte JSON para especificar que seu relatório de teste não exporta arquivos de teste brutos: ``` { "name": "", "type": "TEST", "exportConfig": { "exportConfigType": "NO_EXPORT" } } ``` **nota** A função CodeBuild de serviço especificada no projeto é usada para obter permissões de upload para o bucket do S3. 1. Execute este comando: . ``` aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json ``` ## Criar um grupo de relatórios (CloudFormation) Utilize as instruções a seguir para criar um grupo de relatórios utilizando o modelo do CloudFormation **Para criar um grupo de relatórios usando o modelo do CloudFormation ** Você pode usar um arquivo CloudFormation de modelo para criar e provisionar um grupo de relatórios. Para obter mais informações, consulte o [CloudFormation Guia do usuário do ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html). O modelo CloudFormation YAML a seguir cria um grupo de relatórios que não exporta arquivos brutos de resultados de testes. ``` Resources: CodeBuildReportGroup: Type: AWS::CodeBuild::ReportGroup Properties: Name: my-report-group-name Type: TEST ExportConfig: ExportConfigType: NO_EXPORT ``` O modelo CloudFormation YAML a seguir cria um grupo de relatórios que exporta arquivos brutos de resultados de testes para um bucket do Amazon S3. ``` Resources: CodeBuildReportGroup: Type: AWS::CodeBuild::ReportGroup Properties: Name: my-report-group-name Type: TEST ExportConfig: ExportConfigType: S3 S3Destination: Bucket: amzn-s3-demo-bucket Path: path-to-folder-for-exported-files Packaging: ZIP EncryptionKey: my-KMS-encryption-key EncryptionDisabled: false ``` **nota** A função CodeBuild de serviço especificada no projeto é usada para obter permissões de upload para o bucket do S3.