Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md). 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. # GitHub Action « Actions » YAML Voici la définition YAML de l'action **GitHubActions**. Cette définition d'action existe sous la forme d'une section au sein d'un fichier de définition de flux de travail plus large. Pour plus d’informations sur ce fichier, consultez [Définition du flux de travail YAML](workflow-reference.md). Choisissez une propriété YAML dans le code suivant pour en voir la description. **Note** La plupart des propriétés YAML suivantes ont des éléments d'interface utilisateur correspondants dans l'éditeur visuel. Pour rechercher un élément de l'interface utilisateur, utilisez **Ctrl\$1F**. L'élément sera répertorié avec sa propriété YAML associée. ``` # The workflow definition starts here. # See Propriétés de haut niveau for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. action-name: Identifier: aws/github-actions-runner@v1 DependsOn: - dependent-action-name-1 Compute: Fleet: fleet-name Timeout: timeout-minutes Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Inputs: Sources: - source-name-1 - source-name-2 Artifacts: - artifact-name Variables: - Name: variable-name-1 Value: variable-value-1 - Name: variable-name-2 Value: variable-value-2 Outputs: Artifacts: - Name: output-artifact-1 Files: - github-output/artifact-1.jar - "github-output/build*" - Name: output-artifact-2 Files: - github-output/artifact-2.1.jar - github-output/artifact-2.2.jar Variables: - variable-name-1 - variable-name-2 AutoDiscoverReports: Enabled: true | false ReportNamePrefix: AutoDiscovered IncludePaths: - "**/*" ExcludePaths: - node_modules/cdk/junit.xml SuccessCriteria: PassRate: percent LineCoverage: percent BranchCoverage: percent Vulnerabilities: Severity: CRITICAL|HIGH|MEDIUM|LOW|INFORMATIONAL Number: whole-number Reports: report-name-1: Format: format IncludePaths: - "*.xml" ExcludePaths: - report2.xml - report3.xml SuccessCriteria: PassRate: percent LineCoverage: percent BranchCoverage: percent Vulnerabilities: Severity: CRITICAL|HIGH|MEDIUM|LOW|INFORMATIONAL Number: whole-number Configuration Steps: - github-actions-code ``` ## nom-action (Obligatoire) Spécifiez le nom de l'action. Tous les noms d'action doivent être uniques dans le flux de travail. Les noms d'action sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms d'action. Interface utilisateur correspondante : onglet Configuration/ *action-name* ## Identifier (*action-name*/**Identifier**) Identifie l'action. Ne modifiez pas cette propriété, sauf si vous souhaitez modifier la version. Pour de plus amples informations, veuillez consulter [Spécification de la version de l'action à utiliser](workflows-action-versions.md). À utiliser `aws/github-actions-runner@v1` pour **GitHubles actions** Actions. Interface utilisateur correspondante : diagramme de flux de travail/*action-name*/**aws/ @v1 label github-actions-runner** ## DependsOn (*action-name*/**DependsOn**) (Facultatif) Spécifiez une action, un groupe d'actions ou une porte qui doit s'exécuter correctement pour que cette action soit exécutée. Pour plus d'informations sur la fonctionnalité « dépend », consultez. [Actions de séquençage](workflows-depends-on.md) Interface utilisateur correspondante : onglet **Entrées/dépend de - facultatif** ## Compute (*action-name*/**Compute**) (Facultatif) Le moteur informatique utilisé pour exécuter les actions de votre flux de travail. Vous pouvez spécifier le calcul au niveau du flux de travail ou au niveau de l'action, mais pas les deux. Lorsqu'elle est spécifiée au niveau du flux de travail, la configuration de calcul s'applique à toutes les actions définies dans le flux de travail. Au niveau du flux de travail, vous pouvez également exécuter plusieurs actions sur la même instance. Pour de plus amples informations, veuillez consulter [Partage du calcul entre les actions](compute-sharing.md). Interface utilisateur correspondante : *aucune* ## Fleet (*action-name*/Compute/**Fleet**) (Facultatif) Spécifiez la machine ou le parc qui exécutera votre flux de travail ou vos actions de flux de travail. Dans le cas des flottes à la demande, lorsqu'une action démarre, le flux de travail fournit les ressources dont il a besoin et les machines sont détruites à la fin de l'action. Exemples de flottes à la demande :`Linux.x86-64.Large`,`Linux.x86-64.XLarge`. Pour plus d'informations sur les flottes à la demande, consultez[Propriétés de la flotte à la demande](workflows-working-compute.md#compute.on-demand). Avec les flottes provisionnées, vous configurez un ensemble de machines dédiées pour exécuter les actions de votre flux de travail. Ces machines restent inactives, prêtes à exécuter des actions immédiatement. Pour plus d'informations sur les flottes provisionnées, consultez. [Propriétés de la flotte de véhicules provisionnée](workflows-working-compute.md#compute.provisioned-fleets) S'il `Fleet` est omis, la valeur par défaut est`Linux.x86-64.Large`. Interface utilisateur correspondante : onglet **Configuration/parc de calcul - facultatif** ## Timeout (*action-name*/**Timeout**) (Facultatif) Spécifiez la durée en minutes (éditeur YAML) ou en heures et minutes (éditeur visuel) pendant laquelle l'action peut être exécutée avant la CodeCatalyst fin de l'action. Le minimum est de 5 minutes et le maximum est décrit dans[Quotas pour les flux de travail dans CodeCatalyst](workflows-quotas.md). Le délai d'expiration par défaut est le même que le délai d'expiration maximal. Interface utilisateur correspondante : onglet **Configuration/Délai d'expiration - facultatif** ## Environment (*action-name*/**Environment**) (Facultatif) Spécifiez l' CodeCatalyst environnement à utiliser avec l'action. L'action se connecte au Compte AWS VPC Amazon facultatif spécifié dans l'environnement choisi. L'action utilise le rôle IAM par défaut spécifié dans l'environnement pour se connecter au Compte AWS, et utilise le rôle IAM spécifié dans la [connexion Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) pour se connecter à Amazon VPC. **Note** Si le rôle IAM par défaut ne dispose pas des autorisations requises par l'action, vous pouvez configurer l'action pour utiliser un autre rôle. Pour de plus amples informations, veuillez consulter [Modifier le rôle IAM d'une action](deploy-environments-switch-role.md). Pour plus d'informations sur les environnements, reportez-vous [Déploiement dans Comptes AWS et VPCs](deploy-environments.md) aux sections et[Création d'un environnement](deploy-environments-creating-environment.md). **Interface utilisateur correspondante : onglet Configuration/Environnement** ## Name (*action-name*/Environment/**Name**) (Obligatoire s'[Environment](#github.environment)il est inclus) Spécifiez le nom de l'environnement existant que vous souhaitez associer à l'action. **Interface utilisateur correspondante : onglet Configuration/Environnement** ## Connections (*action-name*/Environment/**Connections**) (Facultatif) Spécifiez la connexion au compte à associer à l'action. Vous pouvez spécifier un maximum d'une connexion à un compte sous`Environment`. Si vous ne spécifiez pas de connexion au compte : + L'action utilise la Compte AWS connexion et le rôle IAM par défaut spécifiés dans l'environnement de la CodeCatalyst console. Pour plus d'informations sur l'ajout d'une connexion à un compte et d'un rôle IAM par défaut dans l'environnement, consultez[Création d'un environnement](deploy-environments-creating-environment.md). + Le rôle IAM par défaut doit inclure les politiques et les autorisations requises par l'action. Pour déterminer quelles sont ces politiques et autorisations, consultez la description de la propriété **Role** dans la documentation de définition YAML de l'action. Pour plus d'informations sur les connexions aux comptes, consultez[Permettre l'accès aux AWS ressources avec Connected Comptes AWS](ipa-connect-account.md). Pour plus d'informations sur l'ajout d'une connexion de compte à un environnement, consultez[Création d'un environnement](deploy-environments-creating-environment.md). Interface utilisateur correspondante : la configuration tab/Environment/What est prête *my-environment* ? **/menu à trois points/ Changer de rôle** ## Name (*action-name*/Environment/Connections/**Name**) (Obligatoire s'[Connections](#github.environment.connections)il est inclus) Spécifiez le nom de la connexion au compte. Interface utilisateur correspondante : la configuration tab/Environment/What est prête *my-environment* ? **/menu à trois points/ Changer de rôle** ## Role (*action-name*/Environment/Connections/**Role**) (Obligatoire s'[Connections](#github.environment.connections)il est inclus) Spécifiez le nom du rôle IAM que cette action utilise pour accéder et opérer dans des AWS services tels qu'Amazon S3 et Amazon ECR. Assurez-vous que ce rôle est ajouté à votre Compte AWS connexion dans votre espace. Pour ajouter un rôle IAM à une connexion à un compte, consultez[Ajout de rôles IAM à des connexions de compte](ipa-connect-account-addroles.md). Si vous ne spécifiez aucun rôle IAM, l'action utilise le rôle IAM par défaut répertorié dans l'[environnement](deploy-environments.md) de la console. CodeCatalyst Si vous utilisez le rôle par défaut dans l'environnement, assurez-vous qu'il est conforme aux politiques suivantes. **Note** Vous pouvez utiliser le `CodeCatalystWorkflowDevelopmentRole-spaceName` rôle avec cette action. Pour plus d’informations sur ce rôle, consultez [Création du **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle pour votre compte et votre espace](ipa-iam-roles.md#ipa-iam-roles-service-create). Sachez que le `CodeCatalystWorkflowDevelopmentRole-spaceName` rôle dispose d'autorisations d'accès complètes, ce qui peut présenter un risque de sécurité. Nous vous recommandons de n'utiliser ce rôle que dans les didacticiels et les scénarios où la sécurité est moins préoccupante. **Avertissement** Limitez les autorisations à celles requises par l'**GitHub action** Action. L'utilisation d'un rôle doté d'autorisations plus étendues peut présenter un risque de sécurité. Interface utilisateur correspondante : la configuration tab/Environment/What est prête *my-environment* ? **/menu à trois points/ Changer de rôle** ## Inputs (*action-name*/**Inputs**) (Facultatif) La `Inputs` section définit les données dont une action a besoin lors de l'exécution d'un flux de travail. **Note** Un maximum de quatre entrées (une source et trois artefacts) sont autorisées par action **GitHub Actions**. Les variables ne sont pas prises en compte dans ce total. Si vous devez faire référence à des fichiers résidant dans différentes entrées (par exemple, une source et un artefact), l'entrée source est l'entrée principale et l'artefact est l'entrée secondaire. Les références aux fichiers dans les entrées secondaires utilisent un préfixe spécial pour les distinguer du fichier principal. Pour en savoir plus, consultez [Exemple : Référencement de fichiers dans plusieurs artefacts](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file). Interface utilisateur correspondante : onglet **Entrées** ## Sources (*action-name*/Inputs/**Sources**) (Facultatif) Spécifiez les étiquettes qui représentent les référentiels sources qui seront nécessaires à l'action. Actuellement, la seule étiquette prise en charge est`WorkflowSource`, qui représente le référentiel source dans lequel votre fichier de définition de flux de travail est stocké. Si vous omettez une source, vous devez spécifier au moins un artefact d'entrée sous. `action-name/Inputs/Artifacts` Pour plus d'informations sur les sources, consultez [Connecter les référentiels sources aux flux de travail](workflows-sources.md). Interface utilisateur correspondante : onglet **Entrées/Sources - facultatif** ## Artifacts - input (*action-name*/Inputs/**Artifacts**) (Facultatif) Spécifiez les artefacts des actions précédentes que vous souhaitez fournir en entrée pour cette action. Ces artefacts doivent déjà être définis en tant qu'artefacts de sortie dans les actions précédentes. Si vous ne spécifiez aucun artefact d'entrée, vous devez spécifier au moins un référentiel source sous`action-name/Inputs/Sources`. Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md). **Note** Si la liste déroulante **Artéfacts - optionnelle** n'est pas disponible (éditeur visuel), ou si vous recevez des erreurs lors de la validation de votre YAML (éditeur YAML), c'est peut-être parce que l'action ne prend en charge qu'une seule entrée. Dans ce cas, essayez de supprimer l'entrée source. Interface utilisateur correspondante : onglet **Entrées/Artefacts - facultatif** ## Variables - input (*action-name*/Inputs/**Variables**) (Facultatif) Spécifiez une séquence de name/value paires qui définit les variables d'entrée que vous souhaitez mettre à la disposition de l'action. Les noms de variables sont limités aux caractères alphanumériques (a-z, A-Z, 0-9), aux tirets (-) et aux traits de soulignement (\$1). Les espaces ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les caractères spéciaux et les espaces dans les noms de variables. Pour plus d'informations sur les variables, y compris des exemples, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). Interface utilisateur correspondante : onglet **Entrées/Variables - facultatif** ## Outputs (*action-name*/**Outputs**) (Facultatif) Définit les données produites par l'action lors de l'exécution d'un flux de travail. Interface utilisateur correspondante : onglet **Sorties** ## Artifacts - output (*action-name*/Outputs/**Artifacts**) (Facultatif) Spécifiez le nom d'un artefact généré par l'action. Les noms d'artifact doivent être uniques dans un flux de travail et sont limités aux caractères alphanumériques (a-z, A-Z, 0-9) et aux traits de soulignement (\$1). Les espaces, les tirets (-) et les autres caractères spéciaux ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les espaces, les tirets et autres caractères spéciaux dans les noms d'artefacts en sortie. Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md). **Interface utilisateur correspondante : onglet Sorties/Artefacts** ## Name (*action-name*/Outputs/Artifacts/**Name**) (Obligatoire s'[Artifacts - output](#github.outputs.artifacts)il est inclus) Spécifiez le nom d'un artefact généré par l'action. Les noms d'artifact doivent être uniques dans un flux de travail et sont limités aux caractères alphanumériques (a-z, A-Z, 0-9) et aux traits de soulignement (\$1). Les espaces, les tirets (-) et les autres caractères spéciaux ne sont pas autorisés. Vous ne pouvez pas utiliser de guillemets pour activer les espaces, les tirets et autres caractères spéciaux dans les noms d'artefacts en sortie. Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md). **Interface utilisateur correspondante : affiche le nom de l'tab/Artifacts/Addartefact/de l'artefact de construction** ## Files (*action-name*/Outputs/Artifacts/**Files**) (Obligatoire s'[Artifacts - output](#github.outputs.artifacts)il est inclus) Spécifiez les fichiers CodeCatalyst inclus dans l'artefact généré par l'action. Ces fichiers sont générés par l'action du flux de travail lorsqu'elle s'exécute et sont également disponibles dans votre référentiel source. Les chemins de fichiers peuvent résider dans un référentiel source ou dans un artefact issu d'une action précédente, et sont relatifs au référentiel source ou à la racine de l'artefact. Vous pouvez utiliser des modèles globulaires pour définir des chemins. Exemples : + Pour spécifier un seul fichier situé à la racine de l'emplacement de votre build ou de votre référentiel source, utilisez`my-file.jar`. + Pour spécifier un seul fichier dans un sous-répertoire, utilisez `directory/my-file.jar` ou`directory/subdirectory/my-file.jar`. + Pour spécifier tous les fichiers, utilisez`"**/*"`. Le modèle `**` glob indique qu'il doit correspondre à un nombre quelconque de sous-répertoires. + Pour spécifier tous les fichiers et répertoires d'un répertoire nommé`directory`, utilisez`"directory/**/*"`. Le modèle `**` glob indique qu'il doit correspondre à un nombre quelconque de sous-répertoires. + Pour spécifier tous les fichiers d'un répertoire nommé`directory`, mais aucun de ses sous-répertoires, utilisez`"directory/*"`. **Note** Si le chemin de votre fichier comporte un ou plusieurs astérisques (`*`) ou autres caractères spéciaux, mettez-le entre guillemets (). `""` Pour plus d'informations sur les caractères spéciaux, consultez[Consignes et conventions de syntaxe](workflow-reference.md#workflow.terms.syntax.conv). Pour plus d'informations sur les artefacts, y compris des exemples, consultez[Partage d'artefacts et de fichiers entre les actions](workflows-working-artifacts.md). **Note** Vous devrez peut-être ajouter un préfixe au chemin du fichier pour indiquer dans quel artefact ou dans quelle source le trouver. Pour plus d’informations, consultez [Référencement des fichiers du référentiel source](workflows-sources-reference-files.md) et [Référencement de fichiers dans un artefact](workflows-working-artifacts-refer-files.md). Interface utilisateur correspondante : produit des tab/Artifacts/Add **artéfacts/fichiers** produits par build ## Variables - output (*action-name*/Outputs/**Variables**) (Facultatif) Spécifiez les variables que vous souhaitez que l'action exporte afin qu'elles puissent être utilisées par les actions suivantes. Pour plus d'informations sur les variables, y compris des exemples, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Interface utilisateur correspondante : onglet Sorties/Variables/Ajouter une variable** ## nom-variable-1 (*action-name*/Outputs/Variables**nom-variable 1**) (Facultatif) Spécifiez le nom de la variable que vous souhaitez que l'action exporte. Cette variable doit déjà être définie dans la `Steps` section `Inputs` ou de la même action. Pour plus d'informations sur les variables, y compris des exemples, consultez[Utilisation de variables dans les flux de travail](workflows-working-with-variables.md). **Interface utilisateur correspondante : tab/Variables/Add variable/nom de sortie** ## AutoDiscoverReports (*action-name*/Outputs/**AutoDiscoverReports**) (Facultatif) Définit la configuration de la fonctionnalité de découverte automatique. Lorsque vous activez la découverte automatique, les CodeCatalyst recherches `Inputs` sont toutes transmises à l'action ainsi que tous les fichiers générés par l'action elle-même, à la recherche de rapports de test, de couverture de code et d'analyse de la composition logicielle (SCA). Pour chaque rapport trouvé, le CodeCatalyst transforme en CodeCatalyst rapport. Un *CodeCatalyst rapport* est un rapport entièrement intégré au CodeCatalyst service et qui peut être consulté et manipulé via la CodeCatalyst console. **Note** Par défaut, la fonction de découverte automatique inspecte tous les fichiers. Vous pouvez limiter les fichiers inspectés à l'aide des [ExcludePaths](#github.reports.excludepaths) propriétés [IncludePaths](#github.reports.includepaths) or. Interface utilisateur correspondante : *aucune* ## Enabled (*action-name*/Outputs/AutoDiscoverReports/**Enabled**) (Facultatif) Activez ou désactivez la fonction de découverte automatique. Les valeurs valides sont `true` ou `false`. S'il `Enabled` est omis, la valeur par défaut est`true`. **Interface utilisateur correspondante : onglet Sorties/Rapports/Découverte automatique des rapports** ## ReportNamePrefix (*action-name*/Outputs/AutoDiscoverReports/**ReportNamePrefix**) (Obligatoire s'[AutoDiscoverReports](#github.outputs.autodiscover)il est inclus et activé) Spécifiez un préfixe qui CodeCatalyst précède tous les rapports trouvés afin de nommer les rapports associés. CodeCatalyst Par exemple, si vous spécifiez le préfixe de`AutoDiscovered`, et que vous CodeCatalyst découvrez automatiquement deux rapports de test`TestSuiteTwo.xml`, `TestSuiteOne.xml` et, les CodeCatalyst rapports associés seront nommés `AutoDiscoveredTestSuiteOne` et. `AutoDiscoveredTestSuiteTwo` Interface utilisateur correspondante : les sorties tab/Reports/Automatically découvrent les rapports/le préfixe **du rapport** ## IncludePaths (*action-name*/Outputs/AutoDiscoverReports/**IncludePaths**) Or (*action-name*/Outputs/Reports/*report-name-1*/**IncludePaths**) (Obligatoire s'[AutoDiscoverReports](#github.outputs.autodiscover)il est inclus et activé, ou s'il [Reports](#github.configuration.reports) est inclus) Spécifiez les fichiers et les chemins de fichiers CodeCatalyst inclus lors de la recherche de rapports bruts. Par exemple, si vous le spécifiez`"/test/report/*"`, CodeCatalyst recherche l'intégralité de [l'image de construction](build-images.md) utilisée par l'action à la recherche du `/test/report/*` répertoire. Lorsqu'il trouve ce répertoire, CodeCatalyst il recherche des rapports dans ce répertoire. **Note** Si le chemin de votre fichier comporte un ou plusieurs astérisques (`*`) ou autres caractères spéciaux, mettez-le entre guillemets (). `""` Pour plus d'informations sur les caractères spéciaux, consultez[Consignes et conventions de syntaxe](workflow-reference.md#workflow.terms.syntax.conv). Si cette propriété est omise, la valeur par défaut est`"**/*"`, ce qui signifie que la recherche inclut tous les fichiers, quel que soit leur chemin. **Note** Pour les rapports configurés manuellement, `IncludePaths` il doit s'agir d'un modèle global correspondant à un seul fichier. Interface utilisateur correspondante : + **Affiche les tab/Reports/Automatically discover reports/'Include/exclude chemins «/Inclure les chemins »** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /'Include/Exclure les chemins'/Inclure les chemins** ## ExcludePaths (*action-name*/Outputs/AutoDiscoverReports/**ExcludePaths**) Or (*action-name*/Outputs/Reports/*report-name-1*/**ExcludePaths**) (Facultatif) Spécifiez les fichiers et les chemins de fichiers à CodeCatalyst exclure lors de la recherche de rapports bruts. Par exemple, si vous le spécifiez`"/test/my-reports/**/*"`, ne CodeCatalyst recherchera pas de fichiers dans le `/test/my-reports/` répertoire. Pour ignorer tous les fichiers d'un répertoire, utilisez le modèle `**/*` glob. **Note** Si le chemin de votre fichier comporte un ou plusieurs astérisques (`*`) ou autres caractères spéciaux, mettez-le entre guillemets (). `""` Pour plus d'informations sur les caractères spéciaux, consultez[Consignes et conventions de syntaxe](workflow-reference.md#workflow.terms.syntax.conv). Interface utilisateur correspondante : + **Affiche les tab/Reports/Automatically discover reports/'Include/exclude chemins «/Exclure les chemins »** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /'Include/Exclure les chemins'/Exclure les chemins** ## SuccessCriteria (*action-name*/Outputs/AutoDiscoverReports/**SuccessCriteria**) Or (*action-name*/Outputs/Reports/*report-name-1*/**SuccessCriteria**) (Facultatif) Spécifiez les critères de réussite pour les rapports de test, de couverture du code, d'analyse de la composition logicielle (SCA) et d'analyse statique (SA). Pour de plus amples informations, veuillez consulter [Configuration des critères de réussite pour les rapports](test-config-action.md#test.success-criteria). Interface utilisateur correspondante : + Résultats, tab/Reports/Automatically découverte des rapports/critères de **réussite** + Les sorties tab/Reports/Manually configurent les rapports/*report-name-1*/Critères de **réussite** ## PassRate (*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**PassRate**) Or (*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**PassRate**) (Facultatif) Spécifiez le pourcentage de tests dans un rapport de test qui doivent être réussis pour que le CodeCatalyst rapport associé soit marqué comme réussi. Les valeurs valides incluent les nombres décimaux. Par exemple   `50`, `60.5`. Les critères relatifs au taux de réussite ne sont appliqués qu'aux rapports de test. Pour plus d'informations sur les rapports de test, consultez[Rapports d'essais](test-workflow-actions.md#test-reports). Interface utilisateur correspondante : + tab/Reports/Automatically discover reports/Success**Critères de sorties/taux de réussite** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /Critères de succès/ Taux de réussite** ## LineCoverage (*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**LineCoverage**) Or (*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**LineCoverage**) (Facultatif) Spécifiez le pourcentage de lignes d'un rapport de couverture de code qui doivent être couvertes pour que le CodeCatalyst rapport associé soit marqué comme transmis. Les valeurs valides incluent les nombres décimaux. Par exemple   `50`, `60.5`. Les critères de couverture de ligne sont appliqués uniquement aux rapports de couverture de code. Pour plus d'informations sur les rapports de couverture du code, consultez[Rapports de couverture du code](test-workflow-actions.md#test-code-coverage-reports). Interface utilisateur correspondante : + tab/Reports/Automatically discover reports/Success**Critères de sorties/couverture de ligne** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /Critères de succès/ Couverture des lignes** ## BranchCoverage (*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**BranchCoverage**) Or (*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**BranchCoverage**) (Facultatif) Spécifiez le pourcentage de branches dans un rapport de couverture de code qui doivent être couvertes pour que le CodeCatalyst rapport associé soit marqué comme transmis. Les valeurs valides incluent les nombres décimaux. Par exemple   `50`, `60.5`. Les critères de couverture des succursales sont appliqués uniquement aux rapports de couverture par code. Pour plus d'informations sur les rapports de couverture du code, consultez[Rapports de couverture du code](test-workflow-actions.md#test-code-coverage-reports). Interface utilisateur correspondante : + tab/Reports/Automatically discover reports/Success**Critères de sorties/couverture des branches** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /Critères de succès/ Couverture des branches** ## Vulnerabilities (*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**Vulnerabilities**) Or (*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**Vulnerabilities**) (Facultatif) Spécifiez le nombre maximum et la gravité des vulnérabilités autorisées dans le rapport SCA pour que le CodeCatalyst rapport associé soit marqué comme transmis. Pour définir les vulnérabilités, vous devez spécifier : + La gravité minimale des vulnérabilités que vous souhaitez inclure dans le décompte. Les valeurs valides, de la plus sévère à la moins sévère, sont les suivantes : `CRITICAL``HIGH`,`MEDIUM`,`LOW`,,`INFORMATIONAL`. Par exemple, si vous le souhaitez`HIGH`, `HIGH` les `CRITICAL` vulnérabilités seront comptabilisées. + Le nombre maximum de vulnérabilités de la gravité spécifiée que vous souhaitez autoriser. Le dépassement de ce nombre entraîne le marquage CodeCatalyst du rapport comme ayant échoué. Les valeurs valides sont des nombres entiers. Les critères de vulnérabilité ne sont appliqués qu'aux rapports SCA. Pour plus d'informations sur les rapports SCA, consultez[Rapports d'analyse de la composition des logiciels](test-workflow-actions.md#test-sca-reports). Pour spécifier la sévérité minimale, utilisez la `Severity` propriété. Pour spécifier le nombre maximum de vulnérabilités, utilisez la `Number` propriété. Pour plus d'informations sur les rapports SCA, consultez[Types de rapports sur la qualité](test-workflow-actions.md#test-reporting). Interface utilisateur correspondante : + tab/Reports/Automatically discover reports/Success**Critères de sorties/vulnérabilités** + **Les sorties tab/Reports/Manually configurent les rapports/ *report-name-1* /Critères de succès/ Vulnérabilités** ## Reports (*action-name*/Outputs/**Reports** ) (Facultatif) Section qui spécifie la configuration des rapports de test. **Interface utilisateur correspondante : onglet Sorties/Rapports** ## nom-du-rapport-1 (*action-name*/Outputs/Reports/**nom-de-rapport-1**) (Obligatoire s'[Reports](#github.configuration.reports)il est inclus) Le nom que vous souhaitez donner au CodeCatalyst rapport qui sera généré à partir de vos rapports bruts. Interface utilisateur correspondante : les sorties tab/Reports/Manually configurent les rapports/nom **du rapport** ## Format (*action-name*/Outputs/Reports/*report-name-1*/**Format**) (Obligatoire s'[Reports](#github.configuration.reports)il est inclus) Spécifiez le format de fichier que vous utilisez pour vos rapports. Les valeurs possibles sont les suivantes. + Pour les rapports de test : + Pour Cucumber JSON, spécifiez **Cucumber** (éditeur visuel) ou `CUCUMBERJSON` (éditeur YAML). + Pour le JUnit XML, spécifiez **JUnit**(éditeur visuel) ou `JUNITXML` (éditeur YAML). + Pour le NUnit XML, spécifiez **NUnit**(éditeur visuel) ou `NUNITXML` (éditeur YAML). + Pour NUnit 3 XML, spécifiez **NUnit3**(éditeur visuel) ou `NUNIT3XML` (éditeur YAML). + Pour Visual Studio TRX, spécifiez **Visual Studio TRX** (éditeur visuel) ou `VISUALSTUDIOTRX` (éditeur YAML). + Pour TestNG XML, spécifiez **TestNG** (éditeur visuel) ou `TESTNGXML` (éditeur YAML). + Pour les rapports sur la couverture du code : + Pour Clover XML, spécifiez **Clover** (éditeur visuel) ou `CLOVERXML` (éditeur YAML). + Pour Cobertura XML, spécifiez **Cobertura** (éditeur visuel) ou `COBERTURAXML` (éditeur YAML). + Pour le JaCoCo XML, spécifiez **JaCoCo**(éditeur visuel) ou `JACOCOXML` (éditeur YAML). + Pour le SimpleCov JSON généré par [simplecov](https://github.com/simplecov-ruby/simplecov), et non par [simplecov-json](https://github.com/vicentllongo/simplecov-json), spécifiez **Simplecov (éditeur visuel) ou (éditeur YAML**). `SIMPLECOV` + Pour les rapports d'analyse de composition logicielle (SCA) : + Pour SARIF, spécifiez **SARIF** (éditeur visuel) ou `SARIFSCA` (éditeur YAML). Interface utilisateur correspondante : tab/Reports/Manually configure reports/Add Rapport de *report-name-1* sortie// **Type de rapport et format de** **rapport** ## Configuration (*action-name*/**Configuration**) (Obligatoire) Section dans laquelle vous pouvez définir les propriétés de configuration de l'action. Interface utilisateur correspondante : onglet **Configuration** ## Steps (*action-name*/Configuration/**Steps**) (Obligatoire) Spécifiez votre code GitHub d'action tel qu'il apparaît sur la page de détails de l'action dans [GitHub Marketplace](https://github.com/marketplace). Ajoutez le code en suivant les instructions suivantes : 1. Collez le code de la `steps:` section GitHub Action dans la `Steps:` section du CodeCatalyst flux de travail. Le code commence par un tiret (-) et ressemble à ce qui suit. GitHub code à coller : ``` - name: Lint Code Base uses: github/super-linter@v4 env: VALIDATE_ALL_CODEBASE: false DEFAULT_BRANCH: master GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} ``` 1. Passez en revue le code que vous venez de coller et modifiez-le si nécessaire afin qu'il soit conforme aux CodeCatalyst normes. Par exemple, avec le bloc de code précédent, vous pouvez supprimer le code en *red italics* gras et l'ajouter en **gras**. CodeCatalyst flux de travail yaml : ``` Steps: - name: Lint Code Base uses: github/super-linter@v4 env: VALIDATE_ALL_CODEBASE: false DEFAULT_BRANCH: mastermain GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} ``` 1. Pour le code supplémentaire inclus dans l' GitHub action mais qui n'existe pas dans la `steps:` section, ajoutez-le au CodeCatalyst flux de travail à l'aide d'un code CodeCatalyst équivalent. Vous pouvez les consulter [Définition du flux de travail YAML](workflow-reference.md) pour avoir un aperçu de la manière dont vous pourriez porter votre GitHub code CodeCatalyst. Les étapes de migration détaillées ne sont pas abordées dans ce guide. Voici un exemple de la manière de spécifier des chemins de fichiers dans une action **GitHub Actions** : ``` Steps: - name: Lint Code Base uses: github/super-linter@v4 ... - run: cd /sources/WorkflowSource/MyFolder/ && cat file.txt - run: cd /artifacts/MyGitHubAction/MyArtifact/MyFolder/ && cat file2.txt ``` Pour plus d'informations sur la spécification des chemins de fichiers, reportez-vous [Référencement des fichiers du référentiel source](workflows-sources-reference-files.md) aux sections et[Référencement de fichiers dans un artefact](workflows-working-artifacts-refer-files.md). Interface utilisateur correspondante : onglet **GitHub Configuration/Actions YAML**