इस लेख में, मैं ग्रैड कलेक्टर का उपयोग करके सोनाटाइप मावेन सेंट्रल रिपॉजिटरी में जीथब एक्टेशन के माध्यम से स्क्रैच से जावा आर्टवर्क को प्रकाशित करने की प्रक्रिया पर एक विस्तृत नज़र डालना चाहता हूं।

मैंने एक जगह सामान्य ट्यूटोरियल की कमी के कारण इस लेख को लिखने का फैसला किया। सभी जानकारी विभिन्न स्रोतों से टुकड़ों में एकत्र की जानी थी, जबकि पूरी तरह से ताजा नहीं थी। कौन परवाह करता है, बिल्ली में आपका स्वागत है।

सोनाटाइप में एक भंडार का निर्माण

पहला कदम सोनाटाइप मावेन सेंट्रल में एक भंडार बनाना है। ऐसा करने के लिए, यहां जाएं , पंजीकरण करें और एक नया कार्य बनाएं, जिससे हमें हमारे लिए एक रिपॉजिटरी बनाने के लिए कहा जा सके। हम प्रोजेक्ट के हमारे GroupId , Project URL को प्रोजेक्ट और SCM url लिंक को उस संस्करण नियंत्रण प्रणाली में चलाते हैं जिसमें परियोजना निहित है। यहां GroupId कॉम का होना चाहिए। com.example, com.example.domain, com.example.testsupport, और यह आपके github: github.com/yourusername -> jio.github.yourusername का लिंक भी हो सकता है । किसी भी स्थिति में, आपको इस डोमेन या प्रोफ़ाइल के स्वामित्व की पुष्टि करनी होगी। यदि आपने एक जीथूब प्रोफाइल निर्दिष्ट किया है, तो वे आपको वांछित नाम के साथ एक सार्वजनिक भंडार बनाने के लिए कहेंगे।

पुष्टि के कुछ समय बाद, आपका GroupId बनाया जाएगा और हम अगले चरण, ग्रैडल कॉन्फ़िगरेशन के लिए आगे बढ़ सकते हैं।

ग्रेडिंग को कॉन्फ़िगर करना

इस लेखन के समय, मुझे ग्रैडल के लिए कोई प्लगइन्स नहीं मिला जो आर्टवर्क के प्रकाशन में मदद कर सके। यह एकमात्र प्लगइन है जो मैंने पाया है, हालांकि लेखक ने अपने आगे के समर्थन से इनकार कर दिया है। इसलिए, मैंने खुद ही सब कुछ करने का फैसला किया, क्योंकि यह करना बहुत मुश्किल नहीं है।

पहली बात यह पता लगाना है कि सोनाटाइप की प्रकाशन आवश्यकताएं हैं। वे इस प्रकार हैं:

स्रोत कोड और JavaDoc की उपस्थिति, अर्थात मौजूद होना चाहिए -sources.jarऔर -javadoc.jarफ़ाइलें। जैसा कि प्रलेखन में कहा गया है, यदि स्रोत कोड या प्रलेखन प्रदान करना संभव नहीं है, तो आप परीक्षण पास करने के लिए एक डमी -sources.jarया -javadoc.jarएक साधारण README के साथ बना सकते हैं ।
GPG/PGP, .asc , , .
pom
groupId, artifactId version. -SNAPSHOT
name, description url
,

, . .

build.gradle . , , , url, . :

def customizePom(pom) {
    pom.withXml {
        def root = asNode()

        root.dependencies.removeAll { dep ->
            dep.scope == "test"
        }

        root.children().last() + {
            resolveStrategy = DELEGATE_FIRST

            description 'Some description of artifact'
            name 'Artifct name'
            url 'https://github.com/login/projectname'
            organization {
                name 'com.github.login'
                url 'https://github.com/login'
            }
            issueManagement {
                system 'GitHub'
                url 'https://github.com/login/projectname/issues'
            }
            licenses {
                license {
                    name 'The Apache License, Version 2.0'
                    url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                }
            }
            scm {
                url 'https://github.com/login/projectname'
                connection 'scm:https://github.com/login/projectname.git'
                developerConnection 'scm:git://github.com/login/projectname.git'
            }
            developers {
                developer {
                    id 'dev'
                    name 'DevName'
                    email 'email@dev.ru'
                }
            }
        }
    }
}

, -sources.jar -javadoc.jar . java :

java {
    withJavadocJar()
    withSourcesJar()
}

, GPG/PGP . signing:

plugins {
    id 'signing'
}

signing {
    sign publishing.publications
}

, publishing:

publishing {
    publications {
        mavenJava(MavenPublication) {
            customizePom(pom)
            groupId group
            artifactId archivesBaseName
            version version

            from components.java
        }
    }
    repositories {
        maven {
            url "https://oss.sonatype.org/service/local/staging/deploy/maven2"
            credentials {
                username sonatypeUsername
                password sonatypePassword
            }
        }
    }
}

sonatypeUsername sonatypePassword , , sonatype.org.

, build.gradle :

build.gradle

plugins {
    id 'java'
    id 'maven-publish'
    id 'signing'
}

java {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
    withJavadocJar()
    withSourcesJar()
}

group 'io.github.githublogin'
archivesBaseName = 'projectname'
version = System.getenv('RELEASE_VERSION') ?: "0.0.1"

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.5.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.5.2'
}

test {
    useJUnitPlatform()
}

jar {
    from sourceSets.main.output
    from sourceSets.main.allJava
}

signing {
    sign publishing.publications
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            customizePom(pom)
            groupId group
            artifactId archivesBaseName
            version version

            from components.java
        }
    }
    repositories {
        maven {
            url "https://oss.sonatype.org/service/local/staging/deploy/maven2"
            credentials {
                username sonatypeUsername
                password sonatypePassword
            }
        }
    }
}

def customizePom(pom) {
    pom.withXml {
        def root = asNode()

        root.dependencies.removeAll { dep ->
            dep.scope == "test"
        }

        root.children().last() + {
            resolveStrategy = DELEGATE_FIRST

            description 'Some description of artifact'
            name 'Artifct name'
            url 'https://github.com/login/projectname'
            organization {
                name 'com.github.login'
                url 'https://github.com/githublogin'
            }
            issueManagement {
                system 'GitHub'
                url 'https://github.com/githublogin/projectname/issues'
            }
            licenses {
                license {
                    name 'The Apache License, Version 2.0'
                    url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                }
            }
            scm {
                url 'https://github.com/githublogin/projectname'
                connection 'scm:https://github.com/githublogin/projectname.git'
                developerConnection 'scm:git://github.com/githublogin/projectname.git'
            }
            developers {
                developer {
                    id 'dev'
                    name 'DevName'
                    email 'email@dev.ru'
                }
            }
        }
    }
}

, : System.getenv('RELEASE_VERSION'). .

PGP

Sonatype GPG/PGP . GnuPG .

: gpg --gen-key, , e-mail, .
id : gpg --list-secret-keys --keyid-format short. Id , : rsa2048/9B695056
https://keys.openpgp.org : gpg --keyserver https://keys.openpgp.org/ --send-keys 9B695056
, : gpg --export-secret-key 9B695056 > D:\\gpg\\9B695056.gpg

Github Actions

, , Github Actions.
Github Actions – , , CI/CD. , : , issues. .

Sonatype , .

, id , , , PGP , / Sonatype. :

SONATYPE_USERNAME/SONATYPE_PASSWORD — /, Sonatype
SIGNING_KEYID/SIGNING_PASSWORD — id PGP , .

GPG_KEY_CONTENTS . , PGP . , , .

gpg: gpg --symmetric --cipher-algo AES256 9B695056.gpg, . : SECRET_PASSPHRASE
base64: base64 9B695056.gpg.gpg > 9B695056.txt. : GPG_KEY_CONTENTS.

PR

: .github/workflows.

, , gradle-ci-build.yml :

name: build

on:
  push:
    branches:
      - master
      - dev
      - testing
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - name: Set up JDK 8
        uses: actions/setup-java@v1
        with:
          java-version: 8

      - name: Build with Gradle
        uses: eskatos/gradle-command-action@v1
        with:
          gradle-version: current
          arguments: build -PsonatypeUsername=${{secrets.SONATYPE_USERNAME}} -PsonatypePassword=${{secrets.SONATYPE_PASSWORD}}

master, dev testing, .

jobs , . ubuntu, Java 8, Gradle eskatos/gradle-command-action@v1, , arguments. secrets.SONATYPE_USERNAME secrets.SONATYPE_PASSWORD , .

Actions:

gradle-ci-publish.yml:

name: publish

on:
  push:
    tags:
      - 'v*'

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - name: Set up JDK 8
        uses: actions/setup-java@v1
        with:
          java-version: 8

      - name: Prepare to publish
        run: |
          echo '${{secrets.GPG_KEY_CONTENTS}}' | base64 -d > publish_key.gpg
          gpg --quiet --batch --yes --decrypt --passphrase="${{secrets.SECRET_PASSPHRASE}}" \
          --output secret.gpg publish_key.gpg
          echo "::set-env name=RELEASE_VERSION::${GITHUB_REF:11}"

      - name: Publish with Gradle
        uses: eskatos/gradle-command-action@v1
        with:
          gradle-version: current
          arguments: test publish -Psigning.secretKeyRingFile=secret.gpg -Psigning.keyId=${{secrets.SIGNING_KEYID}} -Psigning.password=${{secrets.SIGNING_PASSWORD}} -PsonatypeUsername=${{secrets.SONATYPE_USERNAME}} -PsonatypePassword=${{secrets.SONATYPE_PASSWORD}}

, . , v.

PGP , . RELEASE_VERSION gradle.build . Prepare to publish. GPG_KEY_CONTENTS, gpg , , secret.gpg.

GITHUB_REF, , . refs/tags/v0.0.2 11 , . Gradle : test publish

Sonatype

, . :

v. Publish release, , Sonatype Nexus :

Staging . Open, Close, . , Close . MavenCentral. , Release, Sonatype.

, MavenCentral, , . , . , . , MavenCentral 5 .

बस इतना ही, हमने अपनी कलाकृतियों को मावनसेन्ट्रल में प्रकाशित किया।

उपयोगी कड़ियाँ

इसी तरह का लेख , केवल मावेन के माध्यम से प्रकाशन
स्टेजिंग रिपोजिटरी सोनाटाइप
जीरा सोनाटाइप, जिसमें आपको एक कार्य बनाने की आवश्यकता है
एक उदाहरण भंडार जहां यह सब स्थापित है

Sonatype Maven Central Repository में जावा प्रोजेक्ट को प्रकाशित करने के लिए ग्रैडल और गितुब क्रियाओं का उपयोग करना

सोनाटाइप में एक भंडार का निर्माण

ग्रेडिंग को कॉन्फ़िगर करना

PGP

Github Actions

PR

Sonatype

उपयोगी कड़ियाँ

More articles: