快照发布在 CodeArtifact 使用快照版本删除快照版本使用 curl 进行快照发布快照和外部连接快照和上游存储库

使用 Maven 快照

Maven 快照是 Maven 程序包的特殊版本，该版本引用了最新的生产分支代码。它是先于最终发布版本的开发版本。您可以通过附加到程序包版本的后缀 SNAPSHOT 来识别 Maven 程序包的快照版本。例如，版本 1.1 的快照是 1.1-SNAPSHOT。有关更多信息，请参阅什么是SNAPSHOT版本？在 Apache Maven Project 网站上。

AWS CodeArtifact 支持发布和使用 Maven 快照。仅支持使用基于时间的版本号的唯一快照。 CodeArtifact 不支持 Maven 2 客户端生成的非唯一快照。您可以将支持的 Maven 快照发布到任何 CodeArtifact 存储库。

快照发布在 CodeArtifact

AWS CodeArtifact 支持客户端（例如mvn）在发布快照时使用的请求模式。因此，您无需详细了解 Maven 快照的发布方式，即可按照构建工具或程序包管理器的文档进行操作。如果你正在做更复杂的事情，本节将详细介绍如何 CodeArtifact 处理快照。

将 Maven 快照发布到 CodeArtifact 存储库时，其先前版本将保留在名为 build 的新版本中。每次发布 Maven 快照时，都会创建一个新的构建版本。快照的所有先前版本都保留在其构建版本中。发布 Maven 快照时，其程序包版本状态将设置为 Published，包含先前版本的版本的构建的状态设置为 Unlisted。此行为仅适用于程序包版本使用 -SNAPSHOT 作为后缀的 Maven 程序包版本。

例如，名为的 maven 包的快照版本com.mycompany.myapp:pkg-1会上传到名为的 CodeArtifact 存储库。my-maven-repo快照版本是 1.0-SNAPSHOT。到目前为止，尚未发布 com.mycompany.myapp:pkg-1 的任何版本。首先，在以下路径发布初始构建的资产：


PUT maven/my-maven-repo/com/mycompany/myapp/pkg-1/1.0-SNAPSHOT/pkg-1-1.0-20210728.194552-1.jar
PUT maven/my-maven-repo/com/mycompany/myapp/pkg-1/1.0-SNAPSHOT/pkg-1-1.0-20210728.194552-1.pom

请注意，由发布快照版本的客户端生成时间戳 20210728.194552-1。

上传 .pom 和 .jar 文件后，存储库中唯一存在的 com.mycompany.myapp:pkg-1 版本是 1.0-20210728.194552-1。即使在前面的路径中指定的版本是 1.0-SNAPSHOT，也会发生这种情况。此时的程序包版本状态为 Unfinished。


aws codeartifact list-package-versions --domain my-domain --repository \
  my-maven-repo --package pkg-1 --namespace com.mycompany.myapp --format maven
{
    "versions": [
        {
            "version": "1.0-20210728.194552-1",
            "revision": "GipMW+599JmwTcTLaXo9YvDsVQ2bcrrk/02rWJhoKUU=",
            "status": "Unfinished"
        }
    ],
    "defaultDisplayVersion": null,
    "format": "maven",
    "package": "pkg-1",
    "namespace": "com.mycompany.myapp"
}

接下来，客户端上传程序包版本的 maven-metadata.xml 文件：


PUT my-maven-repo/com/mycompany/myapp/pkg-1/1.0-SNAPSHOT/maven-metadata.xml

成功上传 maven-metadata.xml 文件后， CodeArtifact 会创建1.0-SNAPSHOT包版本并将1.0-20210728.194552-1版本设置为Unlisted。


aws codeartifact list-package-versions --domain my-domain --repository \
  my-maven-repo --package pkg-1 --namespace com.mycompany.myapp --format maven
{
    "versions": [
        {
            "version": "1.0-20210728.194552-1",
            "revision": "GipMW+599JmwTcTLaXo9YvDsVQ2bcrrk/02rWJhoKUU=",
            "status": "Unlisted"
        },
        {
            "version": "1.0-SNAPSHOT",
            "revision": "tWu8n3IX5HR82vzVZQAxlwcvvA4U/+S80edWNAkil24=",
            "status": "Published"
        }
    ],
    "defaultDisplayVersion": "1.0-SNAPSHOT",
    "format": "maven",
    "package": "pkg-1",
    "namespace": "com.mycompany.myapp"
}

此时，可以在构建中使用快照版本 1.0-SNAPSHOT。虽然存储库 my-maven-repo 中有 com.mycompany.myapp:pkg-1 的两个版本，但它们都包含相同的资产。


aws codeartifact list-package-version-assets --domain my-domain --repository \
  my-maven-repo --format maven --namespace com.mycompany.myapp \
 --package pkg-1 --package-version 1.0-SNAPSHOT--query 'assets[*].name'
[ 
     "pkg-1-1.0-20210728.194552-1.jar",
     "pkg-1-1.0-20210728.194552-1.pom"
]

将 --package-version 参数更改为 1.0-20210728.194552-1，运行如前所示的相同 list-package-version-assets 命令会得到相同的输出。

在向存储库中添加 1.0-SNAPSHOT 的额外构建时，会为每个新构建创建一个新的 Unlisted 程序包版本。每次都会更新版本 1.0-SNAPSHOT 的资产，因此版本始终引用该版本的最新构建。通过上传新构建的 maven-metadata.xml 文件，开始将 1.0-SNAPSHOT 更新为包含最新资产。

使用快照版本

如果您请求快照，则会返回状态为 Published 的版本。这始终是 Maven 快照的最新版本。您也可以使用构建版本号（例如1.0-20210728.194552-1）而不是URL路径中的快照版本（例如）来请求快照的特定构建。1.0-SNAPSHOT要查看 Maven 快照的构建版本，请使用CodeArtifact API指南ListPackageVersions API中的并将状态参数设置为Unlisted。

删除快照版本

要删除 Maven 快照的所有构建版本 DeletePackageVersionsAPI，请使用，指定要删除的版本。

使用 curl 进行快照发布

如果您在亚马逊简单存储服务 (Amazon S3) Simple Storage Service 或其他项目存储库产品中存储了现有快照版本，则可能需要将其重新发布到。 AWS CodeArtifact由于 CodeArtifact支持 Maven 快照的方式（请参阅快照发布在 CodeArtifact），因此使用通用HTTP客户端（例如）发布快照比发布 Maven 发行版本要复杂得多，如中所述。curl 使用 curl 进行发布请注意，如果您使用 mvn 或 gradle 等 Maven 客户端来构建和部署快照版本，则本节不相关。您需要遵循该客户端的文档进行操作。

发布快照版本涉及发布快照版本的一个或多个构建。在中 CodeArtifact，如果快照版本有 n 个内部版本，则将有 n + 1 个 CodeArtifact 版本：n 个版本的状态均为Unlisted，一个快照版本（最新发布的版本）的状态为Published。快照版本（即版本字符串包含 “-SNAPSHOT” 的版本）包含与最新发布版本相同的资源集。使用 curl 创建此结构的最简单方法如下：

使用 curl 发布所有构建的所有资产。
使用 curl 发布最后一个构建（即带有最新日期时间戳的构建）的 maven-metadata.xml 文件。这将创建一个版本字符串中带有“-SNAPSHOT”且具有正确资产集的版本。
使用UpdatePackageVersionsStatusAPI将所有非最新版本的状态设置为。Unlisted

使用以下 curl 命令来发布程序包 com.mycompany.app:pkg-1 的快照版本 1.0-SNAPSHOT 的快照资产（例如 .jar 和 .pom 文件）：


curl --user "aws:$CODEARTIFACT_AUTH_TOKEN" -H "Content-Type: application/octet-stream" \
     -X PUT https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/maven/my_maven_repo/com/mycompany/app/pkg-1/1.0-SNAPSHOT/pkg-1-1.0-20210729.171330-2.jar \
     --data-binary @pkg-1-1.0-20210728.194552-1.jar


curl --user "aws:$CODEARTIFACT_AUTH_TOKEN" -H "Content-Type: application/octet-stream" \
     -X PUT https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/maven/my_maven_repo/com/mycompany/app/pkg-1/1.0-SNAPSHOT/pkg-1-1.0-20210729.171330-2.pom \
     --data-binary @pkg-1-1.0-20210728.194552-1.pom

使用这些示例时：

Replace（替换） my_domain 用你的 CodeArtifact 域名。
Replace（替换） 111122223333 使用您的 CodeArtifact 域名所有者的 AWS 账户 ID。
Replace（替换） us-west-2 使用您的 CodeArtifact 域名所在的。 AWS 区域
Replace（替换） my_maven_repo 使用您的 CodeArtifact 存储库名称。

重要

必须在 --data-binary 参数的值前面加上 @ 字符。将值放在引号中时，@ 必须包含在引号内。

每个构建可能有两个以上的资产需要上传。例如，除了主JAR文件和之外，可能还有 Javadoc 和源JAR文件。pom.xml无需为包版本资产发布校验和文件，因为会 CodeArtifact自动为每个上传的资源生成校验和。要验证资产是否已正确上传，请使用 list-package-version-assets 命令提取生成的校验和，并将其与原始校验和进行比较。有关如何 CodeArtifact 处理 Maven 校验和的更多信息，请参阅。使用 Maven 校验和

使用以下 curl 命令来发布最新构建版本的 maven-metadata.xml 文件：


curl --user "aws:$CODEARTIFACT_AUTH_TOKEN" -H "Content-Type: application/octet-stream" \
     -X PUT https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/maven/my_maven_repo/com/mycompany/app/pkg-1/1.0-SNAPSHOT/maven-metadata.xml \
     --data-binary @maven-metadata.xml

maven-metadata.xml 文件必须引用 <snapshotVersions> 元素中最新构建版本的至少一个资产。此外，必须存在 <timestamp> 值，且该值必须与资产文件名中的时间戳相匹配。例如，对于之前发布的 20210729.171330-2 构建，maven-metadata.xml 的内容将为：


<?xml version="1.0" encoding="UTF-8"?>
<metadata>
  <groupId>com.mycompany.app</groupId>
  <artifactId>pkg-1</artifactId>
  <version>1.0-SNAPSHOT</version>
  <versioning>
    <snapshot>
      <timestamp>20210729.171330</timestamp>
      <buildNumber>2</buildNumber>
    </snapshot>
    <lastUpdated>20210729171330</lastUpdated>
    <snapshotVersions>
      <snapshotVersion>
        <extension>jar</extension>
        <value>1.0-20210729.171330-2</value>
        <updated>20210729171330</updated>
      </snapshotVersion>
      <snapshotVersion>
        <extension>pom</extension>
        <value>1.0-20210729.171330-2</value>
        <updated>20210729171330</updated>
      </snapshotVersion>
    </snapshotVersions>
  </versioning>
</metadata>

发布 maven-metadata.xml 后，最后一步是将所有其他构建版本（即除最新构建之外的所有构建版本）的程序包版本状态设置为 Unlisted。例如，如果 1.0-SNAPSHOT 版本有两个构建，第一个构建是 20210728.194552-1，则将该构建设置为 Unlisted 的命令是：


aws codeartifact update-package-versions-status --domain my-domain --domain-owner 111122223333 \
   --repository my-maven-repo --format maven --namespace com.mycompany.app --package pkg-1 \
   --versions 1.0-20210728.194552-1 --target-status Unlisted

快照和外部连接

无法通过外部连接从 Maven 公共存储库获取 Maven 快照。 AWS CodeArtifact 仅支持导入 Maven 发行版本。

快照和上游存储库

通常，在与上游存储库一起使用时，Maven 快照的工作方式与 Maven 发布版本相同，但是如果您计划将相同软件包版本的快照发布到两个具有上游关系的存储库，则存在限制。例如，假设一个 AWS CodeArtifact 域中有两个存储库，R以及U，其中U是的上游R。如果您在中发布新版本R，则当 Maven 客户端请求该快照版本的最新版本时，会 CodeArtifact 返回来自U的最新版本。这可能出乎意料，因为最新版本已经推出R，但事实并非如此U。有两种方法可以避免这种情况：

不要发布快照版本（例如1.0-SNAPSHOT中R）的版本（如果1.0-SNAPSHOT存在于中）U。
使用 CodeArtifact 包源控件在中R禁用该软件包的上游。后者将允许你1.0-SNAPSHOT在中发布内部版本R，但它也会阻止R从中获取尚未保留的该软件包的任何其他版本。U

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

使用 Maven 校验和

从上游和外部连接请求 Maven 程序包