Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Accès Services AWS depuis IBM z/OS en installant le AWS CLI
*Souma Ghosh, Paulo Vitor Pereira et Phil de Valence, Amazon Web Services*
## Résumé
The [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) est un outil open source permettant de gérer plusieurs AWS services à l'aide de commandes dans un shell de ligne de commande. Avec une configuration minimale, vous pouvez exécuter des commandes à partir de sessions de ligne de commande telles que l'invite de commande, le terminal et le shell bash pour implémenter des fonctionnalités équivalentes à celles fournies par le navigateur AWS Management Console.
Toutes les fonctions d'administration, de gestion et d'accès de l' AWS infrastructure en tant que service (IaaS) AWS Management Console sont disponibles dans l' AWS API et. AWS CLI Vous pouvez l'installer AWS CLI sur un z/OS mainframe IBM pour y accéder, le gérer et interagir directement Services AWS depuis z/OS. AWS CLI Permet aux utilisateurs et aux applications d'effectuer diverses tâches, telles que :
+ Transfert de fichiers ou d'ensembles de données entre z/OS le stockage d'objets Amazon Simple Storage Service (Amazon S3) et affichage du contenu des buckets
+ Démarrage et arrêt de différentes AWS ressources ; par exemple, démarrage d'une tâche par lots dans un AWS Mainframe Modernization environnement
+ Appel d'une AWS Lambda fonction pour implémenter une logique métier commune
+ Intégration à l'intelligence artificielle, à l'apprentissage automatique (IA/ML) et aux services d'analyse
Ce modèle décrit comment installer, configurer et utiliser le AWS CLI sur z/OS. You can install it globally, so it's available to all z/OS les utilisateurs ou au niveau des utilisateurs. Le modèle explique également comment l'utiliser AWS CLI dans une session de ligne de commande interactive à partir d' z/OS Unix System Services (USS) ou en tant que travail par lots.
## Conditions préalables et limitations
**Conditions préalables**
+ **Communication réseau de z/OS à AWS**
Par défaut, les demandes sont AWS CLI envoyées à l'aide Services AWS du protocole HTTPS sur le port TCP 443. Pour l'utiliser AWS CLI correctement, vous devez être en mesure d'établir des connexions sortantes sur le port TCP 443. Vous pouvez utiliser l'une des commandes z/OS USS suivantes (certaines d'entre elles ne sont peut-être pas installées dans votre environnement) pour tester la connectivité réseau de z/OS à AWS :
```
ping amazonaws.com
dig amazonaws.com
traceroute amazonaws.com
curl -k https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html
```
+ **AWS credentials**
Pour communiquer avec les AWS Cloud services depuis z/OS, vous devez configurer certaines informations d'identification avec des privilèges pour accéder à la cible Compte AWS. AWS CLI Pour les commandes programmatiques AWS, vous pouvez utiliser des clés d'accès, qui se composent d'un identifiant de clé d'accès et d'une clé d'accès secrète. Si vous ne disposez pas des clé d'accès, vous pouvez les créer à partir de l' AWS Management Console. Il est recommandé de n'utiliser les clés d'accès de l'utilisateur Compte AWS root pour aucune tâche, sauf si l'utilisateur root est requis. [Créez plutôt un nouvel utilisateur administrateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) et [préparez-vous à obtenir des autorisations de moindre privilège****](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#LeastPrivilege) afin de configurer l'utilisateur avec des clés d'accès. Après avoir créé l'utilisateur, vous pouvez [créer un identifiant de clé d'accès et une clé d'accès secrète](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) pour cet utilisateur.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)
+ **IBM Python pour z/OS**
AWS CLI Nécessite Python 3.8 ou version ultérieure. IBM a permis à Python de continuer à fonctionner z/OS avec [IBM Open Enterprise Python for z/OS](https://www.ibm.com/products/open-enterprise-python-zos). [IBM Open Enterprise Python est disponible gratuitement via Shopz SMP/E, ou vous pouvez télécharger le fichier PAX depuis le site Web d'IBM.](https://www.ibm.com/account/reg/signup?formid=urx-49465) Pour obtenir des instructions, consultez la [documentation d'installation et de configuration](https://www.ibm.com/docs/en/python-zos) d'IBM Open Enterprise Python for z/OS.
**Limites**
+ Les instructions d'installation fournies dans ce modèle s'appliquent **uniquement àAWS CLI la version 1**. La dernière version AWS CLI est la version 2. Toutefois, ce modèle utilise l'ancienne version car les méthodes d'installation sont différentes pour la version 2 et les exécutables binaires disponibles pour la version 2 ne sont pas compatibles avec le z/OS système.
**Versions du produit**
+ AWS CLI version 1
+ Python 3.8 ou version ultérieure
## Architecture
**Pile technologique**
+ Mainframe exécutant z/OS
+ Services du système z/OS UNIX pour mainframe (USS)
+ Mainframe Open MVS (OMVS) — interface de commande de l'environnement z/OS shell UNIX
+ Disque central, tel qu'un périphérique de stockage à accès direct (DASD)
+ AWS CLI
**Architecture cible**
Le schéma suivant montre un AWS CLI déploiement sur IBM z/OS. Vous pouvez l'invoquer AWS CLI à partir d'une session utilisateur interactive, telle que des sessions SSH et Telnet. Vous pouvez également l'invoquer depuis un traitement par lots en utilisant le langage de contrôle des tâches (JCL) ou depuis n'importe quel programme capable d'appeler une commande shell z/OS Unix.
![\[CLI AWS sur un z/OS mainframe IBM accédant aux services AWS.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/c3883500-bd00-4c56-982a-26d5e0b8b093.png)
Il AWS CLI communique avec les Service AWS points de terminaison via un TCP/IP réseau. Cette connexion réseau peut se faire via Internet ou via une AWS Direct Connect connexion privée entre le centre de données du client et les centres de AWS Cloud données. La communication est authentifiée avec des AWS informations d'identification et cryptée.
**Automatisation et mise à l'échelle**
Vous pouvez explorer les fonctionnalités d'un Service AWS avec AWS CLI et développer des scripts shell USS pour gérer vos AWS ressources depuis z/OS. Vous pouvez également exécuter des AWS CLI commandes et des scripts shell à partir de l'environnement z/OS batch, et vous pouvez automatiser les tâches par lots pour qu'elles s'exécutent selon un calendrier spécifique en les intégrant aux planificateurs mainframe. AWS CLI les commandes ou les scripts peuvent être codés dans les paramètres (PARMs) et les procédures (PROCs), et peuvent être mis à l'échelle en suivant l'approche standard qui consiste à appeler le PARM ou le PROC à partir de différents traitements par lots avec différents paramètres.
## Outils
+ [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) est un outil open source qui vous permet d'interagir Services AWS via des commandes dans votre interface de ligne de commande.
## Bonnes pratiques
+ Pour des raisons de sécurité, limitez les autorisations d'accès au répertoire USS où les détails de la clé AWS d'accès sont stockés. N'autorisez l'accès qu'aux utilisateurs ou aux programmes qui utilisent le AWS CLI.
+ N'utilisez les clés d'accès de l'utilisateur Compte AWS root pour aucune tâche. [Créez plutôt un nouvel utilisateur administrateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) pour vous-même et configurez-le avec des clés d'accès.
|
|
| Les utilisateurs IAM disposent d'informations d'identification à long terme qui présentent un risque de sécurité. Pour atténuer ce risque, nous vous recommandons de ne fournir à ces utilisateurs que les autorisations dont ils ont besoin pour effectuer la tâche et de supprimer ces autorisations lorsqu’elles ne sont plus nécessaires. |
| --- |
## Épopées
### Installez AWS CLI la version 1 sur z/OS USS
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Installez Python 3.8 ou version ultérieure. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrateur mainframe z/OS |
| Définissez les variables d'environnement USS. | Ajoutez des variables d'environnement au profil. Vous pouvez les ajouter soit au `/u/cliuser/.profile` fichier d'un utilisateur individuel (`cliuser`), soit au `/etc/profile` fichier de tous les utilisateurs.Ce modèle suppose que Python a été installé dans le `/u/awscli/python` répertoire. Si votre répertoire d'installation est différent, mettez à jour le code en conséquence.# 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
| Administrateur mainframe z/OS |
| Testez l'installation de Python. | Exécutez la commande **python** :python --version
Le résultat devrait confirmer que Python 3.8 ou version ultérieure est correctement installé. | Administrateur mainframe z/OS |
| Vérifiez ou installez **pip.** | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrateur mainframe z/OS |
| Installez AWS CLI la version 1. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrateur mainframe z/OS |
### Configuration de AWS CLI l'accès depuis z/OS
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Configurez les clés AWS d'accès, la région par défaut et la sortie. | La [AWS CLI documentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) décrit les différentes options de configuration de AWS l'accès. Vous pouvez choisir une configuration en fonction des normes de votre organisation. Cet exemple utilise la configuration des informations d'identification à court terme.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrateur AWS, administrateur mainframe, z/OS développeur mainframe z/OS |
| Testez le AWS CLI. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | z/OS Administrateur mainframe, développeur mainframe z/OS |
### Option 1 ‒ Transférer des données d'USS vers Amazon S3 de manière interactive à partir d'une session USS
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Téléchargez et transférez l'exemple de fichier CSV. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Développeur d'applications, développeur de mainframe z/OS |
| Créez un compartiment S3 et chargez le fichier CSV. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Développeur d'applications, développeur de mainframe z/OS |
| Affichez le compartiment S3 et le fichier chargé. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)Pour plus d'informations sur le téléchargement d'objets, consultez [Getting started with Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html) dans la documentation Amazon S3. | AWS général |
| Exécutez une requête SQL sur une table Amazon Athena. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)La sortie de la requête SQL affichera le contenu de votre fichier CSV. | AWS général, développeur d'applications |
### Option 2 ‒ Transférer des données d'USS vers Amazon S3 à l'aide du JCL par lots
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Téléchargez le fichier d'exemple. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Développeur de mainframe z/OS |
| Créez un JCL par lots. | Codez le JCL du lot comme suit pour créer le compartiment S3 de destination, télécharger l'ensemble de données et répertorier le contenu du compartiment. Assurez-vous de remplacer le nom du répertoire, les noms de fichiers et le nom du compartiment par vos propres valeurs.//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;
/*
| Développeur de mainframe z/OS |
| Soumettez la tâche JCL par lots. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Développeur de mainframe z/OS |
| Affichez le jeu de données chargé dans le compartiment S3. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | AWS général |
## Ressources connexes
+ [AWS CLI documentation de la version 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html)
+ [AWS Mainframe Modernization Référence des commandes d'interface de ligne de commande](https://docs.aws.amazon.com/cli/latest/reference/m2/)
+ [AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/)
## Informations supplémentaires
**USER.DATA.FIXED dans l'option ISPF 3.4 (utilitaire de liste de jeux de données)**
![\[Affichage du contenu du jeu de données dans z/OS.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/96c25145-3d4d-4007-99f6-5eeb9e88642d.png)
**SYSOUT du traitement par lots soumis**
![\[Sortie standard du journal des tâches.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/03fffbd2-7d2b-43b2-bf14-736b3d150e38.png)
## Pièces jointes
[Pour accéder au contenu supplémentaire associé à ce document, décompressez le fichier suivant : attachment.zip](samples/p-attach/4e3188d8-287f-4ced-8c29-80a01cbbdf50/attachments/attachment.zip)