Créer un groupe de rapports - AWS CodeBuild
Création d'un groupe de rapports (buildspec)Créer un groupe de rapports (console)Création d'un groupe de rapports (CLI)Création d'un groupe de rapports (AWS CloudFormation)

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 IAM rôle 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.

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.

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.

  2. 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 et Reports syntax in the buildspec file.

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

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

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.

  2. Dans le panneau de navigation, sélectionnez Groupes de rapports.

  3. Choisissez Créer un groupe de rapports.

  4. Pour Nom du groupe de rapports, entrez un nom pour votre groupe de rapports.

  5. (Facultatif) Pour les balises, entrez le nom et la valeur de toutes les balises que vous souhaitez que les AWS services d'assistance utilisent. Utilisez Ajouter une ligne pour ajouter une balise. Vous pouvez ajouter jusqu’à 50 balises.

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

    2. Pour le nom du compartiment S3, entrez le nom du compartiment S3.

    3. (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.

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

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

    6. 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 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 celle ARN de votre clé de chiffrement. Son format est arn:aws:kms:<region-id>: <aws-account-id>:key/<key-id> . Pour plus d'informations, consultez la section Création de KMS clés dans le guide de AWS Key Management Service l'utilisateur.

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

    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.

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

  2. Selon vos besoins, copiez l'un des extraits de JSON code suivants dans : CreateReportGroup.json

    • Utilisez ce qui suit JSON 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": "<report-name>",
  "type": "TEST",
  "exportConfig": {
    "exportConfigType": "S3",
    "s3Destination": {
      "bucket": "<bucket-name>",
      "bucketOwner": "<bucket-owner>",
      "path": "<path>",
      "packaging": "NONE | ZIP",
      "encryptionDisabled": "false",
      "encryptionKey": "<your-key>"
    },
    "tags": [
      {
        "key": "tag-key",
        "value": "tag-value"
      }
    ]
  }
}

      • Remplacez <bucket-name> avec le nom de votre compartiment Amazon S3 et <path> avec le chemin de votre compartiment vers lequel vous souhaitez exporter les fichiers.

      • Si vous souhaitez compresser les fichiers exportés, pour packaging, spécifiez ZIP. Sinon, spécifiez NONE.

      • bucketOwnerest 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.

    • Utilisez ce qui suit JSON pour spécifier que votre rapport de test n'exporte pas les fichiers de test bruts : 

      {
  "name": "<report-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.

  3. Exécutez la commande suivante : 

    aws codebuild create-report-group --cli-input-json file://CreateReportGroupInput.json

Création d'un groupe de rapports (AWS CloudFormation)

Utilisez les instructions suivantes pour créer un groupe de rapports à l'aide du AWS CloudFormation modèle

Pour créer un groupe de rapports à l'aide du AWS CloudFormation modèle

Vous pouvez utiliser un fichier AWS CloudFormation modèle pour créer et configurer un groupe de rapports. Pour plus d’informations, consultez le AWS CloudFormation guide de l’utilisateur.

Le AWS CloudFormation YAML modèle 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 AWS CloudFormation YAML modèle 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.