Beispiel für eine Quellversion mit AWS CodeBuild

Dieses Beispiel zeigt, wie Sie eine Version Ihrer Quelle in einem anderen Format als einer Commit-ID (auch als Commit-ID bezeichnetSHA) angeben. Sie haben folgende Möglichkeiten, die Version Ihrer Quelle anzugeben:

• Verwenden Sie für einen Amazon S3 S3-Quellanbieter die Versions-ID des Objekts, das die ZIP Build-Eingabedatei darstellt.

• Verwenden Sie für CodeCommit Bitbucket und GitHub Enterprise Server eine der folgenden Optionen: GitHub

  • Pull-Anforderung als Pull-Anforderungsreferenz (z. B. refs/pull/1/head).

  • Branch als Branch-Name.

  • Commit-ID.

  • Tag.

  • Referenz und eine Commit-ID. Die Referenz kann Folgendes sein:

    • Ein Tag (z. B. refs/tags/mytagv1.0^{full-commit-SHA}).

    • Ein Branch (z. B. refs/heads/mydevbranch^{full-commit-SHA}).

    • Eine Pull-Anforderung (z. B. refs/pull/1/head^{full-commit-SHA}).

• Verwende für GitLab und GitLab Self Managed eine der folgenden Optionen:

  • Branch als Branch-Name.

  • Commit-ID.

  • Tag.

Anmerkung

Sie können die Version einer Pull-Request-Quelle nur angeben, wenn es sich bei Ihrem Repository um einen GitHub Enterprise Server handelt GitHub .

Wenn Sie eine Referenz und eine Commit-ID zum Angeben einer Version verwenden, ist die DOWNLOAD_SOURCE-Phase Ihres Builds schneller, als wenn Sie nur die Version angeben. Das liegt daran, dass beim Hinzufügen einer Referenz CodeBuild nicht das gesamte Repository heruntergeladen werden muss, um den Commit zu finden.

• Sie können eine Quellversion mit nur einer Commit-ID angeben, wie z. B. 12345678901234567890123467890123456789. Wenn Sie dies tun, CodeBuild müssen Sie das gesamte Repository herunterladen, um die Version zu finden.

• Sie können eine Quellversion mit einer Referenz und einer Commit-ID im folgenden Format angeben: refs/heads/branchname^{full-commit-SHA} (z. B. refs/heads/main^{12345678901234567890123467890123456789}). Wenn Sie dies tun, wird nur der angegebene Zweig CodeBuild heruntergeladen, um die Version zu finden.

Anmerkung

Um die DOWNLOAD_SOURCE Phase Ihres Builds zu beschleunigen, können Sie die Git-Klontiefe auch auf einen niedrigen Wert setzen. CodeBuild lädt weniger Versionen deines Repositorys herunter.

Um eine GitHub Repository-Version mit einer Commit-ID anzugeben

1. Öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

2. Erstellen Sie ein Build-Projekt. Weitere Informationen finden Sie unter Erstellen Sie ein Build-Projekt (Konsole) und Ausführen eines Build (Konsole). Übernehmen Sie für alle Einstellungen die Standardwerte, außer für folgende Einstellungen:

   • In Source (Quelle):

     • Wählen Sie als Quellanbieter. GitHub Wenn Sie nicht verbunden sind GitHub, folgen Sie den Anweisungen, um eine Verbindung herzustellen.

     • Wählen Sie für Repository (Repository) die Option Public Repository (öffentliche Repository) aus.

     • Geben Sie für Repository URL einhttps://github.com/aws/aws-sdk-ruby.git.

   • In Environment (Umgebung):

     • Wählen Sie für Environment image (Umgebungs-Abbild) die Option Managed image (Verwaltetes Abbild) aus.

     • Wählen Sie für Operating system (Betriebssystem) die Option Amazon Linux 2 aus.

     • Wählen Sie unter Runtime (Laufzeit) die Option Standard aus.

     • Wählen Sie für Image aws/codebuild/amazonlinux2-x86_64-standard:4.0.

3. Wählen Sie unter Build specification (Build-Spezifikationen) die Option Insert build commands (Build-Befehle einfügen) und anschließend Switch to editor (Zum Editor wechseln) aus.

4. Ersetzen Sie unter Build commands (Build-Befehle) den Platzhalter mit dem folgenden Text:

   version: 0.2
   
   phases:
     install:
       runtime-versions:
         ruby: 2.6
     build:
       commands:
          - echo $CODEBUILD_RESOLVED_SOURCE_VERSION

   Der runtime-versions-Abschnitt ist erforderlich, wenn Sie das Ubuntu Standard-Image 2.0 verwenden. Hier ist die Ruby Version 2.6-Laufzeit angegeben, Sie können jedoch eine beliebige Laufzeit verwenden. Der echo-Befehl zeigt die Version des Quellcodes an, der in der CODEBUILD_RESOLVED_SOURCE_VERSION-Umgebungsvariable gespeichert ist.

5. Übernehmen Sie in der Build configuration (Build-Konfiguration) die Standardeinstellungen und wählen Sie dann Start build (Build starten).

6. Geben Sie für Source version (Quellversion) Folgendes ein: 046e8b67481d53bdc86c3f6affdd5d1afae6d369. Dies SHA ist der eines Commits im Repository. https://github.com/aws/aws-sdk-ruby.git

7. Wählen Sie Start build (Build starten).

8. Wenn die Erstellung abgeschlossen ist, sollten Sie Folgendes sehen:

   • Auf der Registerkarte Build logs (Build-Protokolle: die verwendete Version der Projektquelle Ein Beispiel.

     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED 

   • Auf der Registerkarte Environment variables (Umgebungsvariablen): Die Resolved source version (Aufgelöste Quellversion) stimmt mit der zur Erstellung des Builds verwendeten Commit-ID überein.

   • Auf der Registerkarte Phase details (Phasendetails): die Dauer der DOWNLOAD_SOURCE-Phase.

Diese Schritte zeigen, wie Sie einen Build mit derselben Version der Quelle erstellen. Dieses Mal wird die Version der Quelle mithilfe einer Referenz mit der Commit-ID angegeben.

Um eine GitHub Repository-Version mit einer Commit-ID und einer Referenz anzugeben

1. Wählen Sie im linken Navigationsbereich Build projects (Build-Projekte) und anschließend das Projekt, das Sie vorher erstellt haben, aus.

2. Wählen Sie Start build (Build starten).

3. Geben Sie in das Feld Source version (Quellversion) Folgendes ein: refs/heads/main^{046e8b67481d53bdc86c3f6affdd5d1afae6d369}. Dies ist dieselbe Commit-ID und eine Referenz auf einen Branch im Format refs/heads/branchname^{full-commit-SHA}.

4. Wählen Sie Start build (Build starten).

5. Wenn die Erstellung abgeschlossen ist, sollten Sie Folgendes sehen:

   • Auf der Registerkarte Build logs (Build-Protokolle: die verwendete Version der Projektquelle Ein Beispiel.

     [Container] Date Time Running command echo $CODEBUILD_RESOLVED_SOURCE_VERSION 
     046e8b67481d53bdc86c3f6affdd5d1afae6d369
      
     [Container] Date Time Phase complete: BUILD State: SUCCEEDED 

   • Auf der Registerkarte Environment variables (Umgebungsvariablen): Die Resolved source version (Aufgelöste Quellversion) stimmt mit der zur Erstellung des Builds verwendeten Commit-ID überein.

   • Auf der Registerkarte Phase details (Phasendetails) sollte die Dauer der DOWNLOAD_SOURCE-Phase kürzer sein als die Dauer, wenn Sie nur die Commit-ID zum Angeben der Version Ihrer Quelle verwendeten.