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.
# Tutorial: Erstellen Sie eine Regel zur Überprüfung variabler Variablen für eine Pipeline als Eingabebedingung
In diesem Tutorial konfigurieren Sie eine Pipeline, die kontinuierlich Dateien bereitstellt, indem Sie GitHub sie als Quellaktionsanbieter in Ihrer Quellphase verwenden. Die fertige Pipeline erkennt Änderungen, wenn Sie in Ihrem Quell-Repository eine Änderung an den Quelldateien vornehmen. Die Pipeline wird ausgeführt und vergleicht dann die Ausgabevariablen mit dem Quell-Repository-Namen und dem Branchnamen, die in der Bedingung für den Eintritt in die Build-Phase angegeben wurden.
**Wichtig**
Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von CodePipeline for Artifacts verwendet. (Dies unterscheidet sich von dem Bucket, der für eine S3-Quellaktion verwendet wird.) Wenn sich der S3-Artefakt-Bucket in einem anderen Konto befindet als das Konto für Ihre Pipeline, stellen Sie sicher, dass der S3-Artefakt-Bucket denjenigen gehört AWS-Konten , die sicher und zuverlässig sind.
**Wichtig**
Viele der Aktionen, die Sie Ihrer Pipeline in diesem Verfahren hinzufügen, beinhalten AWS Ressourcen, die Sie erstellen müssen, bevor Sie die Pipeline erstellen. AWS Ressourcen für Ihre Quellaktionen müssen immer in derselben AWS Region erstellt werden, in der Sie Ihre Pipeline erstellen. Wenn Sie Ihre Pipeline beispielsweise in der Region USA Ost (Ohio) erstellen, muss sich Ihr CodeCommit Repository in der Region USA Ost (Ohio) befinden.
Sie können beim Erstellen Ihrer Pipeline regionsübergreifende Aktionen hinzufügen. AWS Ressourcen für regionsübergreifende Aktionen müssen sich in derselben AWS Region befinden, in der Sie die Aktion ausführen möchten. Weitere Informationen finden Sie unter [Fügen Sie eine regionsübergreifende Aktion hinzu in CodePipeline](actions-create-cross-region.md).
In diesem Beispiel wird die Beispielpipeline mit einer Quellaktion GitHub (Version2) und einer CodeBuild Build-Aktion verwendet, bei der die Eingangsbedingung für die Buildphase nach Variablen sucht.
## Voraussetzungen
Sie benötigen Folgendes, um starten zu können:
+ Erstellen Sie ein GitHub Repository mit Ihrem GitHub Konto.
+ Halten Sie Ihre GitHub Anmeldedaten bereit. Wenn Sie den verwenden AWS-Managementkonsole , um eine Verbindung herzustellen, werden Sie aufgefordert, sich mit Ihren GitHub Anmeldeinformationen anzumelden.
+ Eine Verbindung zu Ihrem Repository, die GitHub (per GitHub App) als Quellaktion für Ihre Pipeline eingerichtet werden soll. Informationen zum Herstellen einer Verbindung zu Ihrem GitHub Repository finden Sie unter[GitHub Verbindungen](connections-github.md).
## Schritt 1: Erstellen Sie eine Beispielquelldatei und fügen Sie sie Ihrem GitHub Repository hinzu
In diesem Abschnitt erstellen Sie Ihre Beispielquelldatei und fügen sie dem Repository hinzu, das die Pipeline für Ihre Quellphase verwendet. Für dieses Beispiel erstellen Sie Folgendes und fügen es hinzu:
+ Die Datei `README.md`.
Nachdem Sie Ihr GitHub Repository erstellt haben, gehen Sie wie folgt vor, um Ihre README-Datei hinzuzufügen.
1. Loggen Sie sich in Ihr GitHub Repository ein und wählen Sie Ihr Repository aus.
1. Um eine neue Datei zu erstellen, wählen **Sie Datei hinzufügen** und dann **Neue Datei erstellen**. Benennen Sie die Datei `README.md` und fügen Sie den folgenden Text hinzu.
```
This is a GitHub repository!
```
1. Wählen Sie **Commit changes (Änderungen übernehmen)** aus. Fügen Sie für die Zwecke dieses Tutorials eine Commit-Nachricht hinzu, die das großgeschriebene Wort „Update“ wie im folgenden Beispiel enthält:
```
Update to source files
```
**Anmerkung**
Bei der Regelprüfung auf Zeichenketten wird zwischen Groß- und Kleinschreibung unterschieden.
Die Datei `README.md` muss sich im Stammverzeichnis Ihres Repositorys befinden.
## Schritt 2: Erstellen der Pipeline
In diesem Abschnitt erstellen Sie eine Pipeline mit den folgenden Aktionen:
+ Eine Quellstufe mit einer Verbindung zu Ihrem GitHub Repository und einer Aktion.
+ Eine CodeBuild Build-Phase, in der für die Phase eine On-Entry-Bedingung für die Regel zur Überprüfung der Variablen konfiguriert ist.
**So erstellen Sie mit dem Assistenten eine Pipeline**
1. Melden Sie sich bei der CodePipeline Konsole an unter [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Wählen Sie auf der Seite **Welcome (Willkommen)** die Option **Getting started (Erste Schritte)** oder auf der Seite **Pipelines** die Option **Create pipeline (Pipeline erstellen)**.
1. Wählen Sie auf der Seite **Schritt 1: Erstellungsoption auswählen** unter **Erstellungsoptionen** die Option **Benutzerdefinierte Pipeline erstellen** aus. Wählen Sie **Weiter** aus.
1. Geben Sie in **Schritt 2: Pipeline-Einstellungen auswählen** im Feld **Pipeline-Name** den Wert ein**MyVarCheckPipeline**.
1. CodePipeline bietet Pipelines vom Typ V1 und V2, die sich in Eigenschaften und Preis unterscheiden. Der Typ V2 ist der einzige Typ, den Sie in der Konsole auswählen können. Weitere Informationen finden Sie unter [Pipeline-Typen](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Informationen zur Preisgestaltung für finden Sie CodePipeline unter [Preisgestaltung](https://aws.amazon.com/codepipeline/pricing/).
1. Wählen Sie unter **Service role (Servicerolle)** die Option **New service role (Neue Servicerolle)**.
**Anmerkung**
Wenn Sie stattdessen Ihre bestehende CodePipeline Servicerolle verwenden möchten, stellen Sie sicher, dass Sie die `codeconnections:UseConnection` IAM-Berechtigung zu Ihrer Servicerollenrichtlinie hinzugefügt haben. Anweisungen für die CodePipeline Servicerolle finden [Sie unter Hinzufügen von Berechtigungen zur CodePipeline Servicerolle](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Lassen Sie die Standardwerte bei **Erweiterte Einstellungen** unverändert.
Wählen Sie **Weiter** aus.
1. **Fügen Sie auf der Seite Schritt 3: Quellstufe** hinzufügen eine Quellstufe hinzu:
1. Wählen Sie **unter Quellanbieter** die Option **GitHub(über GitHub App)** aus.
1. Wählen Sie unter **Verbindung** eine bestehende Verbindung aus oder erstellen Sie eine neue. Informationen zum Erstellen oder Verwalten einer Verbindung für Ihre GitHub Quellaktion finden Sie unter[GitHub Verbindungen](connections-github.md).
1. Wählen Sie im Feld **Repository name (Repositoryname)** den Namen Ihres GitHub -Repositorys aus.
1. Wählen Sie unter **Branch-Name** den Repository-Branch aus, den Sie verwenden möchten.
1. Vergewissern Sie sich, dass die Option **Kein Trigger** ausgewählt ist.
Wählen Sie **Weiter** aus.
1. **Fügen Sie in Schritt 4: Build-Phase** hinzufügen eine Build-Phase hinzu:
1. Wählen Sie unter **Build provider (Build-Anbieter)** die Option **AWS CodeBuild** aus. Belassen Sie unter **Region** als Standardeinstellung die Pipeline-Region.
1. Wählen Sie **Create project** (Projekt erstellen) aus.
1. Geben Sie unter **Project name (Projektname)** einen Namen für dieses Build-Projekt ein.
1. Wählen Sie für **Environment image (Umgebungs-Image)** die Option **Managed image (Verwaltetes Image)** aus. Wählen Sie für **Operating system (Betriebssystem)** die Option **Ubuntu** aus.
1. Wählen Sie unter **Runtime (Laufzeit)** die Option **Standard** aus. **Wählen Sie für **Image** aus:5.0aws/codebuild/standard.**
1. Wählen Sie unter **Service role (Servicerolle)** die Option **New service role (Neue Servicerolle)** aus.
**Anmerkung**
Notieren Sie sich den Namen Ihrer Servicerolle CodeBuild . Sie benötigen den Rollennamen für den letzten Schritt in diesem Tutorial.
1. Wählen Sie unter **BuildSpec** bei **Build specifications (Build-Spezifikationen)** die Option **Insert build commands (Build-Befehle einfügen)** aus. Wählen Sie **Zum Editor wechseln** und fügen Sie Folgendes unter **Build-Befehle ein**.
```
version: 0.2
#env:
#variables:
# key: "value"
# key: "value"
#parameter-store:
# key: "value"
# key: "value"
#git-credential-helper: yes
phases:
install:
#If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
#If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
runtime-versions:
nodejs: 12
#commands:
# - command
# - command
#pre_build:
#commands:
# - command
# - command
build:
commands:
-
#post_build:
#commands:
# - command
# - command
artifacts:
files:
- '*'
# - location
name: $(date +%Y-%m-%d)
#discard-paths: yes
#base-directory: location
#cache:
#paths:
# - paths
```
1. Wählen Sie **Weiter zu CodePipeline**. Dadurch kehren Sie zur CodePipeline Konsole zurück und erstellen ein CodeBuild Projekt, das Ihre Build-Befehle für die Konfiguration verwendet. Das Build-Projekt verwendet eine Servicerolle zur Verwaltung von AWS-Service Berechtigungen. Dieser Vorgang kann einige Minuten dauern.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie in **Schritt 5: Testphase hinzufügen** die Option **Testphase überspringen** aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut **Überspringen** wählen.
Wählen Sie **Weiter** aus.
1. Wählen Sie auf der Seite **Schritt 6: Bereitstellungsphase hinzufügen** die Option **Bereitstellungsphase überspringen** aus und akzeptieren Sie dann die Warnmeldung, indem Sie erneut auf **Überspringen** klicken. Wählen Sie **Weiter** aus.
1. Wählen **Sie auf Schritt 7: Überprüfen** die Option **Pipeline erstellen** aus.
## Schritt 2: Bearbeiten Sie die Erstellungsphase, um die Bedingung und die Regel hinzuzufügen
In diesem Schritt bearbeiten Sie die Phase, um der Regel zur Überprüfung der Variablen eine Bedingung bei der Eingabe hinzuzufügen.
1. Wählen Sie Ihre Pipeline und dann **Bearbeiten** aus. Wählen Sie, ob Sie in der Erstellungsphase eine Eingaberegel hinzufügen möchten.
Wählen Sie **unter Regelanbieter** die Option **VariableCheck**.
1. **Geben Sie im Feld Variable die Variable oder Variablen ein, die Sie überprüfen möchten.** Geben Sie im Feld **Wert** den Zeichenfolgenwert ein, der mit der aufgelösten Variablen verglichen werden soll. In den folgenden Beispielbildschirmen wird eine Regel für eine Gleichheitsprüfung und eine weitere Regel für eine Prüfung auf „Enthält“ erstellt.
![\[Die Seite zur Regelerstellung für die Prüfung der „Gleich“ -Variablen\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/varcheck-tut-create-rule-equals.png)
![\[Die Seite zur Regelerstellung für die Prüfung der Variablen „enthält“\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/varcheck-tut-create-rule-contains.png)
1. Wählen Sie **Speichern**.
Wählen Sie **Fertig** aus.
## Schritt 3: Führen Sie die Pipeline aus und sehen Sie sich die aufgelösten Variablen an
In diesem Schritt sehen Sie sich die aufgelösten Werte und Ergebnisse der Regel zur Überprüfung von Variablen an.
1. Sehen Sie sich den aufgelösten Lauf an, nachdem die Regelprüfung erfolgreich war, wie im folgenden Beispiel gezeigt.
![\[Der erfolgreiche Lauf\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/varcheck-tut-run-succeeded.png)
1. Sehen Sie sich die Variableninformationen auf der Registerkarte **Timeline** an.
![\[Die Verlaufsseite mit der Registerkarte „Zeitleiste“ mit Variablen war erfolgreich\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/varcheck-tut-history.png)