Add or remove upstream repositories

Follow the steps in the following sections to add or remove upstream repositories to or from an CodeArtifact repository. For more information about upstream repositories, see Working with upstream repositories in CodeArtifact.

This guide contains information about configuring other CodeArtifact repositories as upstream repositories. For information about configuring an external connection to public repositories like npmjs.com, Nuget Gallery, Maven Central, or PyPI, see Add an external connection.

Add or remove upstream repositories (console)

Perform the steps in the following procedure to add a repository as an upstream repository using the CodeArtifact console. For information about adding an upstream repository with the AWS CLI, see Add or remove upstream repositories (AWS CLI).

To add an upstream repository using the CodeArtifact console

1. Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home.

2. In the navigation pane, choose Domains, and then choose the domain name that contains your repository.

3. Choose the name of your repository.

4. Choose Edit.

5. In Upstream repositories, choose Associate upstream repository and add the repository you want to add as an upstream repository. You can only add repositories in the same domain as upstream repositories.

6. Choose Update repository.

To remove an upstream repository using the CodeArtifact console

1. Open the AWS CodeArtifact console at https://console.aws.amazon.com/codesuite/codeartifact/home.

2. In the navigation pane, choose Domains, and then choose the domain name that contains your repository.

3. Choose the name of your repository.

4. Choose Edit.

5. In Upstream repositories, find the list entry of the upstream repository you want to remove and choose Disassociate.

   Important

   Once you remove an upstream repository from a CodeArtifact repository, package managers will not have access to packages in the upstream repository or any of its upstream repositories.

6. Choose Update repository.

Add or remove upstream repositories (AWS CLI)

You can add or remove a CodeArtifact repository's upstream repositories using the AWS Command Line Interface (AWS CLI). To do this, use the update-repository command, and specify the upstream repositories using the --upstreams parameter.

You can only add repositories in the same domain as upstream repositories.

To add upstream repositories (AWS CLI)

1. If you haven't, follow the steps in Setting up with AWS CodeArtifact to set up and configure the AWS CLI with CodeArtifact.

2. Use the aws codeartifact update-repository command with the --upstreams flag to add upstream repositories.

   Note

   Calling the update-repository command replaces the existing configured upstream repositories with the list of repositories provided with the --upstreams flag. If you want to add upstream repositories and keep the existing ones, you must include the existing upstream repositories in the call.

   The following example command adds two upstream repositories to a repository named my_repo that is in a domain named my_domain. The order of the upstream repositories in the --upstreams parameter determines their search priority when CodeArtifact requests a package from the my_repo repository. For more information, see Upstream repository priority order.

   For information about connecting to public, external repositories such as npmjs.com or Maven Central, see Connect a CodeArtifact repository to a public repository.

   aws codeartifact update-repository \
      --repository my_repo \
      --domain my_domain \
      --domain-owner 111122223333 \
      --upstreams repositoryName=upstream-1 repositoryName=upstream-2

   The output contains the upstream repositories, as follows.

   {
          "repository": {
              "name": "my_repo",
              "administratorAccount": "123456789012",
              "domainName": "my_domain",
              "domainOwner": "111122223333",
              "arn": "arn:aws:codeartifact:us-east-2:111122223333:repository/my_domain/my_repo",
              "upstreams": [
                  {
                      "repositoryName": "upstream-1"
                  },
                  {
                      "repositoryName": "upstream-2"
                  }
              ],
              "externalConnections": []
          }
      }

To remove an upstream repository (AWS CLI)

1. If you haven't, follow the steps in Setting up with AWS CodeArtifact to set up and configure the AWS CLI with CodeArtifact.

2. To remove upstream repositories from a CodeArtifact repository, use the update-repository command with the --upstreams flag. The list of repositories provided to the command will be the new set of upstream repositories for the CodeArtifact repository. Include existing upstream repositories that you want to keep, and omit the upstream repositories you want to remove.

   To remove all upstream repositories from a repository, use the update-repository command and include --upstreams without an argument. The following removes upstream repositories from a repository named my_repo that is contained in a domain named my_domain.

   aws codeartifact update-repository \
      --repository my_repo \
      --domain my_domain \
      --domain-owner 111122223333 \
      --upstreams

   The output shows that the list of upstreams is empty.

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