Tutorial: Configurar o Micro Focus Enterprise Developer no AppStream 2.0 - Mainframe Modernization AWS
Conteúdo da imagemPré-requisitosEtapa 1: configuração por usuários individuais do Enterprise DeveloperEtapa 2: criar a pasta virtual baseada no Amazon S3 no Windows (opcional)Etapa 3: clonar o repositórioSessões subsequentesLimpar os recursos

Tutorial: Configurar o Micro Focus Enterprise Developer no AppStream 2.0

Este tutorial descreve como configurar o Micro Focus Enterprise Developer para uma ou mais aplicações de mainframe para mantê-los, compilá-los e testá-los usando os recursos do Enterprise Developer. A configuração é baseada nas imagens Windows do AppStream 2.0 que o AWS Mainframe Modernization compartilha com o cliente e na criação de frotas e pilhas do AppStream 2.0, conforme descrito em Tutorial: Configurar o AppStream 2.0 para uso com o Micro Focus Enterprise Analyzer e o Micro Focus Enterprise Developer.

Importante

As etapas deste tutorial pressupõem que você configurou o AppStream 2.0 usando o modelo de AWS CloudFormation cfn-m2-appstream-fleet-ea-ed.yaml que pode ser baixado. Para ter mais informações, consulte Tutorial: Configurar o AppStream 2.0 para uso com o Micro Focus Enterprise Analyzer e o Micro Focus Enterprise Developer.

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 on-line atualizada (v7.0) no site da Micro Focus.

Conteúdo da imagem

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

Ferramentas de terceiros

Bibliotecas em C:\Users\Public

  • Código-fonte do BankDemo 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 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 repositórios do CodeCommit, 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 no AppStream 2.0.

Pré-requisitos

  • Um ou mais repositórios do CodeCommit carregados com o código-fonte da aplicação a ser mantido. A configuração do repositório deve corresponder aos requisitos do pipeline de CI/CD acima para criar sinergias por meio da combinação das duas ferramentas.

  • Cada usuário deve ter credenciais para o repositório ou repositórios do CodeCommit definidos pelo administrador da conta de acordo com as informações em Autenticação e controle de acesso do AWS CodeCommit. A estrutura dessas credenciais é revisada em Autenticação e controle de acesso do AWS CodeCommit, e a referência completa para autorizações do IAM para o CodeCommit está na referência de permissões do CodeCommit: o administrador pode definir políticas distintas do IAM para funções distintas, ter credenciais específicas para a função de cada repositório e limitar as 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 repositório do CodeCommit, 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 ao CodeCommit.

Etapa 1: configuração por usuários individuais do Enterprise Developer

  1. Obtenha suas credenciais do IAM:

    1. Conecte ao console do AWS em https://console.aws.amazon.com/iam/.

    2. Siga o procedimento descrito na etapa 3 de Configuração para usuários HTTPS usando credenciais do Git no Guia do usuárioAWS CodeCommit.

    3. Copie as credenciais de login específicas do CodeCommit que o IAM gerou para você, mostrando, copiando e colando essas informações em um arquivo seguro no seu computador local ou escolhendo Fazer download das credenciais para baixar essas informações como um arquivo .CSV. Você precisa dessas informações para se conectar ao CodeCommit.

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

  3. Selecione sua pilha de desenvolvedores corporativos.

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

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

nota

Se você já usou o Rclone durante a pré-visualização do AWS Mainframe Modernization, 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.

  2. Atualize os parâmetros de configuração m2-rclone.conf com sua chave de acesso da AWS e o segredo correspondente, bem como sua 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

  3. 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 o AppStream 2.0 faça backup e restaure 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

  4. Abra um prompt de comando do Windows, toque em CD, C:\Users\PhotonUser\My Files\Home Folder se necessário, e executem2-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

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

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

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

O repositório git do CodeCommit 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 Microfocus Enterprise Server (ES) integrada ao Enterprise Developer para depurar e executar interativamente sua aplicação 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 o AWS Mainframe Modernization é executada no Linux. Recomendamos que você execute testes complementares no ambiente Linux fornecido pelo AWS Mainframe Modernization depois de confirmar a nova aplicação no CodeCommit e reconstruí-lo para esse destino e antes de implantar a nova aplicação em produção.

Sessões subsequentes

Ao selecionar uma pasta que está sob gerenciamento do AppStream 2.0, como a pasta inicial para a clonagem do seu repositório do CodeCommit, 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 o AppStream 2.0 com base na URL recebida no e-mail de boas-vindas.

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

  3. Selecione a pilha Enterprise Developer.

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

  5. Inicie o Enterprise Developer para fazer seu trabalho.

Limpar os recursos

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: