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à.
# Aggiunta di un file system personalizzato a un dominio
Quando crei un dominio, Amazon SageMaker AI aggiunge un volume predefinito Amazon Elastic File System (Amazon EFS) al dominio. SageMaker L'intelligenza artificiale crea questo volume per te. Hai anche la possibilità di aggiungere un file system Amazon EFS o Amazon FSx for Lustre personalizzato che hai creato. Dopo averlo aggiunto, il file system diventa disponibile agli utenti che appartengono al dominio. I tuoi utenti possono accedere al file system quando usano Amazon SageMaker Studio. Possono collegare il file system agli spazi che creano per le applicazioni supportate seguenti:
+ JupyterLab
+ Editor di codici
Dopo aver eseguito uno spazio e avviato l’applicazione, gli utenti possono accedere a qualsiasi dato, codice o altro artefatto contenuto nel file system.
Puoi consentire agli utenti di accedere al file system nei seguenti modi:
+ Attraverso *spazi condivisi*: uno spazio condiviso può essere creato e utilizzato da qualsiasi utente appartenente al dominio.
+ Attraverso *spazi privati*: uno spazio privato può essere creato da qualsiasi utente appartenente al dominio e può essere utilizzato solo da quell’utente.
+ Esclusivamente a un singolo utente: se non desideri consentire a tutti gli utenti di accedere al file system, puoi concedere l’accesso solo a un utente specifico. In tal caso, il file system sarà disponibile solo negli spazi privati creati dall’utente specifico.
Puoi aggiungere un file system personalizzato utilizzando l' SageMaker API Amazon, il AWS SDKs, o il AWS CLI. Non puoi aggiungere un file system personalizzato utilizzando la console SageMaker AI.
## Prerequisiti
Prima di aggiungere un file system personalizzato a un dominio, devi soddisfare i requisiti seguenti:
+ Hai un dominio in SageMaker AI. Per poter aggiungere un file system, è necessario l’ID dominio. Puoi cercare l'ID utilizzando la console SageMaker AI. Inoltre puoi eseguire il comando [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-domains.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-domains.html) con l’opzione AWS CLI.
+ Hai un file system Amazon EFS o FSx for Lustre nel tuo Account AWS.
------
#### [ For Amazon EFS ]
+ Per la procedura per creare un Amazon EFS, consulta [Create your Amazon EFS file system](https://docs.aws.amazon.com/efs/latest/ug/gs-step-two-create-efs-resources.html) in *Amazon Elastic File System User Guide*.
+ Per poter accedere al file system, Studio deve disporre di una destinazione di montaggio in ciascuna delle sottoreti associate al dominio. Per ulteriori informazioni sull’assegnazione di destinazioni di montaggio alle sottoreti, consulta [Creating and managing mount targets and security groups](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) in *Amazon Elastic File System User Guide*.
+ Per ogni destinazione di montaggio, devi aggiungere il gruppo di sicurezza creato da Amazon SageMaker AI al Account AWS momento della creazione del dominio. Il formato del nome del gruppo di sicurezza è `security-group-for-inbound-nfs-domain-id`. Per istruzioni su come ottenere l’ID dominio, consulta [Visualizzazione dei domini](domain-view.md).
+ Le autorizzazioni IAM devono consentirti di utilizzare l’azione `elasticfilesystem:DescribeMountTargets`. Per ulteriori informazioni su questa azione, consulta [Azioni, risorse e chiavi di condizione per Amazon Elastic File System](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticfilesystem.html) in *Informazioni di riferimento sull’autorizzazione del servizio*.
------
#### [ For FSx for Lustre ]
+ Per i passaggi per creare un file system FSx for Lustre, consulta la [Guida introduttiva ad Amazon FSx for Lustre](https://docs.aws.amazon.com/fsx/latest/LustreGuide/getting-started.html.html) nella Guida per l'utente di *Amazon FSx for Lustre*. Assicurati che il file system FSx for Lustre esista in:
+ Nello stesso Amazon VPC del tuo dominio.
+ In una delle sottoreti presenti nel tuo dominio.
+ Prima che Studio possa accedere al file system FSx for Lustre, è necessario aggiungere il gruppo di sicurezza del dominio a tutte le interfacce di rete elastiche (ENIs) nel file system FSx for Lustre. Senza questa fase, la creazione dell’app non riesce e restituisce un errore. Utilizzate le seguenti istruzioni per aggiungere il gruppo di sicurezza del dominio al file system FSx for Lustre. ENIs
**Aggiungi il gruppo di sicurezza del dominio al file system FSx for Lustre ENIs (console)**
1. Accedi alla [ FSxconsole Amazon](https://console.aws.amazon.com/fsx).
1. Seleziona **File system**.
1. Scegli il tuo file system FSx for Lustre utilizzando il link corrispondente in **File system ID**.
1. Se non è già selezionata, scegli la scheda **Rete e sicurezza**.
1. In **Sottorete**, scegli **Per vedere tutte le ENI, consulta la console di Amazon EC2**. Verrai indirizzato alla console Amazon EC2 e mostrerà tutti i ENIs collegamenti al tuo file system FSx for Lustre.
1. Per ogni ENI:
1. Scegli l’ENI selezionando il link corrispondente in **ID interfaccia di rete**.
1. Scegli **Azioni** in alto a destra nella pagina di riepilogo per espandere un menu a discesa.
1. Nel menu a discesa, seleziona **Scegli gruppo di sicurezza**.
1. Cerca il gruppo di sicurezza del tuo dominio.
Il formato del nome del gruppo di sicurezza è `security-group-for-inbound-nfs-domain-id`. Per istruzioni su come ottenere l’ID dominio, consulta [Visualizzazione dei domini](domain-view.md).
1. Seleziona **Aggiungi gruppo di sicurezza**.
------
## Aggiungere un file system personalizzato a un dominio con AWS CLI
Per aggiungere un file system personalizzato a un dominio o a un profilo utente con AWS CLI, si passa una `CustomFileSystemConfigs` definizione quando si utilizza uno dei seguenti comandi:
+ [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-domain.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-domain.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-domain.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-domain.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-user-profile.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-user-profile.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-user-profile.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-user-profile.html)
Gli esempi seguenti mostrano come aggiungere un file system a un dominio o a un profilo utente esistente.
**Per aggiungere un file system accessibile in spazi condivisi**
+ Aggiorna le impostazioni di spazio predefinite per il tuo dominio. L’esempio seguente aggiunge le impostazioni del file system alle impostazioni di spazio predefinite:
```
aws sagemaker update-domain --domain-id domain-id \
--default-space-settings file://file-system-settings.json
```
Questo esempio passa la configurazione del file system come file JSON, come illustrato in un esempio successivo.
**Per aggiungere un file system accessibile in spazi privati**
+ Aggiorna le impostazioni utente predefinite per il tuo dominio. L’esempio seguente aggiunge le impostazioni del file system alle impostazioni utente predefinite:
```
aws sagemaker update-domain --domain-id domain-id \
--default-user-settings file://file-system-settings.json
```
Questo esempio passa la configurazione del file system come file JSON, come illustrato in un esempio successivo.
**Per aggiungere un file system accessibile solo a un singolo utente**
+ Aggiorna il profilo utente per l’utente. L’esempio seguente aggiunge le impostazioni del file system a un profilo utente:
```
aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings file://file-system-settings.json
```
Questo esempio passa la configurazione del file system come file JSON, come illustrato nell’esempio seguente.
**Example file di impostazioni del file system**
Il file negli esempi precedenti, `file-system-settings.json`, presenta le impostazioni seguenti:
```
{
"CustomFileSystemConfigs":
[
{
"FSxLustreFileSystemConfig":
{
"FileSystemId": "file-system-id",
"FileSystemPath": "/"
}
}
]
}
```
Questa configurazione di esempio ha le chiavi seguenti:
`CustomFileSystemConfigs`
Impostazioni per i file system personalizzati (sono supportati solo i file system Amazon EFS).
`FSxLustreFileSystemConfig`
Impostazioni personalizzate FSx per i file system Lustre.
`FileSystemId`
L’ID del file system Amazon EFS.
`FileSystemPath`
Il percorso per la directory del file system accessibile agli utenti del dominio nei rispettivi spazi in Studio. Gli utenti autorizzati possono accedere solo a questa directory e a quelle sottostanti. Il percorso predefinito è il root del file system: `/`.
```
{
"CustomFileSystemConfigs":
[
{
"EFSFileSystemConfig":
{
"FileSystemId": "file-system-id",
"FileSystemPath": "/"
}
}
]
}
```
Questa configurazione di esempio ha le chiavi seguenti:
`CustomFileSystemConfigs`
Impostazioni per i file system personalizzati (sono supportati solo i file system Amazon EFS).
`EFSFileSystemConfig`
Impostazioni per i file system Amazon EFS personalizzati.
`FileSystemId`
L’ID del file system Amazon EFS.
`FileSystemPath`
Il percorso per la directory del file system accessibile agli utenti del dominio nei rispettivi spazi in Studio. Gli utenti autorizzati possono accedere solo a questa directory e a quelle sottostanti. Il percorso predefinito è il root del file system: `/`.
Quando si assegna un file system alle impostazioni di spazio predefinite per un dominio, è necessario includere anche il ruolo di esecuzione nelle impostazioni:
```
{
"ExecutionRole": "execution-role-arn"
}
```
Questa configurazione di esempio contiene la chiave seguente:
`ExecutionRole`
Il ruolo di esecuzione predefinito per gli utenti del dominio.
Se desideri applicare le autorizzazioni POSIX al tuo file system, puoi anche passare le impostazioni seguenti ai comandi `create-domain` o `create-user-profile`:
```
{
"CustomPosixUserConfig":
{
"Uid": UID,
"Gid": GID
}
}
```
Questa configurazione di esempio ha le chiavi seguenti:
`CustomPosixUserConfig`
Le identità POSIX predefinite utilizzate per le operazioni del file system. Puoi utilizzare queste impostazioni per applicare la struttura di autorizzazioni POSIX esistente ai profili utente che accedono al file system personalizzato. A livello delle autorizzazioni POSIX, puoi controllare quali utenti possono accedere al file system e a quali file o dati possono accedere.
Puoi anche applicare le impostazioni `CustomPosixUserConfig` quando crei un profilo utente utilizzando il comando `create-user-profile`. Le impostazioni applicate a un profilo utente sono prioritarie rispetto a quelle applicate al dominio associato.
Puoi applicare le impostazioni `CustomPosixUserConfig` quando utilizzi i comandi `create-domain` e `create-user-profile`, ma non quando:
+ Utilizzi il comando `update-domain` per un dominio già associato a un qualsiasi profilo utente. Puoi applicare queste impostazioni solo ai domini senza profili utente.
+ Utilizza il comando `update-user-profile`. Per applicare queste impostazioni a un profilo già creato, elimina il profilo e creane uno nuovo con le impostazioni aggiornate.
`Uid`
L’ID utente POSIX. Il valore predefinito è 200001.
`Gid`
L’ID del gruppo POSIX. Il valore predefinito è 1001.
## Collegamento di un file system personalizzato a uno spazio con AWS CLI
Dopo aver aggiunto un file system personalizzato a un dominio, gli utenti del dominio possono collegare il file system agli spazi che creano. Ad esempio, possono collegare il file system quando utilizzano Studio o il comando [create-space](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-space.html) con la AWS CLI.
**Per collegare un file system personalizzato a uno spazio**
+ Aggiungi la configurazione del file system alle impostazioni dello spazio. Il comando di esempio seguente collega un file system a un nuovo spazio.
```
aws sagemaker create-space \
--space-name space-name \
--domain-id domain-id \
--ownership-settings "OwnerUserProfileName=user-profile-name" \
--space-sharing-settings "SharingType=Private" \
--space-settings file://space-settings.json
```
In questo esempio, il file `space-settings.json` ha le impostazioni seguenti, che includono la configurazione `CustomFileSystems` con la chiave `FileSystemId`.
------
#### [ For your FSx for Lustre file systems ]
```
{
"AppType": "JupyterLab",
"JupyterLabAppSettings":
{
"DefaultResourceSpec":
{
"InstanceType": "instance-type"
}
},
"CustomFileSystems":
[
{
"FSxLustreFileSystem":
{
"FileSystemId": "file-system-id"
}
}
]
}
```
------
#### [ For your Amazon EFS file systems ]
```
{
"AppType": "JupyterLab",
"JupyterLabAppSettings":
{
"DefaultResourceSpec":
{
"InstanceType": "instance-type"
}
},
"CustomFileSystems":
[
{
"EFSFileSystem":
{
"FileSystemId": "file-system-id"
}
}
]
}
```
------
SageMaker AI crea un collegamento simbolico nel seguente percorso:. `/home/sagemaker-user/custom-file-systems/file-system-type/file-system-id` Con questo, gli utenti del dominio possono accedere al file system personalizzato dalla loro home directory `/home/sagemaker-user`.