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. # 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.