AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html). 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: Den Build von Rocket Software (ehemals Micro Focus) für die BankDemo Beispielanwendung einrichten AWS Mainframe-Modernisierung bietet Ihnen die Möglichkeit, Builds und Continuous integration/continuous Delivery (CI/CD) -Pipelines für Ihre migrierten Anwendungen einzurichten. Diese Builds und Pipelines verwenden AWS CodeBuild, AWS CodeCommit und stellen diese Funktionen bereit. AWS CodePipeline CodeBuild ist ein vollständig verwalteter Build-Service, der Ihren Quellcode kompiliert, Komponententests durchführt und Artefakte erzeugt, die sofort einsatzbereit sind. CodeCommit ist ein Versionskontrolldienst, mit dem Sie Git-Repositorys privat in der Cloud speichern und verwalten können. AWS CodePipeline ist ein Dienst zur kontinuierlichen Bereitstellung, mit dem Sie die zur Veröffentlichung Ihrer Software erforderlichen Schritte modellieren, visualisieren und automatisieren können. In diesem Tutorial wird gezeigt, wie Sie AWS CodeBuild den Quellcode der BankDemo Beispielanwendung aus Amazon S3 kompilieren und den kompilierten Code anschließend zurück nach Amazon S3 exportieren. AWS CodeBuild ist ein vollständig verwalteter Continuous Integration-Service, der Quellcode kompiliert, Tests durchführt und Softwarepakete erstellt, die sofort einsatzbereit sind. Mit CodeBuild können Sie vorgefertigte Build-Umgebungen verwenden oder benutzerdefinierte Build-Umgebungen erstellen, die Ihre eigenen Build-Tools verwenden. In diesem Demo-Szenario wird die zweite Option verwendet. Es besteht aus einer CodeBuild Build-Umgebung, die ein vorgefertigtes Docker-Image verwendet. **Wichtig** Bevor Sie mit Ihrem Mainframe-Modernisierungsprojekt beginnen, empfehlen wir Ihnen, sich über das [AWS Migration Acceleration Program (MAP) für Mainframe zu informieren oder sich an [AWS Mainframe-Spezialisten](mailto: mainframe@amazon.com)](https://aws.amazon.com/migration-acceleration-program/mainframe/) zu wenden, um mehr über die zur Modernisierung einer Mainframe-Anwendung erforderlichen Schritte zu erfahren. **Topics** + [Voraussetzungen](#tutorial-build-mf-prerequisites) + [Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto](#tutorial-build-mf-assets) + [Schritt 2: Amazon S3 S3-Buckets erstellen](#tutorial-build-mf-s3) + [Schritt 3: Erstellen Sie die Build-Spezifikationsdatei](#tutorial-build-mf-spec) + [Schritt 4: Laden Sie die Quelldateien hoch](#tutorial-build-mf-upload) + [Schritt 5: IAM-Richtlinien erstellen](#tutorial-build-mf-IAM-policy) + [Schritt 6: Erstellen Sie eine IAM-Rolle](#tutorial-build-mf-IAM-role) + [Schritt 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an](#tutorial-build-mf-attach) + [Schritt 8: Erstellen Sie das CodeBuild Projekt](#tutorial-build-mf-create-project) + [Schritt 9: Starten Sie den Build](#tutorial-build-mf-start) + [Schritt 10: Laden Sie die Ausgabeartefakte herunter](#tutorial-build-mf-download-output) + [Bereinigen von Ressourcen](#tutorial-build-mf-clean) ## Voraussetzungen Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen. + Laden Sie die [BankDemo Beispielanwendung](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) herunter und entpacken Sie sie in einen Ordner. Der Quellordner enthält COBOL-Programme und Copybooks sowie Definitionen. Er enthält auch einen JCL-Ordner als Referenz, obwohl Sie JCL nicht erstellen müssen. Der Ordner enthält auch die für den Build erforderlichen Metadateien. + Wählen Sie in der AWS Mainframe Modernization Console die Option **Tools** aus. Wählen Sie unter **Analysis, Development and Build Assets** die Option **Assets mit meinem AWS-Konto teilen** aus. ## Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto In diesem Schritt stellen Sie sicher, dass Sie die Build-Assets mit Ihrem AWS Konto teilen, insbesondere in der Region, in der die Assets verwendet werden. 1. Öffnen Sie die AWS Mainframe-Modernisierungskonsole unter [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/). 1. Wählen Sie in der linken Navigationsleiste **Tools** aus. 1. Wählen Sie unter **Assets analysieren, entwickeln und erstellen** die Option **Assets mit meinem AWS Konto teilen** aus. **Wichtig** Sie müssen diesen Schritt in jeder AWS Region, in der Sie Builds erstellen möchten, einmal ausführen. ## Schritt 2: Amazon S3 S3-Buckets erstellen In diesem Schritt erstellen Sie zwei Amazon S3 S3-Buckets. Der erste ist ein Eingabe-Bucket für den Quellcode und der andere ist ein Ausgabe-Bucket für die Build-Ausgabe. Weitere Informationen finden Sie unter [Erstellen, Konfigurieren und Arbeiten mit Amazon S3 S3-Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) im *Amazon S3 S3-Benutzerhandbuch*. 1. Um den Eingabe-Bucket zu erstellen, melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie **Create Bucket**. 1. Geben Sie in der **allgemeinen Konfiguration** einen Namen für den Bucket an und geben Sie an AWS-Region , wo Sie den Bucket erstellen möchten. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-input-bucket` Where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre AWS-Konto ID. **Anmerkung** Wenn Sie den Bucket in einer anderen Region als USA AWS-Region Ost (Nord-Virginia) erstellen, geben Sie den `LocationConstraint` Parameter an. Weitere Informationen finden Sie unter [Create Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) in der *Amazon Simple Storage Service API-Referenz*. 1. Behalten Sie alle anderen Einstellungen bei und wählen Sie **Create Bucket**. 1. Wiederholen Sie die Schritte 1—3, um den Ausgabe-Bucket zu erstellen. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-output-bucket` where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre AWS-Konto ID. Welche Namen Sie auch immer für diese Buckets wählen, achten Sie darauf, sie in diesem Tutorial zu verwenden. ## Schritt 3: Erstellen Sie die Build-Spezifikationsdatei In diesem Schritt erstellen Sie eine Build-Spezifikationsdatei,. Diese Datei enthält Build-Befehle und zugehörige Einstellungen im YAML-Format CodeBuild zum Ausführen des Builds. Weitere Informationen finden Sie unter [Referenz zur Build-Spezifikation für CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) im *AWS CodeBuild Benutzerhandbuch*. 1. Erstellen Sie als Voraussetzung eine Datei mit dem Namen `buildspec.yml` in dem Verzeichnis, das Sie entpackt haben. 1. Fügen Sie der Datei den folgenden Inhalt hinzu und speichern Sie sie. Für diese Datei sind keine Änderungen erforderlich. ``` version: 0.2 env: exported-variables: - CODEBUILD_BUILD_ID - CODEBUILD_BUILD_ARN phases: install: runtime-versions: python: 3.7 pre_build: commands: - echo Installing source dependencies... - ls -lR $CODEBUILD_SRC_DIR/source build: commands: - echo Build started on `date` - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target post_build: commands: - ls -lR $CODEBUILD_SRC_DIR/target - echo Build completed on `date` artifacts: files: - $CODEBUILD_SRC_DIR/target/** ``` Hier `$CODEBUILD_SRC_DIR/target` sind Umgebungsvariablen `CODEBUILD_BUILD_ID` `CODEBUILD_BUILD_ARN``$CODEBUILD_SRC_DIR/source`, und innerhalb verfügbar CodeBuild. Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). Zu diesem Zeitpunkt sollte Ihr Verzeichnis so aussehen. ``` (root directory name) |-- build.xml |-- buildspec.yml |-- LICENSE.txt |-- source |... etc. ``` 1. Komprimieren Sie den Inhalt des Ordners in eine Datei mit dem Namen`BankDemo.zip`.. Für dieses Tutorial können Sie den Ordner nicht komprimieren. Stattdessen komprimieren Sie den Inhalt des Ordners in die Datei`BankDemo.zip`. ## Schritt 4: Laden Sie die Quelldateien hoch In diesem Schritt laden Sie den Quellcode für die BankDemo Beispielanwendung in Ihren Amazon S3 S3-Eingabe-Bucket hoch. 1. Melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie im linken Navigationsbereich **Buckets** aus. Wählen Sie dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben. 1. Wählen Sie unter **Objekte** die Option **Hochladen** aus. 1. Wählen Sie im Bereich **Dateien und Ordner** die Option **Dateien hinzufügen** aus. 1. Navigieren Sie zu Ihrer `BankDemo.zip` Datei und wählen Sie sie aus. 1. Klicken Sie auf **Upload**. ## Schritt 5: IAM-Richtlinien erstellen In diesem Schritt erstellen Sie zwei [IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Eine Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, auf das Docker-Image zuzugreifen und es zu verwenden, das die Build-Tools von Rocket Software enthält. Diese Richtlinie ist nicht auf Kunden zugeschnitten. Die andere Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, mit den Eingabe- und Ausgabe-Buckets sowie mit den generierten [ CloudWatch Amazon-Protokollen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) zu interagieren. CodeBuild *Weitere Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Bearbeiten von IAM-Richtlinien im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html).* **So erstellen Sie eine Richtlinie für den Zugriff auf Docker-Images** 1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Richtlinien-Editor ein. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ecr:GetAuthorizationToken" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ecr:BatchCheckLayerAvailability", "ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage" ], "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools" }, { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-m2-repo-*--prod" } ] } ``` ------ 1. Geben Sie einen Namen für die Richtlinie ein, z. B. `m2CodeBuildPolicy` **Um eine Richtlinie zu erstellen, die es AWS Mainframe Modernization ermöglicht, mit Buckets und Logs zu interagieren** 1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Policy-Editor ein. Stellen Sie sicher, dass Sie `regionId` auf die AWS-Region und `accountId` auf Ihre AWS-Konto aktualisieren. 1. Geben Sie einen Namen für die Richtlinie ein, `BankdemoCodeBuildRolePolicy` z. B. ## Schritt 6: Erstellen Sie eine IAM-Rolle In diesem Schritt erstellen Sie eine neue [IAM-Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html), mit der Sie für Sie mit AWS Ressourcen interagieren können CodeBuild , nachdem Sie die zuvor erstellten IAM-Richtlinien mit dieser neuen IAM-Rolle verknüpft haben. Informationen zum Erstellen einer Servicerolle finden Sie unter [Creating a Role to Delegate Permissions to an AWS Service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) im *IAM-Benutzerhandbuch*,. 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **Rolle erstellen** aus. 1. Wählen Sie unter **Vertrauenswürdiger Entitätstyp** die Option **AWS-Service** aus. 1. Wählen **Sie unter Anwendungsfälle für andere AWS-Services** die Option aus **CodeBuild**, und wählen Sie dann **CodeBuild**erneut. 1. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Add permissions** (Berechtigungen hinzufügen) die Option **Next** (Weiter) aus. Sie weisen der Rolle später eine Richtlinie zu. 1. Geben Sie unter **Rollendetails** einen Namen für die Rolle ein, `BankdemoCodeBuildServiceRole` z. B. 1. Stellen **Sie unter Vertrauenswürdige Entitäten auswählen** sicher, dass das Richtliniendokument wie folgt aussieht: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Wählen Sie **Rolle erstellen** aus. ## Schritt 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an In diesem Schritt fügen Sie die beiden IAM-Richtlinien, die Sie zuvor erstellt haben, der `BankdemoCodeBuildServiceRole` IAM-Rolle hinzu. 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **unter Rollen** die Rolle aus, die Sie zuvor erstellt haben, `BankdemoCodeBuildServiceRole` z. B. 1. Wählen Sie unter **Berechtigungsrichtlinien die** Option **Berechtigungen hinzufügen** und dann **Richtlinien anhängen** aus. 1. Wählen Sie **unter Andere Berechtigungsrichtlinien** die Richtlinien aus, die Sie zuvor erstellt haben, z. B. `m2CodeBuildPolicy` und`BankdemoCodeBuildRolePolicy`. 1. Wählen Sie **Richtlinien anfügen**. ## Schritt 8: Erstellen Sie das CodeBuild Projekt In diesem Schritt erstellen Sie das CodeBuild Projekt. 1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie **Build-Projekt erstellen**. 1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein, `codebuild-bankdemo-project` z. B. 1. Wählen Sie im Abschnitt **Quelle** für **Quellanbieter** **Amazon S3** und dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben, zum Beispiel`codebuild-regionId-accountId-input-bucket`. 1. Geben Sie im Feld **S3-Objektschlüssel oder S3-Ordner** den Namen der ZIP-Datei ein, die Sie in den S3-Bucket hochgeladen haben. In diesem Fall lautet der Dateiname`bankdemo.zip`. 1. Wählen Sie im Bereich **Umgebung** die Option **Benutzerdefiniertes Bild** aus. 1. Wählen Sie im Feld **Umgebungstyp** die Option **Linux** aus. 1. Wählen Sie unter **Image-Registrierung** die Option **Andere Registrierung** aus. 1. Im Feld **Externe Registrierungs-URL** + Für Rocket Software v9: Geben Sie ein`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`. Wenn Sie eine andere AWS Region mit Rocket Software v9 verwenden, können Sie auch angeben` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`, in welcher AWS Region der AWS Mainframe-Modernisierungsservice verfügbar ist (z. B.). `eu-west-3` + Für Rocket Software v8: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1` + Für Rocket Software v7: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10` 1. Wählen Sie unter **Servicerolle** die Option **Bestehende Servicerolle** und wählen Sie im Feld **Rollen-ARN** die Servicerolle aus, die Sie zuvor erstellt haben, zum Beispiel`BankdemoCodeBuildServiceRole`. 1. Wählen Sie im Abschnitt **Buildspec** die Option Buildspec-Datei **verwenden** aus. 1. Wählen Sie im Abschnitt **Artifacts** unter **Type** **Amazon S3** und dann Ihren Output-Bucket aus, zum Beispiel`codebuild-regionId-accountId-output-bucket`. 1. Geben Sie im Feld **Name** den Namen eines Ordners im Bucket ein, der die Build-Ausgabeartefakte enthalten soll, `bankdemo-output.zip` z. B. 1. Wählen Sie unter **Verpackung von Artefakten** die Option **Zip** aus. 1. Wählen Sie **Create build project (Build-Projekt erstellen)** aus. ## Schritt 9: Starten Sie den Build In diesem Schritt starten Sie den Build. 1. Loggen Sie sich in die CodeBuild Konsole ein. 1. Wählen Sie im linken Navigationsbereich die Option **Projekte erstellen** aus. 1. Wählen Sie das Build-Projekt aus, das Sie zuvor erstellt haben, `codebuild-bankdemo-project` z. B. 1. Wählen Sie **Start build (Build starten)**. Mit diesem Befehl wird der Build gestartet. Der Build wird asynchron ausgeführt. Die Ausgabe des Befehls ist eine JSON-Datei, die das Attribut id enthält. Diese Attribut-ID ist ein Verweis auf die CodeBuild Build-ID des Builds, den Sie gerade gestartet haben. Sie können den Status des Builds in der CodeBuild Konsole einsehen. Sie können auch detaillierte Protokolle zur Build-Ausführung in der Konsole einsehen. Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Anzeigen detaillierter Build-Informationen](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html). Wenn die aktuelle Phase ABGESCHLOSSEN ist, bedeutet dies, dass Ihr Build erfolgreich abgeschlossen wurde und Ihre kompilierten Artefakte auf Amazon S3 bereit sind. ## Schritt 10: Laden Sie die Ausgabeartefakte herunter In diesem Schritt laden Sie die Ausgabeartefakte von Amazon S3 herunter. Das Build-Tool von Rocket Software kann verschiedene Typen von ausführbaren Dateien erstellen. In diesem Tutorial generiert es gemeinsam genutzte Objekte. 1. Melden Sie sich bei der Amazon S3 S3-Konsole an. 1. Wählen Sie im Abschnitt **Buckets** role="bold"> den Namen Ihres Ausgabe-Buckets aus, zum Beispiel. `codebuild-regionId-accountId-output-bucket` 1. **Wählen Sie „Herunterladen“ role="bold">.** 1. Entpacken Sie die heruntergeladene -Datei. Navigieren Sie zum Zielordner, um die Build-Artefakte zu sehen. Dazu gehören die gemeinsam genutzten `.so` Linux-Objekte. ## Bereinigen von Ressourcen Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, um zusätzliche Kosten zu vermeiden. Führen Sie dazu die folgenden Schritte aus: + Löschen Sie die S3-Buckets, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) im *Amazon Simple Storage Service-Benutzerhandbuch*. + Löschen Sie die IAM-Richtlinien, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie die IAM-Rolle, die Sie für dieses Tutorial erstellt haben. Weitere Informationen zum Löschen von Rollen finden Sie unter [Löschen von Rollen oder Instance-Profilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie das CodeBuild Projekt, das Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie [ CodeBuildim *AWS CodeBuild Benutzerhandbuch* unter Löschen eines Build-Projekts](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html).