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

Transfer Family를 사용하여 FSx for NetApp ONTAP 파일 시스템에 액세스

개요

Transfer Family는 S3 액세스 포인트를 통해 Amazon FSx for NetApp ONTAP을 지원합니다. Amazon FSx for NetApp ONTAP은 NetApp의 인기 있는 ONTAP 파일 시스템에 구축된 매우 안정적이고 확장 가능하며 성능이 뛰어나고 기능이 풍부한 파일 스토리지를 제공하는 완전 관리형 서비스입니다. FSx 파일 시스템으로 Transfer Family를 구성하면 사용자는 표준 파일 전송 클라이언트를 사용하여 Transfer Family 엔드포인트에 연결합니다. Transfer Family는 데이터가 FSx 파일 시스템에 남아 있는 동안 FSx 볼륨에 연결된 S3 액세스 포인트를 통해 파일 작업을 라우팅합니다. FSx for NetApp ONTAP에 대한 자세한 내용은 Amazon FSx for NetApp ONTAP이란 무엇입니까?를 참조하세요.

이 통합을 통해 다음을 수행할 수 있습니다.

사전 조건

Amazon FSx로 Transfer Family를 구성하기 전에 다음 요구 사항을 충족해야 합니다.

FSx for NetApp ONTAP 요구 사항

Transfer Family와 함께 FSx for NetApp ONTAP을 사용하려면 다음이 필요합니다.

자세한 내용은 Amazon FSx for NetApp ONTAP 시작하기를 참조하세요.

필수 IAM 권한

각 S3 액세스 포인트를 사용하여 이루어진 모든 요청에 S3가 적용하는 고유한 권한 및 네트워크 제어를 사용하여 각 S3 액세스 포인트를 구성할 수 있습니다. S3 액세스 포인트는 리소스, 사용자 또는 기타 조건별로 액세스 포인트 사용을 제어하는 데 사용할 수 있는 IAM 리소스 정책을 지원합니다. 애플리케이션 또는 사용자가 액세스 포인트를 통해 파일에 액세스하려면 액세스 포인트와 기본 볼륨 모두 요청을 허용해야 합니다. 자세한 내용은 IAM 액세스 포인트 정책을 참조하세요.

FSx용 Amazon S3 액세스 포인트는 IAM 권한과 파일 시스템 수준 권한을 결합하는 이중 계층 권한 부여 모델을 사용합니다. 이 접근 방식을 사용하면 AWS 서비스 수준과 기본 파일 시스템 수준 모두에서 데이터 액세스 요청이 제대로 승인됩니다.

애플리케이션 또는 사용자가 액세스 포인트를 통해 데이터에 성공적으로 액세스하려면 S3 액세스 포인트 정책과 기본 FSx 볼륨 모두에서 요청을 허용해야 합니다.

이 통합을 생성하고 구성하려면 다음 권한이 필요합니다.

FSx 스토리지가 Transfer Family와 작동하는 방식

FSx 파일 시스템으로 Transfer Family를 구성하면 다음 구성 요소가 함께 작동하여 파일 전송을 활성화합니다.

파일 작업이 성공하려면 두 권한 부여 계층 모두 요청을 허용해야 합니다.

파일 시스템 사용자 자격 증명

각 액세스 포인트는 액세스 포인트를 생성할 때 지정하는 파일 시스템 사용자 ID를 사용합니다. 이 자격 증명은 해당 액세스 포인트를 통해 이루어진 모든 파일 액세스 요청을 승인합니다. 파일 시스템 사용자는 기본 Amazon FSx 파일 시스템의 사용자 계정입니다. 파일 시스템 사용자에게 읽기 전용 액세스 권한이 있는 경우 액세스 포인트를 사용하여 수행된 읽기 요청만 승인되고 쓰기 요청은 차단됩니다. 파일 시스템 사용자에게 읽기-쓰기 액세스 권한이 있는 경우 액세스 포인트를 사용하여 만든 연결된 볼륨에 대한 읽기 및 쓰기 요청이 모두 승인됩니다.

FSx용 S3 액세스 포인트 생성

Transfer Family를 구성하기 전에 FSx 볼륨에 연결된 S3 액세스 포인트를 생성해야 합니다. S3 액세스 포인트는 버킷 또는 Amazon FSx for ONTAP 볼륨과 같은 데이터 소스에 연결된 명명된 네트워크 엔드포인트입니다. Amazon FSx 콘솔, AWS CLI 또는 API를 사용하여 액세스 포인트를 생성하고 FSx for NetApp ONTAP에 연결할 수 있습니다. 연결되면 S3 객체 API를 사용하여 파일 데이터에 액세스할 수 있습니다. 데이터는 Amazon FSx 파일 시스템에 계속 상주하며 기존 워크로드에서 직접 액세스할 수 있습니다. 백업, 스냅샷, 사용자 및 그룹 할당량, 압축 등 모든 FSx for NetApp ONTAP 스토리지 관리 기능을 사용하여 스토리지를 계속 관리합니다.

자세한 내용은 액세스 포인트 생성을 참조하십시오.

액세스 포인트 이름 지정

액세스 포인트의 이름을 지정할 때 다음 지침을 따릅니다.

이름 지정 규칙의 전체 목록은 액세스 포인트 이름 지정 규칙, 제한 및 제한을 참조하세요.

FSx for NetApp ONTAP에 대한 액세스 포인트 생성

다음 절차에 따라 FSx for NetApp ONTAP 볼륨에 대한 S3 액세스 포인트를 생성합니다.

파일 시스템 권한 구성

지정하는 파일 시스템 사용자는 Transfer Family 사용자가 수행할 수 있는 작업을 결정합니다. FSx 볼륨에 대한 적절한 권한을 구성해야 합니다.

UNIX 예제:

# Create a directory for Transfer Family users
mkdir -p /vol1/transfer-users

# Set ownership to match the access point user
chown 1001:1001 /vol1/transfer-users

# Set permissions
chmod 755 /vol1/transfer-users

Windows 예:

# Create a directory for Transfer Family users
New-Item -Path "D:\vol1\transfer-users" -ItemType Directory

# Set permissions for the file system user associated with the access point
# Replace DOMAIN\TransferUser with your Windows user identity
icacls "D:\vol1\transfer-users" /grant "DOMAIN\TransferUser:(OI)(CI)M" /T

# Verify permissions
icacls "D:\vol1\transfer-users"

FSx에서 S3 액세스 포인트 별칭 사용

Transfer Family에서 FSx 파일 시스템을 사용하는 경우 S3 액세스 포인트 별칭을 사용해야 합니다. Transfer Family는 FSx 스토리지에 대한 액세스 포인트 ARNs 또는 기타 참조 방법 사용을 지원하지 않습니다.

액세스 포인트 별칭 정보

FSx 볼륨에 연결된 S3 액세스 포인트를 생성하면 Amazon S3가 액세스 포인트 별칭을 자동으로 생성합니다. 이 별칭은 S3 버킷 이름을 사용하는 모든 곳에서 사용할 수 있는 고유 식별자입니다.

FSx 볼륨에 연결된 액세스 포인트의 경우 별칭은 다음 형식을 사용합니다.

access-point-name-metadata-ext-s3alias

예제 별칭:

my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias

액세스 포인트 별칭 찾기

액세스 포인트를 생성한 후 액세스 포인트 별칭을 찾을 수 있습니다.

액세스 포인트 별칭을 찾으려면(CLI)

describe-s3-access-point-attachments 명령을 사용합니다.

aws fsx describe-s3-access-point-attachments \
    --filters Name=file-system-id,Values=fs-0123456789abcdef0

응답에는 별칭이 포함됩니다.

{
    "S3AccessPointAttachments": [
        {
            "S3AccessPoint": {
                "ResourceARN": "arn:aws:s3:us-east-1:111122223333:accesspoint/my-fsx-ap",
                "Alias": "my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias"
            }
        }
    ]
}

Transfer Family 사용자를 구성할 때 홈 디렉터리 매핑에서 액세스 포인트 별칭을 사용합니다.

홈 디렉터리 형식:

/access-point-alias/path/to/directory

예:

/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith

FSx 스토리지용 Transfer Family 구성

S3 액세스 포인트를 생성한 후 이를 사용하도록 Transfer Family 서버를 구성합니다.

IAM 역할 생성

Transfer Family에 S3 액세스 포인트에 대한 액세스 권한을 부여하는 IAM 역할을 생성해야 합니다.

IAM 정책의 예:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowFileOperations",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject",
                "s3:GetObjectTagging",
                "s3:PutObjectTagging"
            ],
            "Resource": "arn:aws:s3:us-east-2:111122223333:accesspoint/my-fsx-ap/object/*"
        },
        {
            "Sid": "AllowDirectoryOperations",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": "arn:aws:s3:us-east-2:111122223333:accesspoint/my-fsx-ap"
        }
    ]
}

FSx 스토리지 사용자 관리

S3 액세스 포인트 별칭을 사용하는 홈 디렉터리 매핑을 사용하여 Transfer Family 사용자를 생성합니다.

사용자 생성

FSx 스토리지 사용자를 생성할 때 홈 디렉터리 매핑에서 액세스 포인트 별칭을 사용합니다.

사용자를 생성하려면(CLI)

create-user 명령을 사용합니다. 액세스 포인트 별칭을 별칭으로 바꿉니다.

aws transfer create-user \
    --server-id s-0123456789abcdef0 \
    --user-name jsmith \
    --role arn:aws:iam::111122223333:role/TransferFamilyFSxRole \
    --home-directory-type LOGICAL \
    --home-directory-mappings '[
        {
            "Entry": "/",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith"
        }
    ]'

여러 디렉터리 매핑 구성

여러 가상 디렉터리를 FSx 볼륨의 다른 경로에 매핑할 수 있습니다.

예: 별도의 업로드 및 다운로드 디렉터리

aws transfer create-user \
    --server-id s-0123456789abcdef0 \
    --user-name jsmith \
    --role arn:aws:iam::111122223333:role/TransferFamilyFSxRole \
    --home-directory-type LOGICAL \
    --home-directory-mappings '[
        {
            "Entry": "/inbox",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith/inbox"
        },
        {
            "Entry": "/outbox",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith/outbox"
        }
    ]'

파일 전송 클라이언트 구성

Transfer Family에서 FSx 파일 시스템을 사용하는 경우 지원되지 않는 기능을 비활성화하도록 파일 전송 클라이언트를 구성해야 합니다.

WinSCP 구성

WinSCP는 기본적으로 FSx용 S3 액세스 포인트에서 지원되지 않는 임시 이름 바꾸기 기능을 사용합니다.

또는 기존 세션에 대해이 설정을 비활성화할 수 있습니다.

기타 SFTP 클라이언트

다른 SFTP 클라이언트의 경우 사용 가능한 경우 다음 기능을 비활성화합니다.

특정 구성 단계는 클라이언트 설명서를 참조하세요.

FSx 스토리지 문제 해결

이 섹션에서는 FSx 파일 시스템에서 Transfer Family를 사용할 때 발생하는 일반적인 문제를 식별하고 해결하는 방법을 설명합니다.

파일 작업 문제

권한 거부됨

권한 거부 오류가 발생하는 경우:

WinSCP에서 업로드 실패

WinSCP에서 파일 업로드에 실패하면 임시 이름 바꾸기를 비활성화합니다.

자세한 내용은 파일 전송 클라이언트 구성 단원을 참조하십시오.

파일 업로드 실패

파일 업로드에 실패하는 경우: