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.
Anmerkung
Um einen Build mit auszuführen AWS CodeBuild, überspringen Sie diese Schritte und folgen Sie den Anweisungen unterErstellen einer Pipeline unter Verwendung von CodeBuild (AWS CLI). CodePipeline
Weitere Informationen zur Verwendung von AWS CLI with CodeBuild finden Sie unterBefehlszeilenreferenz.
-
Führen Sie den Befehl
start-build
auf eine der folgenden Weisen aus:aws codebuild start-build --project-name
<project-name>
Sie können diesen Befehl verwenden, wenn Sie ein Build ausführen möchten, dass die neueste Version des Build-Eingabeartifakts und die vorhandenen Einstellungen des Build-Projekts einsetzt.
aws codebuild start-build --generate-cli-skeleton
Verwenden Sie diesen Befehl, wenn Sie einen Build mit einer früheren Version des Build-Eingabeartefakts verwenden oder die Einstellungen für Build-Ausgabeartefakte, Umgebungsvariablen, Build-Spezifikationen oder Standard-Build-Zeitbeschränkungen überschreiben möchten.
-
Wenn Sie den start-build Befehl mit der
--project-name
Option ausführen, ersetzen Sie ihn durch den Namen des Build-Projekts, und fahren Sie dann<project-name>
mit Schritt 6 dieses Verfahrens fort. Informationen zum Abrufen einer Liste von Build-Projekten finden Sie unter Namen von Build-Projekten anzeigen. -
Wenn Sie den start-build Befehl mit der
--idempotency-token
Option ausführen, ist ein eindeutiger Bezeichner oder ein Token, bei dem die Groß- und Kleinschreibung beachtet wird, in derstart-build
Anforderung enthalten. Das Token ist nach der Anforderung 5 Minuten gültig. Wenn Sie diestart-build
Anfrage mit demselben Token wiederholen, aber einen Parameter ändern, wird ein Fehler wegen Nichtübereinstimmung der Parameter CodeBuild zurückgegeben. -
Wenn Sie den start-build Befehl mit der Option
--generate-cli-skeleton
ausführen, werden Daten im JSON-Format in der Ausgabe angezeigt. Kopieren Sie die Daten in eine Datei (z. B.
) an einem Speicherort auf dem lokalen Computer oder in der Instanz, in der der installiert AWS CLI ist. Ändern Sie die kopierten Daten, damit diese mit dem nachfolgenden Format übereinstimmen und speichern Sie die Ergebnisse:start-build.json
{ "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
" }Ersetzen die folgenden Platzhalter:
-
projectName
: Erforderliche Zeichenfolge. Der Name des Build-Projekts, der für diesen Build zu verwenden ist. -
sourceVersion
: Optionale Zeichenfolge. Eine Version des Quellcodes, der wie folgt zu erstellen ist:-
Für Amazon S3 die Versions-ID, die der Version der Eingabe-ZIP-Datei entspricht, die Sie erstellen möchten. Wenn
sourceVersion
nicht angegeben, wird die neueste Version verwendet. -
Für CodeCommit die Commit-ID, die der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn nicht angegeben,
sourceVersion
wird die HEAD-Commit-ID des Standardzweigs verwendet. (Sie können keinen Tag-Namen für angebensourceVersion
, aber Sie können die Commit-ID des Tags angeben.) -
Für GitHub die Commit-ID, die Pull-Request-ID, den Branch-Namen oder den Tag-Namen, der der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn eine Pull-Anforderungs-ID angegeben ist, muss diese das Format
pr/
verwenden (Beispiel:pull-request-ID
pr/25
). Wenn ein Branch-Name angegeben wird, wird die Commit-ID von HEAD verwendet. Wenn nicht angegeben,sourceVersion
wird die HEAD-Commit-ID des Standard-Branches verwendet. -
Für Bitbucket, Commit-ID, Branch-Name oder Tag-Name, die/der der Version des Quellcodes entspricht, die Sie erstellen möchten. Wenn ein Branch-Name angegeben wird, wird die Commit-ID von HEAD verwendet. Wenn nicht angegeben,
sourceVersion
wird die HEAD-Commit-ID des Standard-Branches verwendet.
-
-
Die folgenden Platzhalter gelten für
artifactsOverride
.-
type
: Optional. Die Art des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. -
location
: Optional. Der Speicherort des Build-Ausgabeartefakt, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. -
path
: Optional. Der Pfad des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. -
namespaceType
: Optional. Der Pfadtyp des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. -
name
: Optional. Der Name des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. -
packaging
: Optional. Die Verpackungsart des Build-Ausgabeartefakts, der für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist.
-
-
buildspecOverride
: Optional. Eine Build-Spezifikationsdeklaration, die für diesen Build den Build überschreibt, der im Build-Projekt festgelegt ist. Wenn dieser Wert festgelegt ist, kann es sich entweder um eine Inline-Definition einer Build-Spezifikation, den Pfad zu einer alternativen buildspec-Datei relativ zum Wert der integrierten UmgebungsvariablenCODEBUILD_SRC_DIR
oder den Pfad zu einem S3-Bucket handeln. Der S3-Bucket muss sich in derselben AWS -Region wie das Build-Projekt befinden. Geben Sie die buildspec-Datei mit ihrem ARN an (z. B.arn:aws:s3:::
). Wenn der Wert nicht angegeben oder eine leere Zeichenfolge ist, muss der Quellcode eine<my-codebuild-sample2>
/buildspec.ymlbuildspec.yml
-Datei im Stammverzeichnis enthalten. Weitere Informationen finden Sie unter Dateiname der Build-Spezifikation und Speicherort. -
Die folgenden Platzhalter gelten für
cacheOverride
.-
cacheOverride-location
: Optional. Der Speicherort einesProjectCache
-Objekts für diesen Build, der das im Build-Projekt angegebeneProjectCache
-Objekt überschreibt.cacheOverride
ist optional und akzeptiert einProjectCache
-Objekt.location
ist in einemProjectCache
-Objekt erforderlich. -
cacheOverride-type
: Optional. Der Typ einesProjectCache
-Objekts für diesen Build, der das im Build-Projekt angegebeneProjectCache
-Objekt überschreibt.cacheOverride
ist optional und akzeptiert einProjectCache
-Objekt.type
ist in einemProjectCache
-Objekt erforderlich.
-
-
certificateOverride
: Optional. Der Name eines Zertifikats für diesen Build, das das im Build-Projekt angegebene überschreibt. -
environmentTypeOverride
: Optional. Ein Containertyp für diesen Build, der den im Build-Projekt angegebenen überschreibt. Die aktuell gültige Zeichenfolge istLINUX_CONTAINER
. -
Die folgenden Platzhalter gelten für
environmentVariablesOverride
.-
environmentVariablesOverride-name
: Optional. Der Name einer Umgebungsvariable in dem Build_Projekt, deren Wert Sie für diesen Build überschreiben möchten. -
environmentVariablesOverride-type
: Optional. Der Typ der Umgebungsvariablen im Build-Projekt, deren Wert für diesen Build überschrieben werden soll. -
environmentVariablesValue
: Optional. Der Wert der Umgebungsvariablen, der im Build-Projekt festgelegt wurde und für diesen Build überschrieben werden soll.
-
-
gitCloneDepthOverride
: Optional. Der Wert für Git clone depth, der in dem Build-Projekt festgelegt ist, dessen Wert Sie für diesen Build überschreiben möchten. Wenn Ihr Quelltyp Amazon S3 ist, wird dieser Wert nicht unterstützt. -
imageOverride
: Optional. Der Name eines Abbilds für diesen Build, das das im Build-Projekt angegebene überschreibt. -
idempotencyToken
: Optional. Eine Zeichenfolge, die als Token dient und angibt, dass die Build-Anforderung idempotent ist. Sie können eine beliebige Zeichenfolge mit maximal 64 Zeichen verwenden. Das Token ist nach der Start-Build-Anfrage 5 Minuten lang gültig. Wenn Sie die Start-Build-Anfrage mit demselben Token wiederholen, aber einen Parameter ändern, wird ein CodeBuild Parameterkonflikt-Fehler zurückgegeben. -
insecureSslOverride
: Optionaler boolescher Wert, der angibt, ob die im Build-Projekt angegebene unsichere TLS-Einstellung überschrieben werden soll. Die unsichere TLS-Einstellung bestimmt, ob TLS-Warnungen ignoriert werden sollen, während die Verbindung zum Projektquellcode hergestellt wird. Diese Überschreibung gilt nur, wenn die Quelle des Builds Enterprise Server ist GitHub . -
privilegedModeOverride
: Optionaler boolescher Wert. Ist der Wert "true" festgelegt, überschreibt der Build den privilegierten Modus im Build-Projekt. -
queuedTimeoutInMinutesOverride
: Optionale Ganzzahl, die angibt, wie viele Minuten ein Build in die Warteschlange gestellt werden darf, bevor das Timeout eintritt. Der kleinste Wert beträgt fünf Minuten, der größte Wert beträgt 480 Minuten (8 Stunden). -
reportBuildStatusOverride
: Optionaler boolescher Wert, der angibt, ob Ihrem Quellanbieter der Status des Beginns und des Abschlusses eines Builds gesendet werden soll. Wenn Sie dies mit einem anderen Quellanbieter als GitHub GitHub Enterprise Server oder Bitbucket festlegen, wird ein invalidInputException ausgelöst. -
sourceAuthOverride
: Optionale Zeichenfolge. Ein Autorisierungstyp für diesen Build, der den im Build-Projekt angegebenen überschreibt. Diese Überschreibung gilt nur, wenn die Quelle des Build-Projekts Bitbucket oder GitHub ist. -
sourceLocationOverride
: Optionale Zeichenfolge. Ein Speicherort, der für diesen Build den Quellspeicherort überschreibt, der im Build-Projekt definiert ist. -
serviceRoleOverride
: Optionale Zeichenfolge. Der Name einer Servicerolle für diesen Build, die die im Build-Projekt angegebene Servicerolle überschreibt. -
sourceTypeOverride
: Optionale Zeichenfolge. Ein Quelleingabetyp für diesen Build, der die im Build-Projekt definierte Quelleingabe überschreibt. Gültige Zeichenfolgen sindNO_SOURCE
,CODECOMMIT
,CODEPIPELINE
,GITHUB
,S3
,BITBUCKET
undGITHUB_ENTERPRISE
. -
timeoutInMinutesOverride
: Optionale Zahl. Die Anzahl der Minuten der Build-Zeitbeschränkung, die für diesen Build den Build überschreiben, der im Build-Projekt festgelegt ist.
Wir empfehlen, dass Sie eine Umgebungsvariable mit einem sensiblen Wert wie einer AWS Zugriffsschlüssel-ID, einem AWS geheimen Zugriffsschlüssel oder einem Passwort als Parameter im Amazon EC2 Systems Manager Parameter Store speichern. CodeBuild kann einen im Amazon EC2 Systems Manager Parameter Store gespeicherten Parameter nur verwenden, wenn der Name dieses Parameters mit beginnt
/CodeBuild/
(z. B./CodeBuild/dockerLoginPassword
). Sie können die CodeBuild Konsole verwenden, um einen Parameter in Amazon EC2 Systems Manager zu erstellen. Wählen Sie Create a parameter (Parameter erstellen) aus und befolgen Sie dann die Anweisungen. (In diesem Dialogfeld können Sie für KMS-Schlüssel optional den ARN eines AWS KMS Schlüssels in Ihrem Konto angeben. Amazon EC2 Systems Manager verwendet diesen Schlüssel, um den Wert des Parameters beim Speichern zu verschlüsseln und beim Abrufen zu entschlüsseln.) Wenn Sie die CodeBuild Konsole verwenden, um einen Parameter zu erstellen, beginnt die Konsole den Parameter mit dem Wert,/CodeBuild/
während er gespeichert wird. Wenn Sie jedoch die Amazon EC2 Systems Manager Parameter Store-Konsole verwenden, um einen Parameter zu erstellen, müssen Sie den Namen des Parameters mit/CodeBuild/
beginnen und Type auf Secure String setzen. Weitere Informationen finden Sie unter AWS Systems Manager Parameterspeicher und Exemplarische Vorgehensweise: Erstellen und Testen eines String-Parameters (Konsole) im Amazon EC2 Systems Manager Manager-Benutzerhandbuch.Wenn Ihr Build-Projekt auf Parameter Store von Amazon EC2 Systems Manager gespeicherte Parameter verweist, muss die Service-Rolle des Build-Projekts die
ssm:GetParameters
Aktion zulassen. Wenn Sie zuvor in Ihrem Konto die Option Neue Servicerolle erstellen ausgewählt haben, wird CodeBuild diese Aktion automatisch in die Standard-Servicerolle für Ihr Build-Projekt aufgenommen. Wenn Sie jedoch Choose an existing service role from your account ausgewählt haben, müssen Sie diese Aktion separat in Ihre Service-Rolle aufnehmen.Von Ihnen gesetzte Umgebungsvariablen ersetzen vorhandene Umgebungsvariablen. Wenn das Docker-Image beispielsweise bereits eine Umgebungsvariable mit dem Namen
MY_VAR
und einem Wert vonmy_value
enthält und Sie eine Umgebungsvariable mit dem NamenMY_VAR
und einem Wert vonother_value
festlegen, wirdmy_value
durchother_value
ersetzt. Wenn das Docker-Image demgegenüber bereits eine Umgebungsvariable mit dem NamenPATH
und einem Wert von/usr/local/sbin:/usr/local/bin
enthält und Sie eine Umgebungsvariable mit dem NamenPATH
und einem Wert von$PATH:/usr/share/ant/bin
festlegen, wird/usr/local/sbin:/usr/local/bin
durch den Literalwert$PATH:/usr/share/ant/bin
ersetzt.Legen Sie keine Umgebungsvariable mit einem Namen fest, der mit
CODEBUILD_
beginnt. Dieses Präfix ist zur -internen Verwendung reserviert.Wenn eine Umgebungsvariable mit identischem Namen an mehreren Orten definiert ist, wird der Wert der Umgebungsvariable folgendermaßen bestimmt:
-
Der Wert im Aufruf zum Starten des Build-Vorgangs hat den höchsten Vorrang.
-
Der Wert in der Build-Projektdefinition folgt darauf.
-
Der Wert in der Deklaration in der buildspec-Datei hat die niedrigste Priorität.
Weitere Informationen zu gültigen Werten für diese Platzhalter finden Sie unter Erstellen eines Build-Projekts (AWS CLI). Eine Liste der neuesten Einstellungen für ein Build-Projekt finden Sie unter Details zum Build-Projekt anzeigen.
-
-
Wechseln Sie in das Verzeichnis, das die soeben gespeicherte Datei enthält, und führen Sie den Befehl
start-build
erneut aus.aws codebuild start-build --cli-input-json file://start-build.json
-
Bei Erfolg enthält die Ausgabe Daten wie in der So führen Sie den Build aus-Anleitung beschrieben.
Um mit den detaillierten Informationen über diesen Build zu arbeiten, notieren Sie sich den Wert id
im der Ausgabe und zeigen Sie sich dann Anzeigen von Build-Details (AWS CLI) an.