cy6ergn0m / github-release-plugin

Maven plugin for uploading artifacts to the GitHub releases

github-release-plugin

Maven plugin to deploy artifacts to the GitHub releases.

Setup

• Add git URL (SSH or https url)

    <scm>
        <connection>scm:git:[email protected]:owner/repository.git</connection>
        <tag>HEAD</tag>
    </scm>

• Add plugin

    <pluginRepositories>
        <pluginRepository>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
            <id>bintray-cy6ergn0m-maven</id>
            <name>bintray-plugins</name>
            <url>http://dl.bintray.com/cy6ergn0m/maven</url>
        </pluginRepository>
    </pluginRepositories>

    <build>
        <plugins>
            <plugin>
                <groupId>cy.github</groupId>
                <artifactId>github-release-plugin</artifactId>
                <version>${plugin.version}</version>

                <configuration>
                    <tagName>${project.artifactId}-${project.version}</tagName>
                    <preRelease>true</preRelease>
                </configuration>

                <executions>
                    <execution>
                        <goals>
                            <goal>gh-upload</goal>
                        </goals>
                        <phase>deploy</phase>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

• Obtain token at github: https://github.com/settings/tokens (repo and user access are required for successful upload)
• Open your ~/.m2/settings.xml and add server with the token. If you use TeamCity you have to configure settings.xml for you build configuration

    <server>
        <id>github</id>
        <username>username</username>
        <password>(your token here)</password>
    </server>

Note: you can use password encryption as well, see Maven Password Encryption Guide for details.

Deploy releases

To deploy to github use mvn deploy or use Maven Release Plugin

You also can launch plugin directly mvn package github-release-plugin:gh-upload

Plugin configuration options

Option	System property	Default value	Description
skip	maven.deploy.skip	false	Skip deployment, notice that system property will skip all deployments and will affect all plugins
serverId		github	server id in settings.xml
endpointURL		https://api.github.com	URL of github API, also could be specified via settings.xml server entry
owner			github repository owner, overrides scm tag
repository			github repository id
tagName		${project.version}	git tag to be used to create release from
releaseTitle		${project.version}	title of release
preRelease		false	If true then release will be marked with red prerelese badge

github-release-plugin's Issues

Move to new repository

Now that Bintray has reached its end of service , the plugin should be moved to a new repository. The plugin no longer works as it cannot be retrieved.

Question: Is there a way to provide tokens outside of settings.xml

Hi,
My pipeline runs in temporary containers and there is no way for me to store the access token in a permanent manner in settings.xml. So, is there any other way I can provide the access token ?

Thank you,
Anwar

Skip deploy but release to github

Hi,
i would like if you could manage to allow -Darguments="-Dmaven.deploy.skip=true" to be given as an argument to maven, but still trigger the github release upload.

As is if -Darguments="-Dmaven.deploy.skip=true" is given to maven, the Github release is skipped.

Thanks in advance. (And thanks for the plugin 😄)