FSx for Windows File Server 볼륨 - Amazon Elastic Container Service

FSx for Windows File Server 볼륨

FSx for Windows File Server는 Windows 파일 시스템이 지원하는 완전 관리형 Microsoft Windows 파일 서버를 제공합니다. FSx for Windows File Server와 ECS를 함께 사용하면 영구적이고 분산, 공유된 고정 파일 스토리지로 Windows 태스크를 프로비저닝할 수 있습니다. 자세한 정보는 FSx for Windows File Server란 무엇인가요?를 참조하세요.

참고

Amazon ECS 최적화 Windows Server 2016 Full AMI을 사용하는 EC2 인스턴스는 FSx for Windows File Server ECS 태스크 볼륨을 지원하지 않습니다.

Fargate 구성의 Windows 컨테이너에서 Windows 파일 서버 볼륨용 FSx를 사용할 수 없습니다.

FSx for Windows File Server를 사용하여 공유된 외부 스토리지, 고가용성 리전 스토리지, 고성능 스토리지에 액세스해야 하는 Windows 워크로드를 배포할 수 있습니다. 하나 이상의 FSx for Windows File Server 파일 시스템 볼륨을 ECS Windows 인스턴스에 실행되는 ECS 컨테이너에 탑재할 수 있습니다. 단일 ECS 태스크 내에서는 여러 ECS 컨테이너 사이에 FSx for Windows File Server 파일 시스템 볼륨을 공유할 수 있습니다.

ECS로 FSx for Windows File Server를 사용하도록 지원하려면 FSx for Windows File Server 파일 시스템 ID와 관련 정보를 태스크 정의에 포함해야 합니다. 다음은 태스크 정의 JSON 코드 조각의 예제입니다. 태스크 정의를 생성, 실행하기 전에 다음이 필요합니다.

  • 유효한 도메인에 가입된 ECS Windows EC2 인스턴스. Amazon EC2의 온프레미스 Active Directory 또는 자체 Active Directory인 AWS Directory Service for Microsoft Active Directory에서 호스팅할 수 있습니다.

  • Active Directory와 도메인을 결합하고 the FSx for Windows File Server 파일 시스템을 연결하는 데 사용하는 자격 증명이 포함된 AWS Secrets Manager 암호 또는 Systems Manager 파라미터. 자격 증명 값은 Active Directory를 생성할 때 입력하는 이름과 암호 자격 증명입니다.

다음 섹션에서는 Amazon ECS와 FSx for Windows File Server를 사용하기 시작하는 방법에 대한 설명을 제공합니다.

관련 자습서는 자습서: Amazon ECS에서 FSx for Windows File Server 파일 시스템 사용 섹션을 참조하세요.

FSx for Windows File Server 볼륨 고려 사항

FSx for Windows File Server 볼륨을 사용할 때 다음을 고려하세요.

  • FSx for Windows File Server와 Amazon ECS는 Windows Amazon EC2 인스턴스만 지원합니다. Linux Amazon EC2 인스턴스는 지원하지 않습니다.

  • Amazon ECS는 FSx for Windows File Server만 지원합니다. Amazon ECS는 FSx for Lustre를 지원하지 않습니다.

  • FSx for Windows File Server와 Amazon ECS는 AWS Fargate를 지원하지 않습니다.

  • awsvpc 네트워크 모드의 FSx for Windows File Server와 Amazon ECS는 컨테이너 에이전트의 버전 1.54.0 이상이 필요합니다.

  • Amazon ECS 태스크에 사용할 수 있는 드라이브 문자의 최대 개수는 23개입니다. FSx for Windows File Server 볼륨이 포함된 각 태스크는 드라이브 문자가 할당됩니다.

  • 기본적으로 태스크 리소스 정리 시간은 작업이 끝나고 3시간 후입니다. 태스크에서 생성한 파일 매핑은 사용하는 태스크가 없어도 3시간 동안 유지됩니다. 기본 정리 시간은 Amazon ECS 환경 변수 ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION을 사용하여 구성할 수 있습니다. 자세한 정보는 Amazon ECS 컨테이너 에이전트 구성 섹션을 참조하세요.

  • 일반적으로 태스크는 FSx for Windows File Server 파일 시스템과 동일한 VPC에서 실행됩니다. 그러나 Amazon ECS 클러스터 VPC와 FSx for Windows File Server 파일 시스템 사이에 VPC 피어링을 통한 네트워크 연결이 설정되어 있다면 VPC 간 지원이 가능합니다.

  • VPC 보안 그룹을 구성하면 네트워크 수준에서 FSx for Windows File Server 파일 시스템에 대한 액세스를 제어할 수 있습니다. AD 보안 그룹이 올바르게 구성된 AD 도메인과 결합된 EC2 인스턴스에서 호스팅되는 태스크만 FSx for Windows File Server 파일 공유에 액세스할 수 있습니다. 보안 그룹이 잘못 구성되면 ECS는 “unable to mount file system fs-id” 오류 메시지와 함께 태스크 시작이 실패합니다.

  • FSx for Windows File Server는 AWS Identity and Access Management(IAM)과 통합되어 IAM 사용자와 그룹이 특정 FSx for Windows File Server 리소스에 취할 수 있는 태스크를 제어합니다. 고객은 클라이언트 권한 부여로 특정 FSx for Windows File Server 파일 시스템에 대한 액세스를 허용하거나 거부하는 IAM 역할을 정의할 수 있고, 선택적으로 읽기 전용 액세스를 요구하고 클라이언트에서 파일 시스템에 대한 루트 액세스를 허용 또는 거부할 수 있습니다. 자세한 정보는 Amazon FSx Windows 사용 설명서의 보안을 참조하세요.

태스크 정의에서 FSx for Windows File Server 파일 시스템 지정

컨테이너에 FSx for Windows File Server 파일 시스템 볼륨을 사용하려면 태스크 정의에 볼륨 및 마운트 지점 구성을 지정합니다. 다음 태스크 정의 JSON 코드 조각은 컨테이너에 사용할 volumesmountPoints 객체의 구문을 나타냅니다.

{ "containerDefinitions": [ { "entryPoint": [ "powershell", "-Command" ], "portMappings": [], "command": ["New-Item -Path C:\\fsx-windows-dir\\index.html -ItemType file -Value '<html> <head> <title>Amazon ECS Sample App</title> <style>body {margin-top: 40px; background-color: #333;} </style> </head><body> <div style=color:white;text-align:center> <h1>Amazon ECS Sample App</h1> <h2>It Works!</h2> <p>You are using Amazon FSx for Windows File Server file system for persistent container storage.</p>' -Force"], "cpu": 512, "memory": 256, "image": "mcr.microsoft.com/windows/servercore/iis:windowsservercore-ltsc2019", "essential": false, "name": "container1", "mountPoints": [ { "sourceVolume": "fsx-windows-dir", "containerPath": "C:\\fsx-windows-dir", "readOnly": false } ] }, { "entryPoint": [ "powershell", "-Command" ], "portMappings": [ { "hostPort": 8080, "protocol": "tcp", "containerPort": 80 } ], "command": ["Remove-Item -Recurse C:\\inetpub\\wwwroot\\* -Force; Start-Sleep -Seconds 120; Move-Item -Path C:\\fsx-windows-dir\\index.html -Destination C:\\inetpub\\wwwroot\\index.html -Force; C:\\ServiceMonitor.exe w3svc"], "mountPoints": [ { "sourceVolume": "fsx-windows-dir", "containerPath": "C:\\fsx-windows-dir", "readOnly": false } ], "cpu": 512, "memory": 256, "image": "mcr.microsoft.com/windows/servercore/iis:windowsservercore-ltsc2019", "essential": true, "name": "container2" } ], "family": "fsx-windows", "executionRoleArn": "arn:aws:iam::111122223333:role/ecsTaskExecutionRole", "volumes": [ { "name": "fsx-windows-vol", "fsxWindowsFileServerVolumeConfiguration": { "fileSystemId": "fs-0eeb5730b2EXAMPLE", "authorizationConfig": { "domain": "example.com", "credentialsParameter": "arn:arn-1234" }, "rootDirectory": "share" } } ] }
FSxWindowsFileServerVolumeConfiguration

유형: 객체

필수 항목 여부: 아니요

이 파라미터는 태스크 저장에 FSx for Windows File Server 파일 시스템을 사용할 때 지정됩니다.

fileSystemId

유형: String

필수 항목 여부: 예

사용할 FSx for Windows File Server 파일 시스템 ID입니다.

rootDirectory

유형: String

필수 항목 여부: 예

호스트 내의 루트 디렉터리로 탑재할 FSx for Windows File Server 파일 시스템 내 디렉터리입니다.

authorizationConfig
credentialsParameter

유형: String

필수 항목 여부: 예

권한 부여 자격 증명 옵션:

domain

유형: String

필수 항목 여부: 예

AWS Directory Service Managed Microsoft AD(Active Directory) 또는 셀프 호스팅되는 EC2 AD에서 호스팅되는 정규화된 도메인 이름입니다.

자격 증명 저장 방법

자격 증명 파라미터와 함께 사용할 자격 증명을 저장하는 방법에는 두 가지가 있습니다.

  • AWS Secrets Manager 암호

    이 자격 증명은 다른 암호 유형 카테고리를 사용하여 AWS Secrets Manager 콘솔에서 생성할 수 있습니다. 각 키/값 쌍, 사용자 이름/관리자 및 암호/암호에 대한 열을 추가합니다.

  • Systems Manager 파라미터

    이 자격 증명은 다음 예제 코드 조각에 표시된 형식으로 텍스트를 입력하여 Systems Manager 파라미터 콘솔에서 생성될 수 있습니다.

    { "username": "admin", "password": "password" }

태스크 정의 FSxWindowsFileServerVolumeConfiguration 파라미터의 credentialsParameter는 암호 ARN 또는 Systems Manager 파라미터 ARN을 보유합니다. 자세한 정보는 Secrets Manager 사용 설명서AWS Secrets Manager란 무엇인가요?Systems Manager 사용 설명서Systems Manager 파라미터 스토어를 참조하세요.