Skip to content

Latest commit

 

History

History
85 lines (58 loc) · 3.58 KB

README.adoc

File metadata and controls

85 lines (58 loc) · 3.58 KB

cui-java-module-template

What is it?

This is a template repository for creating java-modules for cui-open-source-projects. This incorporates all necessary java-structures, including pom.xml, sensible project-documentation, an predefined github pipelines.

It is meant to be used as copy-paste-template.

Maven Coordinates

    <dependency>
        <groupId>de.cuioss</groupId>
        <artifactId>cui-java-module-template</artifactId>
    </dependency>

Customization

Names / Keys

Create a new Repository by clicking "Use this template" Replace all of cui-java-module-template with the new project 'key' / name, e.g. my-java-module. Relevant Files are:

Caution

The key must not contain spaces. They are used for creating urls as well.

  • README.adoc → the badges on top

  • pom.xml

  • SECURITY.adoc

  • .github/project.yml

  • src/site/site.xml

  • src/site/asciidoc/about.adoc

Credentials

Add the necessary credentials to the project: "Settings" → "Secrets" → "Actions", as there are:

  • GPG_PASSPHRASE → Code Signing

  • GPG_PRIVATE_KEY → Code Signing

  • OSS_SONATYPE_PASSWORD → Deploy to maven-central

  • OSS_SONATYPE_USERNAME → Deploy to maven-central

  • PAGES_DEPLOY_TOKEN → Deploying the result of maven site to https://cuioss.github.io

  • SONAR_TOKEN → Sonar-Cloud

They are picked up in the predefined pipeline-configurations:

  • .github/workflows/maven.yml

  • .github/workflows/maven-release.yml

Ensure that the actions are authorized correctly: Settings > Actions > General > Workflow permissions > "Read and write permissions" must be selected not "Read repository contents permission"

Documentation on how to create a signing key can be found Documentation at cui-parent-pom

A sonar token can be derived from https://sonarcloud.io/account/security

Further Steps

  • pom.xml: Adjust name and description elements

  • Adjust module-info accordingly

  • pom.xml: Adjust property maven.jar.plugin.automatic.module.name according to your module-info

  • src/site/asciidoc/about.adoc: Adjust content

  • Review / Enable the elements under 'Security' Tab

  • Review / Add Collaborators

  • Add (link) the resulting maven-documentation: github.io-documentation