AzCopy 시작Get started with AzCopy

AzCopy는 스토리지 계정에서 또는 스토리지 계정으로 Blob 또는 파일을 복사하는 데 사용할 수 있는 명령줄 유틸리티입니다.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. 이 문서에서는 AzCopy를 다운로드하고, 스토리지 계정에 연결한 다음, 파일을 전송하는 방법을 설명합니다.This article helps you download AzCopy, connect to your storage account, and then transfer files.

참고

AzCopy V10 는 현재 지원 되는 AzCopy 버전입니다.AzCopy V10 is the currently supported version of AzCopy.

이전 버전의 AzCopy를 사용 해야 하는 경우이 문서의 이전 버전의 AzCopy 사용 섹션을 참조 하세요.If you need to use a previous version of AzCopy, see the Use the previous version of AzCopy section of this article.

AzCopy 다운로드Download AzCopy

먼저 AzCopy V10 실행 파일을 컴퓨터의 모든 디렉터리에 다운로드 합니다.First, download the AzCopy V10 executable file to any directory on your computer. AzCopy V10는 실행 파일 일 뿐 이므로 설치할 항목이 없습니다.AzCopy V10 is just an executable file, so there's nothing to install.

이러한 파일은 zip 파일 (Windows 및 Mac) 또는 tar 파일 (Linux)로 압축 됩니다.These files are compressed as a zip file (Windows and Mac) or a tar file (Linux). Linux에서 tar 파일을 다운로드 하 고 압축을 풀려면 Linux 배포에 대 한 설명서를 참조 하세요.To download and decompress the tar file on Linux, see the documentation for your Linux distribution.

참고

Azure Table storage 서비스로 데이터를 복사 하려면 AzCopy 버전 7.3을 설치 합니다.If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

AzCopy 실행Run AzCopy

편의상, AzCopy 실행 파일의 디렉터리 위치를 시스템 경로에 추가하여 사용하기 쉽도록 하는 것이 좋습니다.For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. 이렇게 하면 azcopy 시스템의 모든 디렉터리에서 입력할 수 있습니다.That way you can type azcopy from any directory on your system.

AzCopy 디렉터리를 경로에 추가 하지 않도록 선택 하는 경우 AzCopy 실행 파일의 위치로 디렉터리를 변경 하 고 azcopy .\azcopy Windows PowerShell 명령 프롬프트에서 또는를 입력 해야 합니다.If you choose not to add the AzCopy directory to your path, you'll have to change directories to the location of your AzCopy executable and type azcopy or .\azcopy in Windows PowerShell command prompts.

명령 목록을 보려면를 입력 한 azcopy -h 다음 enter 키를 누릅니다.To see a list of commands, type azcopy -h and then press the ENTER key.

특정 명령에 대 한 자세한 내용을 보려면 명령의 이름 (예:)을 포함 하면 azcopy list -h 됩니다.To learn about a specific command, just include the name of the command (For example: azcopy list -h).

인라인 도움말Inline help

각 명령 및 명령 매개 변수에 대 한 자세한 참조 설명서를 찾으려면 azcopy 를 참조 하세요.To find detailed reference documentation for each command and command parameter, see azcopy

참고

Azure Storage 계정의 소유자는 데이터에 액세스할 수 있는 권한을 자동으로 할당 하지 않습니다.As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. AzCopy를 사용 하 여 의미 있는 작업을 수행 하려면 먼저 저장소 서비스에 권한 부여 자격 증명을 제공 하는 방법을 결정 해야 합니다.Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

AzCopy 권한 부여Authorize AzCopy

AD (Azure Active Directory)를 사용 하거나 SAS (공유 액세스 서명) 토큰을 사용 하 여 권한 부여 자격 증명을 제공할 수 있습니다.You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

이 표를 가이드로 사용 합니다.Use this table as a guide:

스토리지 유형Storage type 현재 지원 되는 권한 부여 방법Currently supported method of authorization
Blob StorageBlob storage Azure AD 및 SASAzure AD & SAS
Blob 저장소 (계층적 네임 스페이스)Blob storage (hierarchical namespace) Azure AD 및 SASAzure AD & SAS
File StorageFile storage SAS 전용SAS only

옵션 1: Azure Active Directory 사용Option 1: Use Azure Active Directory

이 옵션은 blob 저장소에만 사용할 수 있습니다.This option is available for blob Storage only. Azure Active Directory를 사용 하 여 각 명령에 SAS 토큰을 추가 하지 않고 자격 증명을 한 번 제공할 수 있습니다.By using Azure Active Directory, you can provide credentials once instead of having to append a SAS token to each command.

참고

현재 릴리스에서 저장소 계정 간에 blob을 복사 하려는 경우 각 원본 URL에 SAS 토큰을 추가 해야 합니다.In the current release, if you plan to copy blobs between storage accounts, you'll have to append a SAS token to each source URL. SAS 토큰은 대상 URL 에서만 생략할 수 있습니다.You can omit the SAS token only from the destination URL. 예제는 저장소 계정 간에 Blob 복사를 참조 하세요.For examples, see Copy blobs between storage accounts.

Azure AD를 사용 하 여 액세스 권한을 부여 하려면 AzCopy 및 Azure Active Directory를 사용 하 여 blob에 대 한 액세스 권한 부여 (AZURE ad)를 참조 하세요.To authorize access by using Azure AD, see Authorize access to blobs with AzCopy and Azure Active Directory (Azure AD).

옵션 2: SAS 토큰 사용Option 2: Use a SAS token

AzCopy 명령에서 사용 하는 각 원본 또는 대상 URL에 SAS 토큰을 추가할 수 있습니다.You can append a SAS token to each source or destination URL that use in your AzCopy commands.

이 예제 명령은 로컬 디렉터리에서 blob 컨테이너로 데이터를 재귀적으로 복사 합니다.This example command recursively copies data from a local directory to a blob container. 가상의 SAS 토큰이 컨테이너 URL의 끝에 추가 됩니다.A fictitious SAS token is appended to the end of the container URL.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

SAS 토큰 및 SAS 토큰을 구하는 방법에 대 한 자세한 내용은 sas (공유 액세스 서명) 사용을 참조 하세요.To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

데이터 전송Transfer data

Id에 대 한 권한을 부여 하거나 SAS 토큰을 얻은 후에는 데이터 전송을 시작할 수 있습니다.After you've authorized your identity or obtained a SAS token, you can begin transferring data.

예제 명령을 찾으려면 다음 문서 중 하나를 참조 하세요.To find example commands, see any of these articles.

스크립트에서 사용Use in a script

시간이 지남에 따라 AzCopy 다운로드 링크 는 새 버전의 AzCopy를 가리킵니다.Over time, the AzCopy download link will point to new versions of AzCopy. 스크립트에서 AzCopy를 다운로드 하는 경우 새 버전의 AzCopy가 스크립트가 종속 된 기능을 수정 하면 스크립트가 작동을 중지할 수 있습니다.If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

이러한 문제를 방지 하려면 AzCopy의 현재 버전에 대 한 정적 (변경 되지 않은) 링크를 가져옵니다.To avoid these issues, obtain a static (unchanging) link to the current version of AzCopy. 이렇게 하면 스크립트는 실행 될 때마다 동일한 버전의 AzCopy를 다운로드 합니다.That way, your script downloads the same exact version of AzCopy each time that it runs.

링크를 가져오려면 다음 명령을 실행 합니다.To obtain the link, run this command:

운영 체제Operating system 명령Command
LinuxLinux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
WindowsWindows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

참고

Linux의 경우 --strip-components=1 명령에서 tar 버전 이름이 포함 된 최상위 폴더를 제거 하 고 대신 이진 파일을 현재 폴더로 직접 추출 합니다.For Linux, --strip-components=1 on the tar command removes the top-level folder that contains the version name, and instead extracts the binary directly into the current folder. 이렇게 하면 URL만 업데이트 하 여 새 버전의로 스크립트를 업데이트할 수 있습니다 azcopy wget .This allows the script to be updated with a new version of azcopy by only updating the wget URL.

URL은이 명령의 출력에 표시 됩니다.The URL appears in the output of this command. 그런 다음 스크립트에서 해당 URL을 사용 하 여 AzCopy를 다운로드할 수 있습니다.Your script can then download AzCopy by using that URL.

운영 체제Operating system 명령Command
LinuxLinux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
WindowsWindows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

SAS 토큰의 이스케이프 특수 문자Escape special characters in SAS tokens

확장명이 있는 배치 파일에서 .cmd % SAS 토큰에 표시 되는 문자를 이스케이프 해야 합니다.In batch files that have the .cmd extension, you'll have to escape the % characters that appear in SAS tokens. %SAS 토큰 문자열의 기존 문자 옆에 추가 문자를 추가 하 여이 작업을 수행할 수 있습니다 % .You can do that by adding an additional % character next to existing % characters in the SAS token string.

Jenkins를 사용 하 여 스크립트 실행Run scripts by using Jenkins

Jenkins 를 사용 하 여 스크립트를 실행 하려는 경우 스크립트의 시작 부분에 다음 명령을 입력 해야 합니다.If you plan to use Jenkins to run scripts, make sure to place the following command at the beginning of the script.

/usr/bin/keyctl new_session

Azure Storage 탐색기에서 사용Use in Azure Storage Explorer

Storage 탐색기 AzCopy를 사용 하 여 모든 데이터 전송 작업을 수행 합니다.Storage Explorer uses AzCopy to perform all of its data transfer operations. AzCopy의 성능 이점을 활용 하려는 경우에는 Storage 탐색기 를 사용할 수 있지만 명령줄이 아닌 그래픽 사용자 인터페이스를 사용 하 여 파일을 조작 하는 것이 좋습니다.You can use Storage Explorer if you want to leverage the performance advantages of AzCopy, but you prefer to use a graphical user interface rather than the command line to interact with your files.

Storage 탐색기는 계정 키를 사용 하 여 작업을 수행 하므로 Storage 탐색기에 로그인 한 후에는 추가 권한 부여 자격 증명을 제공할 필요가 없습니다.Storage Explorer uses your account key to perform operations, so after you sign into Storage Explorer, you won't need to provide additional authorization credentials.

구성, 최적화 및 수정Configure, optimize, and fix

AzCopy 구성, 최적화 및 문제 해결 을 참조 하세요.See Configure, optimize, and troubleshoot AzCopy

이전 버전 사용Use a previous version

이전 버전의 AzCopy를 사용 해야 하는 경우 다음 링크 중 하나를 참조 하세요.If you need to use the previous version of AzCopy, see either of the following links:

다음 단계Next steps

질문, 문제 또는 일반 피드백이 있는 경우 GitHub 페이지에서 제출 합니다.If you have questions, issues, or general feedback, submit them on GitHub page.