:sparkles: 使用 GitHub actions 发布 Maven 快照 | Publish Maven SNAPSHOT using GitHub actions

[xuxiaowei-com-cn]

GitHub Package

• 文档：https://docs.github.com/zh/actions/tutorials/publish-packages/publish-java-packages-with-maven

密钥配置 | Secret Configuration

• GPG_SECRET_KEYS（可选）：

  1. gpg 私钥
  2. GPG private key

• 需要配置环境变量 GITHUB_TOKEN，推荐使用 GITHUB_TOKEN: ${{ github.token }}，GitHub CI 中 cat ~/.m2/settings.xml

  <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
    <servers>
      <server>
        <id>github</id>
        <username>${env.GITHUB_ACTOR}</username>
        <password>${env.GITHUB_TOKEN}</password>
      </server>
    </servers>
  </settings>

触发条件 | Trigger Condition

github.repository_owner == 'alibaba' && github.event_name == 'push'

发布 | Release

mvn clean deploy -Prelease

快照 | SNAPSHOT

<repositories>
    <repository>
        <id>github</id>
        <url>https://maven.pkg.github.com/alibaba/spring-cloud-alibaba</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

使用 | Use

• Maven settings.xml 文件中配置，创建 GitHub Token 地址：https://github.com/settings/tokens

<server>
  <id>github</id>
  <username>GitHub 用户名</username>
  <password>GitHub Token（需要 read:packages 权限）</password>
</server>

Maven 中央仓库 | Maven Central Repository

密钥配置 | Secret Configuration

• GPG_SECRET_KEYS：
  1. gpg 私钥
  2. GPG private key
• CENTRAL_USERNAME：
  1. https://central.sonatype.com 用户名，建议在 https://central.sonatype.com/usertoken 中创建 Token，使用
     <publishingServerId>central</publishingServerId>、-s settings.xml 激活
  2. Username for https://central.sonatype.com. It is recommended to create a Token
     at https://central.sonatype.com/usertoken and use <publishingServerId>central</publishingServerId>、
     -s settings.xml to activate it.
• CENTRAL_PASSWORD：
  1. https://central.sonatype.com 密码，同 CENTRAL_USERNAME
  2. Password for https://central.sonatype.com, same as CENTRAL_USERNAME

触发条件 | Trigger Condition

github.repository_owner == 'alibaba' && github.event_name == 'push'

发布 | Release

mvn clean deploy -Prelease -s settings.xml

快照 | SNAPSHOT

<repositories>
    <repository>
        <id>central-snapshots</id>
        <url>https://central.sonatype.com/repository/maven-snapshots</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

[xuxiaowei-com-cn]

GitHub Package、Maven 中央仓库 二选一

[xuxiaowei-com-cn]

下载安装 gpg

1. Windows：https://www.gpg4win.org/thanks-for-download.html ，Windows 可以使用 UI 操作生成密钥对、导出密钥。安装要求：当前用户不能使用中文的用户名
2. Linux、mac：自带 gpg

命令

# 生成一个新的密钥对
# 必须填写邮箱，用于将公钥上传至 https://keys.openpgp.org/upload/ 后验证邮箱
# 管理邮箱绑定的 https://keys.openpgp.org/manage/ 密钥

gpg --generate-key
# 快速生成一个新的密钥对
# gpg --quick-generate-key
# 完整功能的密钥对生成
# gpg --full-generate-key

# 列出密钥
gpg --list-keys
# 列出私钥
gpg --list-secret-keys

# 导出公钥：输出到文件中
# 18688B8352F4DBD0CD4C86F635A4C7C6E30A55D6 是密钥的ID
gpg --armor --export 18688B8352F4DBD0CD4C86F635A4C7C6E30A55D6 > public-key.asc

# 导出私钥：输出到文件中
# 18688B8352F4DBD0CD4C86F635A4C7C6E30A55D6 是密钥的ID
gpg --armor --export-secret-keys 18688B8352F4DBD0CD4C86F635A4C7C6E30A55D6 > private-key.asc

[xuxiaowei-com-cn]

部分电脑无法使用 https://maven.pkg.github.com 域名下载依赖解决办法

找一台可以连接 https://maven.pkg.github.com 的机器，使用 Nexus 作为 Maven 代理仓库，配置如下（需要在 Nexus 中配置 GitHub 的 read:packages 权限的 Token，用户使用 Nexus 时，不用再填写）：

[kuangyoubo]

@xuxiaowei-com-cn Nexus配置后访问没有内容呢

[kuangyoubo]

（需要在 Nexus 中配置 GitHub 的 read:packages 权限的 Token，用户使用 Nexus 时，不用再填写）
请问这个在哪里获取呢？github上吗？支持输入用户名密码还不行吗？

[xuxiaowei-com-cn]

@kuangyoubo
创建 GitHub Token 地址：https://github.com/settings/tokens

[xuxiaowei-com-cn]

@kuangyoubo 完成 nexus 配置后，使用 mvn clean package -U -DskipTests 下载依赖