Usar somas de verificação e instantâneos do Maven

As seções a seguir descrevem como usar somas de verificação do Maven e instantâneos do Maven em. CodeCatalyst

Usar somas de verificação do Maven

Quando um pacote Maven é publicado em um repositório de CodeCatalyst pacotes, a soma de verificação associada a cada ativo ou arquivo no pacote é usada para validar o upload. Os arquivos jar, pom e war são exemplos de ativos. Para cada ativo, o pacote do Maven contém vários arquivos de soma de verificação que usam o nome do ativo com uma extensão adicional, como md5 ou sha1. Por exemplo, os arquivos de soma de verificação de um arquivo chamado my-maven-package.jar podem ser my-maven-package.jar.md5 e my-maven-package.jar.sha1.

Cada pacote do Maven também contém um arquivo maven-metadata.xml. Esse arquivo deve ser carregado para que uma publicação seja bem-sucedida. Se uma incompatibilidade de soma de verificação for detectada durante o upload de qualquer arquivo de pacote, a publicação será interrompida. Isso pode impedir que maven-metadata.xml seja carregado. Quando isso acontece, o status do pacote do Maven é definido como Unfinished. Você não pode baixar ativos que fazem parte de um pacote com esse status.

Lembre-se do seguinte no caso de uma incompatibilidade de soma de verificação ao publicar um pacote do Maven:

• Se a incompatibilidade da soma de verificação ocorrer antes do upload de maven-metadata.xml, o status do pacote não será definido como Unfinished. O pacote não está visível e os ativos não podem ser consumidos. Quando isso acontecer, tente uma das opções a seguir e tente baixar o ativo novamente.

  • Execute o comando que publica o pacote do Maven novamente. Isso pode funcionar se um problema de rede tiver corrompido o arquivo de soma de verificação durante o download. Se o problema de rede for resolvido na nova tentativa, a soma de verificação será correspondente e o download será concluído.

  • Se a republicação do pacote do Maven não funcionar, exclua o pacote e, depois, publique-o novamente.

• Se a incompatibilidade da soma de verificação ocorrer depois do upload de maven-metadata.xml, o status do pacote será definido como Published. Você pode consumir qualquer ativo do pacote, incluindo aqueles com incompatibilidades de soma de verificação. Quando você baixa um ativo, a soma de verificação gerada por CodeCatalyst é baixada com ele. Se o arquivo baixado estiver associado a uma incompatibilidade de soma de verificação, o arquivo de soma de verificação baixado pode não corresponder à soma de verificação que foi carregada quando o pacote foi publicado.

Uso de snapshots do Maven

Um snapshot do Maven é uma versão especial de um pacote do Maven que se refere ao código de ramificação de produção mais recente. É uma versão de desenvolvimento que precede a versão final de lançamento. Você pode identificar a versão de snapshot de um pacote do Maven pelo sufixo SNAPSHOT anexado à versão do pacote. Por exemplo, o snapshot da versão 1.1 é 1.1-SNAPSHOT. Para obter mais informações, consulte O que é uma versão de SNAPSHOT? no site do Apache Maven Project.

CodeCatalyst suporta a publicação e o consumo de instantâneos do Maven. Você pode publicar um snapshot do Maven em um CodeCatalyst repositório ou, se estiver diretamente conectado, em um repositório upstream. No entanto, não há suporte para uma versão de snapshot em um repositório de pacotes e em um dos repositórios upstream. Por exemplo, se você fizer upload de um pacote Maven com versão 1.2-SNAPSHOT para seu repositório de pacotes, CodeCatalyst não oferece suporte ao upload de um pacote Maven com a mesma versão de instantâneo em um de seus repositórios upstream. Esse cenário pode retornar resultados imprevisíveis.

Quando um snapshot do Maven é publicado, a versão anterior dele é preservada em uma nova versão chamada de compilação. Cada vez que um snapshot do Maven é publicado, uma nova versão de compilação é criada. Todas as versões anteriores de um snapshot são mantidas em suas versões de compilação. Quando um snapshot do Maven é publicado, o status é definido como Published e o status da compilação que contém a versão anterior é definido como Unlisted.

Se você solicitar um snapshot, a versão com o status Published será retornada. É sempre a versão mais recente de snapshot do Maven. Você também pode solicitar uma compilação específica de um snapshot.

Para excluir todas as versões de compilação de um snapshot do Maven, use o CodeCatalyst console.