Capítulo 9. Integrando o Red Hat JBoss BPM Suite ao Red Hat JBoss Fuse

A integração do Red Hat JBoss Fuse permite que os usuários do JBoss Fuse complementem a sua solução de integração com os recursos adicionais fornecidos pelo JBoss BPM Suite e JBoss BRMS. A integração do Red Hat JBoss BPM Suite é fornecida por dois arquivos features.xml: um fornecendo os recursos principais do JBoss BPM Suite e JBoss BRMS, o qual define os recursos OSGi que podem ser implantados no JBoss Fuse, e o outro fornecendo um suporte adicional à integração ao SwitchYard e Camel.

Nota

Para os usuários do JBoss Fuse 6.1, apenas os recursos principais do JBoss BPM Suite e JBoss BRMS, fornecidos pelo arquivo de recursos a seguir, possuem suporte. Os clientes que estão usando uma versão mais antiga desse arquivo devem atualizá-la.

Importante

A integração do SwitchYard é uma Visualização Técnica no JBoss Fuse 6.2 e, portanto, não possui suporte atualmente.
Os recursos principais do JBoss BPM Suite e JBoss BRMS são fornecidos pelo jboss-brms-bpmsuite<version>-redhat<version>fuse-features.zip:
  • drools-common
  • drools-module
  • drools-templates
  • drools-decisiontable
  • drools-jpa
  • kie
  • kie-ci
  • kie-spring
  • kie-aries-blueprint
  • jbpm-commons
  • jbpm-human-task
  • jbpm
  • droolsjbpm-hibernate
  • h2
A tabela a seguir fornece exemplos de casos de uso para alguns dos recursos listados acima.

Tabela 9.1. Exemplos de Casos de Uso e Recursos

RecursoCaso de Uso
drools-moduleUsa o mecanismo JBoss BRMS para a avaliação de regras, sem necessidade de persistências, processos ou tabelas de decisão.
drools-jpaUsa o mecanismo JBoss BRMS para a avaliação de regras com persistências e transações mas, sem necessidade de processos ou tabelas de decisão. O recurso drools-jpa já inclui drools-module, no entanto você também pode precisar de instalar o recurso droolsjbpm-hibernate ou verificar se um pacote Hibernate compatível foi instalado.
drools-decisiontableUsa o mecanismo JBoss BRMS com tabelas de decisão.
jbpmUsa o JBoss BPM Suite (ou o mecanismo JBoss BRMS com processos). O recurso jbpm já inclui drools-module e drools-jpa. Você também pode precisar de instalar o recurso droolsjbpm-hibernate ou verificar se um pacote Hibernate compatível foi instalado.
jbpm e jbpm-human-taskUsa o JBoss BPM Suite (ou o mecanismo JBoss BRMS com processos) com Tarefas Humanas.
mecanismos principais jars e kie-ci. Usa o JBoss BRMS ou JBoss BPM Suite com KieScanner (KIE-CI) para baixar kJARs de um repositório do Maven.
kie-springUsa a integração do KIE-Spring.
kie-spring e kie-aries-blueprint.Usa a integração do KIE-Aries-Blueprint.
Os recursos adicionais a seguir para a integração do SwitchYard e Camel ao JBoss Fuse são fornecidos pelo pacote de integração:
  • fuse-bxms-switchyard-common-knowledge
  • fuse-bxms-switchyard-rules
  • fuse-bxms-switchyard-bpm
  • kie-camel
  • jbpm-workitems-camel
Esse arquivo (e os repositórios de suporte) está localizado em http://repository.jboss.org/nexus/content/repositories/public e já possui uma configuração pronta para uso no JBoss Fuse 6.2 em installDir/etc/org.ops4j.pax.url.mvn.cfg.
O arquivo tembém pode ser baixado a partir do JBoss Fuse 6.2 ou da página do produto JBoss BPM Suite no Portal do Consumidor Red Hat.

9.1. Instale/ Atualize os Recursos Principais de Integração

Nota

Esta seção refere-se aos recursos no arquivo jboss-brms-bpmsuite<version>-redhat<version>fuse-features.zip. Para recursos de integração adicionais, consulte Seção 9.2, “Instale os Recursos Adicionais de Integração”.
Caso você já tenha instalado uma versão mais antiga dos recursos principais do JBoss BPM Suite e JBoss BRMS (por exemplo, drools-karaf-features-6.2.0.Final-redhat-6-features.xml), você precisará removê-los, assim como todos os seus arquivos associados, antes de instalar o arquivo mais recente features.xml.

Procedimento 9.1. Removendo uma Instalação drools-karaf-features Existente

  1. Inicie o console Fuse usando: 
    $ ./installDir/bin/fuse
  2. Desinstale recursos/ aplicativos antigos que usavam o arquivo features.xml anterior. Por exemplo: 
    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
  3. Pesquise por referências de pacotes usando drools/kie/jbpm e remova-as: 
    list -t 0 -s | grep drools
list -t 0 -s | grep kie
list -t 0 -s | grep jbpm
    Para remover os pacotes: 
    karaf@root> osgi:uninstall <BUNDLE_ID>
  4. Remova o url drools-karaf-features antigo: 
    karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<version>/xml/features
  5. Reinicie Fuse
Para instalar drools-karaf-features:

Procedimento 9.2. Instale os recursos principais do JBoss BPM Suite e JBoss BRMS

  1. Configure os repositórios necessários:
    1. Edite o arquivo installDir/etc/org.ops4j.pax.url.mvn.cfg na sua instalação do JBoss Fuse e adicione a seguinte entrada à variável org.ops4j.pax.url.mvn.repositories, observe que as entradas são separadas por ‘, \’:
      • http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
  2. Inicie o JBoss Fuse: 
    $ ./installDir/bin/fuse
  3. Adicione uma referência ao arquivo dos recursos principais executando o seguinte comando de console: 
    JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<version>/xml/features
  4. Você pode instalar, agora, os recursos fornecidos por este arquivo executando, por exemplo, o seguinte comando de console: 
    JBossFuse:karaf@root> features:install drools-module