Rust용 Azure SDK를 사용하면 Cargo를 사용하여 개별 SDK 상자를 설치하여 Rust 프로젝트의 Azure 서비스에 액세스할 수 있습니다. 이 문서에서는 필요한 기능만 추가하고 프로젝트를 최신 상태로 유지할 수 있도록 Rust용 Azure SDK를 설치, 업데이트 및 관리하는 방법을 보여 줍니다.
크레이트를 사용하여 개발하기 위한 필수 구성 요소
- Rust 1.85.0 이상. 버전은 Rust Cargo.toml용 Azure SDK에 지정됩니다.
- Azure 구독. 무료로 하나를 만들 수 있습니다.
팁 (조언)
최상의 개발 환경을 위해 안정적인 최신 버전의 Rust가 설치되어 있는지 확인합니다.
최신 Azure SDK 크레이트 버전 설치
crates.io Azure SDK 상자를 가져옵니다. 필요한 개별 상자를 설치합니다.
cargo add <crate_name>
설치하려는 Azure 상자의 이름으로 바꿉 <crate_name> 습니다. 예를 들어 Azure ID 및 Key Vault 비밀 상자를 설치하려면 다음을 수행합니다.
cargo add azure_identity azure_security_keyvault_secrets
Azure용 크레이트 인덱스에서 사용 가능한 상자 이름을 찾을 수 있습니다.
특정 Azure SDK 크레이트 버전 설치
경우에 따라 호환성 테스트를 위해 특정 버전의 상자를 설치하거나 환경 간에 일관성을 유지해야 합니다. 버전을 지정할 때 종속성을 고정 합니다. 프로젝트는 해당 버전을 계속 사용하며 주 업데이트 또는 부 업데이트를 자동으로 받지는 않지만 패치 업데이트를 받을 수 있습니다. 고정은 특정 시나리오에서 유용할 수 있지만 지속적인 개선 및 보안 업데이트의 이점을 활용하려면 최신 버전을 사용하는 것이 좋습니다.
cargo add <crate_name>@<version_number>
다음은 그 예입니다.
cargo add azure_storage_blob@0.20.0
파일에서 버전 요구 사항을 지정할 수도 있습니다 Cargo.toml . 버전 요구 사항 구문에 대한 자세한 내용은 Rust 설명서를 참조하세요.
Azure SDK 상자 업데이트
모든 상자를 호환되는 최신 버전으로 업데이트하려면 다음을 실행합니다.
cargo update
특정 상자를 업데이트하려면 다음을 실행합니다.
cargo update <crate_name>
특정 Azure SDK 크레이트 제거
파일을 포함하여 프로젝트에서 상자를 제거하려면 다음을 Cargo.toml 실행합니다.
cargo remove <crate_name>
파일을 업데이트하는 프로젝트를 빌드합니다 Cargo.lock .
cargo build
Azure SDK 상자 기능 구성
이 상자는 azure_core 다음과 같은 모든 Azure SDK 크레이트의 기능을 제공합니다.
-
reqwest: HTTP 클라이언트 구현. -
tokio: 비동기 런타임 지원.
상자를 추가할 때 SDK 기능을 사용하도록 설정합니다.
cargo add <crate_name> --features <feature_name_1>,<feature_name_2>
또는 다음에서 기능을 지정합니다 Cargo.toml.
[dependencies]
<crate_name> = { version = "0.17", features = ["<feature_name_1>", "<feature_name_2>"] }
추가 리소스
- Crates.io Azure SDK 상자 - 사용 가능한 Azure SDK 상자 목록
- Azure SDK 디자인 지침 - 디자인 원칙 및 패턴
- Rust GitHub 리포지토리용 Azure SDK - 문제 및 소스 코드
- 화물 설명서 - 전체 화물 참조