Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este guia descreve o que você deve estar ciente quando deseja migrar um aplicativo JBoss EAP existente para ser executado no Azure Red Hat OpenShift.
Pré-migração
Para garantir uma migração bem-sucedida, antes de começar, conclua as etapas de avaliação e inventário descritas nas seções a seguir.
Certifique-se de que o destino é o destino apropriado para o seu esforço de migração
A primeira etapa em uma migração bem-sucedida de um aplicativo JBoss EAP para o Azure é selecionar o destino de migração mais apropriado. O JBoss EAP funciona bem em máquinas virtuais (VMs) do Azure ou no Azure Red Hat OpenShift.
O destino da VM é a escolha mais fácil, uma vez que é a opção mais semelhante a uma implementação no local. A experiência administrativa e de implantação para máquinas virtuais é análoga à que você tem no local. A seleção de VMs permite adiar a modernização.
O Red Hat OpenShift reúne serviços testados e confiáveis para reduzir o atrito do desenvolvimento, modernização, implantação, execução e gerenciamento de aplicativos. O Azure Red Hat OpenShift foi criado no Kubernetes. O Azure Red Hat OpenShift oferece uma experiência consistente em nuvem pública, local, nuvem híbrida ou arquitetura de borda.
Se minimizar as alterações for o fator mais importante para seu esforço de migração, considere uma migração baseada em VM. Neste caso, consulte Migrar aplicações JBoss EAP para o JBoss EAP em VMs do Azure. Se você puder tolerar a conversão de seu aplicativo para execução no Red Hat OpenShift para reduzir o custo de tempo de execução, considere uma migração baseada no Azure Red Hat OpenShift. Nesse caso, continue com Migrar aplicações JBoss EAP para o JBoss EAP no Azure Red Hat OpenShift. Para entender as diferenças entre JBoss EAP e JBoss EAP para OpenShift, consulte Comparação: JBoss EAP e JBoss EAP para OpenShift.
Determinar se a oferta pré-criada do Azure Marketplace é um bom ponto de partida
Primeiro, decida que o Red Hat OpenShift do Azure é o destino de implantação apropriado. Em seguida, decida se a oferta pré-configurada do Azure Marketplace é ou não um bom ponto de partida. Considere os seguintes pontos sobre a oferta pré-criada do Azure Marketplace:
- A Red Hat e a Microsoft criaram essa oferta para permitir o provisionamento rápido do JBoss EAP no Azure Red Hat OpenShift.
- Em um alto nível, a oferta automatiza as seguintes etapas para você.
- Instale o operador EAP no Azure Red Hat OpenShift.
- Crie uma imagem de aplicativo usando o modelo eap-s2i-build. Para obter mais informações sobre Source-to-image (S2I), consulte Utilizar o source-to-image do OpenJDK 11 para o OpenShift.
- Implemente o aplicativo Java usando o Operador EAP. Para obter mais informações, consulte a documentação de referência do EAP Operator em Red Hat.
Se você não usar a oferta pré-criada do Azure Marketplace, deverá aprender a usar o Operador EAP diretamente. Dominar o operador está além do escopo deste artigo. A documentação completa do EAP Operator está disponível em Red Hat.
O restante desta seção fornece algumas considerações para decidir usar a oferta pré-criada do Azure Marketplace ou usar o operador diretamente.
Determinar se a versão do JBoss EAP é compatível
Sua versão existente do JBoss EAP deve ser uma das versões suportadas pelo operador. Para obter mais informações, consulte Compatibilidade e suporte de versões na documentação da Red Hat.
Fazer o inventário da capacidade do servidor
Documente o hardware (memória, CPU, disco) do(s) servidor(es) de produção atual e as contagens médias e de pico de solicitações e a utilização de recursos. Você precisa dessas informações independentemente do caminho de migração escolhido. Os seguintes aspetos, e muito mais, se beneficiam de ter um inventário detalhado da capacidade do servidor.
- Para ajudar a orientar a seleção do tamanho das VMs no pool de nós.
- Para entender a quantidade de memória a ser usada pelo contêiner.
- Para saber quantos compartilhamentos de CPU o contêiner precisa.
É possível redimensionar pools de nós no Azure Red Hat OpenShift. Para mais informações, consulte Redimensionar um cluster--Microsoft Azure na documentação da Red Hat.
Inventariar todos os segredos
Antes do advento das tecnologias de "configuração como serviço", como o Azure Key Vault, não havia um conceito bem definido de "segredos". Em vez disso, tínhamos um conjunto díspar de definições de configuração que, efetivamente, funcionavam como aquilo a que hoje chamamos "segredos". Com servidores de aplicativos como o JBoss EAP, esses segredos estão em muitos arquivos de configuração e armazenamentos de configuração diferentes. Verifique todos os ficheiros de propriedades e de configuração no(s) servidor(es) de produção para detetar quaisquer segredos e palavras-passe. Certifique-se de verificar os arquivos de configuração, como custom-config.xml ou jboss-web.xml em seus aplicativos. Também poderá encontrar ficheiros de configuração com palavras-passe ou credenciais dentro da aplicação. Para obter mais informações, consulte Conceitos básicos do Azure Key Vault.
Depois de ter um inventário sólido de segredos, consulte a documentação do Operador EAP sobre segredos. Para obter mais informações, consulte Criar um segredo na documentação da Red Hat.
Inventariar todos os certificados
Documente todos os certificados utilizados para os pontos finais SSL públicos. Pode ver todos os certificados no servidor ou servidores de produção com o comando seguinte:
keytool -list -v -keystore <path to keystore>
Depois de ter um inventário sólido de certificados, você pode configurá-los no Azure Red Hat OpenShift. Para obter mais informações, consulte Configuração de TLS no OpenShift Container Platform (substituir) na documentação da Red Hat.
Verificar se a versão de Java suportada funciona corretamente
Todos os caminhos de migração do JBoss EAP para o Azure Red Hat OpenShift exigem uma versão específica do Java, que varia para cada caminho. Você precisa validar se seu aplicativo é capaz de executar corretamente usando essa versão suportada.
Nota
Esta validação é particularmente importante se o seu servidor atual estiver a ser executado num JDK não suportado (como Oracle JDK ou IBM OpenJ9).
Para obter a sua versão atual do Java, inicie sessão no servidor de produção e execute o comando seguinte:
java -version
Inventariar recursos do JNDI
Inventariar todos os recursos do JNDI. Por exemplo, fontes de dados como bases de dados podem ter associado um nome JNDI que permite ao JPA associar corretamente instâncias de a uma determinada base de dados. Para obter mais informações sobre recursos JNDI e bases de dados, consulte Gestão de fontes de dados na documentação da Red Hat. Outros recursos relacionados a JNDI, como agentes de mensagens ActiveMQ Artemis, podem exigir migração ou reconfiguração. Para mais informações sobre a configuração do ActiveMQ Artemis, consulte Configuração de mensagens na documentação da Red Hat.
Determinar se é utilizada a replicação de sessões
Caso a sua aplicação dependa da replicação de sessões, com ou sem Infinispan, tem três opções:
- O Infinispan funciona bem em máquinas virtuais do Azure, mas se você estiver usando um perfil que fornece recursos de alta disponibilidade, esteja ciente da configuração
JGroups. Determine se o sistema está operando como um domínio gerenciado ou servidor autônomo.- Se estiver em um domínio gerenciado, os perfis
haoufull-halidam com JGroups. - Se estiver em um servidor autônomo, os arquivos de configuração standalone-ha.xml ou standalone-full-ha.xml lidam com JGroups.
- O Microsoft Azure não suporta protocolos de descoberta JGroups baseados em multicast UDP. Para obter mais informações, consulte Utilizar a alta disponibilidade no JBoss EAP no Microsoft Azure na documentação da Red Hat.
- Se estiver em um domínio gerenciado, os perfis
- Refatorize a sua aplicação para utilizar uma base de dados para a gestão de sessões.
- Refatorize a sua aplicação para externalizar a sessão para o Serviço de Redis do Azure. Para obter mais informações, consulte Cache do Azure para Redis.
Para todas essas opções, é uma boa ideia dominar como o JBoss EAP faz a replicação do estado da sessão HTTP. Para mais informações, consulte Acerca da replicação de sessão HTTP na documentação da Red Hat.
Documentar origens de dados
Se a sua aplicação utilizar bases de dados, terá de recolher as seguintes informações:
- Qual é o nome da origem de dados?
- Qual é a configuração do pool de ligações?
- Onde posso obter o ficheiro JAR do controlador JDBC?
Para obter mais informações sobre os controladores JDBC no JBoss EAP, consulte Gestão de origens de dados na documentação da Red Hat.
Determinar se o JBoss EAP foi personalizado
Determine quais das seguintes personalizações foram efetuadas e registe o que foi feito.
- Os scripts de arranque foram alterados? Estes scripts incluem host, eap_env, standalone e domain.
- São transmitidos parâmetros específicos para a JVM?
- Foram adicionados JARs ao classpath do servidor?
Essas personalizações precisam ser capturadas na imagem de contêiner em execução no Azure Red Hat OpenShift. Para obter mais informações, consulte Configurar a imagem do JBoss EAP para OpenShift para a sua aplicação Java na documentação da Red Hat.
Determinar se é necessária uma ligação ao local
Se a sua aplicação precisar de aceder a um dos seus serviços no local, tem de aprovisionar um dos serviços de conectividade do Azure. Para obter mais informações, consulte Ligar uma rede no local ao Azure. Em alternativa, tem de refatorizar a aplicação para utilizar as APIs publicamente disponíveis que os seus recursos no local expõem.
Determinar se as filas ou os tópicos do Java Message Service (JMS) estão a ser usados
Se seu aplicativo estiver usando Filas ou Tópicos JMS, convém migrá-los para um servidor JMS hospedado externamente. O Azure Service Bus e o protocolo AMQP (Advance Message Queueing Protocol) podem ser uma excelente estratégia de migração para quem utiliza o JMS. Para obter mais informações, consulte Use Java Message Service 1.1 com o Azure Service Bus standard e AMQP 1.0.
Se tiverem sido configurados arquivos persistentes do JMS, tem de capturar a respetiva configuração e aplicá-la após a migração.
Para obter mais informações, consulte Configurar mensagens na documentação da Red Hat.
Determinar se está a utilizar bibliotecas Shared Java EE criadas e personalizadas por si.
Se utilizar a funcionalidade de biblioteca Shared Java EE, tem duas opções:
- Refatorizar o código da aplicação para remover todas as dependências nas bibliotecas e, ao invés, incorporar a funcionalidade diretamente na aplicação.
- Adicionar as bibliotecas ao classpath do servidor.
Pode gerir estas bibliotecas utilizando as mesmas técnicas descritas na secção Determinar se o JBoss EAP foi personalizado.
Determinar se a aplicação contem código de SO específico
Se seu aplicativo contiver qualquer código com dependências no sistema operacional host, você precisará refatorá-lo para remover essas dependências. Por exemplo, poderá ser necessário substituir qualquer utilização de ou em caminhos do sistema de ficheiros por ou se a sua aplicação estiver a ser executada no Windows.
O Azure Red Hat OpenShift é executado no OpenShift 4, utilizando o Red Hat Enterprise Linux CoreOS (RHCOS) como sistema operativo em todos os nós do plano de controlo e de trabalho. Qualquer código específico do SO deve ser compatível com RHCOS.
Determinar se a sua aplicação é composta por vários WARs
Se a sua aplicação for composta por vários WARs, deve tratar cada um desses WARs como aplicações separadas e seguir este guia para cada qual individualmente.
Determinar se a sua aplicação está empacotada como EAR
Se o seu aplicativo for empacotado como um arquivo EAR, certifique-se de capturar suas configurações.
Identificar todos os processos e daemons externos em execução nos servidores de produção
Se tiver processos em execução fora do servidor de aplicações, como daemons de monitorização, terá de eliminar ou migrá-los para outro local.
Ter em conta os requisitos de balanceamento de carga
A melhor maneira de contabilizar o balanceamento de carga é usar a integração do App Gateway. Para obter mais informações, consulte O que é o Gateway de Aplicação do Azure?
Migração
As etapas nesta seção pressupõem que sua análise o levou a decidir usar a oferta pré-criada do Azure Marketplace.
Configurar a oferta
Para abrir a oferta no portal do Azure, consulte JBoss EAP no Azure Red Hat OpenShift. Selecione Criar e siga as instruções da oferta.
Migrando seus aplicativos
A oferta suporta o processo Source-to-Image (S2I) para construir e executar um aplicativo Java na imagem JBoss EAP for OpenShift. A Red Hat tem um exemplo que mostra como fazer isso manualmente se você quiser implantar mais tarde sozinho. Para obter mais informações, consulte o Capítulo 2. Compilar e executar uma aplicação Java na imagem do JBoss EAP para OpenShift na documentação da Red Hat.
Pós-migração
Depois de atingir os objetivos de migração que definiu na etapa de pré-migração, realize testes de aceitação de ponta a ponta para verificar se tudo funciona como esperado. Para obter informações sobre alguns possíveis aprimoramentos pós-migração, consulte os seguintes artigos:
Implemente o dimensionamento. O dimensionamento dinâmico é uma proposta de valor fundamental para justificar a complexidade do uso do Azure Red Hat OpenShift. Para obter informações sobre como implementar a sua solução de escalabilidade, consulte Aplicar o escalonamento automático a um cluster do OpenShift Container Platform na documentação do OpenShift.
Talvez você queira fazer mais configurações no Application Gateway. Para mais informações, consulte Descrição geral da configuração do Application Gateway.
Melhore a sua topologia de rede com serviços avançados de balanceamento de carga. Para obter mais informações, consulte Utilizar serviços de balanceamento de carga no Azure.
Obtenha monitoramento de desempenho de aplicativos otimizado para Java com o Azure Monitor e o Application Insights. Para obter mais informações, consulte Monitorização de aplicações sem instrumentação para Kubernetes - Azure Monitor Application Insights.
Implante seus aplicativos no cluster Red Hat OpenShift do Azure migrado com o Azure DevOps. Para obter mais informações, consulte Introdução à documentação do Azure DevOps.
Use as Identidades Gerenciadas do Azure para gerenciar segredos e atribuir acesso baseado em função aos recursos do Azure. Para obter mais informações, consulte O que são identidades geridas para recursos do Azure?
Integre a autenticação e autorização Java EE com o Microsoft Entra ID. Para obter mais informações, consulte o guia de introdução à integração do Microsoft Entra ID com aplicações.