Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Accedi ai file system FSx for NetApp ONTAP con Transfer Family

Panoramica di

Transfer Family supporta Amazon FSx for NetApp ONTAP tramite punti di accesso S3. Amazon FSx for NetApp ONTAP è un servizio completamente gestito che fornisce uno storage di file altamente affidabile, scalabile, ad alte prestazioni e ricco di funzionalità basato sul popolare file system ONTAP. NetApp Quando configuri Transfer Family con un file system FSx, gli utenti si connettono agli endpoint Transfer Family utilizzando client di trasferimento file standard. Transfer Family indirizza le operazioni sui file tramite un punto di accesso S3 collegato al volume FSx, mentre i dati rimangono sul file system FSx. Per ulteriori informazioni su FSx for NetApp ONTAP, consulta Cos'è Amazon FSx for ONTAP? NetApp

Questa integrazione ti consente di:

Prerequisiti

Prima di configurare Transfer Family con Amazon FSx, devi soddisfare i seguenti requisiti.

Requisiti FSx for NetApp ONTAP

Per utilizzare FSx for NetApp ONTAP con Transfer Family, è necessario:

Per ulteriori informazioni, consulta la pagina Guida introduttiva ad Amazon FSx for NetApp ONTAP.

Autorizzazioni IAM richieste

Puoi configurare ogni punto di accesso S3 con autorizzazioni e controlli di rete distinti che S3 applica per qualsiasi richiesta effettuata utilizzando quel punto di accesso. I punti di accesso S3 supportano le policy delle risorse IAM che puoi utilizzare per controllare l'uso del punto di accesso in base alla risorsa, all'utente o ad altre condizioni. Affinché un'applicazione o un utente possa accedere ai file tramite un punto di accesso, sia il punto di accesso che il volume sottostante devono consentire la richiesta. Per ulteriori informazioni, consulta le politiche dei punti di accesso IAM.

Gli access point Amazon S3 per FSx utilizzano un modello di autorizzazione a doppio livello che combina le autorizzazioni IAM con le autorizzazioni a livello di file system. Questo approccio garantisce che le richieste di accesso ai dati siano autorizzate correttamente sia a livello di AWS servizio che a livello di file system sottostante.

Affinché un'applicazione o un utente possa accedere correttamente ai dati tramite un punto di accesso, sia la policy del punto di accesso S3 che il volume FSx sottostante devono consentire la richiesta.

Per creare e configurare questa integrazione, sono necessarie le seguenti autorizzazioni:

Come funziona lo storage FSx con Transfer Family

Quando si configura Transfer Family con un file system FSx, i seguenti componenti interagiscono per abilitare i trasferimenti di file:

Affinché un'operazione sui file abbia esito positivo, entrambi i livelli di autorizzazione devono consentire la richiesta.

Identità dell'utente del file system

Ogni punto di accesso utilizza un'identità utente del file system specificata durante la creazione del punto di accesso. Questa identità autorizza tutte le richieste di accesso ai file effettuate tramite quel punto di accesso. L'utente del file system è un account utente sul file system Amazon FSx sottostante. Se l'utente del file system ha accesso in sola lettura, vengono autorizzate solo le richieste di lettura effettuate utilizzando il punto di accesso e le richieste di scrittura vengono bloccate. Se l'utente del file system dispone di accesso in lettura/scrittura, sono autorizzate sia le richieste di lettura che quelle di scrittura al volume allegato effettuate utilizzando il punto di accesso.

Creazione di un punto di accesso S3 per FSx

Prima di configurare Transfer Family, è necessario creare un punto di accesso S3 collegato al volume FSx. I punti di accesso S3 sono endpoint di rete denominati collegati a un'origine dati come un bucket o un volume Amazon FSx for ONTAP. Puoi creare e collegare un access point a un FSx for NetApp ONTAP utilizzando la console Amazon FSx, l'interfaccia a riga di AWS comando o l'API. Una volta collegato, si possono utilizzare le API degli oggetti S3 per accedere ai dati dei file. I dati continuano a risiedere nel file system Amazon FSx e continuano a essere direttamente accessibili per i carichi di lavoro esistenti. È possibile continuare a gestire lo storage utilizzando tutte le funzionalità di gestione dello storage FSx for NetApp ONTAP, tra cui backup, istantanee, quote di utenti e gruppi e compressione.

Per ulteriori informazioni, consulta Creazione dei punti di accesso.

Denominazione dei punti di accesso

Quando assegnate un nome al punto di accesso, seguite queste linee guida:

Per un elenco completo delle regole di denominazione, consulta Regole, restrizioni e limitazioni di denominazione dei punti di accesso.

Creazione di un punto di accesso per FSx for ONTAP NetApp

Utilizzare la procedura seguente per creare un punto di accesso S3 per un volume FSx NetApp for ONTAP.

Configurazione delle autorizzazioni del file system

L'utente del file system specificato determina le operazioni che gli utenti di Transfer Family possono eseguire. È necessario configurare le autorizzazioni appropriate sul volume FSx.

Esempio 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

Esempio di 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"

Utilizzo degli alias dei punti di accesso S3 con FSx

Quando si utilizzano i file system FSx con Transfer Family, è necessario utilizzare gli alias dei punti di accesso S3. Transfer Family non supporta l'utilizzo di access point ARN o altri metodi di riferimento per lo storage FSx.

Informazioni sugli alias dei punti di accesso

Quando crei un punto di accesso S3 collegato a un volume FSx, Amazon S3 genera automaticamente un alias del punto di accesso. Questo alias è un identificatore univoco che puoi usare ovunque utilizzi un nome di bucket S3.

Per i punti di accesso collegati ai volumi FSx, l'alias utilizza il seguente formato:

access-point-name-metadata-ext-s3alias

Alias di esempio:

my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias

Individuazione dell'alias del punto di accesso

È possibile trovare l'alias del punto di accesso dopo averlo creato.

Per trovare l'alias del punto di accesso (CLI)

Utilizza il comando describe-s3-access-point-attachments.

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

La risposta include l'alias:

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

Quando configuri gli utenti Transfer Family, usa l'alias del punto di accesso nelle mappature delle home directory.

Formato della home directory:

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

Esempio:

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

Configurazione di Transfer Family per lo storage FSx

Dopo aver creato il punto di accesso S3, configura un server Transfer Family per utilizzarlo.

Creazione di un ruolo IAM

Devi creare un ruolo IAM che conceda a Transfer Family l'accesso al punto di accesso S3.

Esempio di policy 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"
        }
    ]
}

Gestione degli utenti per lo storage FSx

Crea utenti Transfer Family con mappature della home directory che utilizzano l'alias del punto di accesso S3.

Creazione di un utente

Quando crei un utente per lo storage FSx, usa l'alias del punto di accesso nelle mappature della home directory.

Per creare un utente (CLI)

Utilizza il comando create-user. Sostituisci l'alias del punto di accesso con il tuo alias.

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"
        }
    ]'

Configurazione di più mappature di directory

È possibile mappare più directory virtuali su percorsi diversi sul volume FSx.

Esempio: directory separate di upload e download

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"
        }
    ]'

Configurazione dei client per il trasferimento di file

Quando si utilizzano i file system FSx con Transfer Family, è necessario configurare i client di trasferimento file per disabilitare le funzionalità non supportate.

Configurazione WinSCP

WinSCP utilizza per impostazione predefinita una funzionalità di ridenominazione temporanea che non è supportata con i punti di accesso S3 per FSx.

In alternativa, puoi disabilitare questa impostazione per una sessione esistente:

Altri client SFTP

Per altri client SFTP, disabilitate le seguenti funzionalità, se disponibili:

Consultate la documentazione del cliente per i passaggi di configurazione specifici.

Risoluzione dei problemi di storage FSx

Questa sezione descrive come identificare e risolvere i problemi più comuni quando si utilizza Transfer Family con i file system FSx.

Problemi relativi al funzionamento dei file

Autorizzazione negata

Se ricevi errori relativi all'autorizzazione negata:

Il caricamento non riesce con WinSCP

Se il caricamento dei file fallisce con WinSCP, disabilita la ridenominazione temporanea:

Per ulteriori informazioni, consulta Configurazione dei client per il trasferimento di file.

Il caricamento del file non riesce

Se il caricamento dei file fallisce: