Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Accesso Servizi AWS da IBM z/OS installando AWS CLI *Souma Ghosh, Paulo Vitor Pereira e Phil de Valence, Amazon Web Services* ## Riepilogo The [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) è uno strumento open source per la gestione di più AWS servizi utilizzando i comandi in una shell a riga di comando. Con una configurazione minima, è possibile eseguire comandi da sessioni a riga di comando come il prompt dei comandi, il terminale e la shell bash per implementare funzionalità equivalenti a quelle fornite dal browser. Console di gestione AWS Tutte le funzioni di amministrazione, gestione e accesso dell' AWS infrastruttura come servizio (IaaS) Console di gestione AWS sono disponibili nell' AWS API e. AWS CLIÈ possibile installarle AWS CLI su un z/OS mainframe IBM per accedere, gestire e interagire Servizi AWS direttamente da z/OS. AWS CLI Consente agli utenti e alle applicazioni di eseguire varie attività, come: + Trasferimento di file o set di dati tra lo storage di oggetti z/OS Amazon Simple Storage Service (Amazon S3) e visualizzazione del contenuto dei bucket + Avvio e arresto di AWS risorse diverse; ad esempio, avvio di un processo in batch in un ambiente Modernizzazione del mainframe AWS + Chiamata di una AWS Lambda funzione per implementare una logica aziendale comune + Integrazione con servizi di intelligenza artificiale e apprendimento automatico (AI/ML) e analisi Questo modello descrive come installare, configurare e utilizzare AWS CLI su z/OS. You can install it globally, so it's available to all z/OS utenti o a livello di utente. Il modello descrive anche come utilizzarlo AWS CLI in una sessione interattiva a riga di comando di z/OS Unix System Services (USS) o come processo batch. ## Prerequisiti e limitazioni **Prerequisiti** + **Comunicazione di rete da a z/OS AWS** Per impostazione predefinita, AWS CLI invia le richieste Servizi AWS utilizzando HTTPS sulla porta TCP 443. Per utilizzare AWS CLI correttamente, è necessario essere in grado di effettuare connessioni in uscita sulla porta TCP 443. È possibile utilizzare uno qualsiasi dei seguenti comandi z/OS USS (alcuni di questi potrebbero non essere installati nell'ambiente in uso) per testare la connettività di rete da a: 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 credenziali** Per comunicare con Cloud AWS i servizi di z/OS, è AWS CLI necessario configurare alcune credenziali con privilegi di accesso alla destinazione. Account AWS Per i comandi programmatici AWS, è possibile utilizzare le chiavi di accesso, che consistono in un ID della chiave di accesso e una chiave di accesso segreta. Se non si dispone di chiavi di accesso, sarà possibile crearle dalla Console di gestione AWS. È consigliabile non utilizzare le chiavi di accesso dell'utente Account AWS root per alcuna attività a meno che non sia richiesto l'utente root. [Create invece un nuovo utente IAM amministratore](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) e [preparatevi a**** ottenere le autorizzazioni con privilegi minimi per](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#LeastPrivilege) configurare l'utente con le chiavi di accesso. Dopo aver creato l'utente, puoi [creare un ID della chiave di accesso e una chiave di accesso segreta](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) per questo utente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) + **IBM Python per z/OS** AWS CLI Richiede Python 3.8 o successivo. IBM ha consentito a Python di funzionare [con IBM Open Enterprise z/OS Python](https://www.ibm.com/products/open-enterprise-python-zos) for z/OS. [IBM Open Enterprise Python è disponibile gratuitamente tramite Shopz SMP/E oppure è possibile scaricare il file PAX dal sito Web IBM.](https://www.ibm.com/account/reg/signup?formid=urx-49465) Per istruzioni, consulta la [documentazione di installazione e configurazione](https://www.ibm.com/docs/en/python-zos) per IBM Open Enterprise Python for z/OS. **Limitazioni** + **Le istruzioni di installazione fornite in questo modello sono applicabili solo alla AWS CLI versione 1.** L'ultima versione di AWS CLI è la versione 2. Tuttavia, questo modello utilizza la versione precedente perché i metodi di installazione sono diversi per la versione 2 e gli eseguibili binari disponibili per la versione 2 non sono compatibili con il z/OS sistema. **Versioni del prodotto** + AWS CLI versione 1 + Python 3.8 o versioni successive ## Architecture **stack tecnologico** + Mainframe con z/OS + Servizi di sistema z/OS UNIX per mainframe (USS) + Mainframe Open MVS (OMVS): z/OS interfaccia di comando dell'ambiente shell UNIX + Disco mainframe, ad esempio un dispositivo di archiviazione ad accesso diretto (DASD) + AWS CLI **Architettura di destinazione** Il diagramma seguente mostra un' AWS CLI implementazione su IBM z/OS. È possibile richiamarlo AWS CLI da una sessione utente interattiva, come SSH, e da sessioni telnet. È inoltre possibile richiamarlo da un processo batch utilizzando il linguaggio di controllo del lavoro (JCL) o da qualsiasi programma in grado di chiamare un comando della shell Unix. z/OS ![\[CLI AWS su un z/OS mainframe IBM che accede ai servizi AWS.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/c3883500-bd00-4c56-982a-26d5e0b8b093.png) AWS CLI Comunica con gli Servizio AWS endpoint tramite una rete. TCP/IP Questa connessione di rete può avvenire tramite Internet o tramite una AWS Direct Connect connessione privata dal data center del cliente ai Cloud AWS data center. La comunicazione viene autenticata con AWS credenziali e crittografata. **Automazione e scalabilità** Puoi esplorare le funzionalità di an Servizio AWS with the AWS CLI e sviluppare script di shell USS per gestire AWS le tue risorse da z/OS. È inoltre possibile eseguire AWS CLI comandi e script di shell dall'ambiente z/OS batch e automatizzare i processi in batch per eseguirli secondo una pianificazione specifica mediante l'integrazione con gli scheduler del mainframe. AWS CLI i comandi o gli script possono essere codificati all'interno di parametri (PARMs) e procedure (PROCs) e possono essere scalati seguendo l'approccio standard di chiamata al PARM o al PROC da diversi processi batch con parametri diversi. ## Tools (Strumenti) + [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) è uno strumento open source che consente di interagire Servizi AWS tramite comandi nella shell della riga di comando. ## Best practice + Per motivi di sicurezza, limita le autorizzazioni di accesso alla directory USS in cui sono memorizzati i dettagli della chiave di AWS accesso. Consenti l'accesso solo agli utenti o ai programmi che utilizzano il AWS CLI. + Non utilizzare le chiavi di accesso utente Account AWS root per alcuna attività. [Crea invece un nuovo utente IAM amministratore](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) e configuralo con le chiavi di accesso. | | | Gli utenti IAM dispongono di credenziali a lungo termine che presentano un rischio per la sicurezza. Per ridurre questo rischio, si consiglia di fornire a questi utenti solo le autorizzazioni necessarie per eseguire l'attività e di rimuoverli quando non sono più necessari. | | --- | ## Epiche ### Installa AWS CLI la versione 1 su z/OS USS | Operazione | Description | Competenze richieste | | --- | --- | --- | | Installa Python 3.8 o versione successiva. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Amministratore del mainframe z/OS | | Imposta le variabili di ambiente USS. | Aggiungi variabili di ambiente al profilo. È possibile aggiungerle al `/u/cliuser/.profile` file per un singolo utente (`cliuser`) o al `/etc/profile` file per tutti gli utenti.Questo modello presuppone che Python sia stato installato nella `/u/awscli/python` directory. Se la directory di installazione è diversa, aggiorna il codice di conseguenza.
# 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
| Amministratore del mainframe z/OS | | Prova l'installazione di Python. | Esegui il comando **python**:
python --version
L'output dovrebbe confermare che Python 3.8 o versione successiva è installato correttamente. | Amministratore del mainframe z/OS | | Verifica o installa **pip**. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Amministratore del mainframe z/OS | | Installa AWS CLI la versione 1. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | z/OS Amministratore del mainframe | ### Configura AWS CLI l'accesso da z/OS | Operazione | Description | Competenze richieste | | --- | --- | --- | | Configura le chiavi di AWS accesso, la regione predefinita e l'output. | La [AWS CLI documentazione](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) descrive diverse opzioni per configurare AWS l'accesso. Puoi scegliere una configurazione in base agli standard della tua organizzazione. Questo esempio utilizza la configurazione delle credenziali a breve termine.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Amministratore AWS, amministratore mainframe z/OS , sviluppatore z/OS mainframe | | Prova il. AWS CLI | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | z/OS z/OS Amministratore di mainframe, sviluppatore mainframe | ### Opzione 1 ‒ Trasferimento interattivo di dati da USS ad Amazon S3 da una sessione USS | Operazione | Description | Competenze richieste | | --- | --- | --- | | Scarica e trasferisci il file CSV di esempio. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Sviluppatore di app, sviluppatore di mainframe z/OS | | Crea un bucket S3 e carica il file CSV. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Sviluppatore di app, sviluppatore di mainframe z/OS | | Visualizza il bucket S3 e il file caricato. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)Per ulteriori informazioni sul caricamento di oggetti, consulta la sezione [Guida introduttiva ad Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html) S3 nella documentazione di Amazon S3. | Informazioni generali su AWS | | Esegui una query SQL su una tabella Amazon Athena. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)L'output della query SQL mostrerà il contenuto del file CSV. | General AWS, sviluppatore di app | ### Opzione 2 ‒ Trasferimento di dati da USS ad Amazon S3 utilizzando batch JCL | Operazione | Description | Competenze richieste | | --- | --- | --- | | Carica il file di esempio. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Sviluppatore di mainframe z/OS | | Crea JCL in batch. | Codifica il batch JCL come segue per creare il bucket S3 di destinazione, caricare il set di dati ed elencare il contenuto del bucket. Assicurati di sostituire il nome della directory, i nomi dei file e il nome del bucket con i tuoi valori.
//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;
/*
| Sviluppatore di mainframe z/OS | | Invia il lavoro JCL in batch. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Sviluppatore di mainframe z/OS | | Visualizza il set di dati caricato nel bucket S3. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Informazioni generali su AWS | ## Risorse correlate + [AWS CLI documentazione della versione 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) + [Modernizzazione del mainframe AWS Riferimento ai comandi CLI](https://docs.aws.amazon.com/cli/latest/reference/m2/) + [Modernizzazione del mainframe AWS](https://aws.amazon.com/mainframe-modernization/) ## Informazioni aggiuntive **USER.DATA.FIXED nell'opzione ISPF 3.4 (utilità per l'elenco dei set di dati)** ![\[Visualizzazione del contenuto del set di dati in z/OS.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/96c25145-3d4d-4007-99f6-5eeb9e88642d.png) **SYSOUT del processo batch inviato** ![\[Output standard dal registro dei lavori.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/4e3188d8-287f-4ced-8c29-80a01cbbdf50/images/03fffbd2-7d2b-43b2-bf14-736b3d150e38.png) ## Allegati [Per accedere al contenuto aggiuntivo associato a questo documento, decomprimi il seguente file: attachment.zip](samples/p-attach/4e3188d8-287f-4ced-8c29-80a01cbbdf50/attachments/attachment.zip)