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á. # Configurar o AWS Transform for mainframe Runtime no contêiner Este tópico explica como configurar e implantar o aplicativo de PlanetsDemo amostra usando o AWS Transform for mainframe Runtime em um contêiner docker. AWS O Transform for mainframe Runtime em contêiner está disponível para Amazon ECS gerenciado pelo Amazon EC2, Amazon ECS gerenciado por e Amazon EKS AWS Fargate gerenciado pelo Amazon EC2. Não é compatível com o Amazon EKS gerenciado por AWS Fargate. **Topics** + [Pré-requisitos](#ba-runtime-deploy-prereq) + [Configurar](#ba-runtime-deploy-setup) + [Testar a aplicação implantada](#ba-runtime-deploy-test) ## Pré-requisitos Antes de começar, certifique-se de que você concluiu os seguintes pré-requisitos. + Configure o AWS CLI seguindo as etapas em [Configuração da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). + Preencha [AWS Pré-requisitos do Transform for mainframe Runtime](ba-runtime-setup-prereq.md), e [AWS Transformação de integração para o mainframe Runtime](ba-runtime-setup-onboard.md). + Baixe os binários do AWS Transform for mainframe Runtime. Para instruções, consulte [AWS Transformação de integração para o mainframe Runtime](ba-runtime-setup-onboard.md). + Baixe os binários do Apache Tomcat. + Baixe o [arquivo do PlanetsDemo aplicativo](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip). + Crie um banco de dados do Amazon Aurora PostgreSQL para JICS e execute a consulta `PlanetsDemo-v1/jics/sql/initJics.sql`. Para ter informações sobre como criar um banco de dados do Amazon Aurora PostgreSQL, consulte [Criar um cluster de banco de dados do Aurora PostgreSQL e se conectar a ele](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ## Configurar Para configurar o aplicativo de PlanetsDemo amostra, conclua as etapas a seguir. 1. Depois de baixar os binários do Apache Tomcat, extraia o conteúdo e acesse a pasta `conf`. Abra o arquivo `catalina.properties` para edição e substitua a linha que começa com `common.loader` com a linha a seguir. ``` common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar" ``` 1. Compacte a pasta do Apache Tomcat utilizando o comando tar para criar um arquivo “tar.gz”. 1. Prepare um [Dockerfile](https://docs.docker.com/engine/reference/builder/) para criar uma imagem personalizada com base nos binários de tempo de execução fornecidos e nos binários do servidor Apache Tomcat. Veja o exemplo do Dockerfile a seguir. O objetivo é instalar o Apache Tomcat, seguido pelo AWS Transform for mainframe Runtime (para Amazon ECS gerenciado por AWS Fargate) extraído na raiz do diretório de instalação do Apache Tomcat e, em seguida, instalar o exemplo de aplicativo modernizado chamado. PlanetsDemo **nota** O conteúdo dos scripts install-gapwalk.sh e install-app.sh, usados neste exemplo do Dockerfile, está listado após o Dockerfile. ``` FROM --platform=linux/x86_64 amazonlinux:2 RUN mkdir -p /workdir/apps WORKDIR /workdir COPY install-gapwalk.sh . COPY install-app.sh . RUN chmod +x install-gapwalk.sh RUN chmod +x install-app.sh # Install Java and AWS CLI v2-y RUN yum install sudo java-17-amazon-corretto unzip tar -y RUN sudo yum remove awscli -y RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" RUN sudo unzip awscliv2.zip RUN sudo ./aws/install # Installation dir RUN mkdir -p /usr/local/velocity/installation/gapwalk # Copy PlanetsDemo archive to a dedicated apps dir COPY PlanetsDemo-v1.zip /workdir/apps/ # Copy resources (tomcat, blu age runtime) to installation dir COPY tomcat.tar.gz /usr/local/velocity/installation/tomcat.tar.gz COPY aws-bluage-runtime-4.x.x.zip /usr/local/velocity/installation/gapwalk/gapwalk.zip # run relevant installation scripts RUN ./install-gapwalk.sh RUN ./install-app.sh EXPOSE 8080 EXPOSE 8081 # ... WORKDIR /bluage/tomcat.gapwalk/velocity # Run Command to start Tomcat server CMD ["sh", "-c", "sudo bin/catalina.sh run"] ``` Veja a seguir o conteúdo de `install-gapwalk.sh.` ``` # Vars TEMP_DIR=/bluage-on-fargate/tomcat.gapwalk/temp # Install echo "Installing Gapwalk and Tomcat" sudo rm -rf /bluage-on-fargate mkdir -p ${TEMP_DIR} # Copy AWS Transform for mainframe runtime and tomcat archives to temporary extraction dir sudo cp /usr/local/velocity/installation/gapwalk/gapwalk.zip ${TEMP_DIR} sudo cp /usr/local/velocity/installation/tomcat.tar.gz ${TEMP_DIR} # Create velocity dir mkdir -p /bluage/tomcat.gapwalk/velocity # Extract tomcat files tar -xvf ${TEMP_DIR}/tomcat.tar.gz -C ${TEMP_DIR} # Copy all tomcat files to velocity dir cp -fr ${TEMP_DIR}/apache-tomcat-10.x.x/* /bluage/tomcat.gapwalk/velocity # Remove default webapps of Tomcat rm -f /bluage-on-fargate/tomcat.gapwalk/velocity/webapps/* # Extract AWS Transform for mainframe runtime at velocity dir unzip ${TEMP_DIR}/gapwalk.zip -d /bluage/tomcat.gapwalk # Remove temporary extraction dir sudo rm -rf ${TEMP_DIR} ``` Veja a seguir o conteúdo de `install-app.sh`. ``` #!/bin/sh APP_DIR=/workdir/apps TOMCAT_GAPWALK_DIR=/bluage-on-fargate/tomcat.gapwalk unzip ${APP_DIR}/PlanetsDemo-v1.zip -d ${APP_DIR} cp -r ${APP_DIR}/webapps/* ${TOMCAT_GAPWALK_DIR}/velocity/webapps/ cp -r ${APP_DIR}/config/* ${TOMCAT_GAPWALK_DIR}/velocity/config/ ``` 1. Forneça as informações de conexão do banco de dados que você criou como parte dos pré-requisitos no trecho a seguir, no arquivo `application-main.yml`, localizado na pasta `{TOMCAT_GAPWALK_DIR}/config`. Para obter mais informações, consulte [Criação e conexão a um cluster Aurora PostgreSQL DB](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster). ``` datasource: jicsDs: driver-class-name : url: username: password: type : ``` 1. Crie e envie a imagem ao repositório do Amazon ECR. Para ter informações, consulte [Envio de uma imagem do Docker](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) no Manual do usuário do Amazon Elastic Container Registry. Então, dependendo da sua situação, crie um pod do Amazon EKS ou uma definição de tarefa do Amazon ECS usando a imagem do Amazon ECR e implante-a no cluster. Por exemplo, sobre como criá-los, consulte [Criação de uma definição de tarefa usando o console](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-task-definition.html) no *Guia do desenvolvedor do Amazon Elastic Container Service (Amazon ECS)* e [Deploy a sample application](https://docs.aws.amazon.com/eks/latest/userguide/sample-deployment.html) no *Guia do usuário do Amazon EKS*. 1. Especificamente, em relação ao **Amazon ECS gerenciado pelo AWS Fargate**, ao criar a definição da tarefa, use o perfil do IAM que você criou como parte da configuração inicial da infraestrutura. Depois, ao criar o serviço, expanda a seção **Rede** e configure a VPC, as sub-redes e o grupo de segurança que você criou como parte da configuração inicial da infraestrutura. Consulte os [requisitos de configuração da infraestrutura para o AWS Transform for mainframe Runtime](https://docs.aws.amazon.com/m2/latest/userguide/ba-infrastructure-setup.html). ## Testar a aplicação implantada Para obter um exemplo de como testar o PlanetsDemo aplicativo, consulte[Teste o PlanetsDemo aplicativo](ba-runtime-test-planetsdemo.md).