You need an access token to publish, install, and delete packages in GitHub Package Registry. You can use a personal access token to authenticate with your username directly to GitHub Package Registry or the GitHub API. You can use a
GITHUB_TOKEN to authenticate using a GitHub Actions workflow.
You must use a personal access token with the appropriate scopes to publish and install packages in GitHub Package Registry. For more information, see "About GitHub Package Registry."
You can authenticate to GitHub Package Registry with Apache Maven by editing your ~/.m2/settings.xml file to include your personal access token. Create a new ~/.m2/settings.xml file if one doesn't exist.
servers tag, add a child
server tag with an
id, replacing USERNAME with your GitHub username, and TOKEN with your personal access token.
repositories tag, configure a repository by mapping the
id of the repository to the
id you added in the
server tag containing your credentials. Replace REPOSITORY with the name of the repository you'd like to publish a package to or install a package from, and OWNER with the name of the user or organization account that owns the repository. Como não é permitido usar letras maiúsculas, é preciso usar letras minúsculas no nome do proprietário do repositório, mesmo que o nome do usuário ou da organização no GitHub contenha letras maiúsculas.
If you want to interact with multiple repositories, you can add each repository to separate
repository children in the
repositories tag, mapping the
id of each to the credentials in the
GitHub Package Registry supports
SNAPSHOT versions of Apache Maven. To use a repository for downloading this type of artifact, you must enable SNAPSHOTS in your ~/.m2/settings.xml file.
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <activeProfiles> <activeProfile>github</activeProfile> </activeProfiles> <profiles> <profile> <id>github</id> <repositories> <repository> <id>central</id> <url>https://repo1.maven.org/maven2</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> <repository> <id>github</id> <name>GitHub OWNER Apache Maven Packages</name> <url>https://maven.pkg.github.com/OWNER/REPOSITORY</url> </repository> </repositories> </profile> </profiles> <servers> <server> <id>github</id> <username>USERNAME</username> <password>TOKEN</password> </server> </servers> </settings>
If you are using a GitHub Actions workflow, you can use a
GITHUB_TOKEN to publish and consume packages in GitHub Package Registry without needing to store and manage a personal access token. For more information, see "Authenticating with the
By default, GitHub publishes the package to an existing repository with the same name as the package. For example, GitHub will publish a package named
com.example:test in a repository called
If you would like to publish multiple packages to the same repository, you can include the URL of the repository in the
<distributionManagement> element of the pom.xml file. O GitHub fará a correspondência do repositório com base nesse campo. Since the repository name is also part of the
distributionManagement element, there are no additional steps to publish multiple packages to the same repository.
For more information on creating a package, see the maven.apache.org documentation.
distributionManagementelement of the pom.xml file located in your package directory, replacing
OWNERwith the name of the user or organization account that owns the repository and
REPOSITORYwith the name of the repository containing your project.
<distributionManagement> <repository> <id>github</id> <name>GitHub OWNER Apache Maven Packages</name> <url>https://maven.pkg.github.com/OWNER/REPOSITORY</url> </repository> </distributionManagement>
Publish the package.
$ mvn deploy
After you publish a package, you can view the package on GitHub. For more information, see "Viewing packages."
To install an Apache Maven package from GitHub Package Registry, edit the pom.xml file to include the package as a dependency. If you want to install packages from more than one repository, add a
repository tag for each. For more information on using a pom.xml file in your project, see "Introduction to the POM" in the Apache Maven documentation.
Authenticate to GitHub Package Registry. Para obter mais informações, consulte "Autenticar-se no GitHub Package Registry."
Add the package dependencies to the
dependencies element of your project pom.xml file, replacing
com.example:test with your package.
<dependencies> <dependency> <groupId>com.example</groupId> <artifactId>test</artifactId> <version>1.0.0-SNAPSHOT</version> </dependency> </dependencies>
Instale o pacote.
$ mvn install