134 lines
4.2 KiB
Markdown
134 lines
4.2 KiB
Markdown
# Hlæja Common Plugin
|
|
|
|
Plugins for the libraries, lofty and grand, Plugins for the services, steadfast as stone, Plugins for the common, bound to their fate, Using the one plugin to rule them all, and in automation bind them, In the realm of code, where the builds take form.
|
|
|
|
## Plugins
|
|
|
|
### Plugin Common
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.common`
|
|
|
|
Set core Java and Kotlin settings and overweight project version with git version.
|
|
|
|
#### Gradle Tasks
|
|
|
|
* `buildInfo` display name and version, add to `build` task.
|
|
* `projectInfo` display project, Gradle, and Java information
|
|
|
|
### Plugin Common Detekt
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.common-detekt`
|
|
|
|
Detect is a code smell analysis for your Kotlin projects.
|
|
|
|
### Plugin Common Ktlint
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.common-ktlint`
|
|
|
|
Ktlint enforces consistent code style and formatting across Kotlin codebases.
|
|
|
|
### Plugin Library
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.library`
|
|
|
|
Default setting and tasks for libraries.
|
|
|
|
### Plugin Library Manifest
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.library-manifest`
|
|
|
|
Extend manifest in library jar file.
|
|
|
|
### Plugin Library publish
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.library-publish`
|
|
|
|
Configuration for publishing project artifacts to a remote Maven repository.
|
|
|
|
### Plugin Service
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.service`
|
|
|
|
Default setting and tasks for services.
|
|
|
|
### Plugin Service Container
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.service-container`
|
|
|
|
Configuration for running project in docker locally during development.
|
|
|
|
#### Configuration
|
|
|
|
* properties `container.network`, environment `CONTAINER_NETWORK`, or default `develop`
|
|
* properties `container.port.expose`, environment `CONTAINER_PORT_EXPOSE`, or default `8080`
|
|
* properties `container.port.host`, environment `CONTAINER_PORT_HOST`, or default `8080`
|
|
* properties `container.profiles`, environment `CONTAINER_PROFILES`, or default `docker`
|
|
* properties `docker.port.expose`, environment `DOCKER_PORT_EXPOSE`, or default `8080`
|
|
|
|
container and docker ports can be a single port (e.g., 8080) or multiple ports separated by commas (e.g., 8080,8443)
|
|
|
|
#### Gradle Tasks
|
|
|
|
* `containerCreate` create docker container with network and spring boot profile.
|
|
* `containerStart` starts docker container.
|
|
* `containerStop` stops docker container.
|
|
* `containerNetworkCheck` check if network exist.
|
|
* `containerNetworkCreate` creates network.
|
|
* `containerNetworkRemove` removes network.
|
|
|
|
### Plugin Service Integration Test
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.service-integration-test`
|
|
|
|
Adding task `integrationTest` to run integration test, add to `verification` group and add to task `check`.
|
|
|
|
Adding intellij support `src/integration-test/java`, `src/integration-test/kotlin`, and `src/integration-test/resources` as test module in intellij.
|
|
|
|
Adding dependencies support `integrationTestImplementation()`, and `integrationTestRuntimeOnly()` as part of Gradle.
|
|
|
|
### Plugin Service Process Resource
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.service-process-resource`
|
|
|
|
Assign values to `application.yml` from Gradle.
|
|
|
|
### Plugin Certificate
|
|
|
|
id `ltd.hlaeja.plugin.hlaeja-common-plugin.cetificat`
|
|
|
|
Copy certificate to build resources by placing one or more of `private_key.pem`, `public_key.pem`, or `keystore.p12` in `/cert` folder.
|
|
|
|
## Releasing Plugin
|
|
|
|
Run release pipeline from `master` branch.
|
|
|
|
## Publishing plugin
|
|
|
|
### Publish plugin locally
|
|
|
|
```shell
|
|
./gradlew clean build publishToMavenLocal
|
|
```
|
|
|
|
### Publish plugin to repository
|
|
|
|
```shell
|
|
./gradlew clean build publishAllPublicationsToGitHubPackagesRepository
|
|
```
|
|
|
|
### Global gradle properties
|
|
|
|
To authenticate with Gradle to access repositories that require authentication, you can set your user and token in the `gradle.properties` file.
|
|
|
|
Here's how you can do it:
|
|
|
|
1. Open or create the `gradle.properties` file in your Gradle user home directory:
|
|
- On Unix-like systems (Linux, macOS), this directory is typically `~/.gradle/`.
|
|
- On Windows, this directory is typically `C:\Users\<YourUsername>\.gradle\`.
|
|
2. Add the following lines to the `gradle.properties` file:
|
|
```properties
|
|
repository.user=your_user
|
|
repository.token=your_token_value
|
|
```
|
|
or use environment variables `REPOSITORY_USER` and `REPOSITORY_TOKEN`
|