Tutorial: Configurar o Micro Focus Enterprise Developer na AppStream versão 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 AppStream 2.0 do Windows que a modernização do AWS mainframe compartilha com o cliente e na criação de frotas e pilhas AppStream 2.0, conforme descrito em. Tutorial: Configure a AppStream versão 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ê configure a AppStream versão 2.0 usando o AWS CloudFormation modelo disponível para download cfn-m2-appstream-fleet-ea-ed.yaml. Para ter mais informações, consulte Tutorial: Configure a AppStream versão 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 up-to-date on-line (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

• Python

• Rclone

• pgAdmin

• git-scm

• PostgreSQL ODBC driver

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 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 foi 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 na versão 2.0 AppStream

Pré-requisitos

• 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 pipeline de CI/CD 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 da AWS. CodeCommit A estrutura dessas credenciais é revisada em Autenticação e controle de acesso para AWS CodeCommit e a referência completa para autorizações do IAM CodeCommit está na referência de CodeCommit permissões: 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

1. Obtenha suas credenciais do IAM:

   1. Conecte-se ao AWS console 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ário AWS CodeCommit .

   3. 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. Você precisa dessas informações para se conectar CodeCommit a.

2. Inicie uma sessão com 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 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.

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

3. Mo m2-rclone.cmd, faça as seguintes alterações:

   • Altere your-s3-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:your-s3-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 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 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 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

Ao selecionar uma pasta que está sob gerenciamento AppStream 2.0, 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 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 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:

• Exclua o CodeCommit repositório que você criou para este tutorial. Para obter mais informações, consulte Excluir um CodeCommit repositório 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.