Implante manualmente um aplicativo Java com Open Liberty/WebSphere Liberty em um cluster do Red Hat OpenShift no Azure

Este artigo fornece diretrizes manuais passo a passo para executar o Open/WebSphere Liberty em um cluster do Red Hat OpenShift no Azure. Ele orienta você pela preparação de um aplicativo do Liberty, pela criação da imagem do Docker do aplicativo e pela execução do aplicativo conteinerizado em um cluster do Red Hat OpenShift no Azure.

Especificamente, você aprende a realizar as seguintes tarefas:

Para obter uma solução mais automatizada que acelere sua jornada para o cluster do Red Hat OpenShift no Azure, consulte Implantar o IBM WebSphere Liberty e o Open Liberty no Red Hat OpenShift no Azure usando a oferta do Azure Marketplace.

Para obter mais informações sobre o Open Liberty, confira a página de projeto Open Liberty. Para mais informações sobre o IBM WebSphere Liberty, consulte a página de produto WebSphere Liberty.

Este artigo tem o objetivo de ajudá-lo a iniciar rapidamente a implementação. Antes de acessar a produção, você deve explorar o Ajuste do Liberty.

Se você tiver interesse em fornecer feedback ou trabalhar em seus cenários de migração em estreita colaboração com a equipe de engenharia que desenvolve o WebSphere para as soluções do Azure, responda a essa breve pesquisa sobre migração para o WebSphere e inclua seus dados de contato. A equipe de gerentes de programas, arquitetos e engenheiros entrará em contato prontamente com você para dar início a uma estreita colaboração.

Pré-requisitos

• Um computador local com o sistema operacional semelhante ao Unix instalado, por exemplo, Ubuntu, macOS ou Subsistema do Windows para Linux.

• Uma implementação Java Standard Edition (SE), versão 17 ou posterior - por exemplo, Eclipse Open J9.

• Maven, versão 3.9.8 ou superior.

• Docker para seu sistema operacional.

• CLI do Azure, versão 2.61.0 ou posterior.

• Um cluster do Red Hat OpenShift no Azure. Para criar o cluster, siga as instruções em Criar um cluster do Red Hat OpenShift no Azure usando as seguintes instruções:

  • Embora a etapa "Obter um segredo de pull do Red Hat" seja rotulada como opcional, ela é necessária para este artigo. O segredo de pull permite que o cluster do Red Hat OpenShift no Azure encontre o Operador do Open Liberty.

  • As seguintes variáveis de ambiente definidas em Criar um cluster do Red Hat OpenShift no Azure são usadas posteriormente neste artigo:

    • RESOURCEGROUP – o nome do grupo de recursos no qual o cluster está implantado.
    • CLUSTER – o nome do cluster.

  • Se você planeja executar aplicativos com uso intensivo de memória no cluster, especifique o tamanho adequado da máquina virtual para os nós de trabalho usando o parâmetro --worker-vm-size. Para obter mais informações, consulte os seguintes artigos:

    • CLI do Azure para criar um cluster
    • Tamanhos de máquina virtual compatíveis com a otimização para memória

• Conecte-se a ele seguindo as etapas em Conectar-se a um cluster do Red Hat OpenShift 4 no Azure usando as seguintes instruções:

  • Siga as etapas em "Instalar a CLI do OpenShift", pois você usa o comando oc mais adiante neste artigo.
  • Salve a URL do console do cluster. Ela deve ter aparência semelhante a https://console-openshift-console.apps.<random>.<region>.aroapp.io/.
  • Anote as credenciais kubeadmin.
  • Siga as etapas em "Conexão usando a CLI do OpenShift" com as credenciais kubeadmin.

Instalar o Operador do Open Liberty OpenShift

Depois de criar e conectar-se ao cluster, use as etapas a seguir para instalar o Open Liberty Operator. A página inicial principal para o Operador do Open Liberty está no GitHub.

1. Entre no console web do OpenShift pelo seu navegador usando as credenciais kubeadmin.

2. Navegue até Operadores>OperatorHub e procure Open Liberty.

3. Selecione Open Liberty nos resultados da pesquisa.

4. Selecione Instalar.

5. Na página Instalar o Operator, use as seguintes etapas:

   1. Para Atualizar canal, selecione o canal v1.3 mais recente.
   2. Para o modo de Instalação, selecione Todos os namespaces no cluster (padrão).
   3. Para Atualizar aprovação, selecione Automático.

   

6. Selecione Instalar e aguarde um ou dois minutos até que a instalação seja concluída.

7. Observe que o Open Liberty Operator está instalado com êxito e pronto para uso. Se ainda não estiver pronto, diagnostique e solucione o problema antes de continuar.

   

Criar um namespace OpenShift para o aplicativo Java

Use as etapas a seguir para criar um namespace do OpenShift para uso com seu aplicativo:

1. Certifique-se de ter entrado no console Web do OpenShift pelo seu navegador usando as credenciais kubeadmin.

2. Navegue até Administração>Namespaces>Criar Namespace.

3. Preencha open-liberty-demo para Nome e selecione Criar, conforme mostrado a seguir.

   

Criar um Servidor Flexível do Banco de Dados do Azure para MySQL

O modelo de implantação Servidor Flexível do Banco de Dados do Azure para MySQL é um modo de implantação projetado para fornecer mais controle granular e flexibilidade sobre as funções de gerenciamento de banco de dados e as definições de configuração do que o modo de implantação de servidor único do Banco de Dados do Azure para MySQL. Esta seção mostra como criar uma instância do Servidor Flexível do Banco de Dados do Azure para MySQL usando a CLI do Azure. Para obter mais informações, consulte Início Rápido: criar uma instância do Banco de Dados do Azure para MySQL – Servidor Flexível usando a CLI do Azure.

Execute o comando a seguir em seu terminar para criar uma instância do Servidor Flexível do Banco de Dados do Azure para MySQL. Substitua <server-admin-password> por uma senha que atenda aos requisitos de complexidade de senha para o Servidor Flexível do Banco de Dados do Azure para MySQL.

az mysql flexible-server create \
    --name ${CLUSTER} \
    --resource-group ${RESOURCEGROUP} \
    --admin-user admin${RESOURCEGROUP} \
    --admin-password '<server-admin-password>' \
    --database-name ${RESOURCEGROUP}db \
    --public-access 0.0.0.0 \
    --yes

az mysql flexible-server list-skus --location <Location>

Localize um local que tenha SKUs disponíveis e repita o az mysql flexible-server create command anterior, mas acrescente o parâmetro --location <Location> apropriado, deixando todos os outros parâmetros inalterados.

Leva alguns minutos para criar o servidor, o banco de dados, o usuário administrador e a regra de firewall que aceita conexões de todos os recursos do Azure. Se o comando for bem-sucedido, a saída será semelhante ao exemplo a seguir:

{
  "connectionString": "mysql <database-name> --host <server-name>.mysql.database.azure.com --user <server-admin-username> --password=<server-admin-password>",
  "databaseName": "<database-name>",
  "firewallName": "AllowAllAzureServicesAndResourcesWithinAzureIps_2024-7-10_16-22-8",
  "host": "<server-name>.mysql.database.azure.com",
  "id": "/subscriptions/REDACTED/resourceGroups/<resource-group-of-the-OpenShift-cluster>/providers/Microsoft.DBforMySQL/flexibleServers/<server-name>",
  "location": "West US",
  "password": "<server-admin-password>",
  "resourceGroup": "<resource-group-of-the-OpenShift-cluster>",
  "skuname": "Standard_B1ms",
  "username": "<server-admin-username>",
  "version": "5.7"
}

Preparar o aplicativo Liberty

Usamos um aplicativo Java EE 8 como nosso exemplo neste guia. O Open Liberty é um servidor totalmente compatível com o perfil completo do Java EE 8 e, portanto, ele pode executar facilmente o aplicativo. O Open Liberty também é compatível com o perfil completo do Jakarta EE 8.

Executar o aplicativo no Open Liberty

Para executar o aplicativo no Open Liberty, você precisa criar um arquivo de configuração do servidor do Open Liberty para que o plug-in Liberty Maven possa empacotar o aplicativo para implantação. O plug-in de Maven do Liberty não é necessário para implantar o aplicativo no OpenShift. No entanto, vamos usá-lo neste exemplo com o modo de desenvolvedor (dev) do Open Liberty. O modo de desenvolvedor permite executar o aplicativo localmente com facilidade. Para saber mais sobre o liberty-maven-plugin, confira Como compilar um aplicativo Web com o Maven.

Siga as etapas nesta seção para preparar o aplicativo de exemplo para uso posterior neste artigo. Essas etapas usam o Maven e o liberty-maven-plugin.

Fazer check-out do aplicativo

Use os comandos a seguir para clonar o código de exemplo para este guia. O exemplo está no GitHub.

git clone https://github.com/Azure-Samples/open-liberty-on-aro.git
cd open-liberty-on-aro
export BASE_DIR=$PWD
git checkout 20240920
cd ${BASE_DIR}/3-integration/connect-db/mysql

Se você vir uma mensagem sobre estar no estado "detached HEAD", essa mensagem pode ser ignorada com segurança. Isso apenas significa que você fez check-out de uma tag.

Há alguns exemplos no repositório. Usamos open-liberty-on-aro/3-integration/connect-db/mysql. Esta é a estrutura de arquivos do aplicativo:

open-liberty-on-aro/3-integration/connect-db/mysql
├─ src/main/
│  ├─ aro/
│  │  ├─ db-secret.yaml
│  │  ├─ openlibertyapplication.yaml
│  ├─ liberty/config/
│  │  ├─ server.xml
│  ├─ java/
│  ├─ resources/
│  ├─ webapp/
├─ Dockerfile
├─ Dockerfile-wlp
├─ pom.xml

Os diretórios java, resources e webapp contêm o código-fonte do aplicativo de exemplo. O código declara e usa uma fonte de dados chamada jdbc/JavaEECafeDB.

No diretório aro, colocamos dois arquivos de implantação. db-secret.xml é usado para criar Segredos com as credenciais de conexão do banco de dados. O arquivo openlibertyapplication.yaml é usado para implantar a imagem do aplicativo.

No diretório raiz, colocamos dois Dockerfiles. Dockerfile e Dockerfile-wlp são usados para depuração local e para criar a imagem para uma implantação do Red Hat OpenShift no Azure, trabalhando com o Open Liberty e o WebSphere Liberty, respectivamente.

No diretório liberty/config, o server.xml é usado para configurar a conexão do banco de dados para o cluster do Open Liberty e do WebSphere Liberty.

Compilar o projeto

Usando as variáveis de ambiente definidas anteriormente, execute os comandos a seguir em seu terminal para criar o projeto. O arquivo POM do projeto lê muitas propriedades do ambiente.

cd ${BASE_DIR}/3-integration/connect-db/mysql

# The following variables are used for deployment file generation
export DB_SERVER_NAME=$CLUSTER.mysql.database.azure.com
export DB_PORT_NUMBER=3306
export DB_NAME=${RESOURCEGROUP}db
export DB_USER=admin${RESOURCEGROUP}
export DB_PASSWORD='<server-admin-password>'
export NAMESPACE=open-liberty-demo

mvn clean install

(Opcional) Testar seu aplicativo localmente

Opcionalmente, você pode executar o aplicativo localmente para verificar se ele funciona conforme o esperado. Primeiro, você precisa adicionar uma regra de firewall para permitir que seu computador local se conecte à instância do Servidor Flexível do Banco de Dados do Azure para MySQL. Use as seguintes etapas para adicionar a regra do firewall:

1. Entre no portal do Azure e navegue até a instância do Servidor Flexível do Banco de Dados do Azure para MySQL que você criou anteriormente.
2. No painel à esquerda, selecione Configurações>Rede.
3. Selecione Adicionar endereço IP do cliente atual.
4. Selecione Salvar e aguarde até que a regra de firewall seja adicionada.

Use as etapas a seguir para executar o comando liberty:devc para executar e testar localmente o projeto e a imagem de contêiner antes de lidar com qualquer complexidade do Azure. Para obter mais informações sobre liberty:devc, confira a documentação do Plug-in do Liberty.

1. Inicie seu ambiente local do Docker, se necessário. As instruções para fazê-lo variam de acordo com o sistema operacional do host.

2. Use os seguintes comandos para iniciar o aplicativo no modo liberty:devc:

   cd ${BASE_DIR}/3-integration/connect-db/mysql
   
   # If you are running with Open Liberty
   mvn liberty:devc -DcontainerRunOpts="-e DB_SERVER_NAME=${DB_SERVER_NAME} -e DB_PORT_NUMBER=${DB_PORT_NUMBER} -e DB_NAME=${DB_NAME} -e DB_USER=${DB_USER} -e DB_PASSWORD=${DB_PASSWORD}" -Dcontainerfile=Dockerfile
   
   # If you are running with WebSphere Liberty
   mvn liberty:devc -DcontainerRunOpts="-e DB_SERVER_NAME=${DB_SERVER_NAME} -e DB_PORT_NUMBER=${DB_PORT_NUMBER} -e DB_NAME=${DB_NAME} -e DB_USER=${DB_USER} -e DB_PASSWORD=${DB_PASSWORD}" -Dcontainerfile=Dockerfile-wlp
   

3. Verifique se o aplicativo funciona conforme o esperado. Você deverá ver uma mensagem semelhante a [INFO] [AUDIT] CWWKZ0003I: The application javaee-cafe updated in 1.930 seconds. na saída do comando, se tiver êxito. Acesse https://localhost:9443/ no navegador e verifique se o aplicativo está acessível e se todas as funções estão operantes.

4. Para parar o modo liberty:devc, pressione Control+C.

Preparar a imagem do aplicativo

Para implantar e executar seu aplicativo do Liberty no cluster do Red Hat OpenShift no Azure, conteinerize seu aplicativo como uma imagem do Docker usando imagens de contêiner do Open Liberty ou imagens de contêiner do WebSphere Liberty.

Compilar o aplicativo e efetuar push para o fluxo de imagem

Como você já executou com êxito o aplicativo no contêiner do Liberty Docker usando o comando liberty:devc, você criará a imagem remotamente no cluster usando as seguintes etapas:

1. Entre na CLI do OpenShift usando as credenciais kubeadmin.

2. Use os seguintes comandos para identificar o diretório de origem e o Dockerfile:

   cd ${BASE_DIR}/3-integration/connect-db/mysql
   
   # If you are building with the Open Liberty base image, the existing Dockerfile is ready for you
   
   # If you are building with the WebSphere Liberty base image, uncomment and execute the following two commands to rename Dockerfile-wlp to Dockerfile
   # mv Dockerfile Dockerfile.backup
   # mv Dockerfile-wlp Dockerfile
   

3. Use o seguinte comando para alterar o projeto para open-liberty-demo:

   oc project open-liberty-demo
   

4. Use o seguinte comando para criar um fluxo de imagem:

   oc create imagestream javaee-cafe-mysql
   

5. Use o seguinte comando para criar uma configuração de compilação que especifica a marca de fluxo de imagem da saída da compilação:

   oc new-build --name javaee-cafe-mysql-config --binary --strategy docker --to javaee-cafe-mysql:v1
   

6. Use o seguinte comando para iniciar a compilação para carregar conteúdo local, colocar em contêiner e saída para a marca de fluxo de imagem especificada antes:

   oc start-build javaee-cafe-mysql-config --from-dir . --follow
   

Implantar o aplicativo no cluster do Red Hat OpenShift no Azure

Agora você pode implantar o aplicativo Liberty de exemplo no cluster do Red Hat OpenShift no Azure criado anteriormente ao trabalhar com os pré-requisitos.

oc delete -f openlibertyapplication.yaml
oc delete -f db-secret.yaml

Limpar os recursos

Exclua o cluster do Red Hat OpenShift no Azure seguindo as etapas em Tutorial: excluir um cluster do Red Hat OpenShift 4 no Azure. Certifique-se de que o banco de dados e todos os recursos associados também sejam excluídos.

Próximas etapas

Você pode saber mais sobre as referências usadas neste guia:

• Open Liberty
• Red Hat OpenShift no Azure
• Open Liberty Operator
• Configuração do Servidor Open Liberty
• Plug-in do Liberty Maven
• Imagens de contêiner do Open Liberty
• Imagens de contêiner do WebSphere Liberty

Para explorar as opções para executar produtos WebSphere no Azure, consulte Quais são as soluções para executar a família de produtos WebSphere no Azure?