前置准备

1. 创建制品库

2. 获取制品库的地址

3. 创建令牌

本地开发

配置凭证

Maven

将以下内容复制到 settings.xml 文件，替换 <YOUR_TOKEN> 为令牌，<REPO_URL> 为制品库地址

<settings>
  <servers>
    <server>
      <id>cnb-maven-repo</id>
      <username>cnb</username>
      <!-- 替换为访问令牌 -->
      <password><YOUR_TOKEN></password>
    </server>
  </servers>
  <profiles>
    <profile>
      <id>cnb-maven-repo-profile</id>
      <repositories>
        <repository>
          <!-- 须与 server 的 id 一致 -->
          <id>cnb-maven-repo</id>
          <!-- 替换为制品库地址 -->
          <!-- 示例 
          <url>https://maven.cnb.cool/cnb/maven-repo/-/packages/</url>
          -->
          <url><REPO_URL></url>
        </repository>
      </repositories>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>
  </profiles>
</settings>

Gradle kotlin

1. 在项目根目录的 gradle.properties 中配置令牌，将 <YOUR_TOKEN> 替换为令牌

cnbArtifactsGradlePassword=<YOUR_TOKEN>

2. 将以下内容粘贴到 build.gradle.kts 中，将 <REPO_URL> 替换为制品库地址

publishing {
    repositories {
        maven {
            val cnbArtifactsGradlePassword = project.findProperty("cnbArtifactsGradlePassword")
            
            // 示例
            // url = uri("https://maven.cnb.cool/cnb/maven-repo/-/packages/")
            url = uri("<REPO_URL>")
            credentials {
                username = "cnb"
                password = cnbArtifactsGradlePassword.toString()
            }
        }
    }
}

Gradle groovy

1. 在项目根目录的 gradle.properties 中配置令牌，将 <YOUR_TOKEN> 替换为令牌

cnbArtifactsGradlePassword=<YOUR_TOKEN>

2. 将以下内容粘贴到 build.gradle 中，将 <REPO_URL> 替换为制品库地址

publishing {
      repositories {
        maven {
            def cnbArtifactsGradlePassword = project.findProperty('cnbArtifactsGradlePassword')

            // 示例 
            // url = uri("https://maven.cnb.cool/cnb/maven-repo/-/packages/")
            url = uri('<REPO_URL>')
            credentials {
                username = 'cnb'
                password = cnbArtifactsGradlePassword.toString()
            }
        }
    }
}

拉取制品

Maven

1. 在 pom.xml 中配置需要拉取的包

<dependencies>
    <dependency>
        <groupId>[GROUP_ID]</groupId>
        <artifactId>[ARTIFACT_ID]</artifactId>
        <version>[VERSION]</version>
    </dependency>
</dependencies>

<!-- 示例
<dependencies>
    <dependency>
        <groupId>org.cnb</groupId>
        <artifactId>maven_demo</artifactId>
        <version>9.0.0</version>
    </dependency>
</dependencies> -->

2. 拉取制品

mvn clean install
# 如需指定 settings.xml 位置，请执行：
mvn clean install -s ./settings.xml

Gradle kotlin

1. 在 build.gradle.kts 中配置所需依赖

dependencies {
  implementation("[GROUP_ID]:[ARTIFACT_ID]:[VERSION]")
}

// 示例
// dependencies {
//  implementation("com.google.guava:guava:32.1.3-jre")
// }

2. 拉取制品

./gradlew build --refresh-dependencies

Gradle groovy

1. 在 build.gradle 中配置所需依赖

dependencies {
    implementation '[GROUP_ID]:[ARTIFACT_ID]:[VERSION]'
}

// 示例
// dependencies {
//   implementation 'com.google.guava:guava:32.1.3-jre'
// }

2. 拉取制品

./gradlew build --refresh-dependencies

推送制品

Maven

1. 在 pom.xml 中配置发布仓库和制品属性，替换 <REPO_URL> 为制品库地址

<project>
  <modelVersion>4.0.0</modelVersion>
  <!-- 制品属性 -->
  <groupId>[GROUP_ID]</groupId>
  <artifactId>[ARTIFACT_ID]</artifactId>
  <version>[VERSION]</version>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <!-- 发布仓库 -->
  <distributionManagement>
    <repository>
      <!-- 须与 settings.xml 中 server 的 id 一致 -->
      <id>cnb-maven-repo</id>
      <name>cnb-maven-repo</name>
      <!-- 示例 
      <url>https://maven.cnb.cool/cnb/maven-repo/-/packages/</url>
      -->
      <url><REPO_URL></url>
    </repository>
  </distributionManagement>
</project>

2. 推送制品

mvn deploy
# 如果选择指定位置的 settings.xml，请执行
mvn deploy -s ./settings.xml

Gradle kotlin

1. 将以下内容粘贴到 build.gradle.kts 中

plugins {
    `java-library`
    `maven-publish`
}

group = "[GROUP_ID]"
version = "[VERSION]"
val artifactName = "[ARTIFACT_ID]"

publishing {
    publications {
        create<MavenPublication>("myLibrary") {
            groupId = group.toString()
            version = version.toString()
            artifactId = artifactName
            from(components["java"])
        }
    }
}

2. 执行上传命令

./gradlew publish

Gradle groovy

1. 粘贴以下内容到 build.gradle 中

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

group = '[GROUP_ID]'
version = '[VERSION]'
def artifactName = '[ARTIFACT_ID]'

publishing {
    publications {
        myLibrary(MavenPublication) {
            groupId = group
            version = version
            artifactId = artifactName
            from components.java
        }
    }
}

2. 执行上传命令

./gradlew publish

云原生构建

配置凭证

云原生构建中推荐使用内置环境变量 CNB_TOKEN。

其他令牌方式

如需使用明文令牌替换 <YOUR_TOKEN> 为您的令牌，或通过密钥仓库中变量名 <ENV_NAME> 引用。 详情请参考云原生构建、云原生开发中使用令牌。

Maven

替换 <REPO_URL> 为制品库地址

<settings>
  <servers>
    <server>
      <id>cnb-maven-repo</id>
      <username>cnb</username>
      <password>${env.CNB_TOKEN}</password>
      <!-- 其他方式： -->
      <!--<password><YOUR_TOKEN></password>               直接使用令牌 -->
      <!--<password>${env.<ENV_NAME>}</password>          密钥仓库 -->
    </server>
  </servers>
  <profiles>
    <profile>
      <id>cnb-maven-repo-profile</id>
      <repositories>
        <repository>
          <!-- 须与 server 的 id 一致 -->
          <id>cnb-maven-repo</id>
          <url><REPO_URL></url>
        </repository>
      </repositories>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>
  </profiles>
</settings>

Gradle kotlin

替换 <REPO_URL> 为制品库地址

publishing {
    repositories {
        maven {
            val cnbArtifactsGradlePassword = System.getenv("CNB_TOKEN")
            // 其他方式：
            // val cnbArtifactsGradlePassword = "<YOUR_TOKEN>"         直接使用令牌
            // val cnbArtifactsGradlePassword = System.getenv("ENV_NAME")  密钥仓库

            url = uri("<REPO_URL>")
            credentials {
                username = "cnb"
                password = cnbArtifactsGradlePassword.toString()
            }
        }
    }
}

Gradle groovy

替换 <REPO_URL> 为制品库地址

publishing {
      repositories {
        maven {
            def cnbArtifactsGradlePassword = System.getenv("CNB_TOKEN")
            // 其他方式：
            // def cnbArtifactsGradlePassword = '<YOUR_TOKEN>'           直接使用令牌
            // def cnbArtifactsGradlePassword = System.getenv("ENV_NAME")   密钥仓库

            url = uri('<REPO_URL>')
            credentials {
                username = 'cnb'
                password = cnbArtifactsGradlePassword.toString()
            }
        }
    }
}

拉取制品

将以下内容粘贴到 .cnb.yml

Maven

.cnb.yml

main:
  push:
    - docker:
        image: maven:3.8.5-openjdk-17
      stages:
        - name: mvn package
          script:
            mvn clean install -s ./settings.xml

Gradle

.cnb.yml

main:
  push:
    - docker:
        image: gradle:7.6.6-jdk17
      stages:
        - name: gradle build and run
          script:
            - ./gradlew build --refresh-dependencies

推送制品

将以下内容粘贴到 .cnb.yml

Maven

.cnb.yml

main:
  push:
    - docker:
        image: maven:3.8.5-openjdk-17
      stages:
        - name: mvn package
          script:
            mvn clean deploy -s ./settings.xml

Gradle

.cnb.yml

main:
  push:
    - docker:
        image: gradle:7.6.6-jdk17
      stages:
        - name: gradle publish
          script:
            - ./gradlew publish

云原生开发

配置凭证

与 云原生构建 配置凭证 相同。

配置开发镜像

根据客户端选择开发镜像：

Maven

.cnb.yml

$:
  vscode:
    - docker:
        image: maven:3.8.5-openjdk-17

Gradle

.cnb.yml

$:
  vscode:
    - docker:
        image: gradle:7.6.6-jdk17

拉取制品

与 本地开发 拉取制品 相同

推送制品

与 本地开发 推送制品 相同

示例

Gradle 本地推送 AAR 包

1. 配置 android-library 插件，配置文件在 gradle/libs.versions.toml

[versions]
agp = "8.11.1"
[plugins]
android-library = { id = "com.android.library", version.ref = "agp" }

2. 在 build.gradle 或者 build.gradle.kts 中配置 AAR 打包插件和 Maven 推送插件

Gradle kotlin

// build.gradle.kts
plugins {
    id("com.android.library") // aar打包插件
    id("maven-publish") 
}

Gradle groovy

// build.gradle
plugins {
    id 'com.android.library'  // aar打包插件
    id 'maven-publish'
}

3. 在 build.gradle 或者 build.gradle.kts 中配置构建任务和推送地址

Gradle kotlin

// build.gradle.kts
afterEvaluate {
    publishing {
        publications {
            create<MavenPublication>("releaseAar") {
                // 配置成您需要的
                groupId = "cnb"
                artifactId = "artifact"
                version = "1.0.0"

                from(components["release"])
            }
        }
        repositories {
            maven {
                // 可在 gradle.properties 文件中声明 cnbArtifactsGradlePassword = 你在 cnb 的访问令牌
                // 或者 export CNB_TOKEN=${YOUR_TOKEN}
                val cnbArtifactsGradlePassword =
                    System.getenv("CNB_TOKEN") ?: project.findProperty("cnbArtifactsGradlePassword")

                // 示例 
                // url = uri("https://maven.cnb.cool/cnb/maven-repo/-/packages/")
                url = uri("<REPO_URL>")
                credentials {
                    username = "cnb"
                    password = cnbArtifactsGradlePassword.toString()
                }
            }
        }
    }
}

Gradle groovy

// build.gradle
afterEvaluate {
    publishing {
        publications {
            releaseAar(MavenPublication) {
                // 配置成您需要的
                groupId = 'cnb'
                artifactId = "artifact"
                version = '1.0.0'

                from components.release
            }
        }
        repositories {
            maven {
                // 可在 gradle.properties 文件中声明 cnbArtifactsGradlePassword = 你在 cnb 的访问令牌
                // 或者 export CNB_TOKEN=${YOUR_TOKEN}
                def cnbArtifactsGradlePassword =
                    System.getenv('CNB_TOKEN') ?: project.findProperty('cnbArtifactsGradlePassword')

                // 示例 
                // url = uri("https://maven.cnb.cool/cnb/maven-repo/-/packages/")
                url = uri("<REPO_URL>")
                credentials {
                    username = 'cnb'
                    password = cnbArtifactsGradlePassword.toString()
                }
            }
        }
    }
}

4. 执行如下命令

./gradlew publish

FAQ

覆盖已有版本后，依赖构建仍使用覆盖前的版本？

这是 Maven 的默认行为：本地缓存中已有该包时不会再次从远程仓库拉取。有以下三种解决方案：

1. 使用 --update-snapshots 命令，强制 Maven 检查远程仓库中快照依赖的更新，此策略仅对 SNAPSHOT 生效。

mvn clean package -U

2. 删除本地缓存中的包：

# macOS和Linux 默认位置为 ～/.m2
# Windows 默认位置为 C:\Users\{用户名}\.m2\repository
# 也可以直接通过如下命令查询
mvn help:evaluate -Dexpression=settings.localRepository

3. 将 settings.xml 中对应依赖仓库的 updatePolicy 调整为 always，此策略仅对 SNAPSHOT 生效：

<settings>
  <profiles>
    <profile>
      <id>cnb-maven-repo-profile</id>
      <repositories>
        <repository>
          <id>cnb-maven-repo</id>
          <url><REPO_URL></url>
          <!-- 这里配置snapshot版本的拉取策略 -->
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
          </snapshots>
        </repository>
      </repositories>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>
  </profiles>
</settings>

遇到 409 Forbidden

已上传过此包且禁止覆盖。如需覆盖，进入对应制品仓库 → 制品库设置 → 策略管理：

• 仅覆盖 SNAPSHOT，请选择 Maven Snapshot 策略
• 覆盖 SNAPSHOT 和 RELEASE，请选择 允许覆盖全部已有版本

更多用法

更多 Maven 用法，请查阅 Maven 官方文档。

上一页Docker Model 制品库

下一页npm 制品库