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. # Zugriff AWS-Services von IBM z/OS durch Installation des AWS CLI *Souma Ghosh, Paulo Vitor Pereira und Phil de Valence, Amazon Web Services* ## Zusammenfassung The [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) ist ein Open-Source-Tool zur Verwaltung mehrerer AWS Dienste mithilfe von Befehlen in einer Befehlszeilen-Shell. Mit minimaler Konfiguration können Sie Befehle von Befehlszeilensitzungen wie der Befehlszeile, dem Terminal und der Bash-Shell aus ausführen, um Funktionen zu implementieren, die der browserbasierten AWS-Managementkonsole Version entsprechen. Alle Administrations-, Management- und Zugriffsfunktionen von AWS Infrastructure as a Service (IaaS) in der AWS-Managementkonsole sind in der AWS API und AWS CLI verfügbar. Sie können den AWS CLI auf einem z/OS IBM-Mainframe installieren, um von z/OS AWS-Services aus direkt darauf zuzugreifen, ihn zu verwalten und mit ihm zu interagieren. Das AWS CLI ermöglicht es Benutzern und Anwendungen, verschiedene Aufgaben auszuführen, wie z. B.: + Übertragung von Dateien oder Datensätzen zwischen z/OS einem Amazon Simple Storage Service (Amazon S3) -Objektspeicher und Anzeigen des Inhalts von Buckets + Starten und Stoppen verschiedener AWS Ressourcen, z. B. Starten eines Batch-Jobs in einer Umgebung AWS Mainframe Modernization + Aufruf einer AWS Lambda Funktion zur Implementierung allgemeiner Geschäftslogik + Integration mit Diensten für künstliche Intelligenz und maschinelles Lernen (AI/ML) sowie Analysedienste Dieses Muster beschreibt, wie Sie das auf Benutzerebene oder AWS CLI auf z/OS. You can install it globally, so it's available to all z/OS Benutzerebene installieren, konfigurieren und verwenden. Das Muster beschreibt auch, wie der AWS CLI in einer interaktiven Befehlszeilensitzung von z/OS Unix System Services (USS) oder als Batch-Job verwendet wird. ## Voraussetzungen und Einschränkungen **Voraussetzungen** + **Netzwerkkommunikation von z/OS bis AWS** Standardmäßig AWS CLI sendet der Anfragen unter Verwendung AWS-Services von HTTPS an TCP-Port 443. Um das AWS CLI erfolgreich verwenden zu können, müssen Sie in der Lage sein, ausgehende Verbindungen über den TCP-Port 443 herzustellen. Sie können jeden der folgenden z/OS USS-Befehle (einige davon sind möglicherweise nicht in Ihrer Umgebung installiert) verwenden, um die Netzwerkkonnektivität von bis zu zu zu z/OS zu zu AWS testen: ``` ping amazonaws.com dig amazonaws.com traceroute amazonaws.com curl -k https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html ``` + **AWS Anmeldedaten** Um mit den AWS Cloud Diensten von z/OS kommunizieren zu können, AWS CLI müssen Sie einige Anmeldeinformationen mit Rechten für den Zugriff auf das Ziel AWS-Konto konfigurieren. Für programmatische Befehle können Sie Zugriffsschlüssel verwenden, die aus einer Zugriffsschlüssel-ID und einem geheimen Zugriffsschlüssel bestehen. AWS Wenn Sie noch keine Zugriffsschlüssel besitzen, können Sie diese über die AWS-Managementkonsole erstellen. Es hat sich bewährt, die Zugriffsschlüssel für den AWS-Konto Root-Benutzer für keine Aufgabe zu verwenden, es sei denn, der Root-Benutzer ist erforderlich. [Erstellen Sie stattdessen einen neuen Administrator-IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) und [bereiten Sie sich auf die Berechtigungen mit den geringsten](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#LeastPrivilege) Rechten vor****, um den Benutzer mit Zugriffsschlüsseln einzurichten. Nachdem Sie den Benutzer erstellt haben, können Sie [eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel für diesen Benutzer erstellen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) + **IBM Python für z/OS** Das AWS CLI erfordert Python 3.8 oder höher. IBM hat Python für die Ausführung z/OS mit [IBM Open Enterprise Python for z/OS](https://www.ibm.com/products/open-enterprise-python-zos) aktiviert. [IBM Open Enterprise Python ist kostenlos über Shopz SMP/E erhältlich, oder Sie können die PAX-Datei von der IBM-Website herunterladen.](https://www.ibm.com/account/reg/signup?formid=urx-49465) Anweisungen finden Sie in der [Installations- und Konfigurationsdokumentation](https://www.ibm.com/docs/en/python-zos) für IBM Open Enterprise Python for z/OS. **Einschränkungen** + Die in diesem Muster enthaltenen Installationsanweisungen gelten **nur für AWS CLI Version 1.** Die neueste Version von AWS CLI ist Version 2. Dieses Muster verwendet jedoch die ältere Version, da die Installationsmethoden für Version 2 unterschiedlich sind und die für Version 2 verfügbaren binären ausführbaren Dateien nicht mit dem z/OS System kompatibel sind. **Produktversionen** + AWS CLI Version 1 + Python 3.8 oder höher ## Architektur **Technologie-Stack** + Mainframe, auf dem z/OS ausgeführt wird + z/OS Mainframe-UNIX-Systemdienste (USS) + Mainframe Open MVS (OMVS) — Befehlsschnittstelle für die z/OS UNIX-Shell-Umgebung + Mainframe-Festplatte, z. B. ein Direct-Access-Speichergerät (DASD) + AWS CLI **Zielarchitektur** Das folgende Diagramm zeigt eine AWS CLI Bereitstellung auf IBM z/OS. Sie können die AWS CLI in einer interaktiven Benutzersitzung wie SSH und in Telnet-Sitzungen aufrufen. Sie können ihn auch von einem Batchjob aus aufrufen, indem Sie die Job Control Language (JCL) verwenden, oder von einem beliebigen Programm aus, das einen Unix-Shell-Befehl aufrufen kann. z/OS ![\[AWS-CLI auf einem z/OS IBM-Mainframe, der auf AWS-Services zugreift.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/c3883500-bd00-4c56-982a-26d5e0b8b093.png) Der AWS CLI kommuniziert mit AWS-Service Endpunkten über ein Netzwerk. TCP/IP Diese Netzwerkverbindung kann über das Internet oder über eine private AWS Direct Connect Verbindung vom Kundenrechenzentrum zu AWS Cloud den Rechenzentren erfolgen. Die Kommunikation wird mit AWS Anmeldeinformationen authentifiziert und verschlüsselt. **Automatisierung und Skalierung** Sie können die Funktionen von und AWS-Service mit dem erkunden AWS CLI und USS-Shell-Skripte entwickeln, um Ihre AWS Ressourcen von z/OS aus zu verwalten. Sie können auch AWS CLI Befehle und Shell-Skripte in der z/OS Batch-Umgebung ausführen und Batch-Jobs automatisieren, sodass sie nach einem bestimmten Zeitplan ausgeführt werden, indem Sie sie in Mainframe-Scheduler integrieren. AWS CLI Befehle oder Skripten können innerhalb von Parametern (PARMs) und Prozeduren (PROCs) codiert und skaliert werden, indem man dem Standardansatz folgt, PARM oder PROC von verschiedenen Batchjobs mit unterschiedlichen Parametern aus aufzurufen. ## Tools + [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) ist ein Open-Source-Tool, mit dem Sie AWS-Services über Befehle in Ihrer Befehlszeilen-Shell interagieren können. ## Best Practices + Beschränken Sie aus Sicherheitsgründen die Zugriffsberechtigungen auf das USS-Verzeichnis, in dem die AWS Zugangsschlüsseldetails gespeichert sind. Erlauben Sie den Zugriff nur Benutzern oder Programmen, die den verwenden AWS CLI. + Verwenden Sie die AWS-Konto Root-Benutzerzugriffstasten für keine Aufgabe. [Erstellen Sie stattdessen einen neuen Administrator-IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) für sich selbst und richten Sie ihn mit Zugriffsschlüsseln ein. | | | IAM-Benutzer verfügen über langfristige Anmeldeinformationen, die ein Sicherheitsrisiko darstellen. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden. | | --- | ## Epen ### Installieren Sie AWS CLI Version 1 auf USS z/OS | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Installieren Sie Python 3.8 oder höher. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Administrator z/OS | | Legen Sie die USS-Umgebungsvariablen fest. | Fügen Sie dem Profil Umgebungsvariablen hinzu. Sie können diese entweder der `/u/cliuser/.profile` Datei für einen einzelnen Benutzer (`cliuser`) oder der `/etc/profile` Datei für alle Benutzer hinzufügen.Dieses Muster geht davon aus, dass Python in dem `/u/awscli/python` Verzeichnis installiert wurde. Wenn Ihr Installationsverzeichnis anders ist, aktualisieren Sie den Code entsprechend.
# Python configuration
export BPXKAUTOCVT='ON'
export CEERUNOPTS='FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)'
export TAGREDIR_ERR=txt
export TAGREDIR_IN=txt
export TAGREDIR_OUT=txt

# AWS CLI configuration
export PATH=/u/cliuser/python/bin:$PATH
export PYTHONPATH=/u/cliuser/python:$PYTHONPATH
| Mainframe-Administrator z/OS | | Testen Sie die Python-Installation. | Führen Sie den **Python-Befehl** aus:
python --version
Die Ausgabe sollte bestätigen, dass Sie Python 3.8 oder höher korrekt installiert haben. | Mainframe-Administrator z/OS | | Überprüfen oder installieren Sie **Pip**. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Administrator z/OS | | Installieren Sie AWS CLI Version 1. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Administrator z/OS | ### Konfigurieren Sie den AWS CLI Zugriff von z/OS aus | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Konfigurieren Sie die AWS Zugriffstasten, die Standardregion und die Ausgabe. | In der [AWS CLI Dokumentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) werden verschiedene Optionen für die Einrichtung des AWS Zugriffs beschrieben. Sie können eine Konfiguration wählen, die den Standards Ihrer Organisation entspricht. In diesem Beispiel wird die Konfiguration mit kurzfristigen Anmeldeinformationen verwendet.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | AWS-Administrator, z/OS Mainframe-Administrator, Mainframe-Entwickler z/OS | | Testen Sie das. AWS CLI | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Administrator, Mainframe-Entwickler z/OS z/OS | ### Option 1 ‒ Daten interaktiv aus einer USS-Sitzung von USS zu Amazon S3 übertragen | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Laden Sie die CSV-Beispieldatei herunter und übertragen Sie sie. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | App-Entwickler, Mainframe-Entwickler z/OS | | Erstellen Sie einen S3-Bucket und laden Sie die CSV-Datei hoch. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | App-Entwickler, z/OS Mainframe-Entwickler | | Sehen Sie sich den S3-Bucket und die hochgeladene Datei an. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)Weitere Informationen zum Hochladen von Objekten finden Sie unter [Erste Schritte mit Amazon S3 in der Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html) S3-Dokumentation. | Allgemeines AWS | | Führen Sie eine SQL-Abfrage für eine Amazon Athena Athena-Tabelle aus. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)In der Ausgabe der SQL-Abfrage wird der Inhalt Ihrer CSV-Datei angezeigt. | Allgemein AWS, App-Entwickler | ### Option 2 ‒ Daten mithilfe von Batch-JCL von USS nach Amazon S3 übertragen | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Laden Sie die Beispieldatei hoch. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Entwickler z/OS | | Erstellen Sie eine Batch-JCL. | Codieren Sie die Batch-JCL wie folgt, um den Ziel-S3-Bucket zu erstellen, den Datensatz hochzuladen und den Bucket-Inhalt aufzulisten. Stellen Sie sicher, dass Sie den Verzeichnisnamen, die Dateinamen und den Bucket-Namen durch Ihre eigenen Werte ersetzen.
//AWSCLICP JOB ACTINFO1,'IBMUSER',CLASS=A,MSGCLASS=H,MSGLEVEL=(1,1), 
// NOTIFY=&SYSUID,TIME=1440 
//*---------------------------------------------------------
//* Sample job for AWS CLI 
//*--------------------------------------------------------- 
//USSCMD EXEC PGM=BPXBATCH
//STDERR  DD SYSOUT=*
//STDOUT  DD SYSOUT=*
//STDENV  DD *
 export PATH=/u/cliuser/python/bin:$PATH
//STDPARM DD *
SH
 export _BPXK_AUTOCVT=ON;
 aws s3 mb s3://DOC-EXAMPLE-BUCKET2;
 cp "//'USER.DATA.FIXED'" /tmp/tmpfile;
 aws s3 cp /tmp/tmpfile s3://DOC-EXAMPLE-BUCKET2/USER.DATA.FIXED; 
 rm /tmp/tmpfile;
 aws s3 ls s3://DOC-EXAMPLE-BUCKET2;
/*
| Mainframe-Entwickler z/OS | | Reichen Sie den Batch-JCL-Job ein. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Mainframe-Entwickler z/OS | | Sehen Sie sich den Datensatz an, der in den S3-Bucket hochgeladen wurde. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Allgemeines AWS | ## Zugehörige Ressourcen + [AWS CLI Dokumentation zu Version 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) + [AWS Mainframe Modernization CLI-Befehlsreferenz](https://docs.aws.amazon.com/cli/latest/reference/m2/) + [AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/) ## Zusätzliche Informationen **USER.DATA.FIXED in der ISPF-Option 3.4 (Hilfsprogramm zur Datensatzliste)** ![\[Den Inhalt des Datensatzes in z/OS anzeigen.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/96c25145-3d4d-4007-99f6-5eeb9e88642d.png) **SYSOUT des übermittelten Batch-Jobs** ![\[Standardausgabe aus dem Job-Protokoll.\]](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/03fffbd2-7d2b-43b2-bf14-736b3d150e38.png) ## Anlagen [Um auf zusätzliche Inhalte zuzugreifen, die mit diesem Dokument verknüpft sind, entpacken Sie die folgende Datei: attachment.zip](samples/p-attach/4e3188d8-287f-4ced-8c29-80a01cbbdf50/attachments/attachment.zip)