Red Hat Training
A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform
4.2.4.2. Configuração Maven para Uso com a Linha de Comando
Os artefatos e dependências necessárias para construir e implantar aplicativos ao JBoss EAP 6 possuem host num repositório público. Caso deseje planejar o uso do Red Hat JBoss Developer Studio para construir e implantar os aplicativos, você pode ignorar este tópico. Do contrário, siga as seguintes instruções: Seção 4.2.3.1, “Configuração Maven para uso com o Red Hat JBoss Developer Studio”. No entanto, caso planeje usar a linha de comando do Maven, você deve direcionar o Maven para uso do JBoss EAP 6 Maven Repository por todos os seus projetos usando as configurações do Maven.
Existem duas maneiras de configurar as configurações para uso com a linha de comando do Maven.
Este tópico descreve ambos os métodos. Caso você tenha baixado as iniciações rápidas, o primeiro procedimento é a maneira mais simples de realizar as configurações.
- Você pode copiar o arquivo
settings.xml
pré-configurado que lança as iniciações rápidas. - Você pode editar manualmente o arquivo
settings.xml
Maven.
Pré-requisitos
Você deve instalar o Maven antes de configurar as configurações. Consulte: Seção 4.2.4.1, “Download e Instalação do Maven” para maiores informações.
Procedimento 4.4. Configure o Maven usando as Configurações lançadas com as Amostras de Iniciação Rápida
As Iniciações Rápidas do Red Hat JBoss Enterprise Application Platform lançam um arquivo
settings.xml
que é configurado para uso online do repositório Maven do JBoss EAP. Caso tenha baixado as iniciações rápidas, esta é a maneira mais fácil de realizar as configurações.
- Este procedimento sobrescreve o arquivo de configurações do Maven existente, de forma que você deve realizar o backup do arquivo
settings.xml
Maven.- Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório
USER_HOME/.m2/
.- Para o Linux ou Mac, ele é:
~/.m2/
- Para o Windows, ele é:
\Documents and Settings\USER_NAME\.m2\
ou\Users\USER_NAME\.m2\
- Caso possua um arquivo
USER_HOME/.m2/settings.xml
existente, renomeie-o ou realize uma cópia de forma que você pode restaurá-lo mais tarde.
- Caso você não tenha baixado as iniciações rápidas, siga as seguintes instruções: Seção 3.4.1, “Realize o Download das Iniciações Rápidas”.
- Copie o arquivo
QUICKSTART_HOME/settings.xml
ao diretórioUSER_HOME/.m2/
. - Caso você modifique o arquivo
settings.xml
enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.
Procedimento 4.5. Edição manual e Configurações Maven para uso online do Repositório Maven do JBoss EAP
É possível adicionar manualmente os perfis do JBoss EAP a um arquivo de configurações Maven existente.
- Encontre o diretório de instalação para o seu sistema operacional. Ele normalmente é instalado no diretório
USER_HOME/.m2/
.- Para o Linux ou Mac, ele é
~/.m2/
- Para o Windows, ele é
\Documents and Settings\USER_NAME\.m2\
ou\Users\USER_NAME\.m2\
- Caso você não encontrar um arquivo
settings.xml
, copie o arquivosettings.xml
a partir do diretórioUSER_HOME/.m2/conf/
no diretórioUSER_HOME/.m2/
. - Copie o seguinte XML ao elemento
<profiles>
do arquivo.<!-- Configure the JBoss GA Maven repository --> <profile> <id>jboss-ga-repository</id> <repositories> <repository> <id>jboss-ga-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-ga-plugin-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> <!-- Configure the JBoss Early Access Maven repository --> <profile> <id>jboss-earlyaccess-repository</id> <repositories> <repository> <id>jboss-earlyaccess-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-earlyaccess-plugin-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile>
Copie o seguinte XML no elemento<activeProfiles>
do arquivosettings.xml
.<activeProfile>jboss-ga-repository</activeProfile> <activeProfile>jboss-earlyaccess-repository</activeProfile>
- Caso você modifique o arquivo
settings.xml
enquanto o Red Hat JBoss Developer Studio estiver sendo executado, siga o procedimento no final deste tópico nomeado Refresh the Red Hat JBoss Developer Studio User Settings.
Procedimento 4.6. Atualize as Configurações do Usuário do Red Hat JBoss Developer Studio
Caso você modificar o arquivo
settings.xml
enquanto o Red Hat JBoss Developer Studio estiver sendo executado, você deve atualizar as configurações do usuário.
- A partir do menu, selecione Window → Preferences.
- Na Janela Preferences, expanda o Maven e selecione User Settings.
- Clique no botão Update Settings para atualizar as configurações do usuário Maven no Red Hat JBoss Developer Studio.
Figura 4.11. Atualização das Configurações do Usuário Maven
Importante
Caso o seu repositório Maven possuir artefatos desatualizados, é possível encontrar um dos seguintes erros de mensagens do Maven quando construindo ou implantando o seu projeto.
Para resolver este problema, exclua a versão com cache de seu repositório local para forçar um download dos artefatos Maven mais recentes. O repositório com cache está localizado no seu subdiretório
- Falta o artefato ARTIFACT_NAME
- [ERROR] Falha ao executar a meta no projeto PROJECT_NAME; Não foi possível resolver as dependências para PROJECT_NAME
~/.m2/repository/
no Linux ou no subdiretório %SystemDrive%\Users\USERNAME\.m2\repository\
no Windows.