YAML-Definition für Aktionen erstellen und testen - Amazon CodeCatalyst
AktionsnameIdentifierDependsOnComputeTypeFleetTimeoutEnvironmentNameConnectionsNameRoleCachingFileCachingSchlüsselname-1PathRestoreKeysInputsSourcesArtifacts - inputVariables - inputOutputsArtifacts - outputNameFilesVariables - outputVariablenname-1AutoDiscoverReportsEnabledReportNamePrefixIncludePathsExcludePathsSuccessCriteriaPassRateLineCoverageBranchCoverageVulnerabilitiesStaticAnalysisBugStaticAnalysisSecurityStaticAnalysisQualityStaticAnalysisFindingReportsBerichtsname-1FormatConfigurationContainerRegistryImageStepsPackagesNpmConfigurationPackageRegistriesPackagesRepositoryScopes

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

YAML-Definition für Aktionen erstellen und testen

Im Folgenden finden Sie die YAML-Definition der Build- und Testaktionen. Es gibt eine Referenz für zwei Aktionen, da sich ihre YAML-Eigenschaften sehr ähnlich sind.

Diese Aktionsdefinition ist als Abschnitt in einer umfassenderen Workflow-Definitionsdatei vorhanden. Weitere Informationen über diese Datei finden Sie unter YAML-Workflow-Definition.

Wählen Sie im folgenden Code eine YAML-Eigenschaft aus, um eine Beschreibung zu erhalten.

Anmerkung

Die meisten der folgenden YAML-Eigenschaften haben entsprechende Benutzeroberflächenelemente im visuellen Editor. Verwenden Sie Strg+F, um nach einem UI-Element zu suchen. Das Element wird mit der zugehörigen YAML-Eigenschaft aufgelistet.

# The workflow definition starts here.
# See Eigenschaften der obersten Ebene for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.
  action-name:
    Identifier: aws/build@v1 | aws/managed-test@v1
    DependsOn:
      - dependent-action-name-1
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Caching:  
      FileCaching:
        key-name-1:
          Path: file1.txt
          RestoreKeys:
            - restore-key-1
    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: 
            - build-output/artifact-1.jar
            - "build-output/build*"
        - Name: output-artifact-2
          Files:
            - build-output/artifact-2.1.jar
            - build-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
          StaticAnalysisBug:
            Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
            Number: whole-number
          StaticAnalysisSecurity:
            Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
            Number: whole-number
          StaticAnalysisQuality:
            Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
            Number: whole-number
          StaticAnalysisFinding:
            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
            StaticAnalysisBug:
                Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
                Number: whole-number
            StaticAnalysisSecurity:
                Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
                Number: whole-number
            StaticAnalysisQuality:
                Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
                Number: whole-number
            StaticAnalysisFinding:
                Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
                Number: whole-number
    Configuration:
      Container:
        Registry: registry
        Image: image
      Steps:
        - Run: "step 1"
        - Run: "step 2"
      Packages:
        NpmConfiguration:
          PackageRegistries:
            - PackagesRepository: package-repository
              Scopes:
                - "@scope"

Aktionsname

(Erforderlich)

Geben Sie den Namen der Aktion an. Alle Aktionsnamen müssen innerhalb des Workflows eindeutig sein. Aktionsnamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (_) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Aktionsnamen zuzulassen.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Aktionsname“

Identifier

(Aktionsname/) Identifier

Identifiziert die Aktion. Ändern Sie diese Eigenschaft nicht, es sei denn, Sie möchten die Version ändern. Weitere Informationen finden Sie unter Angabe der Haupt-, Neben- oder Patch-Version einer Aktion.

Wird aws/build@v1 für Build-Aktionen verwendet.

aws/managed-test@v1Für Testaktionen verwenden.

Entsprechende Benutzeroberfläche: Workflow-Diagramm/Aktionsname/aws/build @v1 |aws/managed-test @v1 label

DependsOn

(Aktionsname/) DependsOn

(Optional)

Geben Sie eine Aktion, eine Aktionsgruppe oder ein Gate an, die erfolgreich ausgeführt werden müssen, damit diese Aktion ausgeführt werden kann.

Weitere Hinweise zur Funktion „Hängt davon ab“ finden Sie unter. Aktionen so konfigurieren, dass sie von anderen Aktionen abhängen

Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„Hängt davon ab“ — optional

Compute

(Aktionsname/) Compute

(Optional)

Die Rechen-Engine, mit der Ihre Workflow-Aktionen ausgeführt wurden. Sie können die Berechnung entweder auf Workflow-Ebene oder auf Aktionsebene angeben, jedoch nicht auf beiden Ebenen. Wenn auf Workflow-Ebene angegeben, gilt die Rechenkonfiguration für alle im Workflow definierten Aktionen. Auf Workflow-Ebene können Sie auch mehrere Aktionen auf derselben Instanz ausführen. Weitere Informationen finden Sie unter Rechenleistung für mehrere Aktionen gemeinsam nutzen.

Entsprechende Benutzeroberfläche: keine

Type

(Typ des Aktionsnamens/Compute/)

(Erforderlich, wenn es enthalten Compute ist)

Der Typ der Compute Engine. Sie können einen der folgenden Werte verwenden:

  • EC2 (visueller Editor) oder EC2 (YAML-Editor)

    Optimiert für Flexibilität bei Aktionsläufen.

  • Lambda (visueller Editor) oder Lambda (YAML-Editor)

    Optimierte Startgeschwindigkeiten für Aktionen.

Weitere Informationen zu Datentypen finden Sie unter Berechnungstypen.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Berechnungstyp“

Fleet

(/Compute/FleetAktionsname)

(Optional)

Geben Sie die Maschine oder Flotte an, auf der Ihr Workflow oder Ihre Workflow-Aktionen ausgeführt werden sollen. Bei bedarfsgesteuerten Flotten stellt der Workflow zu Beginn einer Aktion die benötigten Ressourcen bereit, und die Maschinen werden zerstört, wenn die Aktion abgeschlossen ist. Beispiele für Flotten auf Abruf:Linux.x86-64.Large,. Linux.x86-64.XLarge Weitere Informationen zu Flotten auf Abruf finden Sie unter. Flotteneigenschaften auf Abruf

Bei bereitgestellten Flotten konfigurieren Sie eine Reihe von dedizierten Maschinen, um Ihre Workflow-Aktionen auszuführen. Diese Maschinen bleiben inaktiv und sind bereit, Aktionen sofort zu verarbeiten. Weitere Informationen zu bereitgestellten Flotten finden Sie unter. Bereitgestellte Flotteneigenschaften

Wenn Fleet es weggelassen wird, ist die Standardeinstellung. Linux.x86-64.Large

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Flotte berechnen“

Timeout

(Aktionsname/) Timeout

(Optional)

Geben Sie an, wie lange die Aktion in Minuten (YAML-Editor) oder Stunden und Minuten (Visual Editor) ausgeführt werden kann, bevor die Aktion CodeCatalyst beendet wird. Das Minimum beträgt 5 Minuten und das Maximum ist unter beschriebenKontingente für Workflows. Das Standard-Timeout entspricht dem maximalen Timeout.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Timeout“ — optional

Environment

(Aktionsname/) Environment

(Optional)

Geben Sie die CodeCatalyst Umgebung an, die für die Aktion verwendet werden soll.

Weitere Informationen zu Umgebungen finden Sie unter Bereitstellung in AWS-Konten und VPCs mit Umgebungen CodeCatalyst undErstellen einer Umgebung.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Umgebung“

Name

(/Environment/NameAktionsname)

(Optional)

Geben Sie den Namen einer vorhandenen Umgebung an, die Sie der Aktion zuordnen möchten.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/Name der Umgebung

Connections

(/Environment/ConnectionsAktionsname)

(Optional)

Geben Sie die Kontoverbindung an, die der Aktion zugeordnet werden soll. Sie können unter maximal eine Kontoverbindung angebenEnvironment.

Weitere Informationen zu Kontoverbindungen finden Sie unterErmöglichen des Zugriffs auf AWS Ressourcen mit verbundenen AWS-Konten. Informationen darüber, wie Sie eine Kontoverbindung mit Ihrer Umgebung verknüpfen, finden Sie unterErstellen einer Umgebung.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/

Name

(/Environment/Connections/NameAktionsname)

(Optional)

Geben Sie den Namen der Kontoverbindung an.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/

Role

(/Environment/Connections/RoleAktionsname)

(Optional)

Geben Sie den Namen der IAM-Rolle an, die diese Aktion verwendet, um auf AWS Dienste wie Amazon S3 und Amazon ECR zuzugreifen und diese zu nutzen. Stellen Sie sicher, dass diese Rolle zu Ihrer Kontoverbindung hinzugefügt wurde. Informationen zum Hinzufügen einer IAM-Rolle zu einer Kontoverbindung finden Sie unterHinzufügen von IAM-Rollen zu Kontoverbindungen.

Anmerkung

Möglicherweise können Sie hier den Namen der CodeCatalystWorkflowDevelopmentRole-spaceName Rolle angeben, sofern sie über ausreichende Berechtigungen verfügt. Weitere Informationen über diese Rolle finden Sie unter Die CodeCatalystWorkflowDevelopmentRole-spaceNameRolle für Ihr Konto und Ihren Bereich erstellen. Beachten Sie, dass die CodeCatalystWorkflowDevelopmentRole-spaceName Rolle über sehr umfangreiche Berechtigungen verfügt, was ein Sicherheitsrisiko darstellen kann. Wir empfehlen, diese Rolle nur in Tutorials und Szenarien zu verwenden, in denen die Sicherheit weniger wichtig ist.

Warnung

Beschränken Sie die Berechtigungen auf diejenigen, die für die Build- und Testaktionen erforderlich sind. Die Verwendung einer Rolle mit umfassenderen Berechtigungen kann ein Sicherheitsrisiko darstellen.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/

Caching

(Aktionsname/) Caching

(Optional)

Ein Abschnitt, in dem Sie einen Cache angeben können, um Dateien auf der Festplatte zu speichern und sie bei nachfolgenden Workflow-Ausführungen aus diesem Cache wiederherzustellen.

Weitere Informationen zum Zwischenspeichern von Dateien finden Sie unter. Zwischenspeichern von Dateien zwischen Workflow-Läufen

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/Datei-Caching — optional

FileCaching

(Aktionsname) /Caching/ FileCaching

(Optional)

Ein Abschnitt, der die Konfiguration für eine Sequenz von Caches spezifiziert.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Datei-Caching — optional/ Cache hinzufügen

Schlüsselname-1

(Aktionsname Schlüsselname-1) /Caching/FileCaching/

(Optional)

Geben Sie den Namen Ihrer primären Cache-Eigenschaft an. Die Namen der Cache-Eigenschaften müssen innerhalb Ihres Workflows eindeutig sein. Jede Aktion kann bis zu fünf Einträge enthaltenFileCaching.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Datei-Caching — optional/Cache hinzufügen/Schlüssel

Path

(/Caching/FileCaching/PathAktionsname Schlüsselname-1/)

(Optional)

Geben Sie den zugehörigen Pfad für Ihren Cache an.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Datei-Caching — optional/Cache hinzufügen/Pfad

RestoreKeys

(/Caching/FileCaching/RestoreKeysAktionsname Schlüsselname-1/)

(Optional)

Geben Sie den Wiederherstellungsschlüssel an, der als Fallback verwendet werden soll, wenn die primäre Cache-Eigenschaft nicht gefunden werden kann. Die Namen der Wiederherstellungsschlüssel müssen innerhalb Ihres Workflows eindeutig sein. Jeder Cache kann bis zu fünf Einträge enthaltenRestoreKeys.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Datei-Caching — optional/Cache hinzufügen/Schlüssel wiederherstellen — optional

Inputs

(Aktionsname/) Inputs

(Optional)

Der Inputs Abschnitt definiert die Daten, die eine Aktion während einer Workflow-Ausführung benötigt.

Anmerkung

Pro Build-Aktion oder Testaktion sind maximal vier Eingaben (eine Quelle und drei Artefakte) zulässig. Variablen werden auf diese Summe nicht angerechnet.

Wenn Sie auf Dateien verweisen müssen, die sich in unterschiedlichen Eingaben befinden (z. B. eine Quelle und ein Artefakt), ist die Quelleingabe die primäre Eingabe und das Artefakt die sekundäre Eingabe. Verweise auf Dateien in sekundären Eingaben benötigen ein spezielles Präfix, um sie von der primären Eingabe zu unterscheiden. Details hierzu finden Sie unter Beispiel: Referenzieren von Dateien in mehreren Artefakten.

Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“

Sources

(Aktionsname /Inputs/ Sources)

(Optional)

Geben Sie die Labels an, die die Quell-Repositorys repräsentieren, die für die Aktion benötigt werden. Derzeit wird nur die Bezeichnung, die das Quell-Repository darstelltWorkflowSource, in dem Ihre Workflow-Definitionsdatei gespeichert ist, unterstützt.

Wenn Sie eine Quelle weglassen, müssen Sie mindestens ein Eingabeartefakt unter angeben. action-name/Inputs/Artifacts

Weitere Informationen zu Quellen finden Sie unter Einen Workflow mit einem Quell-Repository verbinden.

Entsprechende Benutzeroberfläche: keine

Artifacts - input

(Aktionsname /Inputs/ Artifacts)

(Optional)

Geben Sie Artefakte aus früheren Aktionen an, die Sie als Eingabe für diese Aktion bereitstellen möchten. Diese Artefakte müssen bereits in früheren Aktionen als Ausgabeartefakte definiert sein.

Wenn Sie keine Eingabeartefakte angeben, müssen Sie mindestens ein Quell-Repository unter angebenaction-name/Inputs/Sources.

Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unterTeilen von Daten zwischen Aktionen in einem Workflow mithilfe von Artefakten.

Anmerkung

Wenn die Dropdownliste Artefakte — optional nicht verfügbar ist (visueller Editor) oder wenn Sie bei der Validierung Ihres YAML (YAML-Editors) Fehler erhalten, kann das daran liegen, dass die Aktion nur eine Eingabe unterstützt. Versuchen Sie in diesem Fall, die Quelleingabe zu entfernen.

Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„Artefakte“ — optional

Variables - input

(/Inputs/VariablesAktionsname)

(Optional)

Geben Sie eine Folge von Name/Wert-Paaren an, die die Eingabevariablen definieren, die Sie für die Aktion verfügbar machen möchten. Variablennamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (_) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Variablennamen zuzulassen.

Weitere Informationen zu Variablen, einschließlich Beispielen, finden Sie unterKonfiguration und Verwendung von Variablen in einem Workflow.

Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„Variablen“ — optional

Outputs

(Aktionsname/) Outputs

(Optional)

Definiert die Daten, die von der Aktion während einer Workflow-Ausführung ausgegeben werden.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgaben“

Artifacts - output

(Aktionsname /Outputs/ Artifacts)

(Optional)

Geben Sie den Namen eines Artefakts an, das durch die Aktion generiert wurde. Artefaktnamen müssen innerhalb eines Workflows eindeutig sein und sind auf alphanumerische Zeichen (a-z, A-Z, 0-9) und Unterstriche (_) beschränkt. Leerzeichen, Bindestriche (-) und andere Sonderzeichen sind nicht zulässig. Sie können keine Anführungszeichen verwenden, um Leerzeichen, Bindestriche und andere Sonderzeichen in Namen von Ausgabeartefakten zuzulassen.

Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter. Teilen von Daten zwischen Aktionen in einem Workflow mithilfe von Artefakten

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Artefakte

Name

(/Outputs/Artifacts/NameAktionsname)

(Erforderlich, wenn es enthalten Artifacts - output ist)

Geben Sie den Namen eines Artefakts an, das durch die Aktion generiert wurde. Artefaktnamen müssen innerhalb eines Workflows eindeutig sein und sind auf alphanumerische Zeichen (a-z, A-Z, 0-9) und Unterstriche (_) beschränkt. Leerzeichen, Bindestriche (-) und andere Sonderzeichen sind nicht zulässig. Sie können keine Anführungszeichen verwenden, um Leerzeichen, Bindestriche und andere Sonderzeichen in Namen von Ausgabeartefakten zuzulassen.

Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter. Teilen von Daten zwischen Aktionen in einem Workflow mithilfe von Artefakten

Entsprechende Benutzeroberfläche: Registerkarte „Ausgaben/Artefakte/Neue Ausgabe/Name des Artefakts erstellen“

Files

(Aktionsname) /Outputs/Artifacts/ Files

(Erforderlich, wenn es enthalten Artifacts - output ist)

Geben Sie die Dateien an, die in dem Artefakt CodeCatalyst enthalten sind, das von der Aktion ausgegeben wird. Diese Dateien werden durch die Workflow-Aktion generiert, wenn sie ausgeführt wird, und sind auch in Ihrem Quell-Repository verfügbar. Dateipfade können sich in einem Quell-Repository oder einem Artefakt aus einer früheren Aktion befinden und sind relativ zum Quell-Repository oder Artefakt-Stamm. Sie können Glob-Muster verwenden, um Pfade anzugeben. Beispiele:

  • Um eine einzelne Datei anzugeben, die sich im Stammverzeichnis Ihres Build-Speicherorts oder Quell-Repository-Speicherorts befindet, verwenden Siemy-file.jar.

  • Um eine einzelne Datei in einem Unterverzeichnis anzugeben, verwenden Sie directory/my-file.jar oderdirectory/subdirectory/my-file.jar.

  • Um alle Dateien anzugeben, verwenden Sie"**/*". Das ** Glob-Muster gibt an, dass es einer beliebigen Anzahl von Unterverzeichnissen entspricht.

  • Um alle Dateien und Verzeichnisse in einem Verzeichnis mit dem Namen anzugebendirectory, verwenden Sie. "directory/**/*" Das ** Glob-Muster gibt an, dass es einer beliebigen Anzahl von Unterverzeichnissen entspricht.

  • Um alle Dateien in einem Verzeichnis mit dem Namendirectory, aber nicht in einem seiner Unterverzeichnisse anzugeben, verwenden Sie. "directory/*"

Anmerkung

Wenn Ihr Dateipfad ein oder mehrere Sternchen (*) oder ein anderes Sonderzeichen enthält, schließen Sie den Pfad in doppelte Anführungszeichen () ein. "" Weitere Hinweise zu Sonderzeichen finden Sie unter. Richtlinien und Konventionen zur Syntax

Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unterTeilen von Daten zwischen Aktionen in einem Workflow mithilfe von Artefakten.

Anmerkung

Möglicherweise müssen Sie dem Dateipfad ein Präfix hinzufügen, um anzugeben, in welchem Artefakt oder in welcher Quelle das Objekt gefunden werden soll. Weitere Informationen finden Sie unter Referenzieren von Dateien in einem Quell-Repository und Referenzieren von Dateien in einem Artefakt.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Artefakte/Neue Ausgabe/ Von build erzeugte Dateien

Variables - output

(Aktionsname) /Outputs/ Variables

(Optional)

Geben Sie die Variablen an, die die Aktion exportieren soll, damit sie von nachfolgenden Aktionen verwendet werden können.

Weitere Informationen zu Variablen, einschließlich Beispielen, finden Sie unterKonfiguration und Verwendung von Variablen in einem Workflow.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Variablen/Variable hinzufügen

Variablenname-1

(Aktionsname Variablenname-1) /Outputs/Variables/

(Optional)

Geben Sie den Namen einer Variablen an, die von der Aktion exportiert werden soll. Diese Variable muss bereits im Steps Abschnitt Inputs oder derselben Aktion definiert sein.

Weitere Informationen zu Variablen, einschließlich Beispielen, finden Sie unterKonfiguration und Verwendung von Variablen in einem Workflow.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Variablen/Variable hinzufügen/Name

AutoDiscoverReports

(Aktionsname) /Outputs/ AutoDiscoverReports

(Optional)

Definiert die Konfiguration für die Auto-Discovery-Funktion.

Wenn Sie die automatische Erkennung aktivieren, werden alle Inputs an die Aktion übergebenen sowie alle von der Aktion selbst generierten Dateien CodeCatalyst durchsucht, wobei nach Test-, Codeabdeckungs- und SCA-Berichten (Software Composition Analysis) gesucht wird. Wandelt jeden gefundenen Bericht in einen CodeCatalyst Bericht um. CodeCatalyst Ein CodeCatalyst Bericht ist ein Bericht, der vollständig in den CodeCatalyst Service integriert ist und über die Konsole angezeigt und bearbeitet werden kann. CodeCatalyst

Anmerkung

Standardmäßig überprüft die automatische Erkennungsfunktion alle Dateien. Mithilfe der Eigenschaften IncludePaths oder ExcludePaths können Sie einschränken, welche Dateien überprüft werden.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgaben/Berichte“/„Automatische Erkennung von Berichten“

Enabled

(Aktionsname) /Outputs/AutoDiscoverReports/ Enabled

(Optional)

Aktivieren oder deaktivieren Sie die automatische Erkennungsfunktion.

Gültige Werte sind true oder false.

Wenn Enabled es weggelassen wird, ist true die Standardeinstellung.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgaben/Berichte“/„Automatische Erkennung von Berichten“

ReportNamePrefix

(Aktionsname) /Outputs/AutoDiscoverReports/ ReportNamePrefix

(Erforderlich, wenn AutoDiscoverReports es enthalten und aktiviert ist)

Geben Sie ein Präfix an, das allen gefundenen Berichten CodeCatalyst vorangestellt wird, um die zugehörigen CodeCatalyst Berichte zu benennen. Wenn Sie beispielsweise das Präfix von AutoDiscovered angeben und zwei Testberichte CodeCatalyst automatisch erkennen, erhalten die zugehörigen CodeCatalyst Berichte den Namen TestSuiteOne.xml AutoDiscoveredTestSuiteOne undTestSuiteTwo.xml. AutoDiscoveredTestSuiteTwo

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Berichte/Präfixname

IncludePaths

(Aktionsname) /Outputs/AutoDiscoverReports/ IncludePaths

Oder

(Aktionsname Berichtsname-1//Outputs/Reports/) IncludePaths

(Erforderlich, wenn AutoDiscoverReports es enthalten und aktiviert ist, oder wenn es enthalten ist) Reports

Geben Sie die Dateien und Dateipfade an, CodeCatalyst die bei der Suche nach Rohberichten berücksichtigt werden. Wenn Sie beispielsweise angeben"/test/report/*", wird das gesamte Build-Image, das von der Aktion verwendet wurde, nach dem /test/report/* Verzeichnis CodeCatalyst durchsucht. Wenn das Verzeichnis gefunden CodeCatalyst wird, wird in diesem Verzeichnis nach Berichten gesucht.

Anmerkung

Wenn Ihr Dateipfad ein oder mehrere Sternchen (*) oder andere Sonderzeichen enthält, schließen Sie den Pfad in doppelte Anführungszeichen () ein. "" Weitere Hinweise zu Sonderzeichen finden Sie unter. Richtlinien und Konventionen zur Syntax

Wenn diese Eigenschaft weggelassen wird, ist die Standardeinstellung"**/*", was bedeutet, dass die Suche alle Dateien in allen Pfaden umfasst.

Anmerkung

Bei manuell konfigurierten Berichten IncludePaths muss es sich um ein Glob-Muster handeln, das einer einzelnen Datei entspricht.

Entsprechende Benutzeroberfläche:

  • Registerkarte „Ausgaben/Berichte automatisch erkennen/Pfade einschließen/ausschließen/Pfade einschließen“

  • Registerkarte „Ausgaben/Berichte/Berichte manuell konfigurieren/Berichtsname-1 /Pfade einschließen/ausschließen/ Pfade einschließen

ExcludePaths

(/Outputs/AutoDiscoverReports/ExcludePathsAktionsname)

Oder

(Aktionsname Berichtsname-1//Outputs/Reports/) ExcludePaths

(Optional)

Geben Sie die Dateien und Dateipfade an, die bei der Suche nach Rohberichten CodeCatalyst ausgeschlossen werden sollen. Wenn Sie beispielsweise angeben"/test/my-reports/**/*", CodeCatalyst wird nicht nach Dateien im /test/my-reports/ Verzeichnis gesucht. Um alle Dateien in einem Verzeichnis zu ignorieren, verwenden Sie das **/* Glob-Muster.

Anmerkung

Wenn Ihr Dateipfad ein oder mehrere Sternchen (*) oder andere Sonderzeichen enthält, schließen Sie den Pfad in doppelte Anführungszeichen () ein. "" Weitere Hinweise zu Sonderzeichen finden Sie unter. Richtlinien und Konventionen zur Syntax

Entsprechende Benutzeroberfläche:

  • Registerkarte Ausgaben/Berichte/Berichte automatisch erkennen/Pfade einschließen/Ausschließen/Pfade ausschließen

  • Registerkarte „Ausgaben/Berichte/Berichte manuell konfigurieren/Berichtsname-1 /Pfade einschließen/ausschließen/ Pfade ausschließen

SuccessCriteria

(/Outputs/AutoDiscoverReports/SuccessCriteriaAktionsname)

Oder

(Aktionsname Berichtsname-1//Outputs/Reports/) SuccessCriteria

(Optional)

Geben Sie die Erfolgskriterien für die Berichte Test, Codeabdeckung, Software Composition Analysis (SCA) und Static Analysis (SA) an.

Weitere Informationen finden Sie unter Erfolgskriterien für Berichte konfigurieren.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“

PassRate

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ PassRate

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ PassRate

(Optional)

Geben Sie den Prozentsatz der Tests in einem Testbericht an, die bestanden werden müssen, damit der zugehörige CodeCatalyst Bericht als bestanden markiert wird. Zu den gültigen Werten gehören Dezimalzahlen. Zum Beispiel: 50, 60.5. Die Kriterien für die Erfolgsquote werden nur auf Testberichte angewendet. Weitere Informationen zu Testberichten finden Sie unterTestberichte.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien/Erfolgsquote“

LineCoverage

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ LineCoverage

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ LineCoverage

(Optional)

Geben Sie den Prozentsatz der Zeilen in einem Bericht über die Codeabdeckung an, die abgedeckt werden müssen, damit der zugehörige CodeCatalyst Bericht als bestanden markiert wird. Zu den gültigen Werten gehören Dezimalzahlen. Zum Beispiel: 50, 60.5. Die Kriterien für die Leitungsabdeckung werden nur auf Berichte zur Codeabdeckung angewendet. Weitere Informationen zu Berichten über die Codeabdeckung finden Sie unterBerichte zur Codeabdeckung.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“/„Linienabdeckung“

BranchCoverage

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ BranchCoverage

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ BranchCoverage

(Optional)

Geben Sie den Prozentsatz der Zweige in einem Bericht zur Codeabdeckung an, die abgedeckt werden müssen, damit der zugehörige CodeCatalyst Bericht als bestanden markiert wird. Gültige Werte beinhalten Dezimalzahlen. Zum Beispiel: 50, 60.5. Die Kriterien für die Abdeckung von Filialen werden nur auf Berichte zur Codeabdeckung angewendet. Weitere Informationen zu Berichten über die Codeabdeckung finden Sie unterBerichte zur Codeabdeckung.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“/„Branch Coverage“

Vulnerabilities

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ Vulnerabilities

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ Vulnerabilities

(Optional)

Geben Sie die maximale Anzahl und den Schweregrad der Sicherheitslücken an, die im SCA-Bericht zulässig sind, damit der zugehörige CodeCatalyst Bericht als bestanden markiert werden kann. Um Sicherheitslücken zu spezifizieren, müssen Sie Folgendes angeben:

  • Der Mindestschweregrad der Sicherheitsanfälligkeiten, die Sie in die Zählung einbeziehen möchten. Gültige Werte, vom höchsten bis zum geringsten Schweregrad, sind: CRITICALHIGH,MEDIUM,,LOW,INFORMATIONAL.

    Wenn Sie beispielsweise wählen HIGHHIGH, werden alle CRITICAL Sicherheitslücken gezählt.

  • Die maximale Anzahl von Sicherheitslücken mit dem angegebenen Schweregrad, die Sie zulassen möchten. Wenn diese Zahl überschritten wird, wird der CodeCatalyst Bericht als fehlgeschlagen markiert. Gültige Werte sind ganze Zahlen.

Die Kriterien für Sicherheitslücken werden nur auf SCA-Berichte angewendet. Weitere Informationen zu SCA-Berichten finden Sie unterBerichte zur Analyse der Softwarezusammensetzung.

Verwenden Sie die Severity Eigenschaft, um den Mindestschweregrad anzugeben. Verwenden Sie die Number Eigenschaft, um die maximale Anzahl von Sicherheitslücken anzugeben.

Entsprechende Benutzeroberfläche: Registerkarte Ausgabe/Berichte/Erfolgskriterien/Sicherheitslücken

StaticAnalysisBug

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ StaticAnalysisBug

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ StaticAnalysisBug

(Optional)

Geben Sie die maximale Anzahl und den Schweregrad der Fehler an, die im SA-Bericht zulässig sind, damit der zugehörige CodeCatalyst Bericht als bestanden markiert wird. Um Fehler zu spezifizieren, müssen Sie Folgendes angeben:

  • Der minimale Schweregrad der Fehler, die Sie in die Zählung einbeziehen möchten. Gültige Werte, vom höchsten bis zum geringsten Schweregrad, sind: CRITICALHIGH,MEDIUM,,LOW,INFORMATIONAL.

    Wenn Sie beispielsweise wählenHIGH, dann werden HIGH alle CRITICAL Bugs gezählt.

  • Die maximale Anzahl von Fehlern mit dem angegebenen Schweregrad, die Sie zulassen möchten. Wenn diese Zahl überschritten wird, wird der CodeCatalyst Bericht als fehlgeschlagen markiert. Gültige Werte sind ganze Zahlen.

Die Bug-Kriterien werden nur auf PyLint ESLint SA-Berichte angewendet. Weitere Informationen zu SA-Berichten finden Sie unterStatische Analyseberichte.

Verwenden Sie die Severity Eigenschaft, um den Mindestschweregrad anzugeben. Verwenden Sie die Number Eigenschaft, um die maximale Anzahl von Sicherheitslücken anzugeben.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“/„Bugs“

StaticAnalysisSecurity

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ StaticAnalysisSecurity

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ StaticAnalysisSecurity

(Optional)

Geben Sie die maximale Anzahl und den Schweregrad der Sicherheitslücken an, die im SA-Bericht zulässig sind, damit der zugehörige CodeCatalyst Bericht als bestanden markiert werden kann. Um Sicherheitslücken zu spezifizieren, müssen Sie Folgendes angeben:

  • Der Mindestschweregrad der Sicherheitslücken, die Sie in die Zählung einbeziehen möchten. Gültige Werte (vom höchsten bis zum geringsten Schweregrad) sind: CRITICALHIGH,MEDIUM,,LOW,INFORMATIONAL.

    Wenn Sie beispielsweise wählenHIGH, dann HIGH werden CRITICAL Sicherheitslücken gezählt.

  • Die maximale Anzahl von Sicherheitslücken mit dem angegebenen Schweregrad, die Sie zulassen möchten. Wenn diese Zahl überschritten wird, wird der CodeCatalyst Bericht als fehlgeschlagen markiert. Gültige Werte sind ganze Zahlen.

Die Kriterien für Sicherheitslücken werden nur auf PyLint Berichte von ESLint SA angewendet. Weitere Informationen zu SA-Berichten finden Sie unterStatische Analyseberichte.

Verwenden Sie die Severity Eigenschaft, um den Mindestschweregrad anzugeben. Verwenden Sie die Number Eigenschaft, um die maximale Anzahl von Sicherheitslücken anzugeben.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“/Sicherheitslücken

StaticAnalysisQuality

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ StaticAnalysisQuality

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ StaticAnalysisQuality

(Optional)

Geben Sie die maximale Anzahl und den Schweregrad von Qualitätsproblemen an, die im SA-Bericht zulässig sind, damit der zugehörige CodeCatalyst Bericht als bestanden markiert werden kann. Um Qualitätsprobleme zu spezifizieren, müssen Sie Folgendes angeben:

  • Der Mindestschweregrad der Qualitätsprobleme, die Sie in die Zählung einbeziehen möchten. Gültige Werte (vom höchsten bis zum geringsten Schweregrad) sind: CRITICALHIGH,MEDIUM,,LOW,INFORMATIONAL.

    Wenn Sie sich beispielsweise dafür entscheiden HIGHHIGH, werden CRITICAL Qualitätsprobleme gezählt.

  • Die maximale Anzahl von Qualitätsproblemen mit dem angegebenen Schweregrad, die Sie zulassen möchten. Wenn diese Zahl überschritten wird, wird der CodeCatalyst Bericht als fehlgeschlagen markiert. Gültige Werte sind ganze Zahlen.

Die Kriterien für Qualitätsprobleme werden nur auf PyLint Berichte von ESLint SA angewendet. Weitere Informationen zu SA-Berichten finden Sie unterStatische Analyseberichte.

Verwenden Sie die Severity Eigenschaft, um den Mindestschweregrad anzugeben. Verwenden Sie die Number Eigenschaft, um die maximale Anzahl von Sicherheitslücken anzugeben.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien“/„Qualitätsprobleme“

StaticAnalysisFinding

(Aktionsname) /Outputs/AutoDiscoverReports/SuccessCriteria/ StaticAnalysisFinding

Oder

(Aktionsname Berichtsname-1/Outputs/Reports/) /SuccessCriteria/ StaticAnalysisFinding

(Optional)

Geben Sie die maximale Anzahl und den Schweregrad der Ergebnisse an, die im SA-Bericht zulässig sind, damit der zugehörige CodeCatalyst Bericht als bestanden markiert werden kann. Um Ergebnisse zu spezifizieren, müssen Sie Folgendes angeben:

  • Der Mindestschweregrad der Ergebnisse, die Sie in die Zählung einbeziehen möchten. Gültige Werte, vom höchsten bis zum geringsten Schweregrad, sind: CRITICALHIGH,MEDIUM,,LOW,INFORMATIONAL.

    Wenn Sie beispielsweise wählenHIGH, dann werden HIGH die CRITICAL Ergebnisse zusammengezählt.

  • Die maximale Anzahl von Ergebnissen mit dem angegebenen Schweregrad, die Sie zulassen möchten. Wenn diese Zahl überschritten wird, wird der CodeCatalyst Bericht als fehlgeschlagen markiert. Gültige Werte sind ganze Zahlen.

Die Ergebnisse werden nur auf Berichte der SARIF SA angewendet. Weitere Informationen zu SA-Berichten finden Sie unterStatische Analyseberichte.

Verwenden Sie die Severity Eigenschaft, um den Mindestschweregrad anzugeben. Verwenden Sie die Number Eigenschaft, um die maximale Anzahl von Sicherheitslücken anzugeben.

Entsprechende Benutzeroberfläche: Registerkarte „Ausgabe/Berichte/Erfolgskriterien/Ergebnisse“

Reports

/Outputs/Reports(Name der Aktion)

(Optional)

Ein Abschnitt, der die Konfiguration für Testberichte spezifiziert.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Berichte

Berichtsname-1

(Aktionsname Berichtsname-1) /Outputs/Reports/

(Erforderlich, falls enthalten) Reports

Der Name, den Sie dem CodeCatalyst Bericht geben möchten, der aus Ihren Rohberichten generiert wird.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Berichte/Berichte manuell konfigurieren/Berichtsname

Format

(/Outputs/Reports/Aktionsname FormatBerichtsname-1/)

(Erforderlich, wenn es enthalten ist) Reports

Geben Sie das Dateiformat an, das Sie für Ihre Berichte verwenden. Mögliche Werte können sein wie folgt.

  • Für Testberichte:

    • Geben Sie für Cucumber JSON Cucumber (visueller Editor) oder CUCUMBERJSON (YAML-Editor) an.

    • Geben Sie für JUnit-XML JUnit (visueller Editor) oder JUNITXML (YAML-Editor) an.

    • Geben Sie für NUnit-XML NUnit (visueller Editor) oder NUNITXML (YAML-Editor) an.

    • Geben Sie für NUnit 3-XML NUnit3 (visueller Editor) oder (YAML-Editor) an. NUNIT3XML

    • Geben Sie für Visual Studio TRX Visual Studio TRX (visueller Editor) oder (YAML-Editor) an. VISUALSTUDIOTRX

    • Geben Sie für TestNG XML TestNG (visueller Editor) oder TESTNGXML (YAML-Editor) an.

  • Für Berichte zur Codeabdeckung:

    • Geben Sie für Clover-XML Clover (visueller Editor) oder CLOVERXML (YAML-Editor) an.

    • Geben Sie für Cobertura XML Cobertura (visueller Editor) oder (YAML-Editor) an. COBERTURAXML

    • Geben Sie für JaCoCo XML JaCoCo(visueller Editor) oder JACOCOXML (YAML-Editor) an.

    • Geben Sie für SimpleCov JSON, das von simplecov und nicht von simplecov-json generiert wurde, Simplecov (visueller Editor) oder (YAML-Editor) an. SIMPLECOV

  • Für SCA-Berichte (Software Composition Analysis):

    • Geben Sie für SARIF SARIF (Visual Editor) oder SARIFSCA (YAML-Editor) an.

Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Berichte/Berichte manuell konfigurieren/Berichte hinzufügen/konfigurieren/Berichtsname-1 /Berichtstyp und Berichtsformat

Configuration

(Aktionsname/) Configuration

(Erforderlich) Ein Abschnitt, in dem Sie die Konfigurationseigenschaften der Aktion definieren können.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“

Container

(Aktionsname /Configuration/ Container)

(Optional)

Geben Sie das Docker-Image oder den Container an, den die Aktion verwendet, um ihre Verarbeitung abzuschließen. Sie können eines der mitgelieferten aktiven Images angeben CodeCatalyst, oder Sie können Ihr eigenes Image verwenden. Wenn Sie Ihr eigenes Image verwenden möchten, kann es sich in Amazon ECR, Docker Hub oder einer anderen Registrierung befinden. Wenn Sie kein Docker-Image angeben, verwendet die Aktion eines der aktiven Images für die Verarbeitung. Informationen darüber, welches aktive Image standardmäßig verwendet wird, finden Sie unterAktive Bilder.

Weitere Informationen zur Angabe Ihres eigenen Docker-Images finden Sie unterZuweisen eines Docker-Images für eine benutzerdefinierte Laufzeitumgebung zu einer Aktion.

Entsprechende Benutzeroberfläche: Docker-Image für die Laufzeitumgebung — optional

Registry

(/Configuration/Container/RegistryAktionsname)

(Erforderlich, wenn es enthalten Container ist)

Geben Sie die Registrierung an, in der Ihr Bild gespeichert ist. Gültige Werte sind:

  • CODECATALYST(YAML-Editor)

    Das Bild wird in der CodeCatalyst Registrierung gespeichert.

  • Docker Hub (visueller Editor) oder DockerHub (YAML-Editor)

    Das Bild wird in der Docker Hub-Image-Registry gespeichert.

  • Andere Registrierung (visueller Editor) oder Other (YAML-Editor)

    Das Bild wird in einer benutzerdefinierten Bildregistrierung gespeichert. Jede öffentlich verfügbare Registrierung kann verwendet werden.

  • Amazon Elastic Container Registry (visueller Editor) oder ECR (YAML-Editor)

    Das Bild wird in einem Image-Repository der Amazon Elastic Container Registry gespeichert. Um ein Bild in einem Amazon ECR-Repository zu verwenden, benötigt diese Aktion Zugriff auf Amazon ECR. Um diesen Zugriff zu aktivieren, müssen Sie eine IAM-Rolle erstellen, die die folgenden Berechtigungen und eine benutzerdefinierte Vertrauensrichtlinie umfasst. (Sie können eine bestehende Rolle so ändern, dass sie die Berechtigungen und die Richtlinie einbezieht, wenn Sie möchten.)

    Die IAM-Rolle muss die folgenden Berechtigungen in ihrer Rollenrichtlinie enthalten:

    • ecr:BatchCheckLayerAvailability

    • ecr:BatchGetImage

    • ecr:GetAuthorizationToken

    • ecr:GetDownloadUrlForLayer

    Die IAM-Rolle muss die folgende benutzerdefinierte Vertrauensrichtlinie enthalten:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service":  [
                   "codecatalyst-runner.amazonaws.com",
                   "codecatalyst.amazonaws.com"
                 ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

    Weitere Informationen zum Erstellen von IAM-Rollen finden Sie unter Erstellen einer Rolle mithilfe benutzerdefinierter Vertrauensrichtlinien (Konsole) im IAM-Benutzerhandbuch.

    Nachdem Sie die Rolle erstellt haben, müssen Sie sie der Aktion über eine Umgebung zuweisen. Weitere Informationen finden Sie unter Einer Workflow-Aktion eine Umgebung, eine Kontoverbindung und eine IAM-Rolle zuordnen.

Entsprechende Benutzeroberfläche: Amazon Elastic Container Registry, Docker Hub und andere Registrierungsoptionen

Image

(/Configuration/Container/ImageAktionsname)

(Erforderlich, wenn es enthalten Container ist)

Geben Sie eines der folgenden Elemente an:

  • Wenn Sie eine CODECATALYST Registrierung verwenden, legen Sie für das Image eines der folgenden aktiven Images fest:

    • CodeCatalystLinux_x86_64:2024_03

    • CodeCatalystLinux_x86_64:2022_11

    • CodeCatalystLinux_Arm64:2024_03

    • CodeCatalystLinux_Arm64:2022_11

    • CodeCatalystLinuxLambda_x86_64:2024_03

    • CodeCatalystLinuxLambda_x86_64:2022_11

    • CodeCatalystLinuxLambda_Arm64:2024_03

    • CodeCatalystLinuxLambda_Arm64:2022_11

    • CodeCatalystWindows_x86_64:2022_11

  • Wenn Sie eine Docker Hub-Registry verwenden, legen Sie für das Image den Namen des Docker Hub-Images und das optionale Tag fest.

    Beispiel: postgres:latest

  • Wenn Sie eine Amazon ECR-Registrierung verwenden, setzen Sie das Bild auf die Amazon ECR-Registrierungs-URI.

    Beispiel: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo

  • Wenn Sie eine benutzerdefinierte Registrierung verwenden, setzen Sie das Bild auf den Wert, der von der benutzerdefinierten Registrierung erwartet wird.

Entsprechende Benutzeroberfläche: Docker-Image der Laufzeitumgebung (falls die Registrierung vorhanden istCODECATALYST), Docker Hub-Image (wenn die Registrierung Docker Hub ist), ECR-Image-URL (wenn die Registrierung Amazon Elastic Container Registry ist) und Image-URL (wenn die Registrierung Andere Registrierung ist).

Steps

(/Configuration/StepsAktionsname)

(Erforderlich)

Geben Sie die Shell-Befehle an, die Sie während der Aktion zur Installation, Konfiguration und Ausführung Ihrer Build-Tools ausführen möchten.

Hier ist ein Beispiel für die Erstellung eines NPM-Projekts:

Steps:
  - Run: npm install
  - Run: npm run build

Hier ist ein Beispiel für die Angabe von Dateipfaden:

Steps:
  - Run: cd $ACTION_BUILD_SOURCE_PATH_WorkflowSource/app  && cat file2.txt
  - Run: cd $ACTION_BUILD_SOURCE_PATH_MyBuildArtifact/build-output/  && cat file.txt

Weitere Hinweise zum Angeben von Dateipfaden finden Sie unter Referenzieren von Dateien in einem Quell-Repository undReferenzieren von Dateien in einem Artefakt.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/Shell-Befehle

Packages

(/Configuration/PackagesAktionsname)

(Optional)

Ein Abschnitt, in dem Sie ein Paket-Repository angeben können, das die Aktion zum Auflösen von Abhängigkeiten verwendet. Mit Paketen können Sie Softwarepakete, die für die Anwendungsentwicklung verwendet werden, sicher speichern und gemeinsam nutzen.

Weitere Informationen zu Paketen finden Sie unterVeröffentlichen und teilen Sie Softwarepakete in CodeCatalyst.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Pakete“

NpmConfiguration

(/Configuration/Packages/NpmConfigurationAktionsname)

(Erforderlich, wenn es enthalten Packages ist)

Ein Abschnitt, der die Konfiguration für das npm-Paketformat definiert. Diese Konfiguration wird von einer Aktion während einer Workflow-Ausführung verwendet.

Weitere Informationen zur Konfiguration des npm-Pakets finden Sie unterVerwenden von npm.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Pakete/Konfiguration hinzufügen/npm“

PackageRegistries

(Aktionsname) /Configuration/Packages/NpmConfiguration/ PackageRegistries

(Erforderlich, wenn es enthalten Packages ist)

Ein Abschnitt, in dem Sie die Konfigurationseigenschaften einer Folge von Paket-Repositorys definieren können.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Pakete/Konfiguration hinzufügen/npm/Paket-Repository hinzufügen

PackagesRepository

(Aktionsname) /Configuration/Packages/NpmConfiguration/PackageRegistries/ PackagesRepository

(Erforderlich, wenn es enthalten Packages ist)

Geben Sie den Namen Ihres CodeCatalyst Paket-Repositorys an, das die Aktion verwenden soll.

Wenn Sie mehrere Standard-Repositorys angeben, hat das letzte Repository Priorität.

Weitere Hinweise zu Paket-Repositorys finden Sie unter. Paket-Repositorys

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Pakete/Konfiguration hinzufügen/npm/Paket-Repository hinzufügen/Paket-Repository

Scopes

(Aktionsname) /Configuration/Packages/NpmConfiguration/PackageRegistries/ Scopes

(Optional)

Geben Sie eine Abfolge von Bereichen an, die Sie in Ihrer Paketregistrierung definieren möchten. Bei der Definition von Bereichen wird das angegebene Paket-Repository als Registrierung für alle aufgelisteten Bereiche konfiguriert. Wenn ein Paket mit dem Bereich über den npm-Client angefordert wird, verwendet es dieses Repository anstelle des Standard-Repositorys. Jedem Bereichsnamen muss ein „@“ vorangestellt werden.

Wenn Sie übergeordnete Bereiche angeben, hat das letzte Repository Vorrang.

Wenn Scopes es weggelassen wird, wird das angegebene Paket-Repository als Standardregistrierung für alle von der Aktion verwendeten Pakete konfiguriert.

Weitere Informationen zu Bereichen finden Sie unter Paket-Namespaces und Pakete mit Geltungsbereich.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Pakete/Konfiguration hinzufügen/npm/Paket-Repository hinzufügen/Bereiche — optional