As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Acesse Serviços da AWS a partir da IBM z/OS instalando o AWS CLI
*Souma Ghosh, Paulo Vítor Pereira e Phil de Valence, da Amazon Web Services*
## Resumo
O [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) é uma ferramenta de código aberto para gerenciar vários AWS serviços usando comandos em um shell de linha de comando. Com uma configuração mínima, você pode executar comandos a partir de sessões de linha de comando, como o prompt de comando, o terminal e o shell bash, para implementar uma funcionalidade equivalente à fornecida pelo navegador Console de gerenciamento da AWS.
Todas as funções de administração, gerenciamento e acesso da AWS infraestrutura como serviço (IaaS) no Console de gerenciamento da AWS estão disponíveis na AWS API e. AWS CLI Você pode instalá-lo AWS CLI em um z/OS mainframe IBM para acessar, gerenciar e interagir diretamente a Serviços da AWS partir do z/OS. AWS CLI Isso permite que usuários e aplicativos executem várias tarefas, como:
+ Transferência de arquivos ou conjuntos de dados entre o armazenamento de objetos do z/OS Amazon Simple Storage Service (Amazon S3) e a visualização do conteúdo de buckets
+ Iniciar e interromper AWS recursos diferentes; por exemplo, iniciar um trabalho em lotes em um AWS Mainframe Modernization ambiente
+ Chamando uma AWS Lambda função para implementar uma lógica comercial comum
+ Integração com inteligência artificial, aprendizado de máquina (IA/ML) e serviços de análise
Esse padrão descreve como instalar, configurar e usar o AWS CLI em z/OS. You can install it globally, so it's available to all z/OS usuários ou em nível de usuário. O padrão também detalha como usar o AWS CLI em uma sessão de linha de comando interativa do z/OS Unix System Services (USS) ou como um trabalho em lote.
## Pré-requisitos e limitações
**Pré-requisitos **
+ **Comunicação de rede de z/OS para AWS**
Por padrão, o AWS CLI envia solicitações Serviços da AWS usando HTTPS na porta TCP 443. Para usar o AWS CLI com sucesso, você deve ser capaz de fazer conexões de saída na porta TCP 443. Você pode usar qualquer um dos seguintes comandos do z/OS USS (alguns deles podem não estar instalados em seu ambiente) para testar a conectividade de rede de z/OS até 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 credenciais**
Para se comunicar com Nuvem AWS serviços do z/OS, é AWS CLI necessário configurar algumas credenciais com privilégios para acessar o destino. Conta da AWS Para comandos programáticos AWS, você pode usar teclas de acesso, que consistem em um ID de chave de acesso e uma chave de acesso secreta. Se você não tiver chaves de acesso, poderá criá-las usando o Console de gerenciamento da AWS. Como prática recomendada, não use as chaves de acesso do usuário Conta da AWS raiz em nenhuma tarefa, a menos que o usuário raiz seja necessário. Em vez disso, [crie um novo usuário administrador do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) e [prepare-se para obter permissões com privilégios mínimos****](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#LeastPrivilege) para configurar o usuário com chaves de acesso. Depois de criar o usuário, você pode [criar uma ID de chave de acesso e uma chave de acesso secreta](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) para esse usuário.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)
+ **IBM Python para z/OS**
AWS CLI Isso requer Python 3.8 ou posterior. A IBM permitiu que o Python fosse executado z/OS com o [IBM Open Enterprise Python](https://www.ibm.com/products/open-enterprise-python-zos) for z/OS. [O IBM Open Enterprise Python está disponível gratuitamente por meio do Shopz SMP/E, ou você pode baixar o arquivo PAX no site da IBM.](https://www.ibm.com/account/reg/signup?formid=urx-49465) Para obter instruções, consulte a [documentação de instalação e configuração do](https://www.ibm.com/docs/en/python-zos) IBM Open Enterprise Python for z/OS.
**Limitações**
+ As instruções de instalação fornecidas nesse padrão são aplicáveis **somente àAWS CLI versão 1**. A versão mais recente do AWS CLI é a versão 2. No entanto, esse padrão usa a versão mais antiga porque os métodos de instalação são diferentes para a versão 2 e os executáveis binários disponíveis para a versão 2 não são compatíveis com o z/OS sistema.
**Versões do produto**
+ AWS CLI versão 1
+ Python 3.8 ou posterior
## Arquitetura
**Pilha de tecnologia**
+ Mainframe executando z/OS
+ Serviços de sistema z/OS UNIX de mainframe (USS)
+ Mainframe Open MVS (OMVS) — interface de comando do ambiente z/OS shell UNIX
+ Disco de mainframe, como um dispositivo de armazenamento de acesso direto (DASD - direct-access storage device)
+ AWS CLI
**Arquitetura de destino**
O diagrama a seguir mostra uma AWS CLI implantação no IBM z/OS. Você pode invocar o a AWS CLI partir de uma sessão de usuário interativa, como SSH e sessões de telnet. Você também pode invocá-lo a partir de um trabalho em lotes usando a linguagem de controle de tarefas (JCL) ou de qualquer programa que possa chamar um comando shell do z/OS Unix.
Eles AWS CLI se comunicam com os AWS service (Serviço da AWS) endpoints por meio de uma TCP/IP rede. Essa conexão de rede pode ocorrer pela Internet ou por meio de uma AWS Direct Connect conexão privada do data center do cliente com os data Nuvem AWS centers. A comunicação é autenticada com AWS credenciais e criptografada.
**Automação e escala**
Você pode explorar os recursos de um AWS service (Serviço da AWS) com o AWS CLI e desenvolver scripts de shell do USS para gerenciar seus AWS recursos a partir do z/OS. Você também pode executar AWS CLI comandos e scripts de shell a partir do ambiente z/OS em lotes e automatizar trabalhos em lotes para execução em um cronograma específico por meio da integração com agendadores de mainframe. AWS CLI comandos ou scripts podem ser codificados dentro de parâmetros (PARMs) e procedimentos (PROCs) e podem ser escalados seguindo a abordagem padrão de chamar o PARM ou o PROC a partir de diferentes trabalhos em lotes com parâmetros diferentes.
## Ferramentas
+ [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) é uma ferramenta de código aberto que ajuda você a interagir Serviços da AWS por meio de comandos em seu shell de linha de comando.
## Práticas recomendadas
+ Por motivos de segurança, restrinja as permissões de acesso ao diretório do USS onde os detalhes da chave de AWS acesso estão armazenados. Permita o acesso somente aos usuários ou programas que usam AWS CLI o.
+ Não use as chaves de acesso do usuário Conta da AWS root para nenhuma tarefa. Em vez disso, [crie um novo usuário administrador do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html#create-an-admin) para você e configure-o com chaves de acesso.
|
|
| Os usuários do IAM têm credenciais de longo prazo, o que representa um risco de segurança. Para ajudar a reduzir esse risco, recomendamos que você forneça a esses usuários somente as permissões necessárias para realizar a tarefa e que você os remova quando não forem mais necessários. |
| --- |
## Épicos
### Instale AWS CLI a versão 1 no z/OS USS
| Tarefa | Description | Habilidades necessárias |
| --- | --- | --- |
| Instale o Python 3.8 ou posterior. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrador de mainframe z/OS |
| Defina as variáveis de ambiente do USS. | Adicione variáveis de ambiente ao perfil. Você pode adicioná-los ao `/u/cliuser/.profile` arquivo de um usuário individual (`cliuser`) ou ao `/etc/profile` arquivo de todos os usuários.Esse padrão pressupõe que o Python tenha sido instalado no `/u/awscli/python` diretório. Se o diretório de instalação for diferente, atualize o código adequadamente.# 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
| Administrador de mainframe z/OS |
| Teste a instalação do Python. | Execute o comando **python**:python --version
A saída deve confirmar que você tem o Python 3.8 ou posterior instalado corretamente. | Administrador de mainframe z/OS |
| Verifique ou instale o **pip.** | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrador de mainframe z/OS |
| Instale AWS CLI a versão 1. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrador de mainframe z/OS |
### Configurar o AWS CLI acesso a partir do z/OS
| Tarefa | Description | Habilidades necessárias |
| --- | --- | --- |
| Configure as chaves de AWS acesso, a região padrão e a saída. | A [AWS CLI documentação](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) descreve diferentes opções para configurar o AWS acesso. Você pode escolher uma configuração de acordo com os padrões da sua organização. Este exemplo usa a configuração de credenciais de curto prazo.[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Administrador da AWS, administrador de mainframe, z/OS desenvolvedor de mainframe z/OS |
| Teste AWS CLI o. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | z/OS Administrador de mainframe, desenvolvedor de mainframe z/OS |
### Opção 1 ‒ Transferir dados do USS para o Amazon S3 de forma interativa a partir de uma sessão do USS
| Tarefa | Description | Habilidades necessárias |
| --- | --- | --- |
| Baixe e transfira o arquivo CSV de amostra. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Desenvolvedor de aplicativos, desenvolvedor de mainframe z/OS |
| Crie um bucket do S3 e faça o upload do arquivo CSV. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Desenvolvedor de aplicativos, desenvolvedor de mainframe z/OS |
| Visualize o bucket do S3 e o arquivo carregado. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)Para obter mais informações sobre o upload de objetos, consulte [Introdução ao Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html) S3 na documentação do Amazon S3. | AWS geral |
| Execute uma consulta SQL em uma tabela do Amazon Athena. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html)A saída da consulta SQL exibirá o conteúdo do seu arquivo CSV. | AWS geral, desenvolvedor de aplicativos |
### Opção 2 ‒ Transferir dados do USS para o Amazon S3 usando JCL em lote
| Tarefa | Description | Habilidades necessárias |
| --- | --- | --- |
| Faça o upload do arquivo de amostra. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Desenvolvedor de mainframe z/OS |
| Crie JCL em lote. | Codifique o JCL em lote da seguinte forma para criar o bucket S3 de destino, fazer o upload do conjunto de dados e listar o conteúdo do bucket. Certifique-se de substituir o nome do diretório, os nomes dos arquivos e o nome do bucket pelos seus próprios valores.//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;
/*
| Desenvolvedor de mainframe z/OS |
| Envie o trabalho JCL em lote. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | Desenvolvedor de mainframe z/OS |
| Visualize o conjunto de dados carregado no bucket do S3. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/access-aws-services-from-ibm-z-os-by-installing-aws-cli.html) | AWS geral |
## Recursos relacionados
+ [AWS CLI documentação da versão 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html)
+ [AWS Mainframe Modernization Referência de comandos da CLI](https://docs.aws.amazon.com/cli/latest/reference/m2/)
+ [AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/)
## Mais informações
**USER.DATA.FIXED na opção 3.4 do ISPF (utilitário de lista de conjuntos de dados)**
**SYSOUT do trabalho em lotes enviado**
## Anexos
Para acessar o conteúdo adicional associado a este documento, descompacte o seguinte arquivo: [ attachment.zip](samples/p-attach/4e3188d8-287f-4ced-8c29-80a01cbbdf50/attachments/attachment.zip)