

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.

# Erstellen Sie eine Pipeline, die CodeBuild (CodePipeline Konsole) verwendet
<a name="how-to-create-pipeline-console"></a>

Gehen Sie wie folgt vor, um eine Pipeline zu erstellen, die CodeBuild zum Erstellen und Bereitstellen Ihres Quellcodes verwendet wird.

So erstellen Sie eine Pipeline, die nur Ihren Quellcode testet:
+ Setzen Sie die das folgende Verfahren ein, um eine Pipeline zu erstellen, und anschließend löschen Sie die Build- und Beta-Stufen aus der Pipeline. Fügen Sie dann mithilfe des [Eine CodeBuild Testaktion zu einer Pipeline hinzufügen (CodePipeline Konsole)](how-to-create-pipeline-add-test.md)-Verfahrens dieses Themas eine Testaktion mit CodeBuild zur Pipeline hinzu.
+ Erstellen Sie die Pipeline mithilfe eines anderen Verfahrens dieses Themas und fügen Sie dann mit dem [Eine CodeBuild Testaktion zu einer Pipeline hinzufügen (CodePipeline Konsole)](how-to-create-pipeline-add-test.md)-Verfahren dieses Themas eine Testaktion mit CodeBuild zur Pipeline hinzu.

**Um den Assistenten zum Erstellen einer Pipeline CodePipeline zu verwenden, erstellen Sie eine Pipeline, die verwendet CodeBuild**

1. Melden Sie sich bei der an, AWS-Managementkonsole indem Sie:
   + Ihr AWS Root-Konto. Dies wird nicht empfohlen. Weitere Informationen finden Sie unter [Der Root-Benutzer des Kontos](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html) im *Benutzerhandbuch*.
   + Ein Administratorbenutzer in Ihrem AWS Konto. Weitere Informationen finden Sie im *Benutzerhandbuch* unter [Erstellen Ihres ersten AWS-Konto Root-Benutzers und Ihrer ersten Root-Gruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html).
   + Ein Benutzer in Ihrem AWS Konto, der berechtigt ist, die folgenden Mindestaktionen zu verwenden:

     ```
     codepipeline:*
     iam:ListRoles
     iam:PassRole
     s3:CreateBucket
     s3:GetBucketPolicy
     s3:GetObject
     s3:ListAllMyBuckets
     s3:ListBucket
     s3:PutBucketPolicy
     codecommit:ListBranches
     codecommit:ListRepositories
     codedeploy:GetApplication
     codedeploy:GetDeploymentGroup
     codedeploy:ListApplications
     codedeploy:ListDeploymentGroups
     elasticbeanstalk:DescribeApplications
     elasticbeanstalk:DescribeEnvironments
     lambda:GetFunctionConfiguration
     lambda:ListFunctions
     opsworks:DescribeStacks
     opsworks:DescribeApps
     opsworks:DescribeLayers
     ```

1. Öffnen Sie die AWS CodePipeline Konsole unter [https://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Wählen Sie in der AWS Regionsauswahl die Region aus, in der sich Ihre AWS Build-Projektressourcen befinden. AWS Dies muss eine AWS Region sein, die unterstützt CodeBuild wird. Weitere Informationen finden Sie unter [AWS CodeBuild](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region) im *Allgemeine Amazon Web Services-Referenz*.

1. Erstellen Sie eine Pipeline. Wenn eine CodePipeline Informationsseite angezeigt wird, wählen Sie **Pipeline erstellen**. Wenn eine **Pipelines**-Seite angezeigt wird, wählen Sie die Option **Create pipeline (Pipeline erstellen)** aus.

1. Geben Sie auf der Seite **Step 1: Choose pipeline settings (Schritt 1: Pipeline-Einstellungen auswählen)** unter **Pipeline name (Pipeline-Name)** einen Namen für die Pipeline ein (z. B. **CodeBuildDemoPipeline**). Wenn Sie einen anderen Namen auswählen, müssen Sie diesen während der gesamten Anleitung verwenden.

1. Führen Sie für **Role name (Rollenname)** einen der folgenden Schritte aus:

   Wählen Sie **New service role (Neue Servicerolle)** aus und geben Sie in **Role Name (Rollenname)** den Namen für Ihre neue Servicerolle aus.

   Wählen Sie **Existing service role (Vorhandene Servicerolle)** und klicken Sie dann auf die CodePipeline-Servicerolle, die Sie erstellt oder als Bestandteil der Voraussetzungen für dieses Thema ermittelt haben.

1. Für **Artifact store (Artefact speichern)** führen Sie einen der folgenden Schritte aus:
   + Wählen Sie **Standardstandort**, um den Standard-Artefaktspeicher, z. B. den als Standard festgelegten S3-Artefakt-Bucket, für Ihre Pipeline in der AWS Region zu verwenden, die Sie für Ihre Pipeline ausgewählt haben.
   + Wählen Sie **Benutzerdefinierter Speicherort**, wenn Sie bereits über einen von Ihnen erstellten Artefaktspeicher verfügen, z. B. einen S3-Artefakt-Bucket, in derselben AWS Region wie Ihre Pipeline.
**Anmerkung**  
Dies ist nicht der Quell-Bucket für den Quellcode Ihrer Pipeline. sondern um den Artefaktspeicher für Ihre Pipeline. Ein separater Artefaktspeicher, z. B. ein S3-Bucket, ist für jede Pipeline in derselben AWS Region wie die Pipeline erforderlich.

1. Wählen Sie **Weiter** aus.

1. Führen Sie auf der Seite **Step 2: Add source stage** für **Source provider** einen der folgenden Schritte aus:
   + Wenn Ihr Quellcode in einem S3-Bucket gespeichert ist, wählen Sie **Amazon S3**. Wählen Sie für **Bucket**, den S3-Bucket aus, der Ihren Quellcode enthält. Geben Sie für **S3 object key (S3-Objektschlüssel)** den Namen der Datei an, die den Quellcode enthält (z. B. `file-name.zip`). Wählen Sie **Weiter** aus.
   + Wenn Ihr Quellcode in einem AWS CodeCommit Repository gespeichert ist, wählen Sie **CodeCommit**. Wählen Sie für **Repository name** den Namen des Repositories aus, das den Quellcode enthält. Wähen Sie für **Branch name (Name der Verzweigung)** den Namen der Verzweigung aus, die die Version des Quellcodes enthält, die Sie erstellen möchten. Wählen Sie **Weiter** aus.
   + Wenn Ihr Quellcode in einem GitHub Repository gespeichert ist, wählen Sie **GitHub**. Wählen **Sie Connect GitHub** und folgen Sie den Anweisungen zur Authentifizierung mit GitHub. Wählen Sie für **Repository** den Namen des Repositories aus, das den Quellcode enthält. Wähen Sie für **Branch (Verzweigung)** den Namen der Verzweigung aus, die die Version des Quellcodes enthält, die Sie erstellen möchten. 

   Wählen Sie **Weiter** aus.

1. Wählen Sie auf der Seite **Step 3: Add build stage** für **Build provider** **CodeBuild** aus.

1. Wenn Sie bereits über ein Build-Projekt verfügen, das Sie verwenden möchten, wählen Sie als **Projektname** den Namen des Build-Projekts aus und fahren Sie mit dem nächsten Schritt in diesem Verfahren fort. 

   Wenn Sie ein neues CodeBuild Build-Projekt erstellen müssen, folgen Sie den Anweisungen unter [Erstellen Sie ein Build-Projekt (Konsole)](create-project.md#create-project-console) und kehren Sie zu diesem Verfahren zurück.

   Wenn Sie ein vorhandenes Build-Projekt auswählen, müssen die Einstellungen für das Build-Ausgabeartefakt bereits definiert sein (auch wenn sie diese CodePipeline überschreiben). Weitere Informationen finden Sie unter [Ändern der Einstellungen eines Build-Projekts (Konsole)](change-project.md#change-project-console).
**Wichtig**  
Wenn Sie Webhooks für ein CodeBuild Projekt aktivieren und das Projekt als Build-Step-In verwendet wird CodePipeline, werden für jeden Commit zwei identische Builds erstellt. Ein Build wird über Webhooks ausgelöst und einer durch CodePipeline. Da die Fakturierung pro Build erfolgt, werden Ihnen beide Builds in Rechnung gestellt. Wenn Sie verwenden, empfehlen wir daher CodePipeline, Webhooks in zu deaktivieren. CodeBuild Deaktivieren Sie in der AWS CodeBuild -Konsole das **Webhook**-Feld. Weitere Informationen finden Sie unter [Ändern der Einstellungen eines Build-Projekts (Konsole)](change-project.md#change-project-console).

1. Führen Sie auf der Seite **Step 4: Add deploy stage** einen der folgenden Schritte aus:
   + Wenn Sie das Build-Ausgabeartefakt nicht bereitstellen möchten, wählen Sie **Skip (Überspringen)** und bestätigen diese Auswahl auf Anforderung. 
   + Wenn Sie Build-Ausgabeartefakte bereitstellen möchten, wählen Sie für **Deployment provider (bereitstellungs-Provider)** einen Bereitstellungs-Provider aus und geben dann die Einstellungen an, wenn Sie dazu aufgefordert werden.

   Wählen Sie **Weiter** aus.

1. Überprüfen Sie auf der Seite **Review (Überprüfen)** Ihre Einstellungen und wählen Sie dann **Create pipeline (Pipeline erstellen)** aus.

1. Wenn die Pipeline erfolgreich läuft, können Sie die Build-Ausgabeartefakte abrufen. Wenn die Pipeline in der CodePipeline Konsole angezeigt wird, wählen Sie in der Aktion **Build** den Tooltip aus. Notieren Sie sich den Wert für das **Ausgabeartefakt** (z. B. **MyAppBuild**).
**Anmerkung**  
Sie können das Build-Ausgabeartefakt auch abrufen, indem Sie auf der **Build-Detailseite in der Konsole auf den Link Artefakte** erstellen klicken. CodeBuild Lassen Sie die restlichen Schritte in diesem Verfahren aus, um zu dieser Seite zu gelangen, und sehen Sie sich diese unter [Anzeigen von Build-Details (Konsole)](view-build-details.md#view-build-details-console) an.

1. Öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Öffnen Sie in der Liste der Buckets auf den von der Pipeline verwendeten Bucket. Der Name des Buckets sollte das Format `codepipeline-region-ID-random-number` aufweisen. Sie können den CodePipeline **get-pipeline** Befehl verwenden AWS CLI , um den Namen des Buckets abzurufen. Dabei *my-pipeline-name* handelt es sich um den Anzeigenamen Ihrer Pipeline:

   ```
   aws codepipeline get-pipeline --name my-pipeline-name
   ```

    In der Ausgabe enthalt das Objekt `pipeline` ein Objekt mit Namen `artifactStore`, das einen Wert `location` mit dem Namen des Buckets enthält.

1. Öffnen Sie den Ordner, der dem Namen Ihrer Pipeline entspricht (abhängig von der Länge des Pipeline-Namens kann der Name des Ordners verkürzt sein), und dann öffnen Sie den Ordner, der dem Wert für **Output artifact (Ausgabeartefakt)** entspricht, den Sie zuvor notiert haben.

1. Extrahieren Sie den Inhalt der Datei . Wenn in diesem Ordner mehrere Dateien enthalten sind, extrahieren Sie die Inhalte der Datei mit dem neuesten Zeitstempel **Last Modified**. (Sie müssen die Datei möglicherweise mit der Erweiterung `.zip` versehen, damit Sie vom ZIP-Dienstprogramm Ihres Systems unterstützt wird.) Das Build-Ausgabeartefakt ist in den extrahierten Inhalten der Datei vorhanden.

1. Wenn Sie angewiesen haben CodePipeline , das Build-Ausgabeartefakt bereitzustellen, verwenden Sie die Anweisungen des Bereitstellungsanbieters, um zum Build-Ausgabeartefakt auf den Bereitstellungszielen zu gelangen.