Batch 서비스 API를 사용하여 Azure Storage에 태스크 데이터 유지

아티클
06/13/2024

Azure Batch에서 실행 중인 태스크는 실행 시 출력 데이터를 생성할 수 있습니다. 작업의 다른 태스크, 작업을 실행한 클라이언트 애플리케이션 또는 둘 다에서 검색할 수 있도록 태스크 출력 데이터는 종종 저장할 필요가 있습니다. 태스크는 Batch 컴퓨팅 노드의 파일 시스템에 출력 데이터를 쓰지만, 노드 이미지를 다시 만들거나 노드에서 풀을 종료할 때 해당 노드의 모든 데이터가 손실됩니다. 또한 태스크에는 파일 보존 기간이 있을 수 있으며, 그 후에는 해당 태스크에서 만든 파일이 삭제됩니다. 이러한 이유로 나중에 Azure Storage와 같은 데이터 저장소에 필요한 태스크 출력을 유지하는 것이 중요합니다.

Batch의 스토리지 계정 옵션은 Batch 계정 및 Azure Storage 계정을 참조하세요.

Batch 서비스 API에서 가상 머신 구성으로 풀에서 실행되는 작업(task) 및 작업(job) 관리자 작업(task)의 출력 데이터를 Azure Storage에 유지하도록 지원합니다. 태스크를 추가할 때 Azure Storage의 컨테이너를 태스크 출력의 대상으로 지정할 수 있습니다. 그런 다음 태스크가 완료되면 Batch 서비스에서 해당 컨테이너에 출력 데이터를 씁니다.

Batch 서비스 API를 사용하여 작업 출력을 유지하면 작업이 실행되는 애플리케이션을 수정할 필요가 없습니다. 대신 클라이언트 애플리케이션을 약간만 수정하면 태스크를 만드는 동일한 코드 내에서 태스크 출력을 유지할 수 있습니다.

Important

2018년 2월 1일 이전에 생성된 풀의 경우 Batch 서비스 API를 사용하여 Azure Storage에 태스크 데이터를 보관할 수 없습니다.

Batch 서비스 API를 사용하여 태스크 출력을 유지하는 경우는?

Azure Batch는 태스크 출력을 유지하는 한 가지 이상의 방법을 제공합니다. Batch 서비스 API를 사용하는 것은 다음 시나리오에 가장 적합한 편리한 방식입니다.

태스크가 실행되는 애플리케이션을 수정하지 않고 클라이언트 애플리케이션 내에서 태스크 출력을 유지하는 코드를 작성하려고 합니다.
가상 컴퓨터 구성으로 만든 풀에서 Batch 태스크 및 작업 관리자 태스크의 출력을 유지하려고 합니다.
Azure Storage 컨테이너에 임의의 이름으로 출력을 유지하려고 합니다.
Batch 파일 규칙 표준(영문)에 따라 명명된 Azure Storage 컨테이너에 출력을 유지하려고 합니다.

위에서 나열한 시나리오와 다른 시나리오이면 다른 방법을 고려해야 할 수도 있습니다. 예를 들어 Batch 서비스 API는 현재 태스크가 실행되는 동안 Azure Storage에 대한 스트리밍 출력을 지원하지 않습니다. 출력을 스트리밍하려면 .NET에서 사용할 수 있는 Batch 파일 규칙 라이브러리를 사용하는 것이 좋습니다. 다른 언어의 경우 사용자 고유의 자체 솔루션을 구현해야 합니다. 다른 옵션에 대한 자세한 내용은 Azure Storage에 작업(job) 및 작업(task) 출력 유지를 참조하세요.

Azure Storage에 컨테이너 만들기

Azure Storage에 태스크 출력을 유지하려면 출력 파일의 대상으로 사용할 컨테이너를 만들어야 합니다. 적절한 Azure Storage 클라이언트 라이브러리 또는 SDK를 사용하여 작업(task)을 실행하기 전에, 되도록 작업(job)을 제출하기 전에 컨테이너를 만듭니다. Azure Storage API에 대한 자세한 내용은 Azure Storage 설명서를 참조하세요.

예를 들어 C#으로 애플리케이션을 작성하는 경우 .NET용 Azure Storage 클라이언트 라이브러리를 사용합니다. 다음 예제에서는 컨테이너를 만드는 방법을 보여 줍니다.

CloudBlobContainer container = storageAccount.CreateCloudBlobClient().GetContainerReference(containerName);
await container.CreateIfNotExists();

태스크 출력에 대한 출력 파일 지정

태스크에 대한 출력 파일을 지정하려면 OutputFile 개체의 컬렉션을 만들고 태스크를 만들 때 CloudTask.OutputFiles 속성에 이 컬렉션을 할당합니다. SAS(공유 액세스 서명) 또는 관리 ID를 사용하여 컨테이너에 대한 액세스를 인증할 수 있습니다.

공유 액세스 서명 사용

컨테이너를 만든 후에는 컨테이너에 대한 쓰기 액세스 권한이 있는 SAS(공유 액세스 서명)를 가져옵니다. SAS는 컨테이너에 대해 위임된 액세스를 제공합니다. SAS는 지정된 권한 집합 및 지정된 시간 간격으로 액세스 권한을 부여합니다. Batch 서비스에는 컨테이너에 작업 출력을 기록하는 쓰기 권한이 있는 SAS가 필요합니다. SAS에 대한 자세한 내용은 Azure Storage에서 SAS(공유 액세스 서명) 사용을 참조하세요.

Azure Storage API를 사용하여 SAS를 가져오면 API에서 SAS 토큰 문자열을 반환합니다. 이 토큰 문자열에는 SAS가 유효한 권한과 간격을 포함하여 SAS의 모든 매개 변수가 포함됩니다. SAS를 사용하여 Azure Storage의 컨테이너에 액세스하려면 SAS 토큰 문자열을 리소스 URI에 추가해야 합니다. 리소스 URI는 추가된 SAS 토큰과 함께 Azure Storage에 대해 인증된 액세스를 제공합니다.

다음 예제에서는 컨테이너에 대한 쓰기 전용 SAS 토큰 문자열을 가져온 다음 컨테이너 URI에 SAS를 추가하는 방법을 보여 줍니다.

string containerSasToken = container.GetSharedAccessSignature(new SharedAccessBlobPolicy()
{
    SharedAccessExpiryTime = DateTimeOffset.UtcNow.AddDays(1),
    Permissions = SharedAccessBlobPermissions.Write
});

string containerSasUrl = container.Uri.AbsoluteUri + containerSasToken;

다음 C# 코드 예제에서는 output.txt라는 파일에 임의의 숫자를 쓰는 태스크를 만듭니다. 이 예제에서는 output.txt라는 출력 파일을 만들어 컨테이너에 씁니다. 또한 std*.txt 파일 패턴(, 예: , stdout.txt 및 stderr.txt)과 일치하는 모든 로그 파일에 대한 출력 파일도 만듭니다. 컨테이너 URL에는 이전에 컨테이너에 대해 만든 SAS가 필요합니다. Batch 서비스에서는 이 SAS를 사용하여 컨테이너에 대한 액세스를 인증합니다.

new CloudTask(taskId, "cmd /v:ON /c \"echo off && set && (FOR /L %i IN (1,1,100000) DO (ECHO !RANDOM!)) > output.txt\"")
{
    OutputFiles = new List<OutputFile>
    {
        new OutputFile(
            filePattern: @"..\std*.txt",
            destination: new OutputFileDestination(
         new OutputFileBlobContainerDestination(
                    containerUrl: containerSasUrl,
                    path: taskId)),
            uploadOptions: new OutputFileUploadOptions(
            uploadCondition: OutputFileUploadCondition.TaskCompletion)),
        new OutputFile(
            filePattern: @"output.txt",
            destination: 
         new OutputFileDestination(new OutputFileBlobContainerDestination(
                    containerUrl: containerSasUrl,
                    path: taskId + @"\output.txt")),
            uploadOptions: new OutputFileUploadOptions(
            uploadCondition: OutputFileUploadCondition.TaskCompletion)),
}

참고 항목

Linux에서 이 예제를 사용하는 경우에는 백슬래시를 슬래시로 변경해야 합니다.

관리 ID를 사용하는 경우

컨테이너에 대한 쓰기 권한이 있는 SAS를 생성하여 Batch에 전달하는 대신 관리 ID를 사용하여 Azure Storage를 인증할 수 있습니다. ID는 Batch 풀에 할당되어야 하며 작성할 컨테이너에 대한 Storage Blob Data Contributor 역할 할당도 있어야 합니다. 그런 다음 SAS가 아니라 관리 ID를 사용하여 컨테이너에 대한 액세스를 인증하도록 Batch 서비스에 알릴 수 있습니다.

CloudBlobContainer container = storageAccount.CreateCloudBlobClient().GetContainerReference(containerName);
await container.CreateIfNotExists();

new CloudTask(taskId, "cmd /v:ON /c \"echo off && set && (FOR /L %i IN (1,1,100000) DO (ECHO !RANDOM!)) > output.txt\"")
{
    OutputFiles = new List<OutputFile>
    {
        new OutputFile(
            filePattern: @"..\std*.txt",
            destination: new OutputFileDestination(
         new OutputFileBlobContainerDestination(
                    containerUrl: container.Uri,
                    path: taskId,
                    identityReference: new ComputeNodeIdentityReference() { ResourceId = "/subscriptions/SUB/resourceGroups/RG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity-name"} })),
            uploadOptions: new OutputFileUploadOptions(
            uploadCondition: OutputFileUploadCondition.TaskCompletion))
    }
}

일치시킬 파일 패턴 지정

출력 파일을 지정할 때 OutputFile.FilePattern 속성을 사용하여 일치시킬 파일 패턴을 지정할 수 있습니다. 파일 패턴은 0개 파일, 단일 파일 또는 태스크에서 만든 파일 집합과 일치할 수 있습니다.

FilePattern 속성은 *(비재귀 일치의 경우) 및 **(재귀 일치의 경우)와 같은 표준 파일 시스템 와일드카드를 지원합니다. 예를 들어 위의 코드 샘플에서는 std*.txt와 비일치하는 파일 패턴을 지정합니다.

filePattern: @"..\std*.txt"

단일 파일을 업로드하려면 와일드카드 없이 파일 패턴을 지정합니다. 예를 들어 위의 코드 샘플에서는 output.txt와 비재귀적으로 일치하는 파일 패턴을 지정합니다.

filePattern: @"output.txt"

업로드 조건 지정

OutputFileUploadOptions.UploadCondition 속성은 출력 파일의 조건부 업로드를 허용합니다. 일반적인 시나리오는 태스크가 성공하면 한 파일 집합을 업로드하고, 실패하면 다른 파일 집합을 업로드하는 것입니다. 예를 들어 태스크가 실패하고 0이 아닌 종료 코드로 종료되는 경우에만 자세한 로그 파일을 업로드하는 것이 좋습니다. 마찬가지로 태스크가 실패하는 경우 파일이 없거나 불완전할 수 있으므로, 태스크가 성공한 경우에만 결과 파일을 업로드하는 것이 좋습니다.

위의 코드 샘플에서는 UploadCondition 속성을 TaskCompletion으로 설정합니다. 이 설정은 종료 코드의 값에 관계 없이 태스크가 완료된 후에 파일을 업로드하도록 지정합니다.

uploadCondition: OutputFileUploadCondition.TaskCompletion

다른 설정은 OutputFileUploadCondition 열거형을 참조하세요.

이름이 같은 파일의 구분

작업의 태스크에서 이름이 같은 파일을 만들 수 있습니다. 예를 들어 stdout.txt 및 stderr.txt는 작업에서 실행되는 모든 태스크에 대해 만들어집니다. 태스크마다 자체의 컨텍스트에서 실행되므로 이러한 파일은 노드의 파일 시스템에서 충돌하지 않습니다. 그러나 여러 태스크의 파일을 공유 컨테이너에 업로드할 때는 이름이 같은 파일을 명확하게 구분해야 합니다.

OutputFileBlobContainerDestination.Path 속성은 출력 파일에 대한 대상 Blob 또는 가상 디렉터리를 지정합니다. Path 속성을 사용하여 이름이 같은 출력 파일이 Azure Storage에서 고유한 이름으로 지정되는 방식으로 Blob 또는 가상 디렉터리의 이름을 지정할 수 있습니다. 고유한 이름을 지정하고 파일을 쉽게 식별할 수 있도록 경로에 태스크 ID를 사용하는 것이 좋습니다.

FilePattern 속성이 와일드카드 식으로 설정되면 해당 패턴과 일치하는 모든 파일이 Path 속성으로 지정된 가상 디렉터리에 업로드됩니다. 예를 들어 컨테이너가 mycontainer이고 태스크 ID가 mytask이고 파일 패턴이 ..\std*.txt인 경우, Azure Storage의 출력 파일에 대한 절대 URI는 다음과 비슷합니다.

https://myaccount.blob.core.windows.net/mycontainer/mytask/stderr.txt
https://myaccount.blob.core.windows.net/mycontainer/mytask/stdout.txt

FilePattern 속성이 단일 파일 이름과 일치하도록 설정되면(와일드카드 문자가 포함되지 않음) Path 속성의 값은 정규화된 Blob 이름을 지정합니다. 여러 태스크에서 단일 파일과 이름이 충돌할 것으로 예상되는 경우 가상 디렉터리의 이름을 파일 이름의 일부로 포함하여 해당 파일을 구분합니다. 예를 들어 태스크 ID, 구분 기호 문자(일반적으로 슬래시) 및 파일 이름을 포함하도록 Path 속성을 설정합니다.

path: taskId + @"/output.txt"

태스크 집합의 출력 파일에 대한 절대 URI는 다음과 비슷합니다.

https://myaccount.blob.core.windows.net/mycontainer/task1/output.txt
https://myaccount.blob.core.windows.net/mycontainer/task2/output.txt

Azure Storage의 가상 디렉터리에 대한 자세한 내용은 컨테이너의 Blob 나열에 있는 Blob 나열을 참조하세요.

많은 출력 파일

태스크가 수많은 출력 파일을 지정하는 경우 Azure Batch API에 의해 적용되는 제한이 발생할 수 있습니다. 작업을 작게 유지하고 출력 파일 수를 낮게 유지하는 것이 좋습니다.

제한이 발생하는 경우 파일 패턴을 사용하거나 tar 또는 zip과 같은 파일 컨테이너를 사용하여 출력 파일을 통합하여 출력 파일 수를 줄이는 것이 좋습니다. 또는 탑재 또는 기타 접근 방식을 활용하여 출력 데이터를 유지합니다(작업 및 태스크 출력 유지 참조).

파일 업로드 오류 진단

Azure Storage에 대한 출력 파일 업로드가 실패하면 태스크가 완료됨 상태로 전환되고 TaskExecutionInformation.FailureInformation 속성이 설정됩니다. FailureInformation 속성을 검사하여 발생한 오류를 확인합니다. 예를 들어 컨테이너가 없는 경우 파일 업로드에서 발생하는 오류는 다음과 같습니다.

Category: UserError
Code: FileUploadContainerNotFound
Message: One of the specified Azure container(s) was not found while attempting to upload an output file

모든 파일 업로드에서 Batch는 두 개의 로그 파일을 fileuploadout.txt 및 fileuploaderr.txt 컴퓨팅 노드에 씁니다. 이러한 로그 파일을 검사하여 특정 오류에 대해 자세히 확인할 수 있습니다. 예를 들어 태스크 자체가 실행되지 않아 파일 업로드를 시도할 수 없는 경우에는 이러한 로그 파일이 존재하지 않습니다.

파일 업로드 성능 진단

fileuploadout.txt 파일은 업로드 진행률을 기록합니다. 이 파일을 검사하면 파일 업로드에 소요된 시간에 대해 자세히 확인할 수 있습니다. 노드 크기, 업로드 시 노드의 다른 활동, 대상 컨테이너가 Batch 풀과 동일한 지역에 있는지 여부, 스토리지 계정에 동시에 업로드되는 노드 수 등 업로드 성능에 영향을 주는 많은 요인들이 있음에 유의하세요.

Batch 파일 규칙 표준과 함께 Batch 서비스 API 사용

Batch 서비스 API를 사용하여 태스크 출력을 유지할 때 원하는 대로 대상 컨테이너 및 Blob의 이름을 지정할 수 있습니다. 또한 Batch 파일 규칙 표준(영문)에 따라 이름을 지정하도록 선택할 수도 있습니다. 파일 규칙 표준에서는 지정된 출력 파일에 대한 Azure Storage 대상 컨테이너 및 Blob의 이름을 작업 및 태스크의 이름을 기반으로 하여 결정합니다. 파일 규칙 표준을 사용하여 출력 파일 이름을 지정하면 Azure Portal에서 출력 파일을 볼 수 있습니다.

C#에서 개발하는 경우 .NET용 Batch 파일 규칙 라이브러리(영문)에 기본 제공된 메서드를 사용할 수 있습니다. 이 라이브러리는 적절하게 명명된 컨테이너와 Blob 경로를 만듭니다. 예를 들어 API를 호출하여 작업 이름에 기반한 올바른 컨테이너 이름을 가져올 수 있습니다.

string containerName = job.OutputStorageContainerName();

CloudJobExtensions.GetOutputStorageContainerUrl 메서드를 사용하여 컨테이너에 쓰는 데 사용되는 SAS(공유 액세스 서명) URL을 반환할 수 있습니다. 그런 다음 이 SAS를 OutputFileBlobContainerDestination 생성자로 전달할 수 있습니다.

C# 이외의 언어로 개발하는 경우 파일 규칙 표준을 직접 구현해야 합니다.

코드 샘플

PersistOutputs 샘플 프로젝트는 GitHub의 Azure Batch 코드 샘플 중 하나입니다. 이 Visual Studio 솔루션에서는 .NET용 Batch 클라이언트 라이브러리를 사용하여 영구 스토리지에 태스크 출력을 유지하는 방법을 보여 줍니다. 샘플을 실행하려면 다음 단계를 수행합니다.

Visual Studio 2019에서 프로젝트를 엽니다.
Microsoft.Azure.Batch.Samples.Common 프로젝트에서 Batch 및 Storage 계정 자격 증명을 AccountSettings.settings에 추가합니다.
빌드 합니다(하지만 실행하지 않음). 메시지가 표시되면 모든 NuGet 패키지를 복원합니다.
Azure 포털을 사용하여 PersistOutputsTask 에 대한 애플리케이션 패키지를 업로드합니다. PersistOutputsTask.exe 및 종속 어셈블리를 .zip 패키지에 포함하고, 애플리케이션 ID를 "PersistOutputsTask"로, 애플리케이션 패키지 버전을 "1.0"으로 설정합니다.
PersistOutputs 프로젝트를 시작(실행)합니다.
샘플을 실행하는 데 사용할 지속성 기술을 선택하라는 메시지가 표시될 때 Batch 서비스 API를 통해 샘플을 실행하여 태스크 출력을 유지하려면 2를 입력합니다.
원하는 경우 샘플을 다시 실행하고 3을 입력하여 Batch 서비스 API를 통해 출력을 유지하고 파일 규칙 표준에 따라 대상 컨테이너와 Blob 경로의 이름도 지정합니다.

다음 단계

.NET용 파일 규칙 라이브러리를 사용하여 태스크 출력을 보관하는 방법에 대한 자세한 내용은 .NET용 Batch 파일 규칙 라이브러리를 사용하여 Azure Storage에 작업 및 태스크 데이터 보관을 참조하세요.
Azure Batch에서 출력 데이터를 보관하는 다른 방법에 대한 자세한 내용은 Azure Storage에 작업 및 태스크 출력 보관을 참조하세요.

다음을 통해 공유