

AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

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á.

# Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces
<a name="set-up-ed"></a>

Este tutorial descreve como configurar o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer) para um ou mais aplicativos de mainframe a fim de mantê-los, compilá-los e testá-los usando os recursos do Enterprise Developer. A configuração é baseada nas imagens do WorkSpaces Applications Windows que a AWS Mainframe Modernization compartilha com o cliente e na criação de frotas e pilhas de WorkSpaces aplicativos, conforme descrito em. [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md)

**Importante**  
As etapas deste tutorial pressupõem que você configure WorkSpaces aplicativos usando o CloudFormation modelo disponível para download [cfn-m2- .yaml](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml). appstream-fleet-ea-ed Para obter mais informações, consulte [Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer](set-up-appstream-mf.md).  
Você deve executar as etapas dessa configuração quando a frota e a pilha do Enterprise Developer estiverem em funcionamento.

Para obter uma descrição completa dos recursos e resultados do Enterprise Developer v7, confira sua [documentação up-to-date on-line (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) no site da Rocket Software (antiga Micro Focus).

## Conteúdo da imagem
<a name="set-up-ed-image-contents"></a>

Além do próprio Enterprise Developer, a imagem contém a imagem que contém o Rumba (um TN3270 emulador). Ele também contém as seguintes ferramentas e bibliotecas.

Ferramentas de terceiros
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC driver](https://odbc.postgresql.org/)

Bibliotecas em `C:\Users\Public`
+ BankDemo código-fonte e definição do projeto para Enterprise Developer:`m2-bankdemo-template.zip`.
+ Pacote de instalação do MFA para o mainframe: `mfa.zip`. Para obter mais informações, consulte [Visão geral do acesso ao mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) na documentação do *Micro Focus Enterprise Developer*.
+ Arquivos de comando e configuração do Rclone (instruções para seu uso nos tutoriais): `m2-rclone.cmd` e `m2-rclone.conf`.

Se você precisar acessar o código-fonte que ainda não está carregado nos CodeCommit repositórios, mas que está disponível em um bucket do Amazon S3, por exemplo, para realizar o carregamento inicial do código-fonte no git, siga o procedimento para criar um disco virtual do Windows conforme descrito em. [Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces](set-up-ea.md)

**Topics**
+ [Conteúdo da imagem](#set-up-ed-image-contents)
+ [Pré-requisitos](#tutorial-ed-prerequisites)
+ [Etapa 1: configuração por usuários individuais do Enterprise Developer](#tutorial-ed-step1)
+ [Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows (opcional)](#tutorial-ed-step2)
+ [Etapa 3: clonar o repositório](#tutorial-ed-step3)
+ [Sessões subsequentes](#tutorial-ed-step4)
+ [Limpar os recursos](#tutorial-ed-clean)

## Pré-requisitos
<a name="tutorial-ed-prerequisites"></a>
+ Um ou mais CodeCommit repositórios carregados com o código-fonte do aplicativo a ser mantido. A configuração do repositório deve corresponder aos requisitos do CI/CD pipeline acima para criar sinergias por meio da combinação das duas ferramentas.
+ Cada usuário deve ter credenciais para o CodeCommit repositório ou repositórios definidos pelo administrador da conta de acordo com as informações em [Autenticação e controle de acesso](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) da AWS. CodeCommit A estrutura dessas credenciais é revisada em [Autenticação e controle de acesso para AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) e a referência completa para autorizações do IAM CodeCommit está na [referência de CodeCommit permissões](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): o administrador pode definir políticas distintas do IAM para funções distintas, tendo credenciais específicas para a função de cada repositório e limitando suas autorizações do usuário ao conjunto específico de tarefas que ele precisa realizar em um determinado repositório. Portanto, para cada mantenedor do CodeCommit repositório, o administrador da conta gerará um usuário primário e concederá a esse usuário permissões para acessar o repositório ou repositórios necessários selecionando a política ou as políticas adequadas do IAM para acesso. CodeCommit

## Etapa 1: configuração por usuários individuais do Enterprise Developer
<a name="tutorial-ed-step1"></a>

1. Obtenha suas credenciais do IAM:

   1. Conecte-se ao AWS console em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   1. Siga o procedimento descrito na etapa 3 de [Configuração para usuários HTTPS usando credenciais do Git](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) no *Guia do usuário AWS CodeCommit *. 

   1. Copie as credenciais de CodeCommit login específicas que o IAM gerou para você, mostrando, copiando e colando essas informações em um arquivo seguro em seu computador local ou escolhendo **Baixar credenciais para baixar** essas informações como um arquivo.CSV. Essas informações são necessárias para você se conectar ao CodeCommit.

1. Inicie uma sessão com WorkSpaces aplicativos com base na URL recebida no e-mail de boas-vindas. Use seu e-mail como nome de usuário e crie sua senha.

1. Selecione sua pilha de desenvolvedores corporativos.

1. Na página do menu, escolha **Desktop** para acessar a área de trabalho do Windows transmitida pela frota.

## Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows (opcional)
<a name="tutorial-ed-step2"></a>

Se houver necessidade do Rclone (veja acima), crie a pasta virtual baseada no Amazon S3 no Windows: (opcional se todos os artefatos do aplicativo vierem exclusivamente do acesso). CodeCommit 

**nota**  
Se você já usou o Rclone durante a pré-visualização da modernização do AWS mainframe, você deve atualizar `m2-rclone.cmd` para a versão mais recente localizada em. `C:\Users\Public`

1. Copie os arquivos `m2-rclone.conf` e `m2-rclone.cmd` fornecidos em `C:\Users\Public` para sua pasta pessoal `C:\Users\PhotonUser\My Files\Home Folder` usando o Explorador de Arquivos.

1. Atualize os parâmetros de `m2-rclone.conf` configuração com sua chave de AWS acesso e o segredo correspondente, bem como seu Região da AWS.

   ```
   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256
   ```

1. Mo `m2-rclone.cmd`, faça as seguintes alterações:
   + Altere `amzn-s3-demo-bucket` para o nome do seu bucket do Amazon S3. Por exemplo, .`m2-s3-mybucket`
   + Altere `your-s3-folder-key` para sua chave de bucket do Amazon S3. Por exemplo, .`myProject`
   + Altere `your-local-folder-path` para o caminho do diretório em que você deseja que os arquivos da aplicação sejam sincronizados a partir do bucket do Amazon S3 que os contém. Por exemplo, .`D:\PhotonUser\My Files\Home Folder\m2-new` Esse diretório sincronizado deve ser um subdiretório da Pasta Inicial para que os WorkSpaces Aplicativos possam fazer backup e restaurá-lo adequadamente no início e no final da sessão.

   ```
   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:{{amzn-s3-demo-bucket}}/{{your-s3-folder-key}} "D:\PhotonUser\My Files\Home Folder\{{your-local-folder-path}}" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop
   ```

1. Abra um prompt de comando do Windows, toque em CD, `C:\Users\PhotonUser\My Files\Home Folder` se necessário, e execute`m2-rclone.cmd`. Esse script de comando executa um loop contínuo, sincronizando o bucket e a chave do Amazon S3 com a pasta local a cada 10 segundos. Você pode ajustar o tempo limite conforme necessário. Você deve ver o código-fonte da aplicação localizado no bucket do Amazon S3 no Windows File Explorer.

Para adicionar novos arquivos ao conjunto em que você está trabalhando ou para atualizar os existentes, faça o upload dos arquivos para o bucket do Amazon S3 e eles serão sincronizados com seu diretório na próxima iteração definida em `m2-rclone.cmd`. Da mesma forma, se quiser excluir alguns arquivos, exclua-os do bucket do Amazon S3. A próxima operação de sincronização os excluirá do seu diretório local.

## Etapa 3: clonar o repositório
<a name="tutorial-ed-step3"></a>

1. Navegue até o menu seletor de aplicações no canto superior esquerdo da janela do navegador e selecione Enterprise Developer.

1. Conclua a criação do espaço de trabalho exigido pelo Enterprise Developer em sua pasta inicial escolhendo `C:\Users\PhotonUser\My Files\Home Folder` (aka `D: \PhotonUser\My Files\Home Folder`) como local para o espaço de trabalho.

1. ****No Enterprise Developer, clone seu CodeCommit repositório acessando o Project Explorer, clique com o botão direito do mouse e escolha **Importar, Importar****...**, Git, Projetos **do** **Git** Clone URI.**** Em seguida, insira suas credenciais CodeCommit de login específicas e preencha a caixa de diálogo do Eclipse para importar o código.

O repositório CodeCommit git agora está clonado em seu espaço de trabalho local.

Seu espaço de trabalho do Enterprise Developer agora está pronto para iniciar o trabalho de manutenção em sua aplicação. Em particular, você pode usar a instância local do Enterprise Server (ES) integrada ao Enterprise Developer para depurar e executar interativamente seu aplicativo para validar suas alterações localmente.

**nota**  
O ambiente local do Enterprise Developer, incluindo a instância local do Enterprise Server, é executado no Windows, enquanto a modernização do AWS mainframe é executada no Linux. Recomendamos que você execute testes complementares no ambiente Linux fornecido pela AWS Mainframe Modernization depois de confirmar o novo aplicativo CodeCommit e reconstruí-lo para esse destino e antes de implantar o novo aplicativo em produção.

## Sessões subsequentes
<a name="tutorial-ed-step4"></a>

Ao selecionar uma pasta que está sob gerenciamento de WorkSpaces aplicativos, como a pasta inicial para a clonagem do seu CodeCommit repositório, ela será salva e restaurada de forma transparente em todas as sessões. Conclua as seguintes etapas na próxima vez que precisar trabalhar com a aplicação: 

1. Inicie uma sessão com WorkSpaces aplicativos com base na URL recebida no e-mail de boas-vindas.

1. Faça login com seu e-mail e senha permanente.

1. Selecione a pilha Enterprise Developer.

1. Inicie `Rclone` para se conectar (veja acima) ao disco baseado no Amazon S3 quando essa opção for usada para compartilhar os arquivos do espaço de trabalho.

1. Inicie o Enterprise Developer para fazer seu trabalho.

## Limpar os recursos
<a name="tutorial-ed-clean"></a>

Se os recursos criados durante este tutorial não forem mais necessários, exclua-os para que você não continue sendo cobrado por eles. Execute as etapas a seguir:
+ Exclua o CodeCommit repositório que você criou para este tutorial. Para obter mais informações, consulte [Excluir um CodeCommit repositório](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) no *Guia do AWS CodeCommit usuário*.
+ Exclua o banco de dados que você criou para este tutorial. Para ter mais informações, consulte [Excluir uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).