Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Publicar pacotes Java com Maven

Você pode usar o Maven para publicar pacotes Java para um registro como parte do seu fluxo de trabalho de integração contínua (CI).

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. Para obter mais informações, consulte "produtos de GitHub

Neste artigo

Introdução

Este guia mostra como criar um fluxo de trabalho que publica pacotes Java no GitHub Package Registry e no Maven Central Repository. Com um único fluxo de trabalho, você pode publicar pacotes em um único repositório ou em vários repositórios.

Pré-requisitos

Recomendamos que você tenha um entendimento básico dos arquivos de fluxo de trabalho e das opções de configuração. Para obter mais informações, consulte "Aprenda GitHub Actions".

Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Java com Maven, consulte "Criando e testando o Java com Maven"

Você também pode achar útil ter um entendimento básico do seguinte:

Sobre a configuração do pacote

Os campos groupId e artefactId no arquivo x-id="4">pom.xml criam a um identificador exclusivo para o seu pacote que os registros usam para vincular o seu pacote a um registro. Para obter mais informações, consulte Guia para fazer o upload de artefatos no Repositório Central na documentação do Apache Maven.

O arquivo pom.xml também contém a configuração para os repositórios de gerenciamento de distribuição nos quais o Maven implementará pacotes. Cada repositório deve ter um nome e uma URL de implementação. A autenticação para estes repositórios pode ser configurada no arquivo .m2/settings.xml no diretório inicial do usuário que está executando o Maven.

É possível usar a ação de setup-java para configurar o repositório de imeplementação, bem como a autenticação para esse repositório. Para obter mais informações, consulte setup-java.

Publicar pacotes no Repositório Central do Maven

Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento versão é acionado com o tipo criado. O fluxo de trabalho publica o pacote no Repositório Central Maven se o teste de CI for aprovado. Para obter mais informações sobre o evento da versão, consulte "Eventos que acionam fluxos de trabalho".

Neste fluxo de trabalho, você pode usar a ação setup-java. Esta ação instala uma determinada versão do JDK no PATH, mas também define settings.xml do Maven para publicação de pacotes. Por padrão, o arquivo de configurações será definido como GitHub Package Registry. No entanto, ele pode ser configurado para implementar outro registro de pacote, como, por exemplo, o Repositório Central do Maven. Se você já tem um repositório de gerenciamento de distribuição configurado em pom.xml, você poderá especificar esse id durante a chamada da ação setup-java.

Por exemplo, se você estava implantando no Repositório Central do Maven por meio do projeto de hospedagem OSSRH, seu pom.xml poderia especificar um repositório de gerenciamento de distribuição com o id de ossrh.

<project ...>
  ...
  <distributionManagement>
    <repository>
      <id>ossrh</id>
      <name>Central Repository OSSRH</name>
      <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
    </repository>
  </distributionManagement>
</project>

Com esta configuração, é possível criar um fluxo de trabalho que publique seu pacote no Repositório Central do Maven especificando o id do gerenciamento do repositório para a ação setup-java. Você também deverá fornecer variáveis de ambiente que contenham o nome de usuário e senha para fazer a autenticação no repositório.

Na etapa de implementação, você deverá definir as variáveis de ambiente para o nome de usuário com o qual deseja fazer a autenticação no repositório e para um segredo que você configurou com a senha ou token para autenticação. Para obter mais informações, consulte "Criando e usando segredos encriptados".

nome: Publicar pacote no Repositório Central do Maven
em:
  versão:
    tipos: [created]
trabalhos:
  publicar:
    runs-on: ubuntu-latest
    etapas:
      - usa: actions/checkout@v2
      - nome: Configurar no Repositório Central do Maven
        usa: actions/setup-java@v1
        com:
          java-version: 1.8
          server-id: ossrh
          server-username: MAVEN_USERNAME
          server-password: MAVEN_PASSWORD
      - nome: Publicar pacote
        executar: mvn -B deploy
        env:
          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}

Este fluxo de trabalho executa os seguintes passos:

  1. Verifica uma cópia do repositório do projeto.

  2. Configura o Java JDK e o arquivo settings.xml do Maven para adicionar autenticação ao repositório ossrh usando as variáveis de ambiente MAVEN_USERNAME e MAVEN_PASSWORD.

  3. Executa o comando mvn -B deploy para publicar no repositório ossrh. A variável de ambiente MAVEN_USERNAME será definida com o conteúdo do seu segredo OSSRH_USERNAME, e a variável de ambiente MAVEN_PASSWORD será definida com o conteúdo do seu segredo OSSRH_TOKEN.

    Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "Criando e usando segredos encriptados".

Publicar pacotes em GitHub Package Registry

Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento versão é acionado com o tipo criado. O fluxo de trabalho publica o pacote em GitHub Package Registry se o teste de CI for aprovado. Para obter mais informações sobre o evento da versão, consulte "Eventos que acionam fluxos de trabalho".

Neste fluxo de trabalho, você pode usar a ação setup-java. Esta ação instala a versão determinada do JDK no PATH, e também configura settings.xml do Maven para a publicação GitHub Package Registry. O settings.xml gerado define a autenticação para um servidor com um id do github, usando a variável de ambiente GITHUB_ACTOR como o nome de usuário e a variável de ambiente GITHUB_TOKEN como a senha.

O GITHUB_TOKEN existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "Autenticação com o GITHUB_TOKEN".

Para um projeto baseado no Maven, você pode usar essas configurações ao criar um repositório de distribuição no seu arquivo pom.xml com um id do github que aponta para seu ponto final GitHub Package Registry.

Por exemplo, se sua organização é denominada "octocat" e seu repositório é denominado "hello-world", a configuração do GitHub Package Registry no pom.xml será parecida ao exemplo abaixo.

<project ...>
  ...
  <distributionManagement>
    <repository>
      <id>github</id>
      <name>GitHub Packages</name>
      <url>https://maven.pkg.github.com/octocat/hello-world</url>
    </repository>
  </distributionManagement>
</project>

Com esta configuração, você pode criar um fluxo de trabalho que publica seu pacote em GitHub Package Registry, fazendo uso do settings.xml gerado automaticamente.

nome: Publicar pacote nos pacotes do GitHub
em:
  versão:
    tipos: [created]
trabalhos:
  publicar:
    runs-on: ubuntu-latest
    etapas:
      - usa: actions/checkout@v2
      - usa: actions/setup-java@v1
        com:
          java-version: 1.8
      - nome: Publicar pacote
        executar: mvn -B deploy
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Este fluxo de trabalho executa os seguintes passos:

  1. Verifica uma cópia do repositório do projeto.

  2. Configura o Java JDK e também configura automaticamente o arquivo settings.xml do Maven para adicionar autenticação para o repositório do github do Maven para usar a variável de ambiente GITHUB_TOKEN.

  3. Executa o comando mvn -B deploy para publicar no GitHub Package Registry. A variável de ambiente GITHUB_TOKEN será definida com o conteúdo do segredo GITHUB_TOKEN.

    Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "Criando e usando segredos encriptados".

Publicar imagens no Repositório Central do Maven e em GitHub Package Registry

Você pode publicar seus pacotes no Repositório Central Maven e em GitHub Package Registry, usando a ação de setup-java para cada registro.

Certifique-se de que seu arquivo pom.xml inclui um repositório de gerenciamento de distribuição tanto para seu repositório GitHub como para o seu provedor de Repositório Central do Maven. Por exemplo, se você fizer a implementação em um Repositório Central por meio do projeto de hospedagem OSSRH, é possível que você deseje especificá-la em um repositório de gerenciamento de distribuição com o id definido como ossrh. Além disso, você pode desejar especificar GitHub Package Registry em um repositório de gerenciamento de distribuição com o id definido como github.

nome: Publicar pacote no Repositório Central do Maven e nos Pacotes do GitHub
em:
  versão:
    tipos: [created]
trabalhos:
  publicar:
    runs-on: ubuntu-latest
    etapas:
      - usar: actions/checkout@v2
      - nome: Configurar o Java para publicação no Repositório Central do Maven
        uses: actions/setup-java@v1
        with:
          java-version: 1.8
          server-id: ossrh
          server-username: MAVEN_USERNAME
          server-password: MAVEN_PASSWORD
      - nome: Publicar no Repositório Central do Maven
        run: mvn -B deploy
        env:
          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
      - name: Set up Java for publishing to GitHub Packages
        usa: actions/setup-java@v1
        com:
          java-version: 1.8
      - nome: Publicar nos pacotes do GitHub
        executar: mvn -B deploy
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Este fluxo de trabalho chama a ação setup-java duas vezes. Cada vez que a ação setup-java é executada, ela sobrescreve o arquivo settings.xml do Maven para a publicação de pacotes. Para autenticação no repositório, o arquivo settings.xml faz referência ao IDdo repositório de gerenciamento de distribuição e ao nome de usuário e senha.

Este fluxo de trabalho executa os seguintes passos:

  1. Verifica uma cópia do repositório do projeto.

  2. Chama setup-java pela primeira vez. Isso configura o arquivo settings.xml do Maven para o repositório ossrh e define as opções de autenticação para variáveis de ambiente definidas na próxima etapa.

  3. Executa o comando mvn -B deploy para publicar no repositório ossrh. A variável de ambiente MAVEN_USERNAME será definida com o conteúdo do seu segredo OSSRH_USERNAME, e a variável de ambiente MAVEN_PASSWORD será definida com o conteúdo do seu segredo OSSRH_TOKEN.

  4. Chama setup-java pela segunda vez. Isso configura automaticamente o arquivo settings.xml do Maven para GitHub Package Registry.

  5. Executa o comando mvn -B deploy para publicar no GitHub Package Registry. A variável de ambiente GITHUB_TOKEN será definida com o conteúdo do segredo GITHUB_TOKEN.

    Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "Criando e usando segredos encriptados".

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.