CodeArtifact로 Cargo 구성 및 사용 - CodeArtifact
CodeArtifact를 사용하여 Cargo 설정Cargo 크레이트 설치Cargo 크레이트 게시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CodeArtifact로 Cargo 구성 및 사용

Cargo를 사용하여 CodeArtifact 리포지토리에서 크레이트를 게시 및 다운로드하거나 Rust 커뮤니티의 크레이트 레지스트리인 crates.io에서 크레이트를 가져올 수 있습니다. 이 항목에서는 CodeArtifact 리포지토리를 인증하고 사용하도록 Cargo를 구성하는 방법을 설명합니다.

CodeArtifact를 사용하여 Cargo 설정

Cargo를 사용하여 AWS CodeArtifact에서 크레이트를 설치하고 게시하려면 먼저 CodeArtifact 리포지토리 정보를 사용하여 구성해야 합니다. 다음 절차 중 하나의 단계에 따라 CodeArtifact 리포지토리 엔드포인트 정보 및 자격 증명으로 Cargo를 구성합니다.

콘솔 지침을 사용하여 Cargo 구성

콘솔의 구성 지침을 사용하여 Cargo를 CodeArtifact 리포지토리에 연결할 수 있습니다. 콘솔 지침은 CodeArtifact 리포지토리에 맞게 사용자 지정된 Cargo 구성을 제공합니다. CodeArtifact 정보를 찾아 입력할 필요 없이 이 사용자 지정 구성을 사용하여 Cargo를 설정할 수 있습니다.

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

  2. 탐색 창에서 리포지토리를 선택한 다음, Cargo에 연결할 리포지토리를 선택합니다.

  3. 연결 지침 보기를 선택합니다.

  4. 운영 체제를 선택합니다.

  5. Cargo를 선택합니다.

  6. 생성된 지침에 따라 Cargo를 CodeArtifact 리포지토리에 연결합니다.

Cargo 수동 구성

콘솔의 구성 지침을 사용할 수 없거나 사용하지 않으려는 경우 다음 지침을 사용하여 Cargo를 CodeArtifact 리포지토리에 수동으로 연결할 수 있습니다.

macOS and Linux

CodeArtifact로 Cargo를 구성하려면 CodeArtifact 리포지토리를 Cargo 구성의 레지스트리로 정의하고 자격 증명을 제공해야 합니다.

  • my_registry를 레지스트리 이름으로 변경합니다.

  • my_domain을 CodeArtifact 도메인 이름으로 변경합니다.

  • 111122223333을 도메인 소유자의 AWS 계정 ID로 변경합니다. 소유한 도메인의 리포지토리에 액세스하는 경우 --domain-owner를 포함하지 않아도 됩니다. 자세한 내용은 크로스 계정 도메인 섹션을 참조하세요.

  • my_repo를 CodeArtifact 리포지토리 이름으로 변경합니다.

구성을 복사하여 Cargo 패키지를 리포지토리에 게시 및 다운로드하고 시스템 수준 구성을 위해 ~/.cargo/config.toml 파일에 저장하거나 프로젝트 수준 구성을 위해 .cargo/config.toml에 저장합니다.

[registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"
Windows: Download packages only

CodeArtifact로 Cargo를 구성하려면 CodeArtifact 리포지토리를 Cargo 구성의 레지스트리로 정의하고 자격 증명을 제공해야 합니다.

  • my_registry를 레지스트리 이름으로 변경합니다.

  • my_domain을 CodeArtifact 도메인 이름으로 변경합니다.

  • 111122223333을 도메인 소유자의 AWS 계정 ID로 변경합니다. 소유한 도메인의 리포지토리에 액세스하는 경우 --domain-owner를 포함하지 않아도 됩니다. 자세한 내용은 크로스 계정 도메인 섹션을 참조하세요.

  • my_repo를 CodeArtifact 리포지토리 이름으로 변경합니다.

구성을 복사하여 리포지토리에서 Cargo 패키지만 다운로드하고 시스템 수준 구성을 위해 %USERPROFILE%\.cargo\config.toml 파일에 저장하거나 프로젝트 수준 구성을 위해 .cargo\config.toml에 저장합니다.

[registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"
Windows: Publish and download packages

  1. CodeArtifact로 Cargo를 구성하려면 CodeArtifact 리포지토리를 Cargo 구성의 레지스트리로 정의하고 자격 증명을 제공해야 합니다.

    • my_registry를 레지스트리 이름으로 변경합니다.

    • my_domain을 CodeArtifact 도메인 이름으로 변경합니다.

    • 111122223333을 도메인 소유자의 AWS 계정 ID로 변경합니다. 소유한 도메인의 리포지토리에 액세스하는 경우 --domain-owner를 포함하지 않아도 됩니다. 자세한 내용은 크로스 계정 도메인 섹션을 참조하세요.

    • my_repo를 CodeArtifact 리포지토리 이름으로 변경합니다.

    구성을 복사하여 Cargo 패키지를 리포지토리에 게시 및 다운로드하고 시스템 수준 구성을 위해 %USERPROFILE%\.cargo\config.toml 파일에 저장하거나 프로젝트 수준 구성을 위해 .cargo\config.toml에 저장합니다.

    ~/.cargo/credentials.toml 파일에 저장된 자격 증명을 사용하는 자격 증명 공급자 cargo:token을 사용하는 것이 좋습니다. cargo publish 중에 Cargo 클라이언트가 권한 부여 토큰을 제대로 잘라내지 않기 때문에 cargo:token-from-stdout를 사용하는 경우 cargo publish 동안 오류가 발생할 수 있습니다.

    [registries.my_registry]
index = "sparse+https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/cargo/my_repo/"
credential-provider = "cargo:token"

[registry]
default = "my_registry"

[source.crates-io]
replace-with = "my_registry"

  2. Windows를 사용하여 리포지토리에 Cargo 패키지를 게시하려면 CodeArtifact get-authorization-token 명령 및 Cargo login 명령을 사용하여 권한 부여 토큰과 자격 증명을 가져와야 합니다.

    • my_registry를 [registries.my_registry]에 정의된 레지스트리 이름으로 변경합니다.

    • my_domain을 CodeArtifact 도메인 이름으로 변경합니다.

    • 111122223333을 도메인 소유자의 AWS 계정 ID로 변경합니다. 소유한 도메인의 리포지토리에 액세스하는 경우 --domain-owner를 포함하지 않아도 됩니다. 자세한 내용은 크로스 계정 도메인 섹션을 참조하세요.

    aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --region us-west-2 --query authorizationToken --output text | cargo login --registry my_registry
    참고

    생성된 권한 부여 토큰은 12시간 동안 유효합니다. 토큰이 생성된 후 12시간이 경과한 경우 새 토큰을 생성해야 합니다.

이전 예제의 [registries.my_registry] 섹션은 my_registry을 사용하여 레지스트리를 정의하고 index 및 credential-provider 정보를 제공합니다.

  • index는 레지스트리에 대한 인덱스의 URL을 지정하며, 이 URL은 /로 끝나는 CodeArtifact 리포지토리 엔드포인트입니다. sparse+ 접두사는 Git 리포지토리가 아닌 레지스트리에 필요합니다.

    참고

    듀얼 스택 엔드포인트를 사용하려면 codeartifact.region.on.aws 엔드포인트를 사용합니다.

  • credential-provider는 지정된 레지스트리에 대한 자격 증명 공급자를 지정합니다. credential-provider가 설정되지 않은 경우 registry.global-credential-providers의 공급자가 사용됩니다. credential-provider를 cargo:token-from-stdout로 설정하면 CodeArtifact 리포지토리에서 게시하거나 다운로드할 때 Cargo 클라이언트가 새 권한 부여 토큰을 자동으로 가져오므로 12시간마다 권한 부여 토큰을 수동으로 새로 고칠 필요가 없습니다.

[registry] 섹션에서는 사용되는 기본 레지스트리를 정의합니다.

  • default는 CodeArtifact 리포지토리에서 게시하거나 다운로드할 때 기본적으로 사용할 [registries.my_registry]에 정의된 레지스트리의 이름을 지정합니다.

[source.crates-io] 섹션에서는 지정되지 않은 경우 사용되는 기본 레지스트리를 정의합니다.

  • replace-with = "my_registry"는 퍼블릭 레지스트리 crates.io를 [registries.my_registry]에 정의된 CodeArtifact 리포지토리로 바꿉니다. 이 구성은 crates.io와 같은 외부 연결에서 패키지를 요청해야 하는 경우에 권장됩니다.

    종속성 혼동 공격을 방지하는 패키지 원본 제어와 같은 CodeArtifact의 모든 이점을 얻으려면 소스 교체를 사용하는 것이 좋습니다. 소스 교체를 통해 CodeArtifact는 외부 연결에 대한 모든 요청을 프록시하고 외부 연결에서 리포지토리로 패키지를 복사합니다. 소스 교체가 없으면 Cargo 클라이언트는 프로젝트의 Cargo.toml 파일에 있는 구성을 기반으로 패키지를 직접 검색합니다. 종속성이 registry=my_registry로 표시되지 않은 경우 Cargo 클라이언트는 CodeArtifact 리포지토리와 통신하지 않고 crates.io를 직접 검색합니다.

    참고

    소스 교체 사용을 시작한 다음, 소스 교체를 사용하지 않도록 구성 파일을 업데이트하면 오류가 발생할 수 있습니다. 반대 시나리오에서도 오류가 발생할 수 있습니다. 따라서 프로젝트의 구성을 변경하지 않는 것이 좋습니다.

Cargo 크레이트 설치

다음 절차를 사용하여 CodeArtifact 리포지토리 또는 crates.io에서 Cargo 크레이트를 설치합니다.

CodeArtifact에서 Cargo 크레이트 설치

Cargo(cargo) CLI를 사용하여 CodeArtifact 리포지토리에서 특정 버전의 Cargo 크레이트를 빠르게 설치할 수 있습니다.

cargo를 사용하여 CodeArtifact 리포지토리에서 Cargo 크레이트를 설치하려면

  1. 아직 구성하지 않았다면 CodeArtifact로 Cargo 구성 및 사용의 단계에 따라 적절한 자격 증명과 함께 CodeArtifact 리포지토리를 사용하도록 cargo CLI를 구성합니다.

  2. CodeArtifact에서 Cargo 크레이트를 설치하려면 다음 명령을 사용합니다.

    cargo add my_cargo_package@1.0.0

    자세한 내용은 Cargo Book에서 cargo add를 참조하세요.

CodeArtifact에 Cargo 크레이트 게시

다음 절차에 따라 cargo CLI를 사용하여 Cargo 크레이트를 CodeArtifact 리포지토리에 게시합니다.

  1. 아직 구성하지 않았다면 CodeArtifact로 Cargo 구성 및 사용의 단계에 따라 적절한 자격 증명과 함께 CodeArtifact 리포지토리를 사용하도록 cargo CLI를 구성합니다.

  2. 다음 명령을 사용하여 Cargo 크레이트를 CodeArtifact 리포지토리에 게시합니다.

    cargo publish

    자세한 내용은 Cargo Book에서 cargo publish를 참조하세요.