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.
# S'intègre AWS CodeBuild
-a
```
Pour exécuter une version ARM, exécutez la commande suivante :
```
$ ./codebuild_build.sh -i -a -l public.ecr.aws/codebuild/local-builds:aarch64
```
Remplacez ** par le nom de l'image du conteneur, tel que `aws/codebuild/standard:5.0` ou`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`.
Le script lance l'image de construction et exécute la construction sur le projet dans le répertoire en cours. Pour spécifier l'emplacement du projet de génération, ajoutez l'`-s `option à la commande de script.
## Recevez des notifications pour les nouvelles versions de CodeBuild l'agent
```
Utilisez cette commande si vous souhaitez exécuter une génération utilisant la dernière version de l'artefact d'entrée de génération et les paramètres existants du projet de génération.
```
aws codebuild start-build --generate-cli-skeleton
```
Utilisez cette commande si vous souhaitez exécuter une génération avec une version précédente de l'artefact d'entrée de génération, ou si vous souhaitez remplacer les paramètres pour les artefacts de sortie, les variables d'environnement, le fichier buildspec ou le délai d'expiration de génération par défaut.
1. Si vous exécutez la **start-build** commande avec l'`--project-name`option, ** remplacez-la par le nom du projet de génération, puis passez à l'étape 6 de cette procédure. Pour obtenir une liste de projets de génération, consultez [Afficher les noms des projets de construction](view-project-list.md).
1. Si vous exécutez la **start-build** commande avec l'`--idempotency-token`option, un identifiant ou un jeton unique distinguant majuscules et minuscules est inclus dans la `start-build` demande. Le jeton est valide pendant 5 minutes après la demande . Si vous répétez la `start-build` demande avec le même jeton, mais que vous modifiez un paramètre, CodeBuild renvoie une erreur de non-concordance des paramètres.
1. Si vous exécutez la commande **start-build** avec l'option `--generate-cli-skeleton`, des données au format JSON apparaissent dans la sortie. Copiez les données dans un fichier (par exemple,`start-build.json`) à un emplacement de l'ordinateur local ou de l'instance sur laquelle le AWS CLI est installé. Modifiez les données copiées pour qu'elles correspondent au format suivant, et enregistrez vos résultats :
```
{
"projectName": "projectName",
"sourceVersion": "sourceVersion",
"artifactsOverride": {
"type": "type",
"location": "location",
"path": "path",
"namespaceType": "namespaceType",
"name": "artifactsOverride-name",
"packaging": "packaging"
},
"buildspecOverride": "buildspecOverride",
"cacheOverride": {
"location": "cacheOverride-location",
"type": "cacheOverride-type"
},
"certificateOverride": "certificateOverride",
"computeTypeOverride": "computeTypeOverride",
"environmentTypeOverride": "environmentTypeOverride",
"environmentVariablesOverride": {
"name": "environmentVariablesOverride-name",
"value": "environmentVariablesValue",
"type": "environmentVariablesOverride-type"
},
"gitCloneDepthOverride": "gitCloneDepthOverride",
"imageOverride": "imageOverride",
"idempotencyToken": "idempotencyToken",
"insecureSslOverride": "insecureSslOverride",
"privilegedModeOverride": "privilegedModeOverride",
"queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
"reportBuildStatusOverride": "reportBuildStatusOverride",
"timeoutInMinutesOverride": "timeoutInMinutesOverride",
"sourceAuthOverride": "sourceAuthOverride",
"sourceLocationOverride": "sourceLocationOverride",
"serviceRoleOverride": "serviceRoleOverride",
"sourceTypeOverride": "sourceTypeOverride"
}
```
Remplacez les espaces réservés suivants :
+ *projectName*: chaîne obligatoire. Nom du projet de génération à utiliser pour la génération.
+ *sourceVersion*: chaîne facultative. Une version du code source à générer, comme suit :
+ Pour Amazon S3, l'ID de version qui correspond à la version du fichier ZIP d'entrée que vous souhaitez créer. Si *sourceVersion* ce n'est pas spécifié, c'est la dernière version qui est utilisée.
+ Pour CodeCommit, l'ID de validation qui correspond à la version du code source que vous souhaitez créer. S'il n'*sourceVersion*est pas spécifié, l'ID de validation HEAD de la branche par défaut est utilisé. (Vous ne pouvez pas spécifier de nom de balise pour*sourceVersion*, mais vous pouvez spécifier l'ID de validation de la balise.)
+ Pour GitHub, l'ID de validation, l'ID de pull request, le nom de branche ou le nom de balise correspondant à la version du code source que vous souhaitez créer. Si un ID de demande d'extraction est spécifié, il doit utiliser le format `pr/pull-request-ID` (par exemple, `pr/25`). Si un nom de branche est spécifié, l'ID de validation HEAD de la branche est utilisé. S'il n'*sourceVersion*est pas spécifié, l'ID de validation HEAD de la branche par défaut est utilisé.
+ Pour Bitbucket, l'ID de validation, le nom de branche ou le nom de balise qui correspond à la version du code source à générer. Si un nom de branche est spécifié, l'ID de validation HEAD de la branche est utilisé. S'il n'*sourceVersion*est pas spécifié, l'ID de validation HEAD de la branche par défaut est utilisé.
+ Les espaces réservés suivants sont pour `artifactsOverride`.
+ *type* - Facultatif. Type d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *location* - Facultatif. Emplacement d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *path* - Facultatif. Chemin d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *namespaceType* - Facultatif. Type de chemin d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *name* - Facultatif. Nom d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *packaging* - Facultatif. Type de packaging d'artefact de sortie de génération qui remplace pour cette génération celui défini dans le projet de génération.
+ *buildspecOverride* - Facultatif. Déclaration de spécification de génération (buildspec) qui remplace pour cette génération celle définie dans le projet de génération. Si cette valeur est définie, il peut s'agir d'une définition de spécification de génération en ligne, du chemin vers un fichier buildspec alternatif, relatif à la valeur de la variable d'environnement `CODEBUILD_SRC_DIR` intégrée, ou du chemin vers un compartiment S3. Le compartiment S3 doit être dans la même région AWS que le projet de génération. Spécifiez le fichier buildspec à l'aide de son nom ARN (par exemple, `arn:aws:s3:::/buildspec.yml`). Si cette valeur n'est pas fournie ou qu'elle est définie sur une chaîne vide, le code source doit contenir un fichier `buildspec.yml` dans son répertoire racine. Pour de plus amples informations, veuillez consulter [Nom de fichier buildspec et emplacement de stockage](build-spec-ref.md#build-spec-ref-name-storage).
+ Les espaces réservés suivants sont pour `cacheOverride`.
+ *cacheOverride-location* - Facultatif. Emplacement d'un objet `ProjectCache` pour cette génération qui remplace l'objet `ProjectCache` spécifié dans le projet de génération. `cacheOverride` est facultatif et accepte un objet `ProjectCache`. `location` est obligatoire dans un objet `ProjectCache`.
+ *cacheOverride-type* - Facultatif. Type d'un objet `ProjectCache` pour cette génération qui remplace l'objet `ProjectCache` spécifié dans le projet de génération. `cacheOverride` est facultatif et accepte un objet `ProjectCache`. `type` est obligatoire dans un objet `ProjectCache`.
+ *certificateOverride* - Facultatif. Nom d'un certificat pour cette génération qui remplace celui spécifié dans le projet de génération.
+ *environmentTypeOverride* - Facultatif. Type de conteneur pour cette génération qui remplace celui spécifié dans le projet de génération. La chaîne valide actuelle est `LINUX_CONTAINER`.
+ Les espaces réservés suivants sont pour `environmentVariablesOverride`.
+ *environmentVariablesOverride-name* - Facultatif. Nom d'une variable d'environnement dans le projet de génération dont vous voulez substituer la valeur pour cette génération.
+ *environmentVariablesOverride-type* - Facultatif. Type de variable d'environnement dans le projet de génération dont vous voulez substituer la valeur pour cette génération.
+ *environmentVariablesValue* - Facultatif. Valeur de la variable d'environnement définie dans le projet de génération que vous voulez substituer pour cette génération.
+ *gitCloneDepthOverride* - Facultatif. Valeur de **Git clone depth** dans le projet de génération dont vous voulez remplacer la valeur pour cette génération. Si votre type de source est Amazon S3, cette valeur n'est pas prise en charge.
+ *imageOverride* - Facultatif. Nom d'une image pour cette génération qui remplace celle spécifiée dans le projet de génération.
+ *idempotencyToken* - Facultatif. Chaîne qui tient lieu de jeton pour spécifier que la demande de génération est idempotente. Vous pouvez choisir n'importe quelle chaîne de 64 caractères maximum. Le jeton est valide pendant 5 minutes après la demande de démarrage de la construction. Si vous répétez la demande de démarrage de la construction avec le même jeton, mais que vous modifiez un paramètre, cela CodeBuild renvoie une erreur de non-concordance des paramètres.
+ *insecureSslOverride*: booléen facultatif qui indique s'il faut remplacer le paramètre TLS non sécurisé spécifié dans le projet de génération. Le paramètre TLS non sécurisé détermine s'il convient d'ignorer les avertissements TLS lors de la connexion au code source du projet. Cette dérogation s'applique uniquement si la source du build est GitHub Enterprise Server.
+ *privilegedModeOverride*: booléen facultatif. Si celle-ci est définie sur true, la génération remplace le mode privilégié dans le projet de génération.
+ *queuedTimeoutInMinutesOverride*: entier facultatif qui indique le nombre de minutes pendant lesquelles une version est autorisée à être mise en file d'attente avant son expiration. Sa valeur minimale est de cinq minutes et sa valeur maximale est 480 minutes (huit heures).
+ *reportBuildStatusOverride*: booléen facultatif qui indique s'il faut envoyer à votre fournisseur source l'état du début et de la fin d'une compilation. Si vous le définissez avec un fournisseur de source autre qu' GitHub GitHub Enterprise Server ou Bitbucket, un invalidInputException est émis.
+ *sourceAuthOverride*: chaîne facultative. Type d'autorisation pour cette génération qui remplace celle définie dans le projet de génération. Cette dérogation s'applique uniquement si la source du projet de build est Bitbucket ou. GitHub
+ *sourceLocationOverride*: chaîne facultative. Emplacement qui remplace l'emplacement de la source pour cette génération par celui défini dans le projet de génération.
+ *serviceRoleOverride*: chaîne facultative. Nom d'un rôle de service pour cette génération qui remplace celui spécifié dans le projet de génération.
+ *sourceTypeOverride*: chaîne facultative. Type d'entrée source pour cette génération qui remplace l'entrée source définie dans le projet de génération. Les chaînes valides sont `NO_SOURCE`, `CODECOMMIT`, `CODEPIPELINE`, `GITHUB`, `S3`, `BITBUCKET` et `GITHUB_ENTERPRISE`.
+ *timeoutInMinutesOverride*: Numéro optionnel. Nombre de minutes de délai d'expiration de génération qui remplace pour cette de génération celui défini dans le projet de génération.
Nous vous recommandons de stocker une variable d'environnement avec une valeur sensible, telle qu'un identifiant de clé d' AWS accès, une clé d'accès AWS secrète ou un mot de passe en tant que paramètre dans Amazon EC2 Systems Manager Parameter Store. CodeBuild peut utiliser un paramètre stocké dans Amazon EC2 Systems Manager Parameter Store uniquement si le nom de ce paramètre commence par `/CodeBuild/` (par exemple,`/CodeBuild/dockerLoginPassword`). Vous pouvez utiliser la CodeBuild console pour créer un paramètre dans Amazon EC2 Systems Manager. Sélectionnez **Créer un paramètre**, puis suivez les instructions. (Dans cette boîte de dialogue, pour la **clé KMS**, vous pouvez éventuellement spécifier l'ARN d'une AWS KMS clé dans votre compte. Amazon EC2 Systems Manager utilise cette clé pour chiffrer la valeur du paramètre pendant le stockage et pour le déchiffrer lors de la récupération.) Si vous utilisez la CodeBuild console pour créer un paramètre, la console commence le paramètre `/CodeBuild/` tel qu'il est stocké. Toutefois, si vous utilisez la console Amazon EC2 Systems Manager Parameter Store pour créer un paramètre, vous devez commencer le nom du paramètre par et définir **Type** sur **Secure String**. `/CodeBuild/` Pour plus d'informations, consultez les [AWS Systems Manager sections Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) et [Walkthrough : Create and test a String parameter (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html) dans le *guide de l'utilisateur d'Amazon EC2 Systems Manager*.
Si votre projet de génération fait référence à des paramètres stockés dans Amazon EC2 Systems Manager Parameter Store, le rôle de service du projet de génération doit autoriser l'`ssm:GetParameters`action. Si vous avez choisi **Créer un nouveau rôle de service dans votre compte** plus tôt, cette action est automatiquement incluse dans le rôle de service par défaut de votre projet de génération. CodeBuild Toutefois, si vous avez choisi précédemment **Choisir un rôle de service existant dans votre compte**, vous devez inclure séparément cette action dans votre rôle de service.
Les variables d'environnement que vous définissez remplacent les variables d'environnement existantes. Par exemple, si l'image Docker contient déjà une variable d'environnement nommée `MY_VAR` avec la valeur `my_value` et que vous définissez une variable d'environnement nommée `MY_VAR` avec la valeur `other_value`, la valeur `my_value` est remplacée par `other_value`. De même, si l'image Docker contient déjà une variable d'environnement nommée `PATH` avec la valeur `/usr/local/sbin:/usr/local/bin` et que vous définissez une variable d'environnement nommée `PATH` avec la valeur `$PATH:/usr/share/ant/bin`, la valeur `/usr/local/sbin:/usr/local/bin` est remplacée par la valeur littérale `$PATH:/usr/share/ant/bin`.
Ne définissez pas de variables d'environnement avec un nom commençant par `CODEBUILD_`. Ce préfixe est réservé à une utilisation interne .
Si une variable d'environnement avec le même nom est définie dans plusieurs emplacements, la valeur de la variable d'environnement est déterminée comme suit :
+ La valeur de l'appel d'opération de démarrage de génération a une priorité plus élevée.
+ La valeur de la définition de projet de génération vient ensuite dans l'ordre des priorités.
+ La valeur figurant dans la déclaration du fichier buildspec a la priorité la plus faible.
Pour de plus amples informations sur les valeurs valides pour ces espaces réservés, consultez [Création d'un projet de génération (AWS CLI)](create-project.md#create-project-cli). Pour obtenir une liste des derniers paramètres pour un projet de génération, consultez [Afficher les détails du projet de construction](view-project-details.md).
1. Placez-vous dans le répertoire contenant le fichier que vous venez d'enregistrer, puis exécutez à nouveau la commande `start-build`.
```
aws codebuild start-build --cli-input-json file://start-build.json
```
1. En cas de réussite, des données similaires à ce qui est décrit dans la procédure [Pour exécuter la génération](getting-started-overview.md#getting-started-run-build-cli) apparaissent en sortie.
Pour utiliser les informations détaillées sur cette génération, notez la valeur `id` de la sortie, puis consultez [Affichage des détails d'une génération (AWS CLI)](view-build-details.md#view-build-details-cli).
# Exécuter une compilation par lots (AWS CLI)
```
Utilisez cette commande si vous souhaitez exécuter une génération utilisant la dernière version de l'artefact d'entrée de génération et les paramètres existants du projet de génération.
```
aws codebuild start-build-batch --generate-cli-skeleton >
```
Utilisez cette commande si vous souhaitez exécuter une génération avec une version précédente de l'artefact d'entrée de génération, ou si vous souhaitez remplacer les paramètres pour les artefacts de sortie, les variables d'environnement, le fichier buildspec ou le délai d'expiration de génération par défaut.
1. Si vous exécutez la **start-build-batch** commande avec l'`--project-name`option, ** remplacez-la par le nom du projet de génération, puis passez à l'étape 6 de cette procédure. Pour obtenir une liste de projets de génération, consultez [Afficher les noms des projets de construction](view-project-list.md).
1. Si vous exécutez la **start-build-batch** commande avec l'`--idempotency-token`option, un identifiant unique distinguant majuscules et minuscules, ou jeton, est inclus dans la `start-build-batch` demande. Le jeton est valide pendant 5 minutes après la demande . Si vous répétez la `start-build-batch` demande avec le même jeton, mais que vous modifiez un paramètre, CodeBuild renvoie une erreur de non-concordance des paramètres.
1. Si vous exécutez la **start-build-batch** commande avec l'`--generate-cli-skeleton`option, les données au format JSON sont sorties dans le fichier. ** Ce fichier est similaire au squelette produit par la **start-build** commande, avec l'ajout de l'objet suivant. Pour plus d'informations sur les objets courants, consultez[Exécution d'une génération (AWS CLI)](run-build-cli.md).
Modifiez ce fichier pour ajouter des remplacements de build et enregistrez vos résultats.
```
"buildBatchConfigOverride": {
"combineArtifacts": combineArtifacts,
"restrictions": {
"computeTypesAllowed": [
allowedComputeTypes
],
"maximumBuildsAllowed": maximumBuildsAllowed
},
"serviceRole": "batchServiceRole",
"timeoutInMins": batchTimeout
}
```
L'`buildBatchConfigOverride`objet est une [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html)structure qui contient les remplacements de configuration de génération par lots pour cette version.
*combineArtifacts*
Un booléen qui indique si les artefacts de construction pour la génération par lots doivent être combinés dans un seul emplacement d'artefact.
*allowedComputeTypes*
Tableau de chaînes qui spécifient les types de calcul autorisés pour la construction par lots. Reportez-vous [à la section Types de calcul de l'environnement](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html) de génération pour ces valeurs.
*maximumBuildsAllowed*
Spécifie le nombre maximal de builds autorisés.
*batchServiceRole*
Spécifie l'ARN du rôle de service pour le projet de génération par lots.
*batchTimeout*
Spécifie la durée maximale, en minutes, pendant laquelle la génération du lot doit être terminée.
1. Placez-vous dans le répertoire contenant le fichier que vous venez d'enregistrer, puis exécutez à nouveau la commande `start-build-batch`.
```
aws codebuild start-build-batch --cli-input-json file://start-build.json
```
1. En cas de succès, la représentation JSON d'un [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html)objet apparaît dans la sortie de la console. Voir la [syntaxe de StartBuildBatch réponse](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) pour un exemple de ces données.
# Lancement automatique de l'exécution de générations (AWS CLI)
```
**est le nom du projet de construction qui contient le code source à reconstruire.
En GitHub effet, des informations similaires aux suivantes apparaissent dans la sortie :
```
{
"webhook": {
"url": ""
}
}
```
**est l'URL du GitHub webhook.
Pour GitHub Enterprise Server, des informations similaires aux suivantes apparaissent dans la sortie :
![\[Exemples d'informations de sortie.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/create-webhook-ghe.png)
1. Copiez la clé secrète et l'URL de la charge utile à partir de la sortie. Vous en avez besoin pour ajouter un webhook dans GitHub Enterprise Server.
1. Dans GitHub Enterprise Server, choisissez le référentiel dans lequel votre CodeBuild projet est stocké. Choisissez **Settings (Paramètres)**, **Hooks & services**, puis **Add webhook (Ajouter un webhook)**.
1. Entrez l'URL et la clé secrète de la charge utile, acceptez les valeurs par défaut pour les autres champs, puis choisissez **Add webhook**.
# Arrêt automatique de l'exécution de générations (AWS CLI)
```
+ où ** est le nom du projet de construction qui contient le code source à reconstruire.
Si cette commande aboutit, aucune information ni aucune erreur n'apparaît dans la sortie.
**Note**
Cela supprime le webhook de votre CodeBuild projet uniquement. Vous devez également supprimer le webhook de votre référentiel GitHub ou de celui GitHub d'Enterprise Server.
# Exécution d'une génération (AWS SDKs)
```
1. Téléchargez le dossier AWS SAM du projet dans un référentiel source compatible. Pour obtenir la liste des types de sources pris en charge, consultez [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Création d'un projet CodeBuild Lambda Java
` pour créer une application React simple.
1. Téléchargez le dossier du projet de l'application React dans un référentiel source compatible. Pour obtenir la liste des types de sources pris en charge, consultez [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Création d'un projet CodeBuild Lambda Node.js
"
LAMBDA_ENV_VARIABLE: "FEATURE_ENABLED"
LAMBDA_ENV_VARIABLE_VALUE: "true"
phases:
install:
commands:
- pip3 install boto3
build:
commands:
- python3 update_lambda_environment_variables.py
```
1. Choisissez **Update buildspec (Mettre à jour buildspec)**.
## Mettez à jour votre configuration Lambda
[ ...]
```
+ ````, etc. : un ou plusieurs modèles globaux à comparer aux fichiers de votre répertoire de travail.
+ `*`: Correspond à n'importe quelle séquence de caractères (à l'exception des séparateurs de chemin).
+ `**`: Correspond à n'importe quelle séquence de caractères (y compris les séparateurs de chemin).
**Note**
Assurez-vous que la chaîne globale contient des guillemets. Pour vérifier les résultats de la correspondance de modèles, utilisez la `echo` commande.
```
version: 0.2
phases:
build:
commands:
- echo $(codebuild-glob-search '**/__tests__/*.js')
- codebuild-glob-search '**/__tests__/*.js' | xargs -n 1 echo
```
## Output
`, où le `shard_number` représente le numéro de la partition dans laquelle le groupe de rapports est créé. Cette organisation vous permet de suivre et d'analyser les tendances au niveau des versions consolidées et individuelles, offrant ainsi une flexibilité dans la manière dont vous surveillez et évaluez leurs processus de création.
Le rapport de construction par lots suit la même structure que les rapports de [génération individuels](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_Report.html). Les champs clés suivants de l'onglet **Rapport** sont spécifiques aux rapports de génération par lots :
**État du rapport de génération par lots**
L'état des rapports de génération par lots suit des règles spécifiques en fonction du type de rapport :
+ Rapports d'essais :
+ Réussite : le statut est défini sur Réussite lorsque tous les rapports de construction individuels ont abouti.
+ Échec : le statut est défini sur Échec si un rapport de génération individuel a échoué.
+ Incomplet : le statut est marqué comme incomplet si un rapport de construction individuel est manquant ou a un statut incomplet.
+ Rapports sur la couverture du code :
+ Terminé : le statut est défini comme terminé lorsque tous les rapports de construction individuels sont terminés.
+ Échec : le statut est défini sur Échec si un rapport de génération individuel a échoué.
+ Incomplet : le statut est marqué comme incomplet si un rapport de construction individuel est manquant ou a un statut incomplet.
**Résumé du test**
Le rapport de test fusionné consolide les champs suivants de tous les rapports de construction individuels :
+ duration-in-nano-seconds: durée maximale du test en nanosecondes pour tous les rapports de construction individuels.
+ total : le nombre combiné de tous les cas de test, en additionnant le nombre total de tests de chaque version.
+ status-counts : fournit une vue consolidée des statuts de test tels que réussis, échoués ou ignorés, calculée en agrégeant le nombre de chaque type de statut sur toutes les versions individuelles.
**Résumé de la couverture du code**
Le rapport de couverture du code fusionné combine les champs de toutes les versions individuelles en utilisant les calculs suivants :
+ branches couvertes : somme de toutes les branches couvertes à partir des rapports individuels.
+ branches-missed : somme de toutes les branches manquantes dans les rapports individuels.
+ branch-coverage-percentage: `(Total covered branches / Total branches) * 100`
+ lignes couvertes : somme de toutes les lignes couvertes dans les rapports individuels.
+ lines-missed : somme de toutes les lignes manquées dans les rapports individuels.
+ lines-coverage-percentage: `(Total covered lines / Total lines) * 100`
**ID d'exécution**
L'ARN de génération par lots.
**Cas de test**
Le rapport fusionné contient une liste consolidée de tous les cas de test issus de versions individuelles, accessible via l'[DescribeTestCases](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeTestCases.html)API et le rapport de génération par lots dans la console.
**Couvertures par code**
Le rapport de couverture du code fusionné fournit des informations consolidées sur la couverture des lignes et des branches pour chaque fichier dans toutes les versions individuelles, accessibles via l'[DescribeCodeCoverages](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeCodeCoverages.html)API et le rapport de génération par lots dans la console. Remarque : Pour les fichiers couverts par plusieurs fichiers de test répartis sur différentes partitions, le rapport fusionné utilise les critères de sélection suivants :
1. La sélection principale est basée sur la couverture de lignes la plus élevée parmi les fragments.
1. Si la couverture des lignes est égale sur plusieurs partitions, la partition présentant la couverture de branches la plus élevée est sélectionnée.
# Exemple d'exécution de tests en parallèle pour différents frameworks de test
...
```
Voici quelques exemples d'utilisation de `codebuild-hash-files` :
```
codebuild-hash-files package-lock.json
codebuild-hash-files '**/*.md'
```
## Version du cache
Artifacts:
Type: S3
Location:
Name: myArtifact
EncryptionDisabled: true
OverrideArtifactName: true
Environment:
Type: LINUX_CONTAINER
ComputeType: BUILD_GENERAL1_SMALL
Image: aws/codebuild/standard:5.0
Certificate:
# PrivilegedMode must be true if you specify LOCAL_DOCKER_LAYER_CACHE
PrivilegedMode: true
Source:
Type: GITHUB
Location:
InsecureSsl: true
GitCloneDepth: 1
ReportBuildStatus: false
TimeoutInMinutes: 10
Cache:
Type: LOCAL
Modes: # You can specify one or more cache mode,
- LOCAL_CUSTOM_CACHE
- LOCAL_DOCKER_LAYER_CACHE
- LOCAL_SOURCE_CACHE
```
**Note**
Par défaut, le démon Docker est activé pour les versions non VPC. Si vous souhaitez utiliser des conteneurs Docker pour les builds VPC, [consultez Runtime Privilege et Linux](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities) Capabilities sur le site Web de Docker Docs et activez le mode privilégié. De plus, Windows ne prend pas en charge le mode privilégié.
Pour de plus amples informations, veuillez consulter [Création d'un projet de génération (CloudFormation)](create-project.md#create-project-cloud-formation).
# Debug s'intègre AWS CodeBuild
:`
Par exemple, `project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
+ ARN du bac à sable : arn:aws:codebuild : ::sandbox/ : ** ** ** **
Par exemple, `arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
------
#### [ Sample response ]
```
{
"sandboxes": [{
"id": "project-name",
"arn": "arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name",
"projectName": "project-name",
"requestTime": "2025-02-06T11:24:15.560000-08:00",
"endTime": "2025-02-06T11:39:21.587000-08:00",
"status": "STOPPED",
"source": {
"type": "S3",
"location": "arn:aws:s3:::cofa-e2e-test-1-us-west-2-beta-default-build-sources/eb-sample-jetty-v4.zip",
"insecureSsl": false
},
"environment": {
"type": "LINUX_CONTAINER",
"image": "aws/codebuild/standard:6.0",
"computeType": "BUILD_GENERAL1_SMALL",
"environmentVariables": [{
"name": "foo",
"value": "bar",
"type": "PLAINTEXT"
},
{
"name": "bar",
"value": "baz",
"type": "PLAINTEXT"
}
],
"privilegedMode": false,
"imagePullCredentialsType": "CODEBUILD"
},
"timeoutInMinutes": 10,
"queuedTimeoutInMinutes": 480,
"logConfig": {
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
},
"encryptionKey": "arn:aws:kms:us-west-2:962803963624:alias/SampleEncryptionKey",
"serviceRole": "arn:aws:iam::962803963624:role/BuildExecutionServiceRole",
"currentSession": {
"id": "0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"currentPhase": "COMPLETED",
"status": "STOPPED",
"startTime": "2025-02-06T11:24:15.626000-08:00",
"endTime": "2025-02-06T11:39:21.600000-08:00",
"phases": [{
"phaseType": "SUBMITTED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.577000-08:00",
"endTime": "2025-02-06T11:24:15.606000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "QUEUED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.606000-08:00",
"endTime": "2025-02-06T11:24:16.067000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "PROVISIONING",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:16.067000-08:00",
"endTime": "2025-02-06T11:24:20.519000-08:00",
"durationInSeconds": 4,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "DOWNLOAD_SOURCE",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:20.519000-08:00",
"endTime": "2025-02-06T11:24:22.238000-08:00",
"durationInSeconds": 1,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "RUNNING_SANDBOX",
"phaseStatus": "TIMED_OUT",
"startTime": "2025-02-06T11:24:22.238000-08:00",
"endTime": "2025-02-06T11:39:21.560000-08:00",
"durationInSeconds": 899,
"contexts": [{
"statusCode": "BUILD_TIMED_OUT",
"message": "Build has timed out. "
}]
},
{
"phaseType": "COMPLETED",
"startTime": "2025-02-06T11:39:21.560000-08:00"
}
],
"logs": {
"groupName": "group",
"streamName": "stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logsV2:log-groups/log-group/group/log-events/stream$252F0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3DeepLink": "https://s3.console.aws.amazon.com/s3/object/codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz?region=us-west-2",
"cloudWatchLogsArn": "arn:aws:logs:us-west-2:962803963624:log-group:group:log-stream:stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3LogsArn": "arn:aws:s3:::codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz",
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
}
}
}],
"sandboxesNotFound": []
}
```
------
### Arrêter un bac à sable ()AWS CLI
:sandbox/
```
**Note**
Pour résoudre les problèmes de connexion, utilisez l'`-v`indicateur pour activer la sortie détaillée. Par exemple, `ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1::sandbox/`.
Pour obtenir des conseils de dépannage supplémentaires, consultez[Résolution des problèmes AWS CodeBuild de connexion SSH au sandbox](sandbox-troubleshooting.md).
## Étape 4 : Passez en revue vos résultats
`, vous pouvez rencontrer une `InvalidInputException` erreur telle que :
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts:::assumed-role//AWSCodeBuild-
is not authorized to perform: ssm:StartSession on resource.
```
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for
sandbox : codebuild: is not connected.
```
**Cause possible :**
+ Agent Amazon EC2 Systems Manager manquant : l'agent SSM n'est pas correctement installé ou configuré sur l'image de compilation.
+ Autorisations insuffisantes : le rôle de service de CodeBuild projet ne dispose pas des autorisations SSM requises.
**Solution recommandée :** Si vous utilisez une image personnalisée pour votre build, procédez comme suit.
1. Installez SSM Agent. Pour plus d'informations, consultez la section [Installation et désinstallation manuelles de l'agent SSM sur les instances Amazon EC2 pour](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) Linux dans le. ** La version de l'agent SSM doit être `3.0.1295.0` ou ultérieure.
1. Copiez le fichier [ https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json) dans le `/etc/amazon/ssm/` répertoire de votre image. Cela active **le mode conteneur** dans l'agent SSM.
1. Assurez-vous que le rôle de service de votre CodeBuild projet dispose des autorisations suivantes, puis redémarrez l'environnement sandbox :
```
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:StartSession"
],
"Resource": [
"arn:aws:codebuild:region:account-id:build/*",
"arn:aws:ssm:region::document/AWS-StartSSHSession"
]
}
```
## Erreur : « Impossible de localiser les informations d'identification » lors du SSH dans un environnement CodeBuild sandbox
`, vous pouvez rencontrer l'erreur d'identification suivante :
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Cause possible :** les AWS informations d'identification n'ont pas été correctement configurées dans votre environnement local.
**Solution recommandée :** Configurez vos AWS CLI informations d'identification en suivant la documentation officielle : [Configuration des paramètres du Guide de AWS CLI l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)*utilisateur de l'interface de ligne de AWS commande pour la version 2*.
## `StartSandboxConnection``AccessDeniedException`erreur lors du SSH dans un environnement CodeBuild sandbox
`, vous pouvez rencontrer l'erreur d'autorisation suivante :
```
An error occurred (AccessDeniedException) when calling the StartSandboxConnection
operation:
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource:
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action
```
**Cause possible :** Vos AWS informations d'identification ne disposent pas CodeBuild des autorisations nécessaires pour effectuer cette opération.
**Solution recommandée :** assurez-vous que l'utilisateur ou le rôle IAM associé à vos AWS CLI informations d'identification dispose des autorisations suivantes :
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Erreur : « ssh : Impossible de résoudre le nom d'hôte » lors du SSH dans un environnement sandbox CodeBuild
`, vous rencontrez l'erreur de résolution de nom d'hôte suivante :
```
ssh: Could not resolve hostname
```
**Cause possible :** Cette erreur se produit généralement lorsque le script de connexion au CodeBuild sandbox requis n'a pas été correctement exécuté dans votre environnement local.
**Solution recommandée:**
1. Téléchargez le script de connexion au CodeBuild sandbox.
1. Exécutez le script dans votre terminal pour établir la configuration SSH nécessaire.
1. Réessayez de vous connecter SSH à l'environnement sandbox.
# Déboguer les builds avec le gestionnaire de session
",
"arn:aws:s3:::/*"
]
}
]
}
```
Pour plus d'informations, consultez la section [Audit et journalisation de l'activité des sessions](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-logging-auditing.html) dans le *guide de AWS Systems Manager l'utilisateur*.
## Suspendre le build
--region --output json
```
1. Copiez la valeur `sessionTarget` de la propriété. Le nom de la `sessionTarget` propriété peut varier en fonction du type de sortie de la `aws` commande. C'est pourquoi `--output json` il est ajouté à la commande à l'étape précédente.
1. Utilisez la commande suivante pour vous connecter au conteneur de construction.
```
aws ssm start-session --target --region
```
Pour cet exemple, vérifiez que le `/tmp/hello-world` fichier existe et contient le texte`Hello World`.
## Reprendre le build
--idempotency-token
```
Dans la commande précédente, remplacez l'espace réservé suivant :
+ **: chaîne obligatoire. L'ID de la version ou de la génération par lots à réessayer. Pour obtenir la liste des versions IDs, consultez les rubriques suivantes :
+ [Afficher la liste des build IDs (AWS CLI)](view-build-list.md#view-build-list-cli)
+ [Afficher la liste des build IDs (AWS CLI) par lots](view-build-list.md#view-batch-build-list-cli)
+ [Afficher la liste des versions IDs pour un projet de construction (AWS CLI)](view-builds-for-project.md#view-builds-for-project-cli)
+ [Afficher la liste des compilations par lots IDs pour un projet de construction (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
+ `--idempotency-token`: Facultatif. Si vous exécutez la **retry-build** commande avec l'option, un identifiant unique distinguant majuscules et minuscules, ou jeton, est inclus dans la `retry-build` demande. Le jeton est valide pendant 5 minutes après la demande . Si vous répétez la `retry-build` demande avec le même jeton, mais que vous modifiez un paramètre, CodeBuild renvoie une erreur de non-concordance des paramètres.
## Réessayer une compilation manuellement ()AWS SDKs
" \
--auto-retry-limit \
--source "" \
--artifacts {} \
--environment "{\"type\": \"environment-type>\",\"image\": \"image-type>\",\"computeType\": \"compute-type>\"}" \
--service-role "service-role>"
```
Dans la commande précédente, remplacez les espaces réservés suivants :
+ **: Définissez la limite de tentatives automatiques au nombre maximum de tentatives automatiques souhaité après l'échec d'une compilation.
+ **,**,**,*environment-type>*, *image-type>**compute-type>*, et *service-role>* : définissez les paramètres de configuration de projet souhaités.
## Réessayer automatiquement un build ()AWS SDKs
```
Dans la commande précédente, remplacez l'espace réservé suivant :
+ **: chaîne obligatoire. Identifiant du lot à arrêter. Pour obtenir la liste des identifiants de génération par lots, consultez les rubriques suivantes :
+ [Afficher la liste des build IDs (AWS CLI) par lots](view-build-list.md#view-batch-build-list-cli)
+ [Afficher la liste des compilations par lots IDs pour un projet de construction (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
## Arrêter une construction par lots (AWS SDKs)