将 CodeArtifact 仓库连接到公共仓库

你可以在 CodeArtifact 存储库和外部公共存储库（例如 https://npmjs.com 或 Maven Centra l 存储库）之间添加外部连接。然后，当您从 CodeArtifact 存储库中请求一个尚不存在于存储库中的软件包时，可以从外部连接获取该软件包。这样就可以使用由应用程序所用的开源依赖项。

在中 CodeArtifact，使用外部连接的预期方法是为每个域设置一个存储库，并与给定的公共存储库建立外部连接。例如，如果要连接到 npmjs.com，请将域中的一个存储库配置为与 npmjs.com 建立外部连接，并将所有其他存储库配置为该存储库的上游存储库。这样，所有存储库都可以使用已经从 npmjs.com 提取的程序包，而不必再次提取和存储程序包。

连接到外部存储库（控制台）

使用控制台向外部存储库添加连接时，会发生以下情况：

1. 如果您的域中尚不存在外部存储库，则将在您的 CodeArtifact 域中创建该存储库。-store这些 -store 存储库充当您的存储库和外部存储库之间的中间存储库，让您可以连接到多个外部存储库。

2. 相应的 -store 存储库将作为上游存储库添加到您的存储库中。

以下列表包含中的每个-store存储库 CodeArtifact 及其连接的相应外部存储库。

1. cargo-store已连接到 crates.io。

2. clojars-store 连接到 Clojars 存储库。

3. commonsware-store已连接到 CommonsWare 安卓存储库。

4. google-android-store 连接到 Google Android。

5. gradle-plugins-store 连接到 Gradle 插件。

6. maven-central-store 连接到 Maven Central 存储库。

7. npm-store 连接到 npmjs.com。

8. nuget-store 连接到 nuget.org。

9. pypi-store 连接到 Python 打包权威机构。

10. rubygems-store已连接到 RubyGems .org。

连接到外部存储库（控制台）

1. 打开 AWS CodeArtifact 控制台，网址为 https://console.aws.amazon.com/codesuite/codeartifact/home。

2. 在导航窗格中，选择域，然后选择包含您的存储库的域名。

3. 选择您的存储库的名称。

4. 选择编辑。

5. 在上游存储库中，选择关联上游存储库，然后添加作为上游存储库连接的相应 -store 存储库。

6. 选择更新存储库。

将-store存储库添加为上游存储库后，连接到您的存储 CodeArtifact 库的包管理器可以从相应的外部存储库中获取软件包。

连接到外部存储库 (CLI)

您可以直接 AWS CLI 向 CodeArtifact 存储库添加外部连接，从而使用将存储库连接到外部存储库。这将允许连接到 CodeArtifact 存储库或其任何下游存储库的用户从配置的外部存储库中获取软件包。每个 CodeArtifact 存储库只能有一个外部连接。

建议每个域都有一个存储库与给定的公有存储库建立外部连接。要将其他存储库连接到公有存储库，请将具有外部连接的存储库作为其上游添加进来。如果您或域中的其他人已经在控制台中配置了外部连接，则您的域可能已经有一个 -store 存储库，该存储库与您要连接的公有存储库建立了外部连接。有关 -store 存储库以及与控制台连接的更多信息，请参阅连接到外部存储库（控制台）。

向 CodeArtifact 存储库添加外部连接 (CLI)

• 使用 associate-external-connection 来添加外部连接。以下示例将存储库连接到 npm 公有注册表 npmjs.com。有关支持的外部存储库的列表，请参阅支持的外部连接存储库。

  aws codeartifact associate-external-connection --external-connection public:npmjs \
      --domain my_domain --domain-owner 111122223333 --repository my_repo

  输出示例：

  {
      "repository": {
          "name": my_repo
          "administratorAccount": "123456789012",
          "domainName": "my_domain",
          "domainOwner": "111122223333",
          "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my_domain/my_repo",
          "description": "A description of my_repo",
          "upstreams": [],
          "externalConnections": [
              {
                  "externalConnectionName": "public:npmjs",
                  "packageFormat": "npm",
                  "status": "AVAILABLE"
              }
          ]
      }
  }

添加外部连接后，有关通过外部连接从外部存储库请求程序包的信息，请参阅从外部连接请求程序包。

支持的外部连接存储库

CodeArtifact 支持与以下公共存储库的外部连接。要使用 CodeArtifact CLI 指定外部连接，请在运行associate-external-connection命令时使用--external-connection参数名称列中的值。

存储库类型	描述	名称
Maven	Clojars 存储库	public:maven-clojars
Maven	CommonsWare 安卓存储库	public:maven-commonsware
Maven	Google Android 存储库	public:maven-googleandroid
Maven	Gradle 插件存储库	public:maven-gradleplugins
Maven	Maven Central	public:maven-central
npm	npm 公有注册表	public:npmjs
NuGet	NuGet 画廊	public:nuget-org
Python	Python 包索引	public:pypi
Ruby	RubyGems.org	public:ruby-gems-org
Rust	Crates.io	public:crates-io

移除外部连接 (CLI)

要删除使用中的associate-external-connection命令添加的外部连接 AWS CLI，请使用disassociate-external-connection。

aws codeartifact disassociate-external-connection --external-connection public:npmjs \
    --domain my_domain --domain-owner 111122223333 --repository my_repo

输出示例：

{
    "repository": {
        "name": my_repo
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my_domain/my_repo",
        "description": "A description of my_repo",
        "upstreams": [],
        "externalConnections": []
    }
}