CodeArtifact 리포지토리를 공용 리포지토리에 연결

리포지토리와 외부 공용 CodeArtifact 리포지토리 (예: https://npmjs.com 또는 Maven Central 리포지토리) 간에 외부 연결을 추가할 수 있습니다. 그러면 저장소에 아직 없는 패키지를 CodeArtifact 저장소에서 요청하면 외부 연결에서 패키지를 가져올 수 있습니다. 이렇게 하면 애플리케이션에서 사용하는 오픈 소스 종속성을 사용할 수 있습니다.

에서 CodeArtifact 외부 연결을 사용하려면 도메인당 리포지토리를 하나씩 두고 지정된 공용 리포지토리에 대한 외부 연결을 사용하는 것이 목적입니다. 예로, npmjs.com에 연결하려면 도메인에 있는 하나의 저장소를 npmjs.com에 외부 연결로 구성하고, 다른 모든 저장소를 이 저장소의 업스트림으로 구성하는 것입니다. 이렇게 하면 모든 저장소에서 패키지를 다시 가져와 저장하지 않고 npmjs.com에서 미리 가져온 패키지를 사용할 수 있습니다.

외부 저장소(콘솔)에 연결하기

콘솔을 사용하여 외부 저장소에 연결을 추가하면 다음과 같은 과정을 거치게 됩니다.

1. 외부 -store 저장소의 저장소가 아직 없는 경우 CodeArtifact 도메인에 해당 저장소가 만들어집니다. 이런 -store 저장소는 저장소와 외부 저장소 사이의 중간 저장소 역할을 하며, 둘 이상의 외부 저장소에 연결할 수 있습니다.

2. 적절한 -store 저장소가 저장소의 업스트림으로 추가됩니다.

다음 목록에는 각 -store CodeArtifact 리포지토리와 해당 리포지토리가 연결되는 개별 외부 리포지토리가 포함되어 있습니다.

1. cargo-storecrates.io에 연결되어 있습니다.

2. clojars-store는 Clojars Repository에 연결되어 있습니다.

3. commonsware-store안드로이드 리포지토리에 연결되어 있습니다. CommonsWare

4. google-android-store는 Google Android에 연결되어 있습니다.

5. gradle-plugins-store는 Gradle 플러그인에 연결되어 있습니다.

6. maven-central-store는 Maven Central Repository에 연결되어 있습니다.

7. npm-store는 npmjs.com에 연결되어 있습니다.

8. nuget-store는 nuget.org에 연결되어 있습니다.

9. pypi-store는 Python Packaging Authority에 연결되어 있습니다.

10. rubygems-store RubyGems.org에 연결되어 있습니다.

외부 저장소(콘솔)에 연결하기

1. https://console.aws.amazon.com/codesuite/codeartifact/home 에서 AWS CodeArtifact 콘솔을 엽니다.

2. 탐색 창에서 도메인을 선택한 후 저장소가 포함된 도메인 이름을 선택합니다.

3. 저장소의 이름을 선택합니다.

4. 편집을 선택합니다.

5. 업스트림 저장소에서 업스트림 저장소 연결을 선택하고 업스트림으로 연결된 적절한 -store 저장소를 추가합니다.

6. 저장소 업데이트를 선택합니다.

-store리포지토리가 업스트림 리포지토리로 추가된 후 리포지토리에 연결된 패키지 관리자는 해당 외부 CodeArtifact 리포지토리에서 패키지를 가져올 수 있습니다.

외부 저장소(CLI)에 연결하기

를 사용하면 리포지토리에 외부 연결을 직접 추가하여 CodeArtifact 리포지토리를 외부 리포지토리에 연결할 수 있습니다. AWS CLI 이렇게 하면 리포지토리 또는 해당 다운스트림 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를 사용하여 외부 연결을 지정하려면 명령을 실행할 때 --external-connection 매개 변수의 이름 열에 있는 값을 사용합니다. associate-external-connection

리포지토리 유형	설명	명칭
Maven	Clojars 저장소	public:maven-clojars
Maven	CommonsWare Android 리포지토리	public:maven-commonsware
Maven	Google Android Repository	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 Package Index	public:pypi
Ruby	RubyGems.org	public:ruby-gems-org
Rust	Crates.io	public:crates-io

외부 연결 제거하기(CLI)

에서 associate-external-connection 명령을 사용하여 추가한 외부 연결을 제거하려면 를 사용합니다. AWS CLIdisassociate-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": []
    }
}