

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

# Tutoriais para Rocket Software (anteriormente Micro Focus)
<a name="tutorials-mf"></a>

Os tutoriais desta seção ajudam você a começar a configurar várias tarefas no mecanismo de tempo de execução da Rocket Software para o serviço de modernização de AWS mainframe. Esses tutoriais são para configurar o aplicativo de amostra, usar modelos com o Rocket Enterprise Developer e configurar o Enterprise Analyzer.

**Topics**
+ [

# Tutorial: Configurando a versão do Rocket Software (anteriormente Micro Focus) para o BankDemo aplicativo de amostra
](tutorial-build-mf.md)
+ [

# Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer
](set-up-appstream-mf.md)
+ [

# Tutorial: Use modelos com o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)
](tutorial-templates-ed.md)
+ [

# Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces
](set-up-ea.md)
+ [

# Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces
](set-up-ed.md)

# Tutorial: Configurando a versão do Rocket Software (anteriormente Micro Focus) para o BankDemo aplicativo de amostra
<a name="tutorial-build-mf"></a>

AWS A modernização do mainframe oferece a capacidade de configurar pipelines de compilação e integration/continuous entrega contínua (CI/CD) para seus aplicativos migrados. Essas compilações e pipelines usam AWS CodeBuild AWS CodeCommit, e AWS CodePipeline para fornecer esses recursos. CodeBuild é um serviço de compilação totalmente gerenciado que compila seu código-fonte, executa testes de unidade e produz artefatos prontos para implantação. CodeCommit é um serviço de controle de versão que permite armazenar e gerenciar de forma privada repositórios Git na nuvem. AWS CodePipeline é um serviço de entrega contínua que permite modelar, visualizar e automatizar as etapas necessárias para lançar seu software.

Este tutorial demonstra como usá-lo para AWS CodeBuild compilar o código-fonte do aplicativo de BankDemo amostra do Amazon S3 e depois exportar o código compilado de volta para o Amazon S3.

AWS CodeBuild é um serviço de integração contínua totalmente gerenciado que compila o código-fonte, executa testes e produz pacotes de software prontos para implantação. Com CodeBuild, você pode usar ambientes de compilação predefinidos ou criar ambientes de compilação personalizados que usam suas próprias ferramentas de compilação. Esse cenário de demonstração usa a segunda opção. Ele consiste em um ambiente de CodeBuild construção que usa uma imagem Docker pré-empacotada.

**Importante**  
Antes de iniciar seu projeto de modernização de mainframe, recomendamos que você conheça o [Programa de Aceleração da Migração (MAP) da AWS para mainframe](https://aws.amazon.com/migration-acceleration-program/mainframe/) ou entre em contato com os [especialistas em mainframe](mailto: mainframe@amazon.com) da AWS para saber mais sobre as etapas necessárias para modernizar uma aplicação de mainframe.

**Topics**
+ [

## Pré-requisitos
](#tutorial-build-mf-prerequisites)
+ [

## Etapa 1: compartilhar os ativos de construção com a AWS conta
](#tutorial-build-mf-assets)
+ [

## Etapa 2: criar buckets do Amazon S3
](#tutorial-build-mf-s3)
+ [

## Etapa 3: criar o arquivo de especificações de compilação
](#tutorial-build-mf-spec)
+ [

## Etapa 4: fazer upload dos arquivos de origem
](#tutorial-build-mf-upload)
+ [

## Etapa 5: criar políticas do IAM
](#tutorial-build-mf-IAM-policy)
+ [

## Etapa 6: criar um perfil do IAM
](#tutorial-build-mf-IAM-role)
+ [

## Etapa 7: anexar as políticas do IAM ao perfil do IAM
](#tutorial-build-mf-attach)
+ [

## Etapa 8: criar o CodeBuild projeto
](#tutorial-build-mf-create-project)
+ [

## Etapa 9: iniciar a compilação
](#tutorial-build-mf-start)
+ [

## Etapa 10: baixar artefatos de saída
](#tutorial-build-mf-download-output)
+ [

## Limpar os recursos
](#tutorial-build-mf-clean)

## Pré-requisitos
<a name="tutorial-build-mf-prerequisites"></a>

Antes de iniciar este tutorial, conclua os seguintes pré-requisitos.
+ Baixe o [aplicativo BankDemo de amostra](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) e descompacte-o em uma pasta. A pasta de origem contém programas e cadernos COBOL, além de definições. Ele também contém uma pasta JCL para referência, embora você não precise criar o JCL. A pasta também contém os meta-arquivos necessários para a compilação.
+ **No console de modernização do AWS mainframe, escolha Ferramentas.** Em **Análise, desenvolvimento e criação de ativos**, selecione **Compartilhar ativos com minha conta da AWS**.

## Etapa 1: compartilhar os ativos de construção com a AWS conta
<a name="tutorial-build-mf-assets"></a>

Nesta etapa, você garante compartilhar os ativos de construção com sua AWS conta, especialmente na região em que os ativos estão sendo usados.

1. Abra o console de modernização do AWS mainframe em. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)

1. Na navegação à esquerda, selecione **Ferramentas**.

1. Em **Análise, desenvolvimento e criação de ativos**, escolha **Compartilhar ativos com minha AWS conta**.

**Importante**  
Você precisa executar essa etapa uma vez em cada AWS região em que pretende fazer construções.

## Etapa 2: criar buckets do Amazon S3
<a name="tutorial-build-mf-s3"></a>

Nesta etapa, você cria dois buckets do Amazon S3. O primeiro é um bucket de entrada para armazenar o código-fonte e o outro é um bucket de saída para armazenar a saída da compilação. Para obter mais informações, consulte [Criação, configuração e trabalho com buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) no *Guia do usuário do Amazon S3*.

1. Para criar o bucket de entrada, faça login no console do Amazon S3 e escolha **Criar bucket**.

1. Em **Configuração geral**, forneça um nome para o bucket e especifique Região da AWS onde você deseja criar o bucket. Um exemplo de nome é`codebuild-regionId-accountId-input-bucket`, where `regionId` is the Região da AWS do bucket e `accountId` é seu Conta da AWS ID.
**nota**  
Se você estiver criando o bucket em um local diferente Região da AWS do Leste dos EUA (Norte da Virgínia), especifique o `LocationConstraint` parâmetro. Para obter mais informações, consulte [Criar Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) na *Referência da API do Amazon Simple Storage Service*.

1. Mantenha todas as outras configurações e escolha **Criar bucket.**

1. Repita as etapas de 1 a 3 para criar o bucket de saída. Um exemplo de nome é`codebuild-regionId-accountId-output-bucket`, where `regionId` is the Região da AWS do bucket e `accountId` é seu Conta da AWS ID.

   Independentemente dos nomes que você escolher para esses buckets, não deixe de usá-los ao longo deste tutorial.

## Etapa 3: criar o arquivo de especificações de compilação
<a name="tutorial-build-mf-spec"></a>

Nesta etapa, você cria um arquivo de especificações de compilação. Esse arquivo fornece comandos de compilação e configurações relacionadas, no formato YAML, CodeBuild para executar a compilação. Para obter mais informações, consulte a [referência da especificação de compilação CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) no *Guia AWS CodeBuild do usuário*.

1. Crie um arquivo chamado `buildspec.yml` no diretório que você descompactou como pré-requisito.

1. Adicione o seguinte conteúdo ao arquivo e salve. Nenhuma alteração é necessária para este arquivo.

   ```
   version: 0.2
   env:
     exported-variables:
       - CODEBUILD_BUILD_ID
       - CODEBUILD_BUILD_ARN
   phases:
     install:
       runtime-versions:
         python: 3.7
     pre_build:
       commands:
         - echo Installing source dependencies...
         - ls -lR $CODEBUILD_SRC_DIR/source
     build:
       commands:
         - echo Build started on `date`
         - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target 
     post_build:
       commands:
         - ls -lR $CODEBUILD_SRC_DIR/target
         - echo Build completed on `date`
   artifacts:
     files:
       - $CODEBUILD_SRC_DIR/target/**
   ```

   Aqui`CODEBUILD_BUILD_ID`,`CODEBUILD_BUILD_ARN`,`$CODEBUILD_SRC_DIR/source`, e `$CODEBUILD_SRC_DIR/target` estão as variáveis de ambiente disponíveis em CodeBuild. Para obter mais informações, consulte [Variáveis de ambiente em ambientes de compilação](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html).

   Nesse ponto, seu diretório deve ter a seguinte aparência.

   ```
   (root directory name)
       |-- build.xml
       |-- buildspec.yml
       |-- LICENSE.txt
       |-- source
            |... etc.
   ```

1. Compacte o conteúdo da pasta em um arquivo chamado `BankDemo.zip`. Para este tutorial, não é possível compactar a pasta. Em vez disso, compacte o conteúdo da pasta no arquivo `BankDemo.zip`.

## Etapa 4: fazer upload dos arquivos de origem
<a name="tutorial-build-mf-upload"></a>

Nesta etapa, você carrega o código-fonte do aplicativo de BankDemo amostra no seu bucket de entrada do Amazon S3.

1. Faça login no console do Amazon S3 e escolha **Buckets** no painel de navegação esquerdo. Em seguida, escolha o bucket de entrada que você criou anteriormente.

1. Em **Objetos**, escolha **Carregar**.

1. Na seção **Arquivos e pastas**, escolha **Adicionar arquivos**.

1. Navegue e escolha seu arquivo `BankDemo.zip`.

1. Escolha **Carregar**.

## Etapa 5: criar políticas do IAM
<a name="tutorial-build-mf-IAM-policy"></a>

Nesta etapa, você cria duas [políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Uma política concede permissões para a modernização do AWS mainframe acessar e usar a imagem do Docker que contém as ferramentas de construção da Rocket Software. Essa política não é personalizada para clientes. A outra política concede permissões para que a modernização do AWS mainframe interaja com os buckets de entrada e saída e com os [ CloudWatch registros da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) que são gerados. CodeBuild 

Para saber mais sobre como criar uma política de IAM, consulte [Edição de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) no *Guia do usuário do IAM*.

**Para criar uma política para acessar imagens do Docker**

1. No console do IAM, copie o seguinte documento de política e cole-o no editor de políticas.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:GetAuthorizationToken"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:BatchCheckLayerAvailability",
                   "ecr:GetDownloadUrlForLayer",
                   "ecr:BatchGetImage"
               ],
               "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": "arn:aws:s3:::aws-m2-repo-*-<region>-prod"
           }
       ]
   }
   ```

------

1. Forneça um nome para a política, por exemplo, `m2CodeBuildPolicy`.

**Para criar uma política que permita que a modernização do AWS mainframe interaja com buckets e registros**

1. No console do IAM, copie o seguinte documento de política e cole-o no editor de políticas. Certifique-se de atualizar `regionId` para o Região da AWS, e `accountId` para o seu Conta da AWS.

1. Forneça um nome para a política, por exemplo, `BankdemoCodeBuildRolePolicy`.

## Etapa 6: criar um perfil do IAM
<a name="tutorial-build-mf-IAM-role"></a>

Nesta etapa, você cria uma nova [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que permite CodeBuild interagir com AWS os recursos para você, depois de associar as políticas do IAM que você criou anteriormente a essa nova função do IAM.

Para obter informações sobre a criação de uma função de serviço, consulte [Criação de uma função para delegar permissões a um AWS serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) no *Guia do usuário do IAM*,.

1. Faça login no console do IAM e escolha **Perfis** no painel de navegação esquerdo.

1. Selecione **Criar perfil**.

1. Em **Tipo de entidade confiável**, escolha **Serviço AWS**.

1. **Em Casos de uso para outros serviços da AWS**, escolha e **CodeBuild**, em seguida, escolha **CodeBuild**novamente.

1. Escolha **Próximo**.

1. Na página **Adicionar permissões**, escolha **Próximo**. Você atribui uma política à função posteriormente.

1. Em **Detalhes da função**, forneça um nome para a função, por exemplo,`BankdemoCodeBuildServiceRole`.

1. Em **Selecionar entidades confiáveis**, verifique se o documento de política tem a seguinte aparência:

------
#### [ JSON ]

****  

   ```
   {
             "Version":"2012-10-17",		 	 	 
             "Statement": [
               {
                 "Effect": "Allow",
                 "Principal": {
                   "Service": "codebuild.amazonaws.com"
                 },
                 "Action": "sts:AssumeRole"
               }
             ]
           }
   ```

------

1. Selecione **Criar perfil**.

## Etapa 7: anexar as políticas do IAM ao perfil do IAM
<a name="tutorial-build-mf-attach"></a>

Nesta etapa, você anexa as duas políticas do IAM que criou anteriormente ao perfil `BankdemoCodeBuildServiceRole` do IAM.

1. Faça login no console do IAM e escolha **Perfis** no painel de navegação esquerdo.

1. Em **Perfil do IAM**, escolha a função que você criou anteriormente, por exemplo, `BankdemoCodeBuildServiceRole`.

1. Em **Políticas de permissões**, escolha **Adicionar permissões** e, em seguida, **Anexar políticas**.

1. Em **Outras políticas de permissões**, escolha as políticas que você criou anteriormente, por exemplo, `m2CodeBuildPolicy` e `BankdemoCodeBuildRolePolicy`.

1. Escolha **Anexar políticas**.

## Etapa 8: criar o CodeBuild projeto
<a name="tutorial-build-mf-create-project"></a>

Nesta etapa, você cria o CodeBuild projeto.

1. Faça login no CodeBuild console e escolha **Criar projeto de compilação**.

1. Na seção **Configuração do projeto**, forneça um nome para o projeto, por exemplo, `codebuild-bankdemo-project`.

1. Na seção **Fonte**, em **Provedor de origem**, escolha **Amazon S3** e, em seguida, escolha o bucket de entrada que você criou anteriormente, por exemplo, `codebuild-regionId-accountId-input-bucket`.

1. No campo **Chave do objeto do S3 ou pasta do S3**, insira o nome do arquivo zip que você carregou no bucket do S3. Nesse caso, o nome do arquivo é `bankdemo.zip`.

1. Na seção **Ambiente**, escolha **Imagem personalizada**.

1. No campo **Tipo de ambiente**, escolha **Linux**.

1. Em **Registro de imagens**, escolha **Outro registro**.

1. No campo **URL do registro externo**, 
   + Para Rocket Software v9: Entre. `673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1` Se você estiver usando uma AWS região diferente com o Rocket Software v9, você também pode especificar ` 673918848628.dkr.ecr.<m2-region>.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1` onde <m2-region>está uma AWS região na qual o serviço de modernização de AWS mainframe está disponível (por exemplo,). `eu-west-3`
   + Para Rocket Software v8: Entrar `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
   + Para Rocket Software v7: Entrar `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10`

1. Em **Perfil de serviço**, escolha **Perfil de serviço existente** e, no campo **ARN o perfil**, escolha o perfil de serviço que você criou anteriormente; por exemplo, `BankdemoCodeBuildServiceRole`.

1. Na seção **Buildspec**, escolha **Usar um arquivo buildspec**.

1. Na seção **Artefatos**, em **Tipo**, escolha **Amazon** S3 e, em seguida, escolha seu bucket de saída, por exemplo, `codebuild-regionId-accountId-output-bucket`.

1. No campo **Nome**, insira o nome de uma pasta no bucket que você deseja que contenha os artefatos de saída da compilação, por exemplo, `bankdemo-output.zip`.

1. Em **Embalagem de artefatos**, escolha **Zip**.

1. Selecione **Create build project (Criar projeto de compilação)**.

## Etapa 9: iniciar a compilação
<a name="tutorial-build-mf-start"></a>

Nesta etapa, você inicia a compilação.

1. Faça login no CodeBuild console.

1. No painel de navegação esquerdo, selecione **Criar projetos**.

1. Escolha o projeto de compilação que você criou anteriormente, por exemplo, `codebuild-bankdemo-project`.

1. Selecione **Iniciar compilação**.

Esse comando inicia a compilação. A compilação é executada de forma assíncrona. A saída do comando é um JSON que inclui o id do atributo. Esse id de atributo é uma referência ao id de CodeBuild compilação da compilação que você acabou de iniciar. Você pode ver o status da compilação no CodeBuild console. Você também pode ver logs detalhados sobre a execução da compilação no console. Para obter mais informações, consulte [Exibir informações detalhadas da compilação](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html) no *Guia do usuário do AWS CodeBuild *.

Quando a fase atual for CONCLUÍDA, significa que sua compilação foi concluída com sucesso e que seus artefatos compilados estão prontos no Amazon S3.

## Etapa 10: baixar artefatos de saída
<a name="tutorial-build-mf-download-output"></a>

Nesta etapa, você baixa os artefatos de saída do Amazon S3. A ferramenta de construção da Rocket Software pode criar vários tipos diferentes de executáveis. Neste tutorial, ele gera objetos compartilhados.

1. Faça login no console do Amazon S3.

1. Na seção **Buckets** role="bold">, escolha o nome do bucket de saída, por exemplo, `codebuild-regionId-accountId-output-bucket`.

1. Escolha **Baixar** role="bold">.

1. Não descompacte o arquivo obtido por download. Navegue até a pasta de destino para ver os artefatos de compilação. Isso inclui os objetos compartilhados do `.so` Linux.

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

Se você não precisar mais dos recursos que criou para este tutorial, exclua-os para evitar cobranças adicionais. Para fazer isso, realize as etapas a seguir:
+ Exclua os buckets do S3 que você criou para este tutorial. Para obter mais informações, consulte [Excluir um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) no *Guia do usuário do Amazon Simple Storage Service*.
+ Exclua as políticas de IAM que você criou para este tutorial. Para obter mais informações, consulte [Exclusão de políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) no *Guia do usuário do IAM*.
+ Exclua o perfil do IAM que você criou para este tutorial. Para obter mais informações sobre como excluir uma função, consulte [Excluir funções ou perfis de instância](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) no *Manual do usuário do IAM*.
+ Exclua o CodeBuild projeto que você criou para este tutorial. Para obter mais informações, consulte [Excluir um projeto de compilação CodeBuild no](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html) *Guia AWS CodeBuild do usuário*.

# Tutorial: Configurar WorkSpaces aplicativos para uso com o Rocket Enterprise Analyzer e o Rocket Enterprise Developer
<a name="set-up-appstream-mf"></a>

AWS A modernização do mainframe fornece várias ferramentas por meio do Amazon WorkSpaces Applications. WorkSpaces O Applications é um serviço de streaming de aplicativos totalmente gerenciado e seguro que permite transmitir aplicativos de desktop aos usuários sem reescrever os aplicativos. WorkSpaces Os aplicativos fornecem aos usuários acesso instantâneo aos aplicativos de que precisam, com uma experiência de usuário responsiva e fluida no dispositivo de sua escolha. O uso de WorkSpaces aplicativos para hospedar ferramentas específicas do mecanismo de tempo de execução oferece às equipes de aplicativos do cliente a capacidade de usar as ferramentas diretamente de seus navegadores da web, interagindo com arquivos de aplicativos armazenados em buckets ou repositórios do Amazon S3. CodeCommit 

Para obter informações sobre o suporte de navegadores em WorkSpaces aplicativos, consulte [System Requirements and Feature Support (Web Browser)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) no *Amazon WorkSpaces Applications Administration Guide*. Se você tiver problemas ao usar WorkSpaces aplicativos, consulte [Solução de problemas de usuários AppStream 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) no *Guia de administração de WorkSpaces aplicativos da Amazon*.

Este documento é destinado aos membros da equipe de operações do cliente. Ele descreve como configurar frotas e pilhas da Amazon WorkSpaces Applications para hospedar as ferramentas Rocket Enterprise Analyzer e Rocket Enterprise Developer usadas com a modernização do mainframe. AWS O Rocket Enterprise Analyzer geralmente é usado durante a fase de avaliação e o Rocket Enterprise Developer geralmente é usado durante a fase de migração e modernização da abordagem de modernização do mainframe. AWS Se você planeja usar o Enterprise Analyzer e o Enterprise Developer, deve criar frotas e pilhas separadas para cada ferramenta. Cada ferramenta requer sua própria frota e pilha porque seus termos de licenciamento são diferentes.

**Importante**  
As etapas deste tutorial são baseadas no CloudFormation modelo disponível para download [cfn-m2- .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). appstream-fleet-ea-ed 

**Topics**
+ [

## Pré-requisitos
](#tutorial-aas-prerequisites)
+ [

## Etapa 1: Obtenha as imagens dos WorkSpaces aplicativos
](#tutorial-aas-step1)
+ [

## Etapa 2: criar a pilha usando o modelo CloudFormation
](#tutorial-aas-step2)
+ [

## Etapa 3: criar um usuário nos WorkSpaces aplicativos
](#tutorial-aas-step3)
+ [

## Etapa 4: Faça login nos WorkSpaces aplicativos
](#tutorial-aas-step4)
+ [

## Etapa 5: verificar os buckets no Amazon S3 (opcional)
](#tutorial-aas-step5)
+ [

## Próximas etapas
](#tutorial-aas-next-steps)
+ [

## Limpar os recursos
](#tutorial-aas-cleanup)

## Pré-requisitos
<a name="tutorial-aas-prerequisites"></a>
+ Faça o download do modelo: [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml.
+ Obtenha o ID da sua VPC e do grupo de segurança padrão. Para obter mais informações sobre a VPC padrão, consulte [Padrão VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) no Guia do usuário da Amazon *VPC*. Para ter mais informações sobre o grupo de segurança padrão, consulte [Grupos de segurança padrão e personalizados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) no *Guia do usuário do Amazon EC2*. 
+ Certifique-se de que você tenha as seguintes permissões:
  + crie pilhas, frotas e usuários em WorkSpaces aplicativos.
  + crie pilhas CloudFormation usando um modelo.
  + crie buckets e faça upload de arquivos para buckets no Amazon S3.
  + baixe as credenciais (`access_key_id` e `secret_access_key`) do IAM.

## Etapa 1: Obtenha as imagens dos WorkSpaces aplicativos
<a name="tutorial-aas-step1"></a>

Nesta etapa, você compartilha as imagens de WorkSpaces aplicativos do Enterprise Analyzer e do Enterprise Developer com sua AWS conta.

1. Abra o console de modernização do AWS mainframe em. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)

1. Na navegação à esquerda, selecione **Ferramentas**.

1. Em **Análise, desenvolvimento e criação de ativos**, escolha **Compartilhar ativos com minha AWS conta**.

## Etapa 2: criar a pilha usando o modelo CloudFormation
<a name="tutorial-aas-step2"></a>

Nesta etapa, você usa o CloudFormation modelo baixado para criar uma pilha e uma frota de WorkSpaces aplicativos para executar o Rocket Enterprise Analyzer. Você pode repetir essa etapa posteriormente para criar outra pilha e frota de WorkSpaces aplicativos para executar o Rocket Enterprise Developer, pois cada ferramenta requer sua própria frota e pilha em aplicativos. WorkSpaces Para obter mais informações sobre CloudFormation pilhas, consulte Como [trabalhar com pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) no Guia do *AWS CloudFormation usuário*.

**nota**  
AWS A modernização do mainframe adiciona uma taxa adicional ao preço padrão dos WorkSpaces aplicativos para o uso do Enterprise Analyzer e do Enterprise Developer. Para obter mais informações, consulte [Preço do AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/pricing/).

1. Faça o download do modelo [cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml), se necessário.

1. Abra o CloudFormation console e escolha **Criar pilha** e **com novos recursos (padrão)**.

1. Em **Pré-requisito — Preparar modelo**, selecione **O modelo está pronto**.

1. Em **Especificar modelo**, selecione **Upload de um arquivo de modelo**.

1. Em **Carregar um arquivo de modelo**, **escolha Escolher arquivo** e carregue o modelo [cfn-m2- appstream-fleet-ea-ed .yml.](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)

1. Escolha **Próximo**.  
![\[A página CloudFormation Criar pilha com o modelo cfn-m2- appstream-fleet-ea-ed .yml selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/cfn-create-stack.png)

1. Em **Especificar detalhes da pilha**, insira as seguintes informações:
   + Em **Nome da pilha**, insira um nome de sua escolha. Por exemplo, .**m2-ea**
   + Em **AppStreamApplication**, escolha **chá**.
   + Em **AppStreamFleetSecurityGroup**, escolha o grupo de segurança padrão da sua VPC padrão.
   + Em **AppStreamFleetVpcSubnet**, escolha uma sub-rede em sua VPC padrão.
   + Em **AppStreamImageName**, escolha a imagem começando com`m2-enterprise-analyzer`. Essa imagem contém a versão atualmente suportada da ferramenta Rocket Enterprise Analyzer.
   + Aceite os padrões para os outros campos e selecione **Próximo**.  
![\[A página de CloudFormation especificação de detalhes da pilha com as opções do Enterprise Analyzer preenchidas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/cfn-specify-stack-details.png)

1. Aceite todos os padrões e selecione **Próximo** novamente.

1. Na **revisão**, certifique-se de que todos os parâmetros sejam o que você pretende.

1. Role até o final, escolha **Eu reconheço que a AWS CloudFormation pode criar recursos do IAM com nomes personalizados** e escolha **Create Stack**.

A pilha e a frota demoram entre 20 e 30 minutos para serem criadas. Você pode escolher **Atualizar** para ver os CloudFormation eventos à medida que eles ocorrem. 

## Etapa 3: criar um usuário nos WorkSpaces aplicativos
<a name="tutorial-aas-step3"></a>

Enquanto espera CloudFormation a conclusão da criação da pilha, você pode criar um ou mais usuários em WorkSpaces Aplicativos. Esses usuários são aqueles que usarão o Enterprise Analyzer em WorkSpaces aplicativos. Você precisará especificar um endereço de e-mail para cada usuário e garantir que cada usuário tenha permissões suficientes para criar buckets no Amazon S3, fazer upload de arquivos em um bucket e vincular a um bucket para mapear seu conteúdo.

1. Abra o console de WorkSpaces aplicativos.

1. Na navegação à esquerda, selecione **Grupo de usuários**.

1. Selecione **Criar usuário**.

1. Forneça um endereço de e-mail onde o usuário possa receber um convite por e-mail para usar os WorkSpaces Aplicativos, um nome e sobrenome e escolha **Criar usuário**.

1. Repita, se necessário, para criar mais usuários. O endereço de e-mail de cada usuário deve ser exclusivo.

Para obter mais informações sobre a criação de usuários de WorkSpaces aplicativos, consulte [WorkSpaces Grupos de usuários](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) de aplicativos no *Guia de administração de WorkSpaces aplicativos da Amazon*.

Ao CloudFormation terminar de criar a pilha, você pode atribuir o usuário que você criou à pilha, da seguinte forma:

1. Abra o console de WorkSpaces aplicativos.

1. Clique no nome de usuário.

1. Escolha **Ação** e, em seguida, **Atribuir pilha**.

1. Em **Atribuir pilha**, escolha a pilha que começa com `m2-appstream-stack-ea`.

1. Escolha **Assign stack**.  
![\[A página WorkSpaces Applications Assign stack mostrando um usuário e a pilha do Enterprise Analyzer a serem atribuídos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-assign-stack.png)

Atribuir um usuário a uma pilha faz com que os WorkSpaces Aplicativos enviem um e-mail para o usuário no endereço que você forneceu. Este e-mail contém um link para a página de login dos WorkSpaces aplicativos.

## Etapa 4: Faça login nos WorkSpaces aplicativos
<a name="tutorial-aas-step4"></a>

Nesta etapa, você faz login nos WorkSpaces Aplicativos usando o link no e-mail enviado pelos WorkSpaces Aplicativos ao usuário em que você criou[Etapa 3: criar um usuário nos WorkSpaces aplicativos](#tutorial-aas-step3).

1. Faça login nos WorkSpaces Aplicativos usando o link fornecido no e-mail enviado pelos WorkSpaces Aplicativos.

1. Altere sua senha, se solicitado. A tela WorkSpaces Aplicativos que você vê é semelhante à seguinte:  
![\[Um exemplo de tela de login de WorkSpaces aplicativos mostrando o ícone da área de trabalho.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-login-screen.png)

1. Escolha **Desktop**.

1. Na barra de tarefas, escolha **Pesquisar** e digite **D:** para navegar até a Pasta Pessoal.
**nota**  
Se você pular essa etapa, poderá receber uma `Device not ready` mensagem de erro ao tentar acessar a Pasta Pessoal.

A qualquer momento, se você tiver problemas para entrar nos WorkSpaces Aplicativos, poderá reiniciar sua frota de WorkSpaces Aplicativos e tentar fazer login novamente, usando as etapas a seguir.

1. Abra o console de WorkSpaces aplicativos.

1. No painel de navegação à esquerda, escolha **Frotas**.

1. Escolha a frota que você está tentando usar.

1. Escolha **Ação** e, em seguida, escolha **Parar**.

1. Espere a frota parar.

1. Escolha **Ação** e, em seguida, escolha **Iniciar**.

Esse processo pode levar cerca de 10 minutos.

## Etapa 5: verificar os buckets no Amazon S3 (opcional)
<a name="tutorial-aas-step5"></a>

Uma das tarefas concluídas pelo CloudFormation modelo que você usou para criar a pilha foi criar dois buckets no Amazon S3, que são necessários para salvar e restaurar os dados do usuário e as configurações do aplicativo em todas as sessões de trabalho. Esses buckets são os seguintes:
+ O nome começa com `appstream2-`. Esse bucket mapeia os dados para sua pasta inicial em WorkSpaces Applications (`D:\PhotonUser\My Files\Home Folder`).
**nota**  
A Pasta Inicial é exclusiva para um determinado endereço de e-mail e é compartilhada entre todas as frotas e pilhas em uma determinada conta AWS . O nome da Pasta Pessoal é um SHA256 hash do endereço de e-mail do usuário e é armazenado em um caminho baseado nesse hash.
+ O nome começa com `appstream-app-settings-`. Esse bucket contém informações da sessão do usuário para WorkSpaces aplicativos e inclui configurações como favoritos do navegador, perfis de conexão do IDE e do aplicativo e personalizações da interface do usuário. Para obter mais informações, consulte [Como funciona a persistência das configurações do aplicativo](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) no *Amazon WorkSpaces Applications Administration Guide*.

Para verificar se os buckets foram criados, siga estas etapas:

1. Abra o console Amazon S3.

1. Na navegação à esquerda, escolha **Buckets**.

1. Em **Localizar compartimentos por nome**, insira **appstream** para filtrar a lista.

Não é necessário realizar nenhuma ação adicional se você ver os compartimentos. Esteja ciente de que os buckets existem. Se você não vê os buckets, significa que o CloudFormation modelo não terminou de ser executado ou ocorreu um erro. Acesse o CloudFormation console e revise as mensagens de criação da pilha.

## Próximas etapas
<a name="tutorial-aas-next-steps"></a>

Agora que a infraestrutura de WorkSpaces aplicativos está configurada, você pode configurar e começar a usar o Enterprise Analyzer. Para obter mais informações, consulte [Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces](set-up-ea.md). Também é possível configurar o Enterprise Developer. Para obter mais informações, consulte [Tutorial: Configurar o Rocket Enterprise Developer em aplicativos WorkSpaces](set-up-ed.md).

## Limpar os recursos
<a name="tutorial-aas-cleanup"></a>

O procedimento para limpar a pilha e as frotas criadas é descrito em [Criar uma frota e uma pilha de WorkSpaces aplicativos](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html).

Quando os objetos de WorkSpaces aplicativos forem excluídos, o administrador da conta também poderá, se apropriado, limpar os buckets do Amazon S3 para configurações do aplicativo e pastas iniciais.

**nota**  
A pasta inicial de um determinado usuário é exclusiva em todas as frotas, portanto, talvez seja necessário mantê-la se outras pilhas de WorkSpaces aplicativos estiverem ativas na mesma conta.

Por fim, WorkSpaces os aplicativos atualmente não permitem que você exclua usuários usando o console. Em vez disso, você deve usar a API de serviço com a CLI. Para obter mais informações, consulte [Administração de grupos de usuários](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) no *Amazon WorkSpaces Applications Administration Guide*.

# Tutorial: Use modelos com o Rocket Enterprise Developer (antigo Micro Focus Enterprise Developer)
<a name="tutorial-templates-ed"></a>

Este tutorial descreve como usar modelos e projetos predefinidos com o Rocket Enterprise Developer. Ele abrange três casos de uso. Todos os casos de uso usam o código de amostra fornecido na BankDemo amostra. Para baixar a amostra, escolha [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip).

**Importante**  
Se você usar a versão do Enterprise Developer para Windows, os binários gerados pelo compilador poderão ser executados somente no Enterprise Server fornecido com o Enterprise Developer. Você não pode executá-los no tempo de execução da Modernização do AWS Mainframe, que é baseado no Linux.

**Topics**
+ [

## Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem
](#tutorial-templates-ed-step1)
+ [

## Caso de uso 2 - Usando o modelo de projeto COBOL sem componentes de origem
](#tutorial-templates-ed-step2)
+ [

## Caso de uso 3 - Usando o projeto COBOL predefinido vinculado às pastas de origem
](#tutorial-templates-ed-step3)
+ [

## Usando o modelo JSON de definição de região
](#tutorial-templates-ed-step4)

## Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem
<a name="tutorial-templates-ed-step1"></a>

Esse caso de uso exige que você copie os componentes de origem na estrutura de diretórios do modelo como parte das etapas de pré-configuração da demonstração. No, [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)isso foi alterado em relação à `AWSTemplates.zip` entrega original para evitar duas cópias da fonte.

1. Inicie o Enterprise Developer e especifique o espaço de trabalho escolhido.  
![\[O lançador do Eclipse com um espaço de trabalho selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step1.png)

1. Na visualização do **Explorador de Aplicações**, no item de visualização em árvore **do Enterprise Development** Project, escolha **Novo projeto a partir do modelo** no menu de contexto.  
![\[O menu de contexto da visualização em árvore do projeto de desenvolvimento corporativo.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step2.png)

1. Insira os parâmetros do modelo conforme indicado.
**nota**  
O caminho do modelo se referirá ao local onde o ZIP foi extraído.  
![\[A caixa Inserir parâmetros do modelo com o caminho e o nome do projeto preenchidos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step3.png)

1. Escolher OK criará um projeto Eclipse de desenvolvimento local com base no modelo fornecido, com uma estrutura completa do ambiente de origem e execução.  
![\[O projeto Eclipse de desenvolvimento local mostrando sua estrutura.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc1-step4.png)

   A estrutura `System` contém um arquivo completo de definição de recursos com as entradas necessárias para o BANKDEMO, o catálogo necessário com entradas adicionadas e os arquivos de dados ASCII correspondentes.

   Como a estrutura do modelo de origem contém todos os itens de origem, esses arquivos são copiados para o projeto local e, portanto, são criados automaticamente no Enterprise Developer.

## Caso de uso 2 - Usando o modelo de projeto COBOL sem componentes de origem
<a name="tutorial-templates-ed-step2"></a>

As etapas 1 a 3 são idênticas [Caso de uso 1 - Usando o modelo de projeto COBOL contendo componentes de origem](#tutorial-templates-ed-step1) a. 

A `System` estrutura nesse caso de uso também contém um arquivo completo de definição de recursos com as entradas necessárias para BankDemo, o catálogo necessário com entradas adicionadas e os arquivos de dados ASCII correspondentes.

No entanto, a estrutura de origem do modelo não contém nenhum componente. Você deve importá-los para o projeto a partir de qualquer repositório de origem que estiver usando.

1. Escolha o nome do projeto. No menu de contexto relacionado, escolha **Importar**.  
![\[O menu de contexto do projeto com a importação selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step4.png)

1. Na caixa de diálogo resultante, na seção **Geral**, escolha **Sistema de arquivos** e, em seguida, escolha Próximo.  
![\[A caixa Importar com o sistema de arquivos selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step5.png)

1. Preencha o campo **Do diretório** navegando no sistema de arquivos para apontar para a pasta do repositório. Escolha todas as pastas que você deseja importar, como `sources`. O `Into folder` campo será preenchido automaticamente. Escolha **Concluir**.   
![\[A caixa Sistema de arquivos com o BankDemo diretório expandido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc2-step6.png)

   Depois que a estrutura do modelo de origem contém todos os itens de origem, eles são criados automaticamente no Enterprise Developer.

## Caso de uso 3 - Usando o projeto COBOL predefinido vinculado às pastas de origem
<a name="tutorial-templates-ed-step3"></a>

1. Inicie o Enterprise Developer e especifique o espaço de trabalho escolhido.  
![\[O lançador do Eclipse com um espaço de trabalho selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step1.png)

1. No menu **File (Arquivo)**, escolha **Import (Importar)**.  
![\[O menu Arquivo com a opção Importar selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step2.png)

1. Na caixa de diálogo resultante, em **Geral**, escolha **Projetos da pasta ou do arquivo** e escolha **Próximo**.  
![\[A caixa Importar com projetos da pasta ou arquivo selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step3.png)

1. Preencha a **fonte de importação**, escolha o **diretório** e navegue pelo sistema de arquivos para selecionar a pasta predefinida do projeto. O projeto contido nele tem links para as pastas de origem no mesmo repositório.  
![\[A importação de projetos do sistema de arquivos ou da caixa de arquivamento com o caminho para a fonte de importação inserido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-uc3-step4.png)

   Escolha **Terminar**.

   Como o projeto é preenchido pelos links para a pasta de origem, o código é criado automaticamente.

## Usando o modelo JSON de definição de região
<a name="tutorial-templates-ed-step4"></a>

1. Alterne para a visualização Server Explorer. No menu de contexto relacionado, escolha **Abrir página de administração**, que inicia o navegador padrão.  
![\[O menu de contexto do explorador de servidores com a página de administração aberta selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-admin-page.png)

1. Na tela resultante do Enterprise Server Common Web Administration (ESCWA), escolha **Importar**.  
![\[A tela Enterprise Server Common Web Administration com a opção Importar selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-import.png)

1. Escolha o tipo de importação **JSON** e escolha **Avançar**.  
![\[A caixa de escolha do tipo de importação com JSON selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-import-type.png)

1. Faça o upload do arquivo `BANKDEMO.JSON` fornecido.  
![\[A caixa de escolha do arquivo para upload com o arquivo BANKDEMO selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-upload.png)

   Depois de selecionado, escolha **Avançar**.  
![\[A caixa de seleção de regiões com portas claras de endpoints não selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-next.png)

   No painel **Selecionar regiões**, certifique-se de que a opção **Limpar portas dos endpoints** não esteja selecionada e continue escolhendo **Avançar nos** painéis até que o painel **Executar importação** seja exibido. Depois, escolha **Importar** no painel de navegação esquerdo.

   Por fim, clique em **Concluir**. A região BANKDEMO será então adicionada à lista de servidores.  
![\[A lista de regiões e servidores BankDemo foi adicionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-server-list.png)

1. Navegue até as **Propriedades Gerais** da região BANKDEMO.

1. Role até a seção **Configuration** (Configuração).

1. A variável de ambiente ESP precisa ser definida na `System` pasta relevante para o Projeto Eclipse criado nas etapas anteriores. Deve ser `workspacefolder/projectname/System`.  
![\[A seção de configuração com a variável ESP mostrada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-ESP.png)

1. Clique em **Aplicar**.

   A região agora está totalmente configurada para ser executada em conjunto com o projeto Eclipse COBOL.

1. Por fim, de volta ao Enterprise Developer, associe a região importada ao projeto.  
![\[O menu de contexto do projeto com Associado ao projeto selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ed-json-associate.png)

   O ambiente Enterprise Developer agora está pronto para uso, com uma versão funcional completa do BankDemo. Você pode editar, compilar e depurar o código na região.
**Importante**  
Se você usar a versão do Enterprise Developer para Windows, os binários gerados pelo compilador poderão ser executados somente no Enterprise Server fornecido com o Enterprise Developer. Você não pode executá-los no tempo de execução da Modernização do AWS Mainframe, que é baseado no Linux.

# Tutorial: Configurar o Enterprise Analyzer em aplicativos WorkSpaces
<a name="set-up-ea"></a>

Este tutorial descreve como configurar o Rocket Enterprise Analyzer (antigo Micro Focus Enterprise Analyzer) para analisar um ou mais aplicativos de mainframe. A ferramenta Enterprise Analyzer fornece vários relatórios com base em sua análise do código-fonte da aplicação e das definições do sistema.

Essa configuração foi projetada para promover a colaboração em equipe. A instalação usa um bucket do Amazon S3 para compartilhar o código-fonte com discos virtuais. Isso faz uso do [Rclone](https://rclone.org/)) na máquina Windows. Com uma instância comum do Amazon RDS executando o [PostgreSQL](https://www.postgresql.org/), qualquer membro da equipe pode acessar todos os relatórios solicitados.

Os membros da equipe também podem montar o disco virtual com suporte do Amazon S3 em suas máquinas pessoais e atualizar o bucket de origem a partir de suas estações de trabalho. Eles podem potencialmente usar scripts ou qualquer outra forma de automação em suas máquinas se estiverem conectados a outros sistemas internos locais.

A configuração é baseada nas imagens do WorkSpaces Applications Windows que a AWS Mainframe Modernization compartilha com o cliente. A configuração também se baseia 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 com o CloudFormation modelo disponível para download [cfn-m2- .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml). 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).  
Para executar as etapas neste tutorial, você deve ter configurado a frota e a pilha do Enterprise Analyzer e elas devem estar em execução.

Para obter uma descrição completa dos recursos e resultados do Enterprise Analyzer, consulte a [documentação do Enterprise Analyzer](https://www.microfocus.com/documentation/enterprise-analyzer/) no site da Rocket Software (antiga Micro Focus).

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

Além da própria aplicação Enterprise Analyzer, a imagem 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`.

**Topics**
+ [

## Conteúdo da imagem
](#set-up-ea-image-contents)
+ [

## Pré-requisitos
](#tutorial-ea-prerequisites)
+ [

## Etapa 1: configuração
](#tutorial-ea-step1)
+ [

## Etapa 2: criar a pasta virtual baseada no Amazon S3 no Windows
](#tutorial-ea-step2)
+ [

## Etapa 3: criar uma fonte de ODBC para a instância do Amazon RDS
](#tutorial-ea-step3)
+ [

## Sessões subsequentes
](#tutorial-ea-step4)
+ [

## Solução de problemas de conexão do espaço de trabalho
](#tutorial-ea-step5)
+ [

## Limpar os recursos
](#tutorial-ea-clean)

## Pré-requisitos
<a name="tutorial-ea-prerequisites"></a>
+ Faça upload do código-fonte e das definições do sistema para a aplicação do cliente que você deseja analisar em um bucket do S3. As definições do sistema incluem CICS CSD, definições de DB2 objetos e assim por diante. Você pode criar uma estrutura de pastas dentro do bucket que faça sentido para a forma como você deseja organizar os artefatos da aplicação. Por exemplo, quando você descompacta a BankDemo amostra, ela tem a seguinte estrutura:

  ```
  demo
       |--> jcl
       |--> RDEF
       |--> transaction
       |--> xa
  ```
+ Crie e inicie uma instância do Amazon RDS executando PostgreSQL. Essa instância armazenará os dados e os resultados produzidos pelo Enterprise Analyzer. Você pode compartilhar essa instância com todos os membros da equipe da aplicação. Além disso, crie um esquema vazio chamado `m2_ea` (ou qualquer outro nome adequado) no banco de dados. Defina credenciais para usuários autorizados que lhes permitam criar, inserir, atualizar e excluir itens nesse esquema. Você pode obter o nome do banco de dados, o URL do endpoint do servidor e a porta TCP no console do Amazon RDS ou no administrador da conta.
+ Certifique-se de ter configurado o acesso programático ao seu Conta da AWS. Para obter mais informações, consulte [Acesso programático](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) no *Referência geral da Amazon Web Services*.

## Etapa 1: configuração
<a name="tutorial-ea-step1"></a>

1. Inicie uma sessão com WorkSpaces Aplicativos com a URL que você recebeu na mensagem de e-mail de boas-vindas dos WorkSpaces Aplicativos.

1. Use seu e-mail como ID de usuário e defina sua senha permanente.

1. Selecione a pilha do Enterprise Analyzer.

1. Na página do menu WorkSpaces Aplicativos, escolha **Área de trabalho** para acessar a área de trabalho do Windows que a frota está transmitindo.

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

**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: criar uma fonte de ODBC para a instância do Amazon RDS
<a name="tutorial-ea-step3"></a>

1. Para iniciar a ferramenta EA\$1Admin, navegue até o menu seletor de aplicações no canto superior esquerdo da janela do navegador e escolha **MF EA\$1Admin.**

1. No menu **Administrar**, escolha **Fontes de dados ODBC** e escolha **Adicionar** na guia **DSN do usuário**.

1. Na caixa de diálogo Criar nova fonte de dados, escolha o driver **PostgreSQL Unicode** e, em seguida, selecione **Concluir**.

1. Na caixa de diálogo **Configuração do driver ODBC PostgreSQL Unicode (psqlODBC)**, defina e anote o nome da fonte de dados que você deseja. Preencha os seguintes parâmetros com os valores da instância do RDS que você criou anteriormente:  
**Description**  
Descrição opcional para ajudá-lo a identificar essa conexão de banco de dados rapidamente.  
**Banco de dados**  
O banco de dados do Amazon RDS que você criou anteriormente.  
**Servidor**  
O endpoint do Amazon RDS.  
**Porta**  
A porta do Amazon RDS.  
**Nome de usuário**  
Conforme definido na instância do Amazon RDS.  
**Senha**  
Conforme definido na instância do Amazon RDS.

1. Escolha **Testar** para validar se a conexão com o Amazon RDS foi bem-sucedida e, em seguida, escolha **Salvar** para salvar seu novo DSN de usuário.

1. Espere até ver a mensagem que confirma a criação do espaço de trabalho adequado e, em seguida, escolha **OK** para finalizar com as fontes de dados ODBC e fechar a ferramenta EA\$1Admin.

1. Navegue novamente até o menu do seletor de aplicações e escolha Enterprise Analyzer para iniciar a ferramenta. Selecione **Criar novo**. 

1. Na janela de configuração do espaço de trabalho, insira o nome do espaço de trabalho e defina sua localização. O espaço de trabalho pode ser o disco baseado no Amazon S3, se você trabalhar com essa configuração, ou sua pasta inicial, se preferir.

1. Escolha **Escolher outro banco de dados** para se conectar à sua instância do Amazon RDS.

1. Escolha o ícone do **Postgre** nas opções e, depois, escolha **OK**.

1. Para as configurações do Windows, em **Opções — Definir parâmetros de conexão**, insira o nome da fonte de dados que você criou. Insira também o nome do banco de dados, o nome do esquema, o nome do usuário e a senha. Escolha **OK**.

1. Aguarde até que o Enterprise Analyzer crie todas as tabelas, índices, etc. necessários para armazenar os resultados. Essa etapa pode levar alguns minutos. O Enterprise Analyzer confirma quando o banco de dados e o espaço de trabalho estão prontos para uso.

1. Navegue novamente até o menu do seletor de aplicações e escolha Enterprise Analyzer para iniciar a ferramenta.

1. A janela de inicialização do Enterprise Analyzer aparece no novo local selecionado do espaço de trabalho. Escolha **OK**.

1. Navegue até seu repositório no painel esquerdo, selecione o nome do repositório e escolha **Adicionar arquivos/pastas ao seu espaço de trabalho**. Selecione a pasta em que o código da aplicação está armazenado para adicioná-lo ao espaço de trabalho. Você pode usar o código de BankDemo exemplo anterior, se quiser. Quando o Enterprise Analyzer solicitar que você verifique esses arquivos, escolha **Verificar** para iniciar o relatório de verificação inicial do Enterprise Analyzer. A conclusão pode levar alguns minutos, dependendo do tamanho da aplicação.

1. Expanda seu espaço de trabalho para ver os arquivos e pastas que você adicionou ao espaço de trabalho. Os tipos de objetos e os relatórios de complexidade ciclomática também são visíveis no quadrante superior do painel **Visualizador de gráficos**.

Agora você pode usar o Enterprise Analyzer para todas as tarefas necessárias.

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

1. Inicie uma sessão com WorkSpaces Aplicativos com a URL que você recebeu na mensagem de e-mail de boas-vindas dos WorkSpaces Aplicativos.

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

1. Selecione a pilha do Enterprise Analyzer.

1. Inicie `Rclone` para se conectar ao disco suportado pelo Amazon S3 se você usar essa opção para compartilhar os arquivos do espaço de trabalho.

1. Inicie o Enterprise Analyzer para fazer suas tarefas.

## Solução de problemas de conexão do espaço de trabalho
<a name="tutorial-ea-step5"></a>

Ao tentar se reconectar ao seu espaço de trabalho do Enterprise Analyzer, você pode ver um erro como este:

```
Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?
```

Para resolver esse problema, escolha **OK** para limpar a mensagem e conclua as etapas a seguir.

1. Em WorkSpaces Aplicativos, escolha o ícone **Iniciar Aplicativo** na barra de ferramentas e, em seguida, escolha **EA\$1Admin** para iniciar a ferramenta de administração do Enterprise Analyzer.  
![\[O menu seletor de inicialização de WorkSpaces aplicativos com a ferramenta de administração do Rocket Enterprise Developer selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-launch-selector.png)

1. No menu **Administrar**, escolha **Atualizar caminho do espaço de trabalho…**.  
![\[Menu de administração da ferramenta de administração do Rocket Enterprise Analyzer com a opção Refresh Workspace Path selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-administer-refresh.png)

1. Em **Selecionar espaço de trabalho**, escolha o espaço de trabalho desejado e, em seguida, escolha **OK**.  
![\[A caixa de diálogo Selecionar espaço de trabalho da ferramenta de administração do Rocket Enterprise Analyzer com um projeto selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-select-workspace.png)

1. Escolha **OK** para confirmar a mensagem de erro.  
![\[A mensagem de erro do Enterprise Analyzer “Não é possível acessar o diretório do espaço de trabalho” com a opção OK selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-select-workspace-error.png)

1. Em **Caminho de rede do diretório Workspace**, insira o caminho correto para seu espaço de trabalho, por exemplo, `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`.  
![\[A caixa de diálogo Enterprise Analyzer Caminho de rede do diretório Workspace com um exemplo de caminho.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)

1. Feche a ferramenta de administração do Micro Focus Enterprise Analyzer.  
![\[A ferramenta de administração do Micro Focus Enterprise Analyzer com o botão Fechar selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ea_admin-close.png)

1. Em WorkSpaces Aplicativos, escolha o ícone **Iniciar aplicativo** na barra de ferramentas e, em seguida, escolha **EA** para iniciar o Micro Focus Enterprise Analyzer.  
![\[O ícone de lançamento do aplicativo de WorkSpaces aplicativos com o EA selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-launch-ea.png)

1. Repita as etapas de 3 a 5.

O Micro Focus Enterprise Analyzer agora deve abrir com o espaço de trabalho existente.

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

Se os recursos criados durante este tutorial não forem mais necessários, exclua-os para não incorrer em cobranças adicionais. Execute as etapas a seguir:
+ Use a ferramenta **EA\$1Admin** para excluir o espaço de trabalho.
+ Exclua os buckets do S3 que você criou para este tutorial. Para obter mais informações, consulte [Exclusão de um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) no *Guia do usuário do Amazon S3*.
+ 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).

# 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).