Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Groupes de rapports
Un *groupe de rapports* contient des rapports de test et spécifie des paramètres partagés. Vous utilisez le fichier buildspec pour spécifier les cas de test à exécuter et les commandes pour les exécuter lors de la génération. Pour chaque groupe de rapports configuré dans un projet de génération, une exécution du projet de génération crée un rapport de test. Plusieurs exécutions d'un projet de génération configurées avec un groupe de rapports créent plusieurs rapports de test dans ce groupe de rapports, chacun avec les résultats des mêmes cas de test spécifiés pour ce groupe de rapports.
Les cas de test sont spécifiés pour un groupe de rapports dans le fichier buildspec d'un projet de génération. Vous pouvez spécifier jusqu'à cinq groupes de rapports dans un projet de génération. Lorsque vous exécutez une génération, tous les cas de test s'exécutent. Un nouveau rapport de test est créé avec les résultats de chaque cas de test spécifié pour un groupe de rapports. Chaque fois que vous exécutez une nouvelle version, les cas de test s'exécutent et un nouveau rapport de test est créé avec les nouveaux résultats de test.
Les groupes de rapports peuvent être utilisés dans plusieurs projets de génération. Tous les rapports de test créés avec un groupe de rapports partagent la même configuration, telle que son option d'exportation et ses autorisations, même si les rapports de test sont créés à l'aide de différents projets de génération. Les rapports de test créés avec un groupe de rapports dans plusieurs projets de génération peuvent contenir les résultats de l'exécution de différents ensembles de cas de test (un ensemble de cas de test pour chaque projet de génération). En effet, vous pouvez spécifier différents fichiers de cas de test pour le groupe de rapports dans le fichier buildspec de chaque projet. Vous pouvez également modifier les fichiers de cas de test d'un groupe de rapports dans un projet de génération en modifiant son fichier buildspec. Les versions ultérieures créent de nouveaux rapports de test qui contiennent les résultats des fichiers de cas de test dans le buildspec mis à jour.
**Topics**
+ [Créer un groupe de rapports](report-group-create.md)
+ [Attribution des noms des groupes de rapports](test-report-group-naming.md)
+ [Partager des groupes de rapports](report-groups-sharing.md)
+ [Spécification des fichiers de test](report-group-test-cases.md)
+ [Spécification des commandes de test](report-group-test-case-commands.md)
+ [Marquer un groupe de rapports dans AWS CodeBuild](how-to-tag-report-group.md)
+ [Mise à jour d'un groupe de rapports](report-group-export-settings.md)
# Créer un groupe de rapports
Vous pouvez utiliser la CodeBuild console AWS CLI, le fichier ou un fichier buildspec pour créer un groupe de rapports. Votre rôle IAM doit disposer des autorisations requises pour créer un groupe de rapports. Pour de plus amples informations, veuillez consulter [Autorisations relatives aux rapports de test](test-permissions.md).
**Topics**
+ [Création d'un groupe de rapports (buildspec)](#test-report-group-create-buildspec)
+ [Créer un groupe de rapports (console)](#test-report-group-create-console)
+ [Création d'un groupe de rapports (CLI)](#test-report-group-create-cli)
+ [Création d'un groupe de rapports (CloudFormation)](#test-report-group-create-cfn)
## Création d'un groupe de rapports (buildspec)
Un groupe de rapports créé à l'aide de buildspec n'exporte pas les fichiers de résultats de test bruts. Vous pouvez afficher votre groupe de rapports et spécifier les paramètres d'exportation. Pour de plus amples informations, veuillez consulter [Mise à jour d'un groupe de rapports](report-group-export-settings.md).
**Pour créer un groupe de rapports à l'aide d'un fichier buildspec**
1. Choisissez un nom de groupe de rapports qui n'est pas associé à un groupe de rapports dans votre AWS compte.
1. Configurez la section `reports` du fichier buildspec avec ce nom. Dans cet exemple, le nom du groupe de rapports est `new-report-group` et les cas de test d'utilisation sont créés avec le JUnit framework :
```
reports:
new-report-group: #surefire junit reports
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
```
Le nom du groupe de rapports peut également être spécifié à l'aide de variables d'environnement dans le 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'
```
Pour plus d’informations, consultez [Spécification des fichiers de test](report-group-test-cases.md) et [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file).
1. Dans la section `commands`, spécifiez la commande pour exécuter vos tests. Pour de plus amples informations, veuillez consulter [Spécification des commandes de test](report-group-test-case-commands.md).
1. Exécutez la génération. Une fois la génération terminée, un nouveau groupe de rapports est créé avec un nom qui utilise le format `project-name-report-group-name`. Pour de plus amples informations, veuillez consulter [Attribution des noms des groupes de rapports](test-report-group-naming.md).
## Créer un groupe de rapports (console)
Utilisez la procédure suivante pour créer un groupe de rapports à l'aide du AWS Management Console.
**Pour créer un groupe de rapports**
1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Dans le panneau de navigation, sélectionnez **Groupes de rapports**.
1. Choisissez **Créer un groupe de rapports**.
1. Pour **Nom du groupe de rapports**, entrez un nom pour votre groupe de rapports.
1. (Facultatif) Pour **Tags**, entrez le nom et la valeur de tous les tags que vous souhaitez que les AWS services d'assistance utilisent. Utilisez **Ajouter une ligne** pour ajouter une balise. Vous pouvez ajouter jusqu’à 50 balises.
1. Si vous souhaitez télécharger les données brutes des résultats de votre rapport de test dans un compartiment Amazon S3 :
1. Sélectionnez **Exporter vers Amazon S3**.
1. Pour le **nom du compartiment S3**, entrez le nom du compartiment S3.
1. (Facultatif) Pour **le propriétaire du AWS compartiment S3**, entrez l'identifiant du compte propriétaire du compartiment S3. Cela permet de signaler les données à exporter vers un compartiment Amazon S3 appartenant à un compte autre que celui exécutant la build.
1. Pour **Préfixe du chemin d'accès**, entrez le chemin de votre compartiment S3 où vous souhaitez télécharger les résultats de vos tests.
1. Sélectionnez **Compresser les données de résultats de test dans un fichier zip** pour compresser vos fichiers de données de résultats de test bruts.
1. Développez **Configuration supplémentaire** pour afficher les options de chiffrement. Sélectionnez l’une des méthodes suivantes :
+ **Clé AWS gérée par défaut** à utiliser Clé gérée par AWS pour Amazon S3. Pour plus d'informations, consultez la section [Gestion des clients CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) dans le *guide de AWS Key Management Service l'utilisateur*. Il s'agit de l'option de chiffrement par défaut.
+ **Choisissez une clé personnalisée** pour utiliser une clé gérée par le client que vous créez et configurez. Pour la **clé de AWS KMS chiffrement**, entrez l'ARN de votre clé de chiffrement. Son format est ` arn:aws:kms:: :key/ `. Pour de plus amples informations, veuillez consulter [Création de clés KMS](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) dans le *Guide de l'utilisateur AWS Key Management Service *.
+ **Désactivez le chiffrement des artefacts** pour désactiver le chiffrement. Vous pouvez choisir cette option si vous souhaitez partager vos résultats de test ou les publier sur un site web statique. (Un site web dynamique peut exécuter du code pour déchiffrer les résultats des tests.)
Pour de plus amples informations sur le chiffrement au repos, veuillez consulter [Chiffrement des données](security-encryption.md).
**Note**
Le rôle CodeBuild de service spécifié dans le projet est utilisé pour les autorisations de téléchargement vers le compartiment S3.
1. Choisissez **Créer un groupe de rapports**.
## Création d'un groupe de rapports (CLI)
Utilisez la procédure suivante pour créer un groupe de rapports à l'aide du AWS CLI.
**Pour créer un groupe de rapports**
1. Créez un fichier nommé `CreateReportGroup.json`.
1. En fonction de vos besoins, copiez l'un des extraits de code JSON suivants dans `CreateReportGroup.json` :
+ Utilisez le JSON suivant pour spécifier que votre groupe de rapports de test exporte les fichiers de résultats de test bruts vers un compartiment 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"
}
]
}
}
```
+ **Remplacez-le par le nom de votre compartiment Amazon S3 et ** par le chemin de votre compartiment vers l'endroit où vous souhaitez exporter les fichiers.
+ Si vous souhaitez compresser les fichiers exportés, pour `packaging`, spécifiez `ZIP`. Sinon, spécifiez `NONE`.
+ `bucketOwner`est facultatif et n'est obligatoire que si le compartiment Amazon S3 appartient à un compte autre que celui qui exécute le build.
+ Utilisez `encryptionDisabled` de spécifier si les fichiers exportés doivent être chiffrés. Si vous cryptez les fichiers exportés, entrez votre clé gérée par le client. Pour de plus amples informations, veuillez consulter [Mise à jour d'un groupe de rapports](report-group-export-settings.md).
+ Utilisez le JSON suivant pour spécifier que votre rapport de test n'exporte pas les fichiers de test bruts :
```
{
"name": "",
"type": "TEST",
"exportConfig": {
"exportConfigType": "NO_EXPORT"
}
}
```
**Note**
Le rôle CodeBuild de service spécifié dans le projet est utilisé pour les autorisations de téléchargement vers le compartiment S3.
1. Exécutez la commande suivante :
```
aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json
```
## Création d'un groupe de rapports (CloudFormation)
Utilisez les instructions suivantes pour créer un groupe de rapports à l'aide du CloudFormation modèle
**Pour créer un groupe de rapports à l'aide du CloudFormation modèle**
Vous pouvez utiliser un fichier CloudFormation modèle pour créer et approvisionner un groupe de rapports. Pour plus d’informations, consultez le [CloudFormation guide de l’utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Le modèle CloudFormation YAML suivant crée un groupe de rapports qui n'exporte pas les fichiers de résultats de test bruts.
```
Resources:
CodeBuildReportGroup:
Type: AWS::CodeBuild::ReportGroup
Properties:
Name: my-report-group-name
Type: TEST
ExportConfig:
ExportConfigType: NO_EXPORT
```
Le modèle CloudFormation YAML suivant crée un groupe de rapports qui exporte les fichiers de résultats de test bruts vers un compartiment 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
```
**Note**
Le rôle CodeBuild de service spécifié dans le projet est utilisé pour les autorisations de téléchargement vers le compartiment S3.
# Attribution des noms des groupes de rapports
Lorsque vous utilisez la console AWS CLI ou la AWS CodeBuild console pour créer un groupe de rapports, vous spécifiez un nom pour le groupe de rapports. Si vous utilisez la spécification de build pour créer un nouveau groupe de rapports, il est nommé en utilisant le format `project-name-report-group-name-specified-in-buildspec`. Tous les rapports créés en exécutant des versions de ce projet de génération appartiennent au nouveau groupe de rapports portant le nouveau nom.
Si vous ne souhaitez pas CodeBuild créer de nouveau groupe de rapports, spécifiez l'ARN du groupe de rapports dans le fichier buildspec d'un projet de construction. Vous pouvez spécifier l'ARN d'un groupe de rapports dans plusieurs projets de génération. Après l'exécution de chaque projet de génération, le groupe de rapports contient des rapports de test créés par chaque projet de génération.
Par exemple, si vous créez un groupe de rapports portant le nom `my-report-group`, puis que vous utilisez son nom dans deux projets de génération différents nommés `my-project-1` et `my-project-2` et que vous créez une version des deux projets, deux nouveaux groupes de rapports sont créés. Le résultat est trois groupes de rapports portant les noms suivants :
+ `my-report-group` : n'a pas de rapport de test.
+ `my-project-1-my-report-group` : contient des rapports avec les résultats des tests exécutés par le projet de génération nommé `my-project-1`.
+ `my-project-2-my-report-group` : contient des rapports avec les résultats des tests exécutés par le projet de génération nommé `my-project-2`.
Si vous utilisez l'ARN du groupe de rapports nommé `my-report-group` dans les deux projets, puis que vous exécutez des versions de chaque projet, vous disposez toujours d'un groupe de rapports (`my-report-group`). Ce groupe de rapports contient des rapports de test avec les résultats des tests exécutés par les deux projets de génération.
Si vous choisissez un nom de groupe de rapports qui n'appartient pas à un groupe de rapports dans votre compte AWS , puis que vous utilisez ce nom pour un groupe de rapports dans un fichier buildspec et exécutez une génération de son projet de génération, un nouveau groupe de rapports est créé. Le format du nom du nouveau groupe de rapports est `project-name-new-group-name`. Par exemple, si aucun groupe de rapports ne porte ce nom `new-report-group` dans votre AWS compte et que vous le spécifiez dans un projet de génération appelé`test-project`, une exécution de génération crée un nouveau groupe de rapports portant ce nom`test-project-new-report-group`.
# Partager des groupes de rapports
Le partage de groupes de rapports permet à plusieurs AWS comptes ou utilisateurs de consulter un groupe de rapports, ses rapports non expirés et les résultats des tests de ses rapports. Dans ce modèle, le compte propriétaire du groupe de rapports (propriétaire) partage un groupe de rapports avec d'autres comptes (consommateurs). Un consommateur ne peut pas modifier un groupe de rapports. Un rapport expire 30 jours après sa création.
**Topics**
+ [Partager un groupe de rapports](#report-groups-sharing-share)
+ [Services connexes](#report-groups-sharing-related)
+ [Accédez aux groupes de rapports partagés avec vous](report-groups-sharing-access-prereqs.md)
+ [Annuler le partage d'un groupe de rapports partagé](report-groups-sharing-unshare.md)
+ [Identifier un groupe de rapports partagé](report-groups-sharing-identify.md)
+ [Autorisations de groupe de rapports partagés](report-groups-sharing-perms.md)
## Partager un groupe de rapports
Lorsque vous partagez un groupe de rapports, le consommateur dispose d'un accès en lecture seule au groupe de rapports et à ses rapports. Le consommateur peut utiliser le AWS CLI pour consulter le groupe de rapports, ses rapports et les résultats des scénarios de test pour chaque rapport. Le consommateur ne peut pas :
+ Consultez un groupe de rapports partagé ou ses rapports dans la CodeBuild console.
+ Modifier un groupe de rapports partagé.
+ Utiliser l'ARN du groupe de rapports partagé dans un projet pour exécuter un rapport. Une génération de projet qui spécifie un groupe de rapports partagé échoue.
Vous pouvez utiliser la CodeBuild console pour ajouter un groupe de rapports à un partage de ressources existant. Si vous souhaitez ajouter le groupe de rapports à un nouveau partage de ressources, vous devez d'abord le créer dans la [console AWS RAM](https://console.aws.amazon.com/ram).
Pour partager un groupe de rapports avec des unités organisationnelles ou une organisation entière, vous devez activer le partage avec AWS Organizations. Pour de plus amples informations, veuillez consulter [Activer le partage avec AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) dans le *Guide de l'utilisateur AWS RAM *.
Vous pouvez utiliser la CodeBuild console, la AWS RAM console ou AWS CLI pour partager des groupes de rapports dont vous êtes propriétaire.
**Prérequis**
Pour partager un groupe de rapports, votre AWS compte doit en être le propriétaire. Vous ne pouvez pas partager un groupe de rapports qui a été partagé avec vous.
**Pour partager un groupe de rapports dont vous êtes le propriétaire (CodeBuild console)**
1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Dans le panneau de navigation, sélectionnez **Groupes de rapports**.
1. Choisissez le projet que vous souhaitez partager, puis choisissez **Partager**. Pour de plus amples informations, veuillez consulter [Création d'un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-create) dans le *Guide de l'utilisateur AWS RAM *.
**Pour partager des groupes de rapports dont vous êtes propriétaire (AWS RAM console)**
Consultez [Création d’un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) dans le *Guide de l’utilisateur AWS RAM *.
**Pour partager des groupes de rapports dont vous êtes propriétaire (AWS RAM commande)**
Utilisez la commande [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**Pour partager un groupe de rapports dont vous êtes le propriétaire (CodeBuild commande)**
Utilisez la commande [put-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/put-resource-policy.html) :
1. Créez un fichier nommé `policy.json` et copiez ce qui suit dans celui-ci.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS":"111122223333"
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:iam::*:role/Service*"
}]
}
```
------
1. Mettez à jour `policy.json` avec l'ARN du groupe de rapports et les identificateurs avec lesquels vous le partagez. L'exemple suivant accorde un accès en lecture seule au groupe de rapports avec l'ARN `arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group` à Alice et à l'utilisateur root pour le AWS compte identifié par 123456789012.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[{
"Effect":"Allow",
"Principal":{
"AWS": [
"arn:aws:iam::123456789012:user/Alice",
"123456789012"
]
},
"Action":[
"codebuild:BatchGetReportGroups",
"codebuild:BatchGetReports",
"codebuild:ListReportsForReportGroup",
"codebuild:DescribeTestCases"],
"Resource":"arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group"
}]
}
```
------
1. Exécutez la commande suivante.
```
aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json
```
## Services connexes
Le partage de groupes de rapports s'intègre à AWS Resource Access Manager (AWS RAM), un service qui vous permet de partager vos AWS ressources avec n'importe quel AWS compte ou via AWS Organizations. Avec AWS RAM, vous partagez les ressources que vous possédez en créant un *partage de ressources* qui spécifie les ressources et les consommateurs avec lesquels les partager. Les consommateurs peuvent être AWS des comptes individuels AWS Organizations, des unités organisationnelles ou une organisation entière AWS Organizations.
Pour plus d’informations, consultez le *Guide de l’utilisateur [AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.
# Accédez aux groupes de rapports partagés avec vous
Pour accéder à un groupe de rapports partagé, le rôle IAM d'un consommateur requiert l'autorisation `BatchGetReportGroups`. Vous pouvez associer la politique suivante à leur rôle IAM :
```
{
"Effect": "Allow",
"Resource": [
"*"
],
"Action": [
"codebuild:BatchGetReportGroups"
]
}
```
Pour de plus amples informations, veuillez consulter [Utilisation de politiques basées sur l'identité pour AWS CodeBuild](auth-and-access-control-iam-identity-based-access-control.md).
# Annuler le partage d'un groupe de rapports partagé
Un groupe de rapports non partagé, y compris ses rapports et leurs résultats de cas de test, est accessible uniquement par son propriétaire. Si vous résiliez le partage d'un groupe de rapports, les AWS comptes ou utilisateurs avec lesquels vous l'avez précédemment partagé ne peuvent pas accéder au groupe de rapports, à ses rapports ou aux résultats des tests figurant dans les rapports.
Pour annuler le partage d'un groupe de rapports partagé qui vous appartient, vous devez le supprimer du partage de ressources. Vous pouvez utiliser la AWS RAM console ou AWS CLI effectuer cette opération.
**Pour annuler le partage d'un groupe de rapports partagé dont vous êtes le propriétaire (AWS RAM console)**
Consultez la section [Mise à jour d'un partage de ressources](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) du *Guide de l'utilisateur AWS RAM *.
**Pour annuler le partage d'un groupe de rapports partagé dont vous êtes le propriétaire (AWS RAM commande)**
Utilisez la commande [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).
**Pour annuler le partage du groupe de rapports dont vous êtes le propriétaire ( CodeBuild commande)**
Exécutez la [delete-resource-policy](https://docs.aws.amazon.com/cli/latest/reference/codebuild/delete-resource-policy.html)commande et spécifiez l'ARN du groupe de rapports dont vous souhaitez annuler le partage :
```
aws codebuild delete-resource-policy --resource-arn report-group-arn
```
# Identifier un groupe de rapports partagé
Les propriétaires et les consommateurs peuvent utiliser le AWS CLI pour identifier les groupes de rapports partagés.
Pour identifier et obtenir des informations sur un groupe de rapports partagé et ses rapports, utilisez les commandes suivantes :
+ Pour voir les groupes ARNs de rapports partagés avec vous, exécutez `[list-shared-report-groups](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-shared-report-groups.html)` :
```
aws codebuild list-shared-report-groups
```
+ Pour voir les rapports ARNs d'un groupe de rapports, exécutez-le à `[list-reports-for-report-group](https://docs.aws.amazon.com/cli/latest/reference/codebuild/list-reports-for-report-group.html)` l'aide de l'ARN du groupe de rapports :
```
aws codebuild list-reports-for-report-group --report-group-arn report-group-arn
```
+ Pour afficher des informations sur les cas de test dans un rapport, exécutez `[describe-test-cases](https://docs.aws.amazon.com/cli/latest/reference/codebuild/describe-test-cases.html)` à l'aide de l'ARN de rapport :
```
aws codebuild describe-test-cases --report-arn report-arn
```
Le résultat se présente comme suit :
```
{
"testCases": [
{
"status": "FAILED",
"name": "Test case 1",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
},
{
"status": "SUCCEEDED",
"name": "Test case 2",
"expired": 1575916770.0,
"reportArn": "report-arn",
"prefix": "Cucumber tests for agent",
"message": "A test message",
"durationInNanoSeconds": 1540540,
"testRawDataPath": "path-to-output-report-files"
}
]
}
```
# Autorisations de groupe de rapports partagés
## Autorisations accordées aux propriétaires
Un propriétaire de groupe de rapports peut modifier le groupe de rapports et le spécifier dans un projet pour exécuter des rapports.
## Autorisations accordées aux consommateurs
Un consommateur de groupe de rapports peut afficher un groupe de rapports, ses rapports et les résultats de cas de test pour ses rapports. Un consommateur ne peut pas modifier un groupe de rapports ou ses rapports, et ne peut pas l'utiliser pour créer des rapports.
# Spécification des fichiers de test
Vous spécifiez les fichiers de résultats de test et leur emplacement pour chaque groupe de rapports dans la section `reports` du fichier buildspec de votre projet de génération. Pour de plus amples informations, veuillez consulter [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file).
Voici un exemple de section `reports` qui spécifie deux groupes de rapports pour un projet de génération. L'un est spécifié avec son ARN, l'autre avec un nom. La section `files` spécifie les fichiers qui contiennent les résultats de cas de test. La section facultative `base-directory` spécifie le répertoire où se trouvent les fichiers de cas de test. La `discard-paths` section facultative indique si les chemins d'accès aux fichiers de résultats de test chargés dans un compartiment Amazon S3 sont supprimés.
```
reports:
arn:aws:codebuild:your-region:your-aws-account-id:report-group/report-group-name-1: #surefire junit reports
files:
- '**/*'
base-directory: 'surefire/target/surefire-reports'
discard-paths: false
sampleReportGroup: #Cucumber reports from json plugin
files:
- 'cucumber-json/target/cucumber-json-report.json'
file-format: CUCUMBERJSON #Type of the report, defaults to JUNITXML
```
# Spécification des commandes de test
Vous spécifiez les commandes qui exécutent vos cas de test dans la section `commands` de votre fichier buildspec. Ces commandes exécutent les cas de test spécifiés pour vos groupes de rapports dans la section `reports` de votre fichier buildspec. Voici un exemple de section `commands` qui inclut des commandes pour exécuter les tests dans les fichiers de test :
```
commands:
- echo Running tests for surefire junit
- mvn test -f surefire/pom.xml -fn
- echo
- echo Running tests for cucumber with json plugin
- mvn test -Dcucumber.options="--plugin json:target/cucumber-json-report.json" -f cucumber-json/pom.xml -fn
```
Pour de plus amples informations, veuillez consulter [Syntaxe d'un fichier buildspec](build-spec-ref.md#build-spec-ref-syntax).
# Marquer un groupe de rapports dans AWS CodeBuild
Une *balise* est une étiquette d'attribut personnalisée que vous attribuez ou AWS assignez à une AWS ressource. Chaque AWS étiquette comporte deux parties :
+ Une *clé de balise* (par exemple, `CostCenter`, `Environment`, `Project` ou `Secret`). Les touches de tag distinguent les majuscules et minuscules.
+ Un champ facultatif appelé *valeur de balise* (par exemple, `111122223333`, `Production` ou le nom d’une équipe). Omettre la valeur de balise équivaut à l’utilisation d’une chaîne vide. Les valeurs de balise sont sensibles à la casse, tout comme les clés de balise.
Ensemble, ces éléments sont connus sous le nom de paires clé-valeur. Pour les limites sur le nombre de balises que vous pouvez avoir dans un groupe de rapports et les restrictions sur les valeurs et clés de balise, consultez [Étiquettes](limits.md#tag-limits).
Les balises vous aident à identifier et à organiser vos AWS ressources. De nombreux AWS services prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer que les ressources sont liées. Par exemple, vous pouvez attribuer la même balise à un groupe de CodeBuild rapports que celle que vous attribuez à un compartiment Amazon S3. Pour de plus amples informations sur l'utilisation de balises, veuillez consulter le livre blanc sur les [bonnes pratiques de balisage](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf).
Dans CodeBuild, les ressources principales sont le groupe de rapports et le projet. Vous pouvez utiliser la CodeBuild console, le AWS CLI CodeBuild APIs, ou AWS SDKs pour ajouter, gérer et supprimer des balises pour un groupe de rapports. Outre l'identification, l'organisation et le suivi de votre groupe de rapports à l'aide de balises, vous pouvez utiliser des balises dans les politiques IAM pour contrôler qui peut consulter votre groupe de rapports et interagir avec celui-ci. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
**Topics**
+ [Ajouter des balises à un groupe de rapports](how-to-tag-report-group-add.md)
+ [Afficher les balises d'un groupe de rapports](how-to-tag-report-group-list.md)
+ [Modifier les balises d'un groupe de rapports](how-to-tag-report-group-update.md)
+ [Supprimer des balises d'un groupe de rapports](how-to-tag-report-group-delete.md)
# Ajouter des balises à un groupe de rapports
L'ajout de balises à un groupe de rapports peut vous aider à identifier et à organiser vos AWS ressources et à gérer l'accès à celles-ci. Tout d'abord, vous ajoutez une ou plusieurs balises (paires clé-valeur) à un groupe de rapports. N'oubliez pas qu'il y a des limites sur le nombre de balises que vous pouvez avoir dans un groupe de rapports. Il existe des restrictions sur les caractères que vous pouvez utiliser dans les champs clé et valeur. Pour de plus amples informations, veuillez consulter [Étiquettes](limits.md#tag-limits). Une fois que vous avez des balises, vous pouvez créer des politiques IAM pour gérer l'accès au groupe de rapports en fonction de ces balises. Vous pouvez utiliser la CodeBuild console ou le AWS CLI pour ajouter des balises à un groupe de rapports.
**Important**
L'ajout de balises à un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant d'ajouter une balise à un groupe de rapports, assurez-vous de consulter les politiques IAM susceptibles d'utiliser des balises pour contrôler l'accès aux ressources telles que les groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
Pour plus d'informations sur l'ajout de balises à un groupe de rapports lorsque vous le créez, consultez [Créer un groupe de rapports (console)](report-group-create.md#test-report-group-create-console).
**Topics**
+ [Ajouter une balise à un groupe de rapports (console)](#how-to-tag-report-group-add-console)
+ [Ajouter une balise à un groupe de rapports (AWS CLI)](#how-to-tag-report-group-add-cli)
## Ajouter une balise à un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour ajouter une ou plusieurs balises à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Report groups (Groupes de rapports)**, choisissez le nom du groupe de rapports auquel vous souhaitez ajouter des balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Si aucune des balises n'a été ajoutée au groupe de rapports, choisissez **Add tag (Ajouter une balise)**. Vous pouvez également choisir **Modifier**, puis **Ajouter une balise**.
1. Dans **Key (Clé)**, entrez un nom de balise. Vous pouvez ajouter une valeur en option pour la balise dans **Value (Valeur)**.
1. (Facultatif) Pour ajouter une autre balise, choisissez à nouveau **Add tag (Ajouter une balise)**.
1. Lorsque vous avez fini d'ajouter des balises, choisissez **Submit (Envoyer)**.
## Ajouter une balise à un groupe de rapports (AWS CLI)
Pour ajouter une balise à un groupe de rapports lorsque vous le créez, veuillez consulter [Création d'un groupe de rapports (CLI)](report-group-create.md#test-report-group-create-cli). Dans `CreateReportGroup.json`, ajoutez vos balises.
Pour ajouter des balises à un groupe de rapports existant, veuillez consulter [Mise à jour d'un groupe de rapports (CLI)](report-group-export-settings.md#update-report-group-cli) et ajoutez vos balises dans `UpdateReportGroupInput.json`.
Dans ces étapes, nous supposons que vous avez déjà installé une version récente de l’ AWS CLI ou que vous avez procédé à une mise à jour vers la version actuelle. Pour plus d’informations, consultez [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) (Installation de).
# Afficher les balises d'un groupe de rapports
Les balises peuvent vous aider à identifier et à organiser vos AWS ressources et à gérer l'accès à celles-ci. Pour de plus amples informations sur l'utilisation de balises, veuillez consulter le livre blanc sur les [bonnes pratiques de balisage](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf). Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Afficher les balises d'un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour afficher les balises associées à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dans lequel vous souhaitez afficher les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
## Afficher les balises d'un groupe de rapports (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI afin d'afficher les AWS balises d'un groupe de rapports. Si aucune balise n'a été ajoutée, la liste des balises renvoyées est vide.
1. Utilisez la console ou le AWS CLI pour localiser l'ARN de votre groupe de rapports. Prenez-en note.
------
#### [ AWS CLI ]
Exécutez la commande suivante.
```
aws list-report-groups
```
Cette commande renvoie des informations au format JSON semblables à ce qui suit :
```
{
"reportGroups": [
"arn:aws:codebuild:region:123456789012:report-group/report-group-1",
"arn:aws:codebuild:region:123456789012:report-group/report-group-2",
"arn:aws:codebuild:region:123456789012:report-group/report-group-3"
]
}
```
Un ARN de groupe de rapports se termine par son nom, que vous pouvez utiliser pour identifier l'ARN de votre groupe de rapports.
------
#### [ Console ]
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom de votre groupe de rapports avec les balises que vous souhaitez afficher.
1. Dans **Configuration** recherchez l'ARN de votre groupe de rapports.
------
1. Exécutez la commande suivante. Utilisez l'ARN dont vous avez fait une note pour le paramètre `--report-group-arns`.
```
aws codebuild batch-get-report-groups --report-group-arns arn:aws:codebuild:region:123456789012:report-group/report-group-name
```
En cas de succès, cette commande renvoie des informations au format JSON qui contiennent une section `tags` similaire à la suivante :
```
{
...
"tags": {
"Status": "Secret",
"Project": "TestBuild"
}
...
}
```
# Modifier les balises d'un groupe de rapports
Vous pouvez modifier la valeur d'une balise associée à un groupe de rapports. Vous pouvez également modifier le nom de la clé, ce qui équivaut à supprimer la balise et à ajoutant une carte différente avec le nouveau nom et la même valeur que l’autre clé. N'oubliez pas qu'il y a des limites sur les caractères que vous pouvez utiliser dans les champs clé et valeur. Pour de plus amples informations, veuillez consulter [Étiquettes](limits.md#tag-limits).
**Important**
La modification des balises d'un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant de modifier le nom (clé) ou la valeur d'une balise pour un groupe de rapports, assurez-vous de consulter les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès aux ressources telles que les groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Deny or allow actions on report groups based on resource tags](auth-and-access-control-using-tags.md#report-group-tag-policy-example).
## Modifier une balise pour un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour modifier les balises associées à un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dont vous souhaitez modifier les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Choisissez **Modifier**.
1. Effectuez l’une des actions suivantes :
+ Pour modifier la balise, entrez un nouveau nom dans **Key (Clé)**. La modification du nom de la balise est l'équivalent de la suppression d'une balise et de l'ajout d'une nouvelle balise avec le nouveau nom de clé.
+ Pour modifier la valeur d'une balise, saisissez une nouvelle valeur. Si vous souhaitez modifier la valeur en valeur nulle, supprimez la valeur actuelle et laissez le champ vide.
1. Lorsque vous avez terminé de modifier des balises, choisissez **Submit (Soumettre)**.
## Modifier les balises d'un groupe de rapports (AWS CLI)
Pour ajouter, modifier ou supprimer des balises d'un groupe de rapports, veuillez consulter [Mise à jour d'un groupe de rapports (CLI)](report-group-export-settings.md#update-report-group-cli). Mettez à jour les balises dans `UpdateReportGroupInput.json`.
# Supprimer des balises d'un groupe de rapports
Vous pouvez supprimer une ou plusieurs balises associées à un groupe de rapports. La suppression d'un tag ne supprime pas le tag des autres AWS ressources associées à ce tag.
**Important**
La suppression de balises pour un groupe de rapports peut avoir un impact sur l'accès au groupe de rapports. Avant de supprimer une balise d'un groupe de rapports, assurez-vous de passer en revue les politiques IAM susceptibles d'utiliser la clé ou la valeur d'une balise pour contrôler l'accès aux ressources telles que les groupes de rapports. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez [Utilisation de balises pour contrôler l'accès aux AWS CodeBuild ressources](auth-and-access-control-using-tags.md).
## Supprimer une balise d'un groupe de rapports (console)
Vous pouvez utiliser la CodeBuild console pour supprimer l'association entre une balise et un groupe de CodeBuild rapports.
1. Ouvrez la CodeBuild console à l'adresse [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).
1. Dans **Groupes de rapports**, choisissez le nom du groupe de rapports dans lequel vous souhaitez supprimer les balises.
1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres).
1. Choisissez **Modifier**.
1. Trouvez la balise que vous voulez supprimer, puis choisissez **Remove tag (Supprimer une balise)**.
1. Lorsque vous avez terminé de supprimer les balises, choisissez **Submit (Envoyer)**.
## Supprimer une balise d'un groupe de rapports (AWS CLI)
Procédez comme suit pour utiliser le AWS CLI pour supprimer une balise d'un groupe de CodeBuild rapports. La suppression d'une balise supprime uniquement son association au groupe de rapports, mais pas la balise en elle-même.
**Note**
Si vous supprimez un groupe de CodeBuild rapports, toutes les associations de balises sont supprimées du groupe de rapports supprimé. Vous n'avez pas besoin de supprimer les balises avant de supprimer un groupe de rapports.
Pour supprimer une ou plusieurs balises d'un groupe de rapports, reportez-vous à la section [Modifier les balises d'un groupe de rapports (AWS CLI)](how-to-tag-report-group-update.md#how-to-tag-report-group-update-cli). Mettez à jour la `tags` section dans les données formatées JSON avec une liste mise à jour de balises qui ne contient pas celles que vous souhaitez supprimer. Si vous souhaitez supprimer toutes les balises, mettez à jour la section `tags` pour :
```
"tags: []"
```
# Mise à jour d'un groupe de rapports
Lorsque vous mettez à jour un groupe de rapports, vous pouvez indiquer s'il convient d'exporter les données brutes des résultats de test vers des fichiers d'un compartiment Amazon S3. Si vous choisissez d'exporter vers un compartiment S3, vous pouvez spécifier les éléments suivants pour votre groupe de rapports :
+ Indique si les fichiers de résultats de test bruts sont compressés dans un fichier ZIP.
+ Indique si les fichiers de résultats de test bruts sont chiffrés. Vous pouvez spécifier le chiffrement avec l'une des options suivantes :
+ Et Clé gérée par AWS pour Amazon S3.
+ Une clé gérée par le client que vous créez et configurez.
Pour de plus amples informations, veuillez consulter [Chiffrement des données](security-encryption.md).
Si vous utilisez le AWS CLI pour mettre à jour un groupe de rapports, vous pouvez également mettre à jour ou ajouter des balises. Pour de plus amples informations, veuillez consulter [Marquer un groupe de rapports dans AWS CodeBuildBaliser un groupe de rapports](how-to-tag-report-group.md).
**Note**
Le rôle CodeBuild de service spécifié dans le projet est utilisé pour les autorisations de téléchargement vers le compartiment S3.
**Topics**
+ [Mise à jour d'un groupe de rapports (console)](#update-report-group-console)
+ [Mise à jour d'un groupe de rapports (CLI)](#update-report-group-cli)
## Mise à jour d'un groupe de rapports (console)
Utilisez la procédure suivante pour mettre à jour un groupe de rapports à l'aide du AWS Management Console.
**Pour mettre à jour un groupe de rapports**
1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Dans le panneau de navigation, sélectionnez **Groupes de rapports**.
1. Choisissez le groupe de rapports que vous souhaitez mettre à jour.
1. Choisissez **Modifier**.
1. Sélectionnez ou désactivez **Backup to Amazon S3**. Si vous avez sélectionné cette option, spécifiez vos paramètres d'exportation :
1. Pour le **nom du compartiment S3**, entrez le nom du compartiment S3.
1. Pour **Préfixe du chemin d'accès**, entrez le chemin de votre compartiment S3 où vous souhaitez télécharger les résultats de vos tests.
1. Sélectionnez **Compresser les données de résultats de test dans un fichier zip** pour compresser vos fichiers de données de résultats de test bruts.
1. Développez **Configuration supplémentaire** pour afficher les options de chiffrement. Sélectionnez l’une des méthodes suivantes :
+ **Clé AWS gérée par défaut** à utiliser Clé gérée par AWS pour Amazon S3. Pour plus d'informations, consultez la section [Gestion des clients CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) dans le *guide de AWS Key Management Service l'utilisateur*. Il s'agit de l'option de chiffrement par défaut.
+ **Choisissez une clé personnalisée** pour utiliser une clé gérée par le client que vous créez et configurez. Pour la **clé de AWS KMS chiffrement**, entrez l'ARN de votre clé de chiffrement. Son format est ` arn:aws:kms:: :key/ `. Pour de plus amples informations, veuillez consulter [Création de clés KMS](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) dans le *Guide de l'utilisateur AWS Key Management Service *.
+ **Désactivez le chiffrement des artefacts** pour désactiver le chiffrement. Vous pouvez choisir cette option si vous souhaitez partager vos résultats de test ou les publier sur un site web statique. (Un site web dynamique peut exécuter du code pour déchiffrer les résultats des tests.)
## Mise à jour d'un groupe de rapports (CLI)
Utilisez la procédure suivante pour mettre à jour un groupe de rapports à l'aide du AWS CLI.
**Pour mettre à jour un groupe de rapports**
1. Créez un fichier nommé `UpdateReportGroupInput.json`.
1. Copiez ce qui suit dans `UpdateReportGroupInput.json` :
```
{
"arn": "",
"exportConfig": {
"exportConfigType": "S3",
"s3Destination": {
"bucket": "bucket-name",
"path": "path",
"packaging": "NONE | ZIP",
"encryptionDisabled": "false",
"encryptionKey": "your-key"
}
},
"tags": [
{
"key": "tag-key",
"value": "tag-value"
}
]
}
```
1. Entrez l'ARN de votre groupe de rapports dans la ligne `arn` (par exemple, `"arn":"arn:aws:codebuild:region:123456789012:report-group/report-group-1")`).
1. Mettez à jour `UpdateReportGroupInput.json` avec les mises à jour que vous souhaitez appliquer à votre groupe de rapports.
+ Si vous souhaitez mettre à jour votre groupe de rapports pour exporter les fichiers de résultats de test bruts vers un compartiment S3, mettez à jour la section `exportConfig`. Remplacez `bucket-name` par le nom de votre compartiment S3 et `path` par le chemin d'accès de votre compartiment S3 vers l'endroit où vous souhaitez exporter les fichiers. Si vous souhaitez compresser les fichiers exportés, pour `packaging`, spécifiez `ZIP`. Sinon, spécifiez `NONE`. Utilisez `encryptionDisabled` de spécifier si les fichiers exportés doivent être chiffrés. Si vous cryptez les fichiers exportés, entrez votre clé gérée par le client.
+ Si vous souhaitez mettre à jour votre groupe de rapports afin qu'il n'exporte pas les fichiers de résultats de test bruts vers un compartiment S3, mettez à jour la section `exportConfig` avec le code JSON suivant :
```
{
"exportConfig": {
"exportConfigType": "NO_EXPORT"
}
}
```
+ Si vous souhaitez mettre à jour les balises du groupe de rapports, mettez à jour la section `tags`. Vous pouvez modifier, ajouter ou supprimer des balises. Si vous voulez supprimer toutes les balises, mettez-le à jour avec le JSON suivant :
```
"tags": []
```
1. Exécutez la commande suivante :
```
aws codebuild update-report-group \
--cli-input-json file://UpdateReportGroupInput.json
```