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 tempo de execução gerenciado para o AWS Transform for mainframe
Você pode implantar um aplicativo modernizado AWS Transform for mainframe em um ambiente de tempo de execução de modernização de AWS mainframe com um aplicativo de demonstração especificado neste tutorial.
**Topics**
+ [Pré-requisitos](#tutorial-runtime-ba-prerequisites)
+ [Etapa 1: fazer o upload da aplicação de demonstração](#tutorial-runtime-ba-step1)
+ [Etapa 2: criar a aplicação](#tutorial-runtime-ba-step2)
+ [Etapa 3: criar um ambiente de runtime](#tutorial-runtime-ba-step3)
+ [Etapa 4: criar uma aplicação do](#tutorial-runtime-ba-step4)
+ [Etapa 5: implantar uma aplicação](#tutorial-runtime-ba-step5)
+ [Etapa 6: iniciar uma aplicação](#tutorial-runtime-ba-step6)
+ [Etapa 7: acessar a aplicação](#tutorial-runtime-ba-step7)
+ [Etapa 8: Testar o aplicativo](#tutorial-runtime-ba-test)
+ [Limpar os recursos](#tutorial-runtime-ba-clean)
## Pré-requisitos
Para concluir este tutorial, baixe o arquivo de aplicativos de demonstração [PlanetsDemo-v4.zip](https://d2azvcayevmroy.cloudfront.net/tutorials/bluage/PlanetsDemo-v4.zip).
A aplicação de demonstração em execução requer um navegador moderno para acesso. Se você executa esse navegador a partir do seu desktop ou de uma instância do Amazon Elastic Compute Cloud, por exemplo, dentro da VPC, determina suas configurações de segurança.
## Etapa 1: fazer o upload da aplicação de demonstração
Faça upload da aplicação de demonstração em um bucket do Amazon S3. Certifique-se de que esse bucket esteja na mesma Região da AWS em que você implantará a aplicação. O exemplo a seguir mostra um bucket chamado **planets-demo**, com um prefixo de chave, ou pasta, chamado **v1** e um arquivo chamado. `planetsdemo-v4.zip`
![\[O PlanetsDemo bucket no Amazon S3 mostrando o prefixo v1 e o arquivo planetsdemo-v4.zip.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/s3-ba-bucket.png)
**nota**
A pasta no bucket é obrigatória.
## Etapa 2: criar a aplicação
Para implantar um aplicativo no tempo de execução gerenciado, você precisa de uma definição de aplicativo de modernização de AWS mainframe. Essa definição é um arquivo JSON que descreve a localização e as configurações da aplicação. O exemplo a seguir é uma definição de aplicação desse tipo para a aplicação de demonstração:
```
{
"template-version": "2.0",
"source-locations": [{
"source-id": "s3-source",
"source-type": "s3",
"properties": {
"s3-bucket": "planets-demo",
"s3-key-prefix": "v1"
}
}],
"definition": {
"listeners": [{
"port": 8196,
"type": "http"
}],
"ba-application": {
"app-location": "${s3-source}/PlanetsDemo-v4.zip"
}
}
}
```
Altere a `s3-bucket` entrada para o nome do arquivo zip do aplicativo de amostra (por exemplo,`planets-demo`) e a `app-location` entrada para o caminho do S3 em que você armazenou o arquivo zip do aplicativo de amostra (por exemplo,`${s3-source}/PlanetsDemo-v4.zip`).
**nota**
Certifique-se de criar o arquivo de definição do aplicativo em seu local como um arquivo de texto.
Para obter mais informações sobre a definição da aplicação, consulte [AWS Exemplo de definição de aplicativo Transform for mainframe](applications-m2-definition.md#applications-m2-definition-ba).
## Etapa 3: criar um ambiente de runtime
Para criar o ambiente de execução da modernização do AWS mainframe, execute as seguintes etapas:
1. Abra o [console do AWS Mainframe Modernization](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing).
1. No Região da AWS seletor, escolha a região em que você deseja criar o ambiente. Isso Região da AWS deve corresponder à região em que você criou o bucket do S3. [Etapa 1: fazer o upload da aplicação de demonstração](#tutorial-runtime-ba-step1)
1. **Em **Modernize aplicativos de mainframe**, escolha **Refactor with AWS Transform for mainframe** e, em seguida, escolha Get started.**
![\[A seção Modernize aplicativos de mainframe com o Refactor AWS Transform selecionado para mainframe.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-get-started.png)
1. Em **Como o AWS Mainframe Modernization pode ajudar**, escolha **Implantar** e **Criar ambiente de runtime**.
![\[A seção Como você gostaria de começar com a modernização do AWS mainframe com a opção Implantar e criar um ambiente de tempo de execução selecionada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/update-m2-ba-deploy-create-env.png)
1. No painel de navegação, escolha **Ambientes de computação**, **Criar ambiente**. Na página **Especificar informações básicas**, insira um nome e uma descrição para seu ambiente e, em seguida, certifique-se de que o mecanismo **AWS Blu Age** esteja selecionado. Opcionalmente, você pode adicionar etiquetas ao recurso criado. Escolha **Próximo**.
![\[A página Especifique as informações básicas da modernização do AWS mainframe com o mecanismo AWS Transform for mainframe selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-env-basic.png)
1. Na página **Especificar configurações**, escolha **Ambiente de runtime autônomo**.
![\[A seção Disponibilidade da Modernização do AWS Mainframe com o ambiente de tempo de execução autônomo selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-config-avail.png)
1. Em **Segurança e rede**, faça as seguintes alterações:
+ Escolha **Permitir que as aplicações implantadas nesse ambiente sejam acessíveis ao público**. Essa opção atribui um endereço IP público à aplicação para que você possa acessá-la do seu desktop.
+ Escolha uma VPC. Você pode usar o **Padrão**.
+ Escolha duas sub-redes. Certifique-se de que as sub-redes permitam a atribuição de endereços IP públicos.
+ Escolha um grupo de segurança. Você pode usar o **Padrão**. Certifique-se de que o grupo de segurança escolhido permita o acesso do endereço IP do navegador à porta especificada na `listener` propriedade da definição da aplicação. Para obter mais informações, consulte [Etapa 2: criar a aplicação](#tutorial-runtime-ba-step2).
![\[A seção Segurança e rede com a VPC padrão e duas sub-redes selecionadas.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-security-network.png)
Se você quiser acessar a aplicação de fora da VPC escolhida, certifique-se de que as regras de entrada dessa VPC estejam configuradas corretamente. Para obter mais informações, consulte [Solução do erro: não é possível acessar o URL de uma aplicação](both-application-connectivity.md).
1. Escolha **Próximo**.
1. Em **Anexar armazenamento - Opcional**, deixe as seleções padrão e escolha **Próximo**.
![\[A página de armazenamento do Attach com os valores padrão aplicados.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-attach-storage.png)
1. Em **Agendar manutenção**, escolha **Sem preferência** e, em seguida, escolha **Próximo**.
1. Em **Revisar e criar**, revise as informações e escolha **Criar ambiente**.
## Etapa 4: criar uma aplicação do
1. Navegue até o **AWS Mainframe Modernization** no Console de gerenciamento da AWS.
1. No painel de navegação, escolha **Aplicações** e **Criar aplicação**. Na página **Especificar informações básicas**, insira um nome e uma descrição para o aplicativo e certifique-se de que o **AWS AWS Transform for mainframe** engine esteja selecionado. Escolha **Próximo**.
![\[A página Especificar informações básicas do aplicativo com o mecanismo AWS Transform for mainframe selecionado.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-app-basic.png)
1. Na página **Especificar recursos e configurações**, copie e cole o JSON de definição da aplicação atualizado que você criou no [Etapa 2: criar a aplicação](#tutorial-runtime-ba-step2).
![\[A seção Recursos e configurações com a definição atualizada da aplicação JSON colada.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-resources-configs.png)
1. Na página **Revisar e criar**, revise suas escolhas e, em seguida, selecione **Criar aplicação**.
**nota**
Se a criação do aplicativo falhar, verifique o caminho do S3 que você inseriu, pois ele diferencia maiúsculas de minúsculas.
## Etapa 5: implantar uma aplicação
Depois de criar com sucesso o ambiente de execução e o aplicativo de modernização de AWS mainframe, e ambos estarem no estado **Disponível**, você poderá implantar o aplicativo no ambiente de tempo de execução. Para fazer isso, conclua as seguintes etapas:
1. Navegue até a **modernização do AWS Mainframe** no console de AWS gerenciamento. No painel de navegação, escolha **Ambientes**. A página da lista de ambientes é exibida.
![\[A lista de ambientes de tempo de execução da modernização do AWS mainframe.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-environments.png)
1. Escolha o ambiente de runtime criado anteriormente. A página do ambiente é exibida.
1. Escolha **Implantar aplicação**.
![\[A página de detalhes do planets-demo-env ambiente.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-env-details-planets.png)
1. Escolha a aplicação criada anteriormente e, em seguida, escolha a versão na qual você deseja implantar a aplicação. Selecione **Deploy (Implantar)**.
![\[A página do aplicativo AWS Mainframe Modernization Deploy com o aplicativo de demonstração Planets exibido.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-app-deploy.png)
1. Espere até que a aplicação conclua a implantação. Você verá um banner com a mensagem **A aplicação foi implantada com sucesso**.
## Etapa 6: iniciar uma aplicação
1. **Navegue até **AWS Mainframe Modernization** em Console de gerenciamento da AWS e escolha Applications.**
1. Vá até a página da aplicação e escolha **Implantar**. O status da aplicação deve ser **Sucedido**.
![\[A página Implantações de modernização de AWS mainframe mostrando o status de implantação de Bem-sucedida.\]](http://docs.aws.amazon.com/pt_br/m2/latest/userguide/images/m2-ba-app-deployments-succeeded.png)
1. Escolha **Ações** > **Iniciar aplicação**.
## Etapa 7: acessar a aplicação
1. Espere até que a aplicação esteja no estado **Executando**. Você verá um banner com a mensagem **A aplicação foi iniciado com sucesso**.
1. Copie o nome de host DNS da aplicação. Você pode encontrar esse nome de host na seção **Informações da aplicação**.
1. Em um navegador, acesse `http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/`, em que:
+ `hostname` é o nome do host DNS copiado anteriormente.
+ `portname` é a porta Tomcat definida na definição da aplicação que você criou em [Etapa 2: criar a aplicação](#tutorial-runtime-ba-step2).
A tela JICS é exibida.
![\[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)
Se você não conseguir acessar a aplicação, consulte [Solução do erro: não é possível acessar o URL de uma aplicação](both-application-connectivity.md).
**nota**
Se o aplicativo não estiver acessível e a regra de entrada no grupo de segurança tiver “Meu IP” selecionado na porta 8196, especifique a regra para permitir o tráfego do LB na porta 8196. i/p
## Etapa 8: Testar o aplicativo
Nesta etapa, você executa uma transação na aplicação migrada.
1. Na tela JICS, insira `PINQ` no campo de entrada e escolha **Executar** (ou pressione Enter) para iniciar a transação da aplicação.
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)
Você deve ver detalhes sobre o planeta.
## Limpar os recursos
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:
+ Se o aplicativo de modernização do AWS mainframe ainda estiver em execução, pare-o.
+ Exclua a aplicação do . Para obter mais informações, consulte [Excluir um AWS Mainframe Modernization aplicativo](applications-m2-delete.md).
+ Exclua o ambiente de runtime. Para obter mais informações, consulte [Excluir um ambiente de AWS execução de modernização de mainframeExcluir um ambiente de runtime](delete-environments-m2.md).