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: Use o AWS Transform para desenvolvedores de mainframe em aplicativos WorkSpaces
Este tutorial mostra como acessar o AWS Transform for mainframe Developer on WorkSpaces Applications e usá-lo com um aplicativo de amostra para que você possa experimentar os recursos. Ao concluir este tutorial, você poderá usar as mesmas etapas em suas próprias aplicações.
**Topics**
+ [Etapa 1: criar um banco de dados](#tutorial-ba-developer-create-db)
+ [Etapa 2: acessar o ambiente](#tutorial-ba-developer-access-env)
+ [Etapa 3: configurar o runtime](#tutorial-ba-developer-set-up-runtime)
+ [Etapa 4: iniciar o Eclipse IDE](#tutorial-ba-developer-start-eclipse)
+ [Etapa 5: configurar um projeto Maven](#tutorial-ba-developer-set-up-maven)
+ [Etapa 6: configurar um servidor Tomcat](#tutorial-ba-developer-config-tomcat)
+ [Etapa 7: implantar no Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [Etapa 8: criar o banco de dados do JICS](#tutorial-ba-developer-create-jics)
+ [Etapa 9: iniciar e testar a aplicação](#tutorial-ba-developer-test-app)
+ [Etapa 10: depurar a aplicação](#tutorial-ba-developer-debug)
+ [Limpar os recursos](#tutorial-ba-developer-clean)
## Etapa 1: criar um banco de dados
Nesta etapa, você usa o Amazon RDS para criar um banco de dados PostgreSQL gerenciado que a aplicação de demonstração usa para armazenar informações de configuração.
1. Abra o console do Amazon RDS.
1. Escolha **Bancos de dados > Criar banco de dados**.
1. Escolha **Standard create > PostgreSQL**, deixe a versão padrão e escolha **Free tier**.
1. Escolha um identificador de instância de BD.
1. Em **Configurações de credenciais**, escolha **Gerenciar credenciais mestre no AWS Secrets Manager**. Para obter mais informações, consulte [Gerenciamento de senhas com Amazon RDS e o AWS Secrets Manager](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) no *Guia do usuário do Amazon RDS*.
1. Certifique-se de que a VPC seja a mesma que você usa para a instância WorkSpaces Applications. Você pode solicitar esse valor ao administrador.
1. Para o **grupo de segurança VPC**, escolha **Criar novo**.
1. Defina **Acesso público** como **Sim**.
1. Deixe todos os outros valores padrão. Analise esses valores.
1. Selecione **Criar banco de dados**.
Para tornar o servidor de banco de dados acessível a partir da sua instância, selecione o servidor de banco de dados no Amazon RDS. Em **Conectividade e segurança**, escolha o grupo de segurança VPC para o servidor de banco de dados. Esse grupo de segurança foi criado anteriormente para você e deve ter uma descrição semelhante à do **console de gerenciamento Criado pelo RDS**. Escolha **Ação > Editar regras de entrada**, escolha **Adicionar regra** e crie uma regra do tipo **PostgreSQL**. Para fonte de regra, use o grupo de segurança **padrão**. Você pode começar a digitar o nome da fonte no campo **Fonte** e, em seguida, aceitar a ID sugerida. Por fim, escolha **Salvar regras**.
## Etapa 2: acessar o ambiente
Nesta etapa, você acessa o ambiente de desenvolvimento do AWS Transform for mainframe em WorkSpaces aplicativos.
1. Entre em contato com seu administrador para saber a maneira correta de acessar sua instância de WorkSpaces aplicativos. Para obter informações gerais sobre possíveis clientes e configurações, consulte [WorkSpaces Applications Access Methods and Clients](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) no *Amazon WorkSpaces Applications Administration Guide*. Considere usar o cliente nativo para obter a melhor experiência.
1. Em WorkSpaces Aplicativos, escolha **Desktop**.
## Etapa 3: configurar o runtime
Nesta etapa, você configura o tempo de execução do AWS Transform for mainframe. Você deve configurar o runtime na primeira inicialização e novamente se for notificado sobre uma atualização do runtime. Essa etapa preenche sua pasta `.m2`.
1. Escolha **Aplicações**, na barra de menu, e escolha **Terminal**.
1. Digite o comando:
```
~/_install-velocity-runtime.sh
```
## Etapa 4: iniciar o Eclipse IDE
Nesta etapa, você inicia o Eclipse IDE e escolhe um local onde deseja criar um espaço de trabalho.
1. Em WorkSpaces Aplicativos, escolha o ícone Iniciar aplicativo na barra de ferramentas e, em seguida, escolha **Eclipse JEE**.
![\[Inicie o ícone do aplicativo na barra de ferramentas em WorkSpaces Aplicativos. O Eclipse JEE está selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/aas-ba-eclipse.png)
1. Quando o inicializador abrir, insira o local em que você deseja criar seu espaço de trabalho e escolha **Iniciar**.
![\[AWS Transform for mainframeLançador do Eclipse IDE em WorkSpaces aplicativos. O espaço de trabalho está selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-launcher.png)
Opcionalmente, você pode iniciar o Eclipse a partir da linha de comando, da seguinte forma:
```
~/eclipse &
```
## Etapa 5: configurar um projeto Maven
Nesta etapa, você importará um projeto em Maven para a aplicação de demonstração Planets.
1. Faça [PlanetsDemoo upload de -pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) para sua pasta inicial. Você pode usar o recurso “Meus arquivos” do cliente nativo para fazer isso.
1. Use a ferramenta de linha de `unzip` comando para extrair os arquivos.
1. Navegue dentro da pasta descompactada e abra a raiz `pom.xml` do seu projeto em um editor de texto.
1. Edite a `gapwalk.version` propriedade para que ela corresponda ao tempo de execução do AWS Transform for mainframe instalado.
Se não tiver certeza da versão instalada, emita o seguinte comando em um terminal:
```
cat ~/runtime-version.txt
```
Esse comando imprime a versão de runtime atualmente disponível, por exemplo, `3.1.0-b3257-dev`.
**nota**
Não inclua o sufixo `-dev` em `gapwalk.version`. Por exemplo, um valor válido seria `3.1.0-b3257`.
1. Em Eclipse, escolha **Arquivo** e **Importar**. Na janela de diálogo **Importar**, expanda **Maven** e escolha **Projetos existentes do Maven**. Escolha **Próximo**.
1. Em **Importar projetos do Maven**, forneça a localização dos arquivos extraídos e escolha **Concluir**.
Você pode ignorar isso com segurança. O Maven baixa uma cópia local do `node.js` para criar a parte Angular (\$1-web) do projeto:
![\[Mensagem de aviso sobre a falta de node.js.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Espere até o final da compilação. É possível acompanhar a compilação na visualização **Progresso**.
1. No Eclipse, selecione o projeto e escolha **Executar como**. Em seguida, escolha a **instalação do Maven**. Depois que a instalação do Maven for bem-sucedida, ele criará o arquivo `war` em `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`.
## Etapa 6: configurar um servidor Tomcat
Nesta etapa, você configura um servidor Tomcat em que você implanta e inicia sua aplicação compilada.
1. No Eclipse, escolha **Janela > Mostrar visualização > Servidores** para mostrar a visualização **Servidores**:
![\[AWS Transformar para o mainframe Eclipse com a visualização de servidores selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Escolha **Nenhum servidor está disponível. Clique neste link para criar um novo servidor...** . O assistente de **Novo servidor** é exibido. No campo **Selecionar o tipo de servidor** do assistente, digite **tomcat v9** e escolha **Servidor Tomcat v9.0**. Escolha **Próximo**.
![\[A caixa de diálogo Novo servidor. O servidor Tomcat v9.0 está selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Escolha **Procurar** e escolha a pasta **tomcat** na raiz da pasta inicial. Deixe o JRE em seu valor padrão e escolha **Concluir**.
Um projeto de **servidores** é criado no espaço de trabalho, e um servidor Tomcat v9.0 agora está disponível na visualização de **servidores.** É aqui que a aplicação compilada será implantada e iniciada:
![\[AWS Transforme a guia Servidores Eclipse para mainframe com o novo servidor Tomcat listado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Etapa 7: implantar no Tomcat
Nesta etapa, você implantará a aplicação de demonstração Planets no servidor Tomcat para poder executar a aplicação.
1. Selecione o arquivo `PlanetsDemo-web` e escolha **Executar como > Instalação do Maven**. Selecione `PlanetsDemo-web` novamente e escolha **Atualizar** para garantir que o frontend compilado com npm seja compilado corretamente em um .war e seja notado pelo Eclipse.
1. Faça upload do [PlanetsDemo-runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) na instância e descompacte o arquivo em um local acessível. Isso garante que a aplicação de demonstração possa acessar as pastas e arquivos de configuração necessários.
1. Copie o conteúdo de `PlanetsDemo-runtime/tomcat-config` na subpasta `Servers/Tomcat v9.0...` que você criou para o seu servidor Tomcat:
![\[AWS Transforme para a subpasta Eclipse Tomcat v9.0 do mainframe e os arquivos que ela contém.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Abra a entrada do servidor `tomcat v9.0` na visualização Servidores. O editor de propriedades do servidor aparece:
![\[O editor de propriedades do servidor. A guia Visão geral está selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. Na guia **Visão geral**, aumente os valores de **tempo limite** para 450 segundos para Iniciar e 150 segundos para Parar, conforme mostrado aqui:
![\[Valor do tempo limite inicial definido para 450 segundos. Valor de tempo limite de parada definido para 150 segundos.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Escolha **Abrir configuração de lançamento**. É exibido um assistente. No assistente, navegue até a pasta **Argumentos** e, em **Diretório de trabalho**, escolha **Outro**. Escolha **Sistema de arquivos** e navegue até a `PlanetsDemo-runtime` pasta descompactada anteriormente. Essa pasta deve conter uma subpasta direta chamada **config**.
![\[A caixa de diálogo Editar configurações com o diretório de trabalho especificado no campo Outro.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Escolha a guia **Módulos** do editor de propriedades do servidor e faça as seguintes alterações:
+ Escolha **Adicionar módulo Web** e adicione `PlanetsDemo-service`.
+ Escolha **Adicionar módulo Web externo**. A janela de diálogo **Adicionar módulo Web** é exibida. Faça as seguintes alterações em:
+ Na **base de documentos**, escolha **Procurar** e navegue até `~/webapps/gapwalk-application...war`
+ Em **Caminho**, insira`/gapwalk-application`.
+ Escolha OK.
+ Escolha **Adicionar módulo Web externo** novamente e faça as seguintes alterações:
+ Para **Document base**, insira o caminho para o frontend .war (in) `PlanetsDemo-web/target`
+ Em **Path**, insira `/demo`
+ Escolha OK
+ Salve as modificações do editor (Ctrl \$1 S).
O conteúdo do editor agora deve ser semelhante ao seguinte.
![\[A guia Módulos Web para as propriedades do servidor Tomcat com os módulos listados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Etapa 8: criar o banco de dados do JICS
Nesta etapa, você se conecta ao banco de dados do criado em [Etapa 1: criar um banco de dados](#tutorial-ba-developer-create-db).
1. Na instância WorkSpaces Applications, execute o seguinte comando em um terminal para iniciar`pgAdmin`:
```
./pgadmin-start.sh
```
1. Escolha um endereço de e-mail e uma senha como identificadores de login. Anote o URL fornecido (normalmente http://127.0.0.1:5050). Inicie o Google Chrome na instância, copie e cole o URL no navegador e faça login com seus identificadores.
![\[A caixa de diálogo de login do pgAdmin.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Depois de fazer login, escolha **Adicionar novo servidor** e insira as informações de conexão no banco de dados criado anteriormente da seguinte maneira.
![\[A caixa de diálogo pgAdmin Register Server. A guia Conexão está selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Ao se conectar ao servidor do banco de dados, use **Objeto > Criar > Banco de dados** e crie um novo banco de dados chamado **jics**.
1. Edite as informações de conexão do banco de dados que a aplicação de demonstração usou. Essas informações são definidas em `PlanetsDemo-runtime/config/application-main.yml`. Pesquise a entrada `jicsDs`. Para recuperar os valores `username` e `password`, no console do Amazon RDS, navegue até o banco de dados. Na guia **Configuration** (Configuração), em **Master Credentials ARN** (ARN das credenciais principais), escolha **Manage in Secrets Manager** (Gerenciar no Secrets Manager). Em seguida, no console do Secrets Manager, no segredo, escolha **Recuperar valor secreto**.
## Etapa 9: iniciar e testar a aplicação
Nesta etapa, você inicia o servidor Tomcat e a aplicação de demonstração para poder testá-la.
1. Para iniciar o servidor Tomcat e as aplicações implantadas anteriormente, selecione a entrada do servidor na visualização Servidores e escolha **Iniciar**. É exibido um console que exibe os logs de inicialização.
1. Verifique o status do servidor na visualização **Servidores** ou aguarde a **inicialização do servidor em [xxx] milissegundos** na mensagem no console. Depois que o servidor for iniciado, verifique se a aplicação gapwalk-application está implantada corretamente. Para fazer isso, acesse a URL **http://localhost:8080/gapwalk-application** em um navegador Google Chrome. Você deverá ver o seguinte.
![\[Mensagem de confirmação mostrando que a aplicação jics está em execução.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Acesse o front-end da aplicação implantada no Google Chrome em http://localhost:8080/demo. A seguinte página do **Transaction Launcher** deve aparecer.
![\[A página do iniciador de transações do JICS.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-jics-launcher.png)
1. Para iniciar a transação da aplicação, insira `PINQ` no campo de entrada e escolha **Executar** (ou pressione Enter).
A tela da aplicação de demonstração deve aparecer.
![\[A tela do PlanetsDemo aplicativo no modo de inserção.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Digite o nome do planeta no campo correspondente e pressione Enter.
![\[A tela do PlanetsDemo aplicativo com a Terra inserida no campo Nome do planeta.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-demo-with-data.png)
## Etapa 10: depurar a aplicação
Nesta etapa, você testará usando os recursos de depuração padrão do Eclipse. Esses recursos estão disponíveis quando você trabalha em uma aplicação modernizada.
1. Para abrir a classe de serviço principal, pressione Ctrl \$1 Shift \$1 T. Em seguida, insira `PlanetsinqProcessImpl`.
![\[A janela de diálogo Eclipse Open Type com a PlanetsinqProcessImpl entrada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Navegue até o método `searchPlanet` e coloque um ponto de interrupção nele.
1. Selecione o nome do servidor e selecione **Reiniciar na depuração**.
1. Repita as etapas anteriores. Ou seja, acesse a aplicação, insira o nome do planeta e pressione Enter.
O Eclipse interromperá a aplicação no método `searchPlanet`. Agora você pode examiná-la.
## Limpar os recursos
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:
+ Se a aplicação Planets ainda estiver em execução, pare-o.
+ Exclua o banco de dados que você criou em [Etapa 1: criar um banco de dados](#tutorial-ba-developer-create-db). Para ter mais informações, consulte [Excluir uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).