Blog do PJ

O Servidor JBoss AS suporta a implantação de diversos arquivos necessários para a execução de uma aplicação Java (*.[jewsr]ar *-ds.xml …) até mesmo se eles estiverem disponíveis em uma URL como, por exemplo, http://servidor/diretorio-com-suporte-a-WebDAV/. Este mecanismo é útil em diversas situações. Neste post, vou ilustrar um caso prático: suponhamos que você deseje instalar uma única instância do CruiseControl como a ferramenta responsável pelo processo de Integração Contínua de diversas aplicações que precisam ser implantadas em diferentes instâncias de JBoss, sendo executadas em várias máquinas distintas.

Uma possível solução para este problema é:

• Configurar um servidor Apache na mesma máquina que roda o CruiseControl, ativando os módulos responsáveis pelo suporte ao WebDAV ou, de maneira alternativa, instalando um Servlet que ofereça este suporte ao container que executa o CruiseControl;
  
• Configurar no Apache uma URL como, por exemplo, http://cruisecontrol.minhaempresa.com/aplicacaoX/ apontando para o diretório no qual serão gerados os arquivos da aplicação X que precisam ser implantados em uma instância de JBoss;
  
• Configurar a URL anterior no JBoss para que o mesmo possa fazer uma busca (scan) (via comando PROPFIND do WebDAV) pelos arquivos da aplicação X, que estão disponíveis na URL;

• Desabilitar o scan automático do JBoss, para que ele não perca o seu tempo tentando verificar se novas versões dos arquivos precisam ser implantadas ou não (ele será avisado sobre isto, pelo CruiseControl);
  
• Fazer o script de controle do CruiseControl para o aplicação X enviar o comando scan para o JBoss, quando for finalizado o processo de geração (build) dos arquivos desta aplicação, a fim de que este servidor possa realizar a implantação destes arquivos;
  
• Fazer o processo de testes da aplicação X (via JUnit ou TestNG por exemplo) ser iniciado apenas quando o processo de implantação no servidor terminar. Em alguns casos, principalmente na situação em que a implantação é responsável por gerar várias tabelas em um SGBD (como quando se utiliza a feature schemaexport do Hibernate), este processo pode ser um pouco lento, gerando então um pequeno atraso no início dos testes, que só deverão ser iniciados após a completa verificação de que a implantação foi finalizada e bem sucedida.

Uma observação sob esta solução é que, as máquinas que rodam as instâncias de JBoss que serão responsáveis pelas implantações das aplicações X, Y, …, não precisarão ter serviços como SSH remoto, FTP, NFS, ou quaisquer outros que possibilitem a cópia remota dos arquivos a serem implantados. Esta característica pode ser vista com bons olhos por analistas de segurança já que ela praticamente elimina a necessidade de acesso remoto ao servidor para fins de cópias de arquivo.

Ficaria muito extenso este post, se eu fosse entrar em detalhes sobre como realizar a configuração do CruiseControl, do Apache e de seu suporte ao WebDAV. Desta forma, vou apenas apenas dar algumas dicas de como proceder a configuração do JBoss para a realização de algumas tarefas:

• Para desabilitar o scan automático do JBoss é necessário ajustar o valor do atributo ScanEnabled do MBean jboss.deployment:flavor=URL,type=DeploymentScanner para false. Isto é realizado no arquivo jboss-service.xml da configuração que será executada pelo JBoss;

• Para incluir a URL que será acessada pelo JBoss a fim de que o mesmo possa verificar que arquivos estão em um diretório-com-suporte-a-WebDAV/ é necessário adicionar ao atributo URLs do mesmo MBean a URL a ser utilizada para o scan no servidor HTTP (note a barra final no fim da URL pois ela é ESSENCIAL). Exemplo:
  

  
  
    <attribute name=”URLs”>
  
        deploy/,http://servidor/diretorio-com-suporte-a-WebDAV/
  
    </attribute>
  
  

  
  
• Para enviar o comando scan para o JBoss, ao final do processo de build da aplicação X, será necessário a execução de da operação operação scan do mesmo MBean. Isto pode ser feito de diversas formas, sendo que, uma delas é, através da inclusão das seguintes tasks em um script Ant (disponíveis em jars do diretório client do JBoss):

  
  
    <jmx>
  
        <invoke target=”jboss.deployment:flavor=URL,type=DeploymentScanner” operation=”scan”/>
  
    </jmx>
  
  

  
  
• Para instanciar o JBoss (na versão 4.0.5) com o suporte ao scan de URLs com o suporte a WebDAV é preciso executar o run.{sh,bat} passando os parâmetros do exemplo abaixo (ATENÇÃO: se você esquecê-los tomará um TOCO do JBoss). E mais um pouco de atenção ainda: a informação abaixo é MUIIITOO difícil de ser encontrada em algum manual do JBoss. Fábio Sbano, um amigo Linuxer e Geek de trabalho na Andima, também colaborador do Lado Servidor, encontrou este detalhe no JIRA do JBoss para que pudesse fechar a solução abaixo. Desta forma, acho que seria legal a Red Hat rever a documentação e acertar com um pouco mais de ênfase pequenos detalhes como este nesta página ou nesta.

  
  
    $ run.sh -L commons-logging.jar -L commons-httpclient.jar -L webdavlib.jar
  
  

  
  
• Caso você esteja utilizando a versão 4.2.2 do JBoss, para que o suporte ao WebDAV funcione, também é necessário que a biblioteca webdavlib.jar esteja disponível no diretório $JBOSS_HOME/lib (por algum motivo ela desapareceu nesta versão) e a linha de execução do run também deverá conter o parâmetro -L commmons-codec.jar, caso contrário, você também irá ter problemas.
  

É isto… em próximos posts, mais dicas!

No sábado passado iniciei um treinamento de JBoss para o Cliente Cabal Brasil, em Brasília.
A Cabal foi minha Cliente em treinamentos que ministrei em parceria com a Argo Navis enquanto eu ainda possuia uma infra-estrutura para cursos abertos, no Terraço Shopping, em Brasília.
Agora, é com grande satisfação que posso atendê-los novamente, oferencendo os seguintes treinamentos:

1. Introdução a Java EE utilizando o JBoss AS, de 10 a 17 de maio;
2. Administração básica do JBoss AS, de 17 de maio a 7 de junho;
3. Arquitetura e funcionamento do JBoss AS, de 26 de julho a 23 de agosto;

Este curso, fechado para a Cabal, ocorre aos sábados, das 10:00 às 17:00.